PGCluster安裝及設定

0. 介紹
PGCluster是日本作者修改PostgreSQL，使其達到Auto Replication, Load Balance 的能力。操作方式與原本PostgreSQL沒有太多差異，新增增加的幾個功能也會在下面介紹。

在安裝之前也建議將所有的node使用NIS/NFS管理。



系統架構如下：
[code lang="cpp"]

((Load Balance Server))
(( Replication Server))
( hostname: master )
( receive port:5432 )
( recovery port:6001 )
|
----------+-------------+------------+----------
| |
(( Cluster DB 1 )) (( Cluster DB 2 ))
( hostname: db1 ) ( hostname: db2 )
( receive port: 5432 ) ( receive port:5432 )
( recovery port:7001 ) ( recovery port 7001 )
[/code]

[b]1. 安裝[/b]
解開套件並且安裝，在此我們配合SRB的配置，prefix改成/opt/pgsql

[code lang="cpp"]
# tar -zxvf /usr/local/src/pgcluster-1.0.x.tar.gz
# ./configure
# make
# make install
[/code]

使用標準的postgresql初始化PGDATA的方式
請先確定你有一個postgres帳號。
[code lang="cpp"]
# cd /usr/local/pgsql
# mkdir data
# chown postgres data
# su postgres
# initdb -D data
[/code]

2. 設定
大略的架構圖，在我們的系統裡，Load Balancer和Replicator是一起的。


一般設定：
a. 存取控制
修改data/pg_hba.conf使其可以不用帳號登入存取其他node
舉例來說，
[code lang="cpp"]
local all trust
host all 127.0.0.1 255.255.255.255 trust
host all 192.168.0.1 255.255.255.0 trust
host all 192.168.0.2 255.255.255.0 trust
[/code]
請記得將IP改成你的主機的IP位置。

b. 開啟TCP Socket
修改data/postgres.conf，找到一行
#tcpip_socket = false
請刪除註解，並改成
tcpip_socket = true


c. rsync
在一般的linux系統，rsync是預設安裝的套件。pgcluster需要rsync + ssh(secured rsync)作為有任何資料庫損毀時回復資料的工具，而在進行資料回復時如果要打密碼，postmaster主程序會導致錯誤，所以需要進行public key authentication。
[code lang="cpp"]
# su postgres
# ssh-keygen -d
Generating public/private dsa key pair.
Enter file in which to save the key (/home/postgres/.ssh/id_dsa): <直接按enter>
Enter passphrase (empty for no passphrase):<直接按enter>
Enter same passphrase again:<直接按enter>
Your identification has been saved in /home/postgres/.ssh/id_dsa.
Your public key has been saved in /home/postgres/.ssh/id_dsa.pub.
# cp ~/.ssh/id_dsa.pub ~/.ssh/authorized_keys2
[/code]

接著進行連線的建立，一般ssh連線都會在known_host建立主機的finger-print，在你尚未連到對方主機前，會要求你輸入yes以便驗明正身。然而postmaster如果執行時還要輸入yes就不妙了，所以要事先進行連線。

在known_host裡的主機驗證是根據你連線時打的名稱，如果你打的是ip，便會增加ip，如果打主機名稱便以此類推。但ip,hostname,fullname在known_host裡視為不同的entry，而postmaster連線是連fullname，所以一定要對每一台的主機進行ssh fullname的連線。
[code lang="cpp"]
# ssh master.nchc.org.tw
The authenticity of host 'master.nchc.org.tw (192.168.0.1)' can't be established.
RSA key fingerprint is 22:f7:fe:31:67:1d:a2:60:7a:0e:fd:68:95:c7:b4:11.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added 'master.nchc.org.tw,192.168.0.1' (RSA) to the list of known hosts.
#
[/code]
如果成功，你不需要打密碼便可以登入主機。

設定Replicator：
[code lang="cpp"]
# cp [path to source]/src/pgcluster/pgrp/pgreplicate.conf.sample /usr/local/pgsql/data/pgreplicate.conf
[/code]
編輯pgreplicate.conf ，每一個標籤代表一個Cluster DB，請修改成符合你的狀況的設定。注意第一個標籤的DB就是MasterDB，基本上所有的資料會預設從MasterDB做Repliaction。

如果你不想安裝Load Balancer，請將有關Load Balancer的標籤註解起來。

設定Cluster DB：
data/cluster.conf在你initdb時就會存在，先編輯它。

編輯標籤的項目，以便符合你的設定。
注意到標籤，之前我們採用的ssh-keygen是使用ssh2的dsa，所以這裡要改為ssh -2。

而為了避免任何資料庫損毀時系統就無法進行insert，視你的需要將標籤的值改為read-write。應用在SRB上，則是必須要可讀寫的。

設定Load Balancer：
LB是將查詢轉送給ClusterDB來實際進行資料查詢，所以不能夠再執行postmaster。
同樣我們將範本複製到data目錄。
[code lang="cpp"]
# cp [path to source]/src/pgcluster/pgrp/pglb.conf.sample /usr/local/pgsql/data/pglb.conf
[/code]
編輯這個檔案，並且在填入符合你的狀況的值。

注意到下面的標籤，基本上不要使這個功能以免增加流量。

[b]3. 啟動[/b]
啟動的順序：Replicator -> Master DB -> Slave DB -> Load Balancer
同樣地，請使用postgres帳號進行作業。

[i]a. 啟動及停止Replicator[/i]
[code lang="cpp"]
# pgreplicate -D /usr/local/pgsql/data
# pgreplicate -D /usr/local/pgsql/data stop
[/code]

[i]b. 啟動及停止ClusterDB[/i]
[code lang="cpp"]
# pg_ctl -D /usr/local/pgsql/data start
# pg_ctl -D /usr/local/pgsql/data stop
[/code]
其餘的操作方式皆與原本的pg_ctl相同

[i]c. 啟動及停止Load Balancer[/i]
[code lang="cpp"]
# pglb -D /usr/local/pgsql/data
# pglb -D /usr/local/pgsql/data stop
[/code]

[b]4. 回復[/b]
當任何DB發生問題，你手動停止之後，你可能需要進行回復的作業以便讓這個DB與還活著的DB進行同步。
請使用postgres帳號進行作業。

回復的時候postmaster會明確呼叫rsync讓重新啟動的DB複製資料，相關的問題前面已經敘述。

而新增加的DB也可以同樣使用這個方式來進行資料同步。

[code lang="cpp"]
# pg_ctl start -D /usr/local/pgsql/data -o "-R"

[/code]