## 1. 环境准备
– 主节点：192.168.1.100 (master)
– 从节点1：192.168.1.101 (slave1)
– 从节点2：192.168.1.102 (slave2)
– PGPool-II节点1：192.168.1.103 (pgpool1)
– PGPool-II节点2：192.168.1.104 (pgpool2)
– 操作系统：Oracle Linux 9.3
– PostgreSQL版本：18.0
– PGPool-II版本：4.4.6

## 2. 安装PGPool-II
– 在PGPool-II节点上执行：
$ sudo dnf install -y epel-release
$ sudo dnf install -y pgpool-II-pg18-devel pgpool-II-pg18

## 3. 配置PGPool-II
– 编辑pgpool.conf：
$ sudo vi /etc/pgpool-II/pgpool.conf

# 基本配置
listen_addresses = ‘*’
port = 9999
socket_dir = ‘/var/run/pgpool’

# 后端节点配置
backend_fgedu.net.cnname0 = ‘192.168.1.100’
backend_port0 = 5432
backend_weight0 = 1
backend_data_directory0 = ‘/postgresql/data18’
backend_flag0 = ‘ALLOW_TO_FAILOVER’

backend_fgedu.net.cnname1 = ‘192.168.1.101’
backend_port1 = 5432
backend_weight1 = 1
backend_data_directory1 = ‘/postgresql/data18’
backend_flag1 = ‘ALLOW_TO_FAILOVER’

backend_fgedu.net.cnname2 = ‘192.168.1.102’
backend_port2 = 5432
backend_weight2 = 1
backend_data_directory2 = ‘/postgresql/data18’
backend_flag2 = ‘ALLOW_TO_FAILOVER’

# 负载均衡配置
load_balance_mode = on
master_slave_mode = on
master_slave_sub_mode = ‘streaming’
sr_check_period = 10
sr_check_fgedu = ‘replication’
sr_check_password = ‘replication123’
sr_check_fgedudb = ‘postgres’

# 连接池配置
connection_pooling = on
max_pool = 4
min_pool_size = 1
max_client_conn = 100

# 故障转移配置
failover_command = ‘/etc/pgpool-II/failover.sh’
follow_master_command = ‘/etc/pgpool-II/follow_master.sh’

## 4. 配置认证文件
– 编辑pool_hba.conf：
$ sudo vi /etc/pgpool-II/pool_hba.conf

# 添加以下内容
local all all trust
fgedu.net.cn all all 127.0.0.1/32 trust
fgedu.net.cn all all ::1/128 trust
fgedu.net.cn all all 192.168.1.0/24 md5

– 编辑pool_passwd：
$ sudo vi /etc/pgpool-II/pool_passwd

# 添加以下内容
fgedu:md5:5f4dcc3b5aa765d61d8327deb882cf99 # 密码：fgedu123

## 5. 创建故障转移脚本
– 创建failover.sh：
$ sudo vi /etc/pgpool-II/failover.sh

#!/bin/bash
# failover.sh
# from:www.itpux.com.qq113257174.wx:itpux-com
# web: http://www.fgedu.net.cn

failed_node=$1
new_master=$2

# 执行故障转移操作
echo “Failover triggered: node $failed_node down, new master is $new_master”

– 创建follow_master.sh：
$ sudo vi /etc/pgpool-II/follow_master.sh

#!/bin/bash
# follow_master.sh
# from:www.itpux.com.qq113257174.wx:itpux-com
# web: http://www.fgedu.net.cn

new_master=$1
new_master_port=$2
old_master=$3
old_master_port=$4

# 执行跟随主节点操作
echo “Following new master: $new_master:$new_master_port”

– 设置脚本权限：
$ sudo chmod +x /etc/pgpool-II/failover.sh /etc/pgpool-II/follow_master.sh

## 6. 启动PGPool-II服务
– 启动PGPool-II服务：
$ sudo systemctl start pgpool-II-pg18
$ sudo systemctl enable pgpool-II-pg18

– 检查服务状态：
$ sudo systemctl status pgpool-II-pg18

## 7. 验证PGPool-II
– 连接PGPool-II：
$ psql -U fgedu -d fgedudb -h 192.168.1.103 -p 9999

– 检查PGPool-II状态：
$ pgpool-II-pg18 status

– 检查后端节点状态：
$ psql -U fgedu -d fgedudb -h 192.168.1.103 -p 9999 -c “SHOW pool_nodes;”

## 1. 配置主从复制
– 确保主从复制正常运行
– 检查复制状态：
$ sudo -u pgsql psql -c “SELECT * FROM pg_stat_replication;”

## 2. 配置PGPool-II负载均衡
– 编辑pgpool.conf：
$ sudo vi /etc/pgpool-II/pgpool.conf

