pgpool-II是一个集连接池、主备切换与负载均衡于一身的数据库连接件,本文以配置读写分离集群为例,介绍pgpool-II的配置方式。
本文使用的版本为PostgreSQL12.1,由于PG12版本不再支持通过recovery.conf的方式进行主备切换,如果数据目录中存在recovery.conf,则数据库无法启动。
(一) 准备工作
1.本例中,两台数据节点IP与端口号为
Harvest1 192.168.100.1:5432
Harvest2 192.168.100.2:5432
保证服务器都安装了PostgreSQL12.1。
提示:
在典型配置中,可以将pgpool配置在一台独立的节点上。本文为简便起见,将pgpool部署在master节点。
2.使用yum下载rpm包安装pgpool-II,注意下载的安装包须与PG的版本一致。安装包目录详见https://www.pgpool.net/yum/rpms/4.1/redhat/rhel-8-x86_64/。
[root@Harvest1 ~] yum install https://www.pgpool.net/yum/rpms/4.1/redhat/rhel-8-x86_64/pgpool-II-pg12-4.1.0-1pgdg.rhel8.x86_64.rpm
提示:
使用rpm安装的pgpool-II的数据目录在/etc/pgpool-II路径下。
(二) 配置双机环境-主节点
在Harvest1的postgresql.conf中添加以下配置,将wal_level配置为hot_standy表示两台数据库进行热备份,archive_mode表示开启归档模式。
wal_level = hot_standby
checkpoint_timeout = 5min
archive_mode = on
max_wal_senders = 3
wal_keep_segments = 16
在数据库中创建用于同步数据的用户rep:
postgres#= CREATE USER rep REPLICATION LOGIN ENCRYPTED PASSWORD '123456';
为rep用户修改pg_hba.conf:
host replication rep 0.0.0.0/0 md5
修改完成后重启数据库
pg_ctl restart
(三) 配置双机环境-备份节点
停止备份节点
pg_ctl stop
清空备份节点$PGDATA目录下的所有文件,执行命令行工具pg_basebackup:
pg_basebackup -R -D /home/postgres/data/ -Fp -Xs -v -P -h 192.168.100.1 -p 5432 -U rep
备份完成后启动备份数据库,查看流复制同步效果
postgres#= SELECT pg_is_in_recovery();
(四)配置pgpool-II
修改/etc/pgpool-II目录下的pgpool.conf:
# 以下为后端连接参数
backend_hostname0 = '192.168.26.128'
backend_port0 = 5432
backend_weight0 = 1
backend_flag0 = 'ALLOW_TO_FAILOVER'
backend_hostname1 = '192.168.26.129'
backend_port1 = 5432
backend_weight1 = 100
backend_flag1 = 'ALLOW_TO_FAILOVER'
#pgpool的hba参数
enable_pool_hba = on
pool_passwd = 'pool_passwd'
#开启语句日志
log_statement = on
log_per_node_statement = on
log_destination = 'syslog'
print_timestamp = on
log_connections = on
log_hostname = off
log_standby_delay = 'always'
syslog_facility = 'LOCAL0'
syslog_ident = 'pgpool'
#开启附LB模式、流复制模式,设置拒绝的函数与SQL
load_balance_mode = on
ignore_leading_white_space = on
white_function_list = ''
black_function_list = 'currval,lastval,nextval,setval'
master_slave_mode = on
master_slave_sub_mode = 'stream'
(五)开启系统日志
pgpool的日志默认写到stderr,可以如上文中设置为syslog中。但由于默认情况下写入LOCAL0级别的日志会被丢弃,故要在/etc/rsyslog.conf中修改该syslog指定的输出路径:
local0.* /var/pgpool/pgpool.log
(六)pgpool秘钥
1.生成pgpool-II管理秘钥
pg_md5 -u sup_pool 123456
生成结果如:
e10adc3949ba59abbe56e057f20f883e
2.在pcp.conf中添加秘钥
sup_pool: e10adc3949ba59abbe56e057f20f883e
配置pool_hba.conf,注意认证方式必须为MD5
host all all 192.168.0.0/16 md5
修改pool_passwd
默认情况下,使用pg_md5即可向pass_wd写入用户与密码,例如:
pg_md5 --md5auth --username=postgres 123456
至此pgool-II配置完毕。
(七)pgool-II的启动与停止
启动pgpool:
pgpool -n -d > /var/pgpool/pgpool.log 2>&1 &
停止pgpool:
pgpool stop
若要强制定制pgpool:
pgpool stop -m fast
启动pgpool后,若连接正常,则会提示:
pgpool-II successfully started. version x.x.x
find_primary_node: primary node id is 0
例如:
(八)查看pgpool节点id及使用情况:
在pgpool中,默认的端口为9999,可以通过修改pgpool.conf来更改。
本例中,由于本地有psql,故可以直接使用psql连接pgpool:
psql -p 9999 -U postgres
通过以下SQL查询节点id:
show pool_nodes;