## 1. 环境准备
– 主节点：192.168.1.100 (master)
– 从节点：192.168.1.101 (slave1)
– 操作系统：Oracle Linux 9.3
– PostgreSQL版本：18.0

## 2. 主节点配置
– 安装PostgreSQL：
$ sudo dnf install -y postgresql18-server postgresql18-contrib

– 初始化数据库：
$ sudo /postgresql/fgapp/bin/postgresql-18-setup –initdb

– 编辑postgresql.conf：
$ sudo vi /postgresql/data18/postgresql.conf

# 修改以下参数
listen_addresses = ‘*’
port = 5432
shared_buffers = 4GB
wal_level = replica
max_wal_senders = 10
wal_keep_size = 1GB
max_replication_slots = 10
hot_standby = on

– 编辑pg_hba.conf：
$ sudo vi /postgresql/data18/pg_hba.conf

# 添加复制用户权限
fgedu.net.cn replication replication 192.168.1.101/32 md5

– 创建复制用户：
$ sudo -u pgsql psql
postgres=# CREATE USER replication REPLICATION LOGIN ENCRYPTED PASSWORD ‘replication123’;
postgres=# \q

– 启动PostgreSQL服务：
$ sudo systemctl start postgresql-18
$ sudo systemctl enable postgresql-18

## 3. 从节点配置
– 安装PostgreSQL：
$ sudo dnf install -y postgresql18-server postgresql18-contrib

– 停止PostgreSQL服务：
$ sudo systemctl stop postgresql-18