# 启用负载均衡
load_balance_mode = on

# 配置负载均衡算法
load_balance_node_selecting_method = ‘least_loaded’

# 配置SQL语句类型
master_slave_mode = on
master_slave_sub_mode = ‘streaming’

# 配置复制状态检查
sr_check_period = 10
sr_check_fgedu = ‘replication’
sr_check_password = ‘replication123’
sr_check_fgedudb = ‘postgres’

## 3. 配置连接池
– 编辑pgpool.conf：
$ sudo vi /etc/pgpool-II/pgpool.conf

# 启用连接池
connection_pooling = on

# 配置连接池大小
max_pool = 4
min_pool_size = 1
max_client_conn = 100
child_max_connections = 100

# 配置连接超时
client_idle_limit = 0
connection_life_time = 0

## 4. 配置应用连接
– 修改应用连接字符串：
jdbc:postgresql://192.168.1.103:9999/fgedudb

– 配置连接池（如应用使用连接池）：
– 最小连接数：5
– 最大连接数：50
– 连接超时：30秒
– 验证查询：SELECT 1

## 5. 测试读写分离
– 执行写操作：
$ psql -U fgedu -d fgedudb -h 192.168.1.103 -p 9999
fgedudb=> INSERT INTO fgedu_fgedus (name, email) VALUES (‘test’, ‘test@fgedu.net.cn’);
INSERT 0 1

– 执行读操作：
fgedudb=> SELECT * FROM fgedu_fgedus;

– 检查负载均衡情况：
$ psql -U fgedu -d fgedudb -h 192.168.1.103 -p 9999 -c “SHOW pool_nodes;”

## 6. 监控读写分离
– 监控PGPool-II状态：
$ psql -U fgedu -d fgedudb -h 192.168.1.103 -p 9999 -c “SHOW pool_status;”

– 监控连接池状态：
$ psql -U fgedu -d fgedudb -h 192.168.1.103 -p 9999 -c “SHOW pool_pools;”

– 监控后端节点状态：
$ psql -U fgedu -d fgedudb -h 192.168.1.103 -p 9999 -c “SHOW pool_nodes;”

## 1. 内置监控命令
– 检查PGPool-II状态：
$ psql -U fgedu -d fgedudb -h 192.168.1.103 -p 9999 -c “SHOW pool_status;”

– 检查后端节点状态：
$ psql -U fgedu -d fgedudb -h 192.168.1.103 -p 9999 -c “SHOW pool_nodes;”

– 检查连接池状态：
$ psql -U fgedu -d fgedudb -h 192.168.1.103 -p 9999 -c “SHOW pool_pools;”

– 检查进程状态：
$ psql -U fgedu -d fgedudb -h 192.168.1.103 -p 9999 -c “SHOW pool_processes;”

– 检查性能统计：
$ psql -U fgedu -d fgedudb -h 192.168.1.103 -p 9999 -c “SHOW pool_statistics;”

## 2. 外部监控
– 安装PGPool-II Exporter：
$ wget https://github.com/prometheus-community/pgpool-exporter/releases/download/v0.5.0/pgpool-exporter-0.5.0.linux-amd64.tar.gz
$ tar -xzf pgpool-exporter-0.5.0.linux-amd64.tar.gz

– 配置PGPool-II Exporter：
$ vi pgpool_exporter.yml
pgpool:
fgedu.net.cn: 192.168.1.103
port: 9999
fgedu: fgedu
password: fgedu123
fgedudb: fgedudb

– 启动PGPool-II Exporter：
$ ./pgpool_exporter –config.file=pgpool_exporter.yml

## 3. 集成Prometheus和Grafana
– 配置Prometheus：
$ vi prometheus.yml

scrape_configs:
– job_name: ‘pgpool’
static_configs:
– targets: [‘192.168.1.103:9635’]

– 导入Grafana Dashboard：
– 登录Grafana
– 添加Prometheus数据源
– 导入PGPool-II Dashboard

## 4. 管理命令
– 重新加载配置：
$ pgpool-II-pg18 reload

– 重启PGPool-II：
$ sudo systemctl restart pgpool-II-pg18

– 停止PGPool-II：
$ sudo systemctl stop pgpool-II-pg18

– 查看日志：
$ tail -f /var/log/pgpool-II/pgpool.log

## 5. 常见管理操作
– 添加新的从节点：
# 编辑pgpool.conf，添加新节点配置
# 重新加载配置

– 移除节点：
# 编辑pgpool.conf，移除节点配置
# 重新加载配置

– 手动故障转移：
$ pgpool-II-pg18 failover

– 切换主节点：
$ pgpool-II-pg18 promote