KingbaseES V8R6 集群运维系列之 -- 手工创建主备流复制
案例说明：
KingbaseES V8R6通过手工方式创建流复制集群，无需通过repmgr进行集群管理，则只能具有流复制功能，不能实现集群的故障自动切换。
适用版本：
KingbaseES V8R6
主机节点信息：
系统环境准备：（参考金仓官方文档）
https://help.kingbase.com.cn/v8/install-updata/install-linux/install-linux-2.html
一、配置主库环境
1、启动数据库服务
[kingbase@node101 ~]$ cd /opt/Kingbase/ES/V8R6_041/Server/bin
[kingbase@node101 bin]$ ./sys_ctl start -D /data/kingbase/v8r6_041/data
waiting for server to start....2022-03-29 22:07:19.775 CST [15822] LOG: sepapower extension initialized
......
server started
2、建立测试数据
[kingbase@node101 bin]$ ./ksql -U SYSTEM TEST
TEST=# create database prod;
CREATE DATABASE
TEST=# \c prod
You are now connected to database "prod" as user "SYSTEM".
prod=# create table t1 (id int ,name varchar(10));
CREATE TABLE
prod=# insert into t1 values (generate_series(1,10000),'usr'||generate_series(1,10000));
INSERT 0 10000
prod=# select count(*) from t1;
count
-------
10000
(1 row)
3、配置sys_hba.conf支持远程主机replication
重新加载sys_hba.conf：
TEST=# select sys_reload_conf();
sys_reload_conf
-----------------
t
(1 row)
4、主备流复制参数配置
5、主库创建replication slot
二、配置备库系统环境
1、安装数据库软件（和主库相同版本）
=注意：只需安装软件，不需要创建数据库。=
2、创建备库数据存储目录（尽量和主库一致）
[root@node102 soft]# mkdir -p /data/kingbase/v8r6_041/data
[root@node102 soft]# chown -R kingbase.kingbase /data/kingbase/
三、手工clone流复制备库
1、查看备库端sys_basebackup工具
2、通过sys_basebackup克隆备库
[kingbase@node102 bin]$ ./sys_basebackup -h 192.168.1.101 -U SYSTEM -D /data/kingbase/v8r6_041/data -P -v -X stream -F p -S slot_node102
Password:
sys_basebackup: initiating base backup, waiting for checkpoint to complete
sys_basebackup: checkpoint completed
sys_basebackup: write-ahead log start point: 0/33000028 on timeline 1
sys_basebackup: starting background WAL receiver
556390/556390 kB (100%), 1/1 tablespace
sys_basebackup: write-ahead log end point: 0/330000F8
sys_basebackup: waiting for background process to finish streaming ...
sys_basebackup: syncing data to disk ...
sys_basebackup: base backup completed
参数说明:
-h 指定所连接的主库的ip
-U 连接数据库主库的用户
-P 显示进度详细信息
-v 显示备份详情
-X 指定wal日志获取模式
-F 备份文件的输出格式（plain或tar）
四、配置备库流复制环境
1、创建备库标识文件
[kingbase@node102 data]$ pwd
/data/kingbase/v8r6_041/data
[kingbase@node102 data]$ touch standby.signal
2、编辑备库连接字符串
[kingbase@node102 data]$ cat kingbase.auto.conf
# Do not edit this file manually!
# It will be overwritten by the ALTER SYSTEM command.
primary_conninfo='host=192.168.1.101 user=system password=123456 port=54321 application_name=node102 connect_timeout=10 keepalives=1 keepalives_idle=10 keepalives_interval=1 keepalives_count=3'
recovery_target_timeline = 'latest'
primary_slot_name = 'slot_node102'
=如上所示，在kingbase.auto.conf中配置明文口令有一点的风险，也可以采取以下方案：=
1）配置主库端sys_hba.conf文件，支持指定的网段做‘replication’采用‘trust’方式认证。
2）在备库kingbase.auto.conf文件中，不指定用户的口令。
五、启动备库流复制服务
1、配置data目录权限
[kingbase@node102 bin]$ chmod 700 /data/kingbase/v8r6_041/data
2、启动备库数据库服务
[kingbase@node102 bin]$ ./sys_ctl start -D /data/kingbase/v8r6_041/data
waiting for server to start....2022-03-29 22:46:49.429 CST [9781] LOG: sepapower extension initialized
......
server started
3、查看备库数据库进程
[kingbase@node102 bin]$ ps -ef |grep kingbase
/opt/Kingbase/ES/V8R6_041/KESRealPro/V008R006C005B0041/Server/bin/kingbase -D /data/kingbase/v8r6_041/data
kingbase 9782 9781 0 22:46 ? 00:00:00 kingbase: logger
kingbase 9783 9781 0 22:46 ? 00:00:00 kingbase: startup waiting for 000000010000000000000034
kingbase 9784 9781 0 22:46 ? 00:00:00 kingbase: checkpointer
kingbase 9785 9781 0 22:46 ? 00:00:00 kingbase: background writer
kingbase 9786 9781 0 22:46 ? 00:00:00 kingbase: stats collector
六、验证主备流复制
1、查看replication slots
test=# select * from sys_replication_slots;
slot_name | plugin | slot_type | datoid | database | temporary | active | active_pid | xmin | catalog_xmin | restart_lsn | confirmed
_flush_lsn
--------------+--------+-----------+--------+----------+-----------+--------+------------+------+--------------+-------------+----------
-----------
slot_node102 | | physical | | | f | t | 21977 | | | 0/34000130 |
slot_node101 | | physical | | | f | f | | | | |
(2 rows)
2、查看主备流复制状态
test=# select * from sys_stat_replication;
pid | usesysid | usename | application_name | client_addr | client_hostname | client_port | backend_start | backend
_xmin | state | sent_lsn | write_lsn | flush_lsn | replay_lsn | write_lag | flush_lag | replay_lag | sync_priority | sync_state
| reply_time
-------+----------+---------+------------------+---------------+-----------------+-------------+-------------------------------+--------
21977 | 10 | system | node102 | 192.168.1.102 | | 48657 | 2022-03-29 23:29:53.857475+08 |
| streaming | 0/34000130 | 0/34000130 | 0/34000130 | 0/34000130 | | | | 0 | async
| 2022-03-29 23:20:02.074682+08
(1 row)
3、测试数据同步
主库执行DML：
备库查看：
七、配置主备同步模式
=默认创建主备流复制后，同步模式为‘async’。=
1、配置主库kingbase.conf
注意：此备库节点名称要和备库中kingbase.auto.con中配置一致。
2、reload conf文件
[kingbase@node101 bin]$ ./sys_ctl reload -D /data/kingbase/v8r6_041/data
server signaled
3、查看主备流复制同步模式
八、配置故障问题
1、当在备库kingbase.auto.conf中配置加密口令连接主库
加密口令的明文信息：
[kingbase@node102 sys_log]$ echo 'MTIzNDU2' |base64 -d
123456
2、备库日志提示“用户认证失败”错误，明文口令无此错误。
并且在主备库已经配置了.encpwd:
九、总结
对于KingbaseES V8R6单机环境手工配置主备流复制有一定的复杂度，和KingbaseES V8R3配置略有不同。
KINGBASE研究院