– 清理数据目录：
$ sudo rm -rf /postgresql/data18/*

– 从主节点复制数据：
$ sudo -u pgsql pg_basebackup -h 192.168.1.100 -U replication -D /postgresql/data18 -F p -X stream -c fast -P

– 创建recovery.conf文件：
$ sudo vi /postgresql/data18/recovery.conf

standby_mode = ‘on’
primary_conninfo = ‘fgedu.net.cn=192.168.1.100 port=5432 fgedu=replication password=replication123’
primary_slot_name = ‘slave1_slot’
recovery_target_timeline = ‘latest’

– 设置权限：
$ sudo chown pgsql: pgsql /postgresql/data18/recovery.conf

– 启动PostgreSQL服务：
$ sudo systemctl start postgresql-18
$ sudo systemctl enable postgresql-18

## 4. 验证复制状态
– 在主节点上创建复制槽：
$ sudo -u pgsql psql
postgres=# SELECT * FROM pg_create_physical_replication_slot(‘slave1_slot’);
postgres=# \q

– 在主节点上检查复制状态：
$ sudo -u pgsql psql
postgres=# SELECT * FROM pg_stat_replication;

– 在从节点上检查复制状态：
$ sudo -u pgsql psql
postgres=# SELECT pg_is_in_recovery();
postgres=# SELECT * FROM pg_stat_wal_receiver;

## 5. 测试复制
– 在主节点上创建测试表：
$ sudo -u pgsql psql
postgres=# CREATE DATABASE testdb;
postgres=# \c testdb
testdb=# CREATE TABLE fgedu_test_table (id SERIAL PRIMARY KEY, name VARCHAR(50));
testdb=# INSERT INTO test_table (name) VALUES (‘fgfgfgtest1’), (‘test2’), (‘test3’);
testdb=# \q

– 在从节点上验证数据：
$ sudo -u pgsql psql
postgres=# \c testdb
testdb=# SELECT * FROM test_table;

id | name
—-+——-
1 | fgfgfgtest1
2 | test2
3 | test3
(3 rows)

## 1. 安装Prometheus和Grafana
– 安装Prometheus：
$ wget https://github.com/prometheus/prometheus/releases/download/v2.45.0/prometheus-2.45.0.linux-amd64.tar.gz
$ tar -xzf prometheus-2.45.0.linux-amd64.tar.gz
$ cd prometheus-2.45.0.linux-amd64
$ ./prometheus –config.file=prometheus.yml

– 安装Grafana：
$ sudo dnf install -y grafana
$ sudo systemctl start grafana-server
$ sudo systemctl enable grafana-server

## 2. 配置PostgreSQL Exporter
– 安装PostgreSQL Exporter：
$ wget https://github.com/prometheus-community/postgres_exporter/releases/download/v0.15.0/postgres_exporter-0.15.0.linux-amd64.tar.gz
$ tar -xzf postgres_exporter-0.15.0.linux-amd64.tar.gz

– 创建连接配置：
$ vi .pgpass
localfgedu.net.cn:5432:pgsql: pgsql: pgsql – 启动PostgreSQL Exporter：
$ ./postgres_exporter –web.listen-address=:9187

## 3. 配置Prometheus
– 编辑prometheus.yml：
$ vi prometheus.yml

global:
scrape_interval: 15s

scrape_configs:
– job_name: ‘postgres-master’
static_configs:
– targets: [‘192.168.1.100:9187’]
– job_name: ‘postgres-slave1’
static_configs:
– targets: [‘192.168.1.101:9187’]

## 4. 配置Grafana Dashboard
– 登录Grafana：http://localfgedu.net.cn:3000
– 添加Prometheus数据源
– 导入PostgreSQL Dashboard（ID: 9628）
– 配置告警规则

## 5. 监控指标
– 复制延迟：pg_replication_lag
– 复制状态：pg_replication_status
– WAL生成速率：pg_wal_generated_bytes_total
– 连接数：pg_connections
– 查询性能：pg_stat_statements
– 系统资源：CPU、内存、磁盘、网络

## 6. 告警配置
– 复制延迟超过10秒
– 复制连接中断
– 主节点不可用
– 从节点不可用
– 磁盘空间不足
– 连接数超限

## 1. 手动故障转移
– 检查主节点状态：
$ ping 192.168.1.100
$ pg_isready -h 192.168.1.100

– 检查从节点状态：
$ sudo -u pgsql psql -c “SELECT pg_is_in_recovery();”

– 在从节点上执行故障转移：
$ sudo -u pgsql pg_ctl promote -D /postgresql/data18

– 验证新主节点状态：
$ sudo -u pgsql psql -c “SELECT pg_is_in_recovery();”

– 更新应用连接配置：
# 修改应用连接字符串，指向新的主节点（192.168.1.101）

– 重建复制关系：
# 在新主节点上创建复制用户
# 在原主节点（现在作为从节点）上执行pg_basebackup
# 配置recovery.conf

## 2. 自动故障转移
– 使用Patroni实现自动故障转移：

# 安装Patroni
$ pip install patroni[etcd]

# 创建Patroni配置文件
$ vi /etc/patroni.yml

scope: pgsql namespace: /db/
name: master

restapi:
listen: 192.168.1.100:8008
connect_address: 192.168.1.100:8008

etcd:
fgedu.net.cns: 192.168.1.100:2379,192.168.1.101:2379,192.168.1.102:2379

postgresql:
listen: 192.168.1.100:5432
connect_address: 192.168.1.100:5432
data_dir: /postgresql/data18
pgpass: /tmp/pgpass
authentication:
replication:
fgeduname: replication
password: replication123
superfgedu:
fgeduname: pgsql password: pgsql parameters:
shared_buffers: 4GB
wal_level: replica
max_wal_senders: 10
max_replication_slots: 10
hot_standby: on

# 启动Patroni
$ patroni /etc/patroni.yml

# 检查集群状态
$ patronictl -c /etc/patroni.yml list

## 3. 故障转移验证
– 验证新主节点状态：
$ pg_isready -h 192.168.1.101

– 验证数据完整性：
$ sudo -u pgsql psql -h 192.168.1.101 -c “SELECT * FROM test_table;”

– 验证应用连接：
$ psql -U fgedu -d fgedudb -h 192.168.1.101 -c “SELECT 1;”

– 验证复制状态：
# 在新主节点上检查复制状态
$ sudo -u pgsql psql -c “SELECT * FROM pg_stat_replication;”

## 4. 故障转移后处理
– 修复原主节点：
# 修复硬件或网络问题
# 重新加入集群作为从节点

– 验证集群状态：
$ patronictl -c /etc/patroni.yml list

– 执行备份：
$ pg_dump -U fgedu -d fgedudb -F c -f /backup/fgedudb_after_failover.dump