关键字：
KingbaseFlysync、KFS、replicator、同步程序、服务端、flysync.ini、安装部署、kingbase 、KingbaseES 集群安装部署KingbaseFlysync、Kingbase ES集群安装部署KFS、Kingbase ES集群安装同步程序
一、概述
Kingbase FlySync 支持基于 Kingbase ES 集群 作为目标端的数据同步。本文以下部分对基于 Kingbase ES 集群作为目标端时的部署过程进行阐述。
二、安装前准备
前置条件：已经完成Kingbase ES集群的安装部署
2.1 环境信息
参数名 | 参数值 |
源端数据库ip node1地址 | 10.10.3.199 |
源端数据库ip node2地址 | 10.10.3.200 |
源端KUFL端口 | 3114 |
目标端数据库IP地址 | 10.10.3.200 |
安装KFS同步程序IP地址 | 10.10.3.200 |
Kingbase ES集群数据库名 | Test |
Kingbase ES集群服务端口 | 54321 |
可用内存 | >4GB |
可用储存空间 | >1GB+7*每日数据增量 |
2.2 端口开放
1、临时关闭防火墙服务（服务器重启后失效）
service firewalld stop
永久关闭防火墙服务
chkconfig firewalld off
2、若有特殊情况如业务要求需要开启防火墙，则需要保证KFS同步程序所需端口可用，若不可用，可以在后续配置中修改默认端口。
telnet xx.xx.xx.xx 端口号
Kingbase FlySync同步服务运行所需的默认端口如下：
端口 | 描述 |
11000/11001 | KFS远程管理/监控RMI端口 |
3112 | KUFL传输接口 |
2.3 创建KFS同步程序安装用户
假设KFS同步程序安装用户为fly，创建如下（本文设置fly用户密码为123）：
adduser fly
passwd fly
2.4 ruby环境配置
上传ruby包到KFS同步程序安装服务器下并解压：
unzip rbenv_2.2.2_linux_x64.zip
然后在KFS同步程序安装用户的环境变量中进行配置
vi ~/.bash_profile
export RUBY_HOME=ruby绝对路径
export PATH=$RUBY_HOME/bin:$PATH
source ~/.bash_profile
2.5 安装包准备
准备需要安装的Kingbase FlySync同步程序安装包和license文件。
2.6 Kingbase ES集群准备
1、创建用于KFS同步的数据库用户
CREATE USER FLYSYNC with superuser password ‘ password’
三、安装执行
3.1 上传并解压KFS同步程序
tar –zxvf KingbaseFlysync-Vxxxxxxxxxxxxxx-replicator.tar.gz
3.2 配置flysync.ini
在$HOME目录下新建flysync.ini文件，示例如下：
参数说明：
[defaults] | |
install-directory=/home/fly/kfs | 同步程序安装目录 |
profile-script=~/.bash_profile | |
rmi-port=11000 | rmi端口号，默认为11000 |
[s_kes_3114] | 服务名 |
role=slave | 同步角色，源端为master，目标端为slave |
master=localhost199 | 源端服务的安装ip/hostname |
master-kufl-port=3114 | 源端同步程序KUFL端口号 |
members=10.10.3.200 | 本服务的安装ip |
kufl-port=3114 | KUFL端口号 |
replication-host=10.10.3.200 | 数据库ip |
replication-port=54321 | 数据库端口 |
replication-user=system | 数据库用户名 |
replication-password=123456 | 数据库用户密码 |
datasource-type=kingbase | 数据库类型 |
property = replicator.datasource.global.connectionSpec.databaseMode=oracle | Kinbasev8数据库模式 |
Kingbase-dbname=test | 数据库名 |
svc-extractor-filters=rename | 开启名称映射 |
property=replicator.filter.rename.definitionsFile= | 设置名称映射 |
property=replicator.datasource.global.connectionSpec.use_cluster=true | 指定是否使用读写分离功能标识，默 认取值为：false。此配置项关闭 JDBC 就变成单机 JDBC，无读写分离功能 |
property=replicator.datasource.global.connectionSpec.slave_add=192.168.1.2 | 当 use_cluster 为 true 时，指定后端 V8 的备节点地址；当 use_cluster 为 false 时无效 |
property=replicator.datasource.global.connectionSpec.slave_port=54321 | 当 use_cluster 为 true 时，指定后端 V8 的备节点端口，与备节点地址对 应；当 use_cluster 为 false 时无效 |
Property= replicator.datasource.global.connectionSpec.nodeList | 若为 V8R6 则还需添加该参数 |
注意：
1. nodeList 为集群中指定的各节点的名称，各节点的名称可通过数据库提供的工具./repmgr cluster show 命令查询获取。要求开启读写分离时必须配置此项，不允许为空并要与节点的地址配置顺序完全一致。 各个节点名称之间用逗号分隔，如：nodeList=node1,node2
2. replication-host推荐使用集群vip方式部署
3.3 执行安装
执行解压目录/tools/下的fspm install
更新环境配置
source ~/.bash_profile
3.4 上传license文件
上传license文件至$HOME/kfs/目录
3.5 启动同步程序
replicator start
3.6 查看同步服务情况
fsrepctl services或fsrepctl status（state：online表示服务正常）
四、测试验证
执行kufl list 查看接收KUFL并入库的情况
源端数据情况（源端为realestate.test）:
目标端数据情况（目标端为realestate.test）:
KFS同步程序常见操作命令：
KFS同步程序的启停
replicator start
replicator stop
replicator restart
查看同步服务状态
fsrepctl services
fsrepctl -service 同步服务名 status
同步服务的启停
fsrepctl -service 同步服务名 online
fsrepctl -service 同步服务名 offline
重置KUFL
fsrepctl -service 同步服务名 reset –all –y
更多参见：Kingbase FlySync产品手册
