本文详细介绍了KingbaseES数据库的两地三中心部署方案，包括如何使用数据库部署工具创建节点、集群，以及配置数据库和Cluster参数，最后展示了集群的管理与日志查看功能。
4.1 运行数据库部署工具
数据库所在路径下的DeployTools文件夹运行./deploy命令，或者直接在开始菜单中开启“数据库部署工具”。
4.1.1. 创建节点
在开启的“数据库部署工具”中，关闭欢迎窗口。然后点击左上角的“窗口”菜单。
图 4-1 数据库部署工具
点击“集群管理”后，如下图所示
图 4-2 集群管理
鼠标右键单击“节点”，工具弹出右键菜单，选择“新建节点”，如下图：
图 4-3 新建节点
图 4-4 节点属性
这里需要创建集群中所需要的所有的节点信息(服务器信息)。
界面属性介绍如下：
表4-1. 界面属性
输入项
描述
显示名称
新建的节点名称，只能填写英文名称和数字的组合，不能为空
IP地址
新建的节点IP，需要遵循IP填写格式，目前不支持127.0.0.1，需要填写真实Ip地址，Ip不能为空
端口
节点所在的物理机器的ssh端口，默认22，需要遵循端口填写格式，不能为空。可以根据实际情况进行修改。
Root密码
节点所在的物理机器的root密码，不能为空。
信任网关
建议使用节点所在的物理机器的网关，可通过ip route show、route
-n等命令查询，需要遵循IP填写格式，不能为空。(特殊情况下也可使用一个可以ping通的IP)
常规用户
节点所在的物理机器的用户，如果填写用户不存在，则以当前输入用户名称新建一个用户，默认kingbase。只能填写英文名称，不能为空，且每个节点的用户名必须保持一致。如果名称包含中文或特殊符号，会导致集群部署失败。如果此处使用非默认的用户,那么该用户一定要具有对“/home/非默认用户/cluster/”文件夹的读、写、执行权限
默认路径
集群部署的路径，默认/home/kingbase/cluster/，可修改，但只能在家目录下，且需要填写有效路径，不能为空，每个节点的路径须保持一致。
注：在创建节点时，一定要保证ssh服务的畅通，延时不可超过20秒。
根据实际的情况填入信息，然后点击界面右下角的按钮。按钮功能如下：
图 4-5 创建节点-确认
检查：验证当前所输入的信息是否正确有效，并给出提示。
确定：验证当前所输入的信息是否正确有效的同时，创建节点信息，并将该信息 记录到隐藏文件下的配置文件中。
取消：放弃本次操作，并关闭当前创建节点的窗口。
以同样的方式创建集群所需要的所有节点。
4.1.2. 创建集群
右键单击“主备同步”节点，弹出菜单，选择“新建主备同步”。在后续的操作中，都只用填写基础属性即可，高级属性无需填写。
图 4-6 新建主备同步
4.1.2.1. 数据库配置
工具开启数据库配置窗口如下图
图 4-7 数据库配置
界面属性介绍如下：
表4-2. 界面属性
输入项
描述
集群名称
新建的集群名称，只能是英文和数字或者两者组合，不能为空。
数据库配置
点击新增按钮，添加主机数据库，再次点击新增添加备机数据库，可根据需要指定到不同节点，可一主多备，不能多主多备。
选择数据库zip包
点击选择按钮，选择db.zip。
基础属性
数据库参数的设置。包括用户名、密码、端口等一些常规参数。
max_wal_senders
支持最大集群备机个数，默认为4个，此配置项不能大于max_connections，最少是n+4个，
n为集群个数，不能为空。
max_standby_archive_delay
备机wal被归档时，允许最大延迟 以解决查询取消冲突，默认为0，不能为空。
wal_keep_segments
最小预留xlog文件个数，默认为256个，不能为空。
max_standby_streaming_delay
备机接受主服务器的xlog时，允许最大延迟以解决查询取消冲突，默认为0，不能为空。
max_connections
数据库最大连接数，默认100个，不能为空。
wal_receiver_status_interval
备机发送 复制进度信息的频率，默认为0，不能为空。
hot_standby_feedback
备机读事物时避免主机vacuum造成的数据无法查询的取消冲突，默认为on，开启状态。
listenerPort
数据库监听端口号，默认54321，不能为空。
dbUser
数据库用户名，默认SYSTEM，不能为空。
dbPassword
数据库密码，默认123456，不能为空。
replication model
同步/异步模式，默认是sync，同步模式。
db_delegate_IP
DB节点的虚拟ip(用于切换时ip的移动，一直跟随着主DB)。
目前支持多cluster，VIP就可以为空。如果要填写则必须为有效的IP格式，且必须为无法ping通的IP地址。
control_file_copy
控制文件备份的路径，该路径必须必须为有效路径，有读写权限，不能为空。
case insensitive
大小写是否敏感，默认敏感。
delegate_IP掩码长度
虚拟ip的掩码长度，默认为24。
填写完成后如下图：
图 4-8 数据库属性
4.1.2.2. Cluster配置
点击上图中“下一步”按钮，系统进入Cluster配置界面，如下图：
图 4-9 Cluster配置
界面属性介绍如下：
表4-3. 界面属性
输入项
描述
KingbaseCluster配置
点击新增按钮，添加主机cluster，再次点击新增添加备机数据库，可根据需要指定到不同节点，可一主多备，不能多主多备。
选择KingbaseCluster的zip包
点击选择按钮，选择kingbasecluster.zip。
基础属性
集群参数的设置。包括pcp账号、密码、端口等一些常规参数。
pool_delegate_IP
pool的虚拟IP，目前支持多cluster，VIP就可以为空。如果要填写则必须为有效的IP格式，且必须为无法ping通的IP地址，不能与db节点的delegate_IP相同。
port
KingbaseCluster的端口,默认为9999，不能为空。
wd_port
watchdog的端口，默认为9000，不能为空。
pcp账号
KingbaseCluster的用户名，默认为kingbase，不能为空。
pcp密码
KingbaseCluster的密码，默认为123456，不能为空。
num_init_children
pool服务器的连接个数，默认为16个，不能为空。
CMD_IP_PATH
ip命令所在的位置，该路径必须必须为有效路径，该路径下必须有ip命令对应的文件，不能为空。
CMD_ARPING_PATH
arping命令所在的位置，该路径必须必须为有效路径，该路径下必须有arping命令对应的文件，不能为空。
IP地址掩码长度
虚拟ip的掩码长度，默认为24。
填写完成后如下图：
图 4-10 Cluster属性
4.1.2.3. 预览信息
点击上图中“下一步”按钮，系统进入预览信息界面，当前界面将会把前两步的配置信息进行汇总并显示，如下图所示：
图 4-11 预览信息
4.1.2.4. 集群部署
点击上图中“确定”按钮，系统进入集群部署界面，如下图：
图 4-12 集群部署
图中按钮功能如下：
继续：当集群安装过程中出现中断(例如：数据库启动超时)，部署集群的流程也随之中断，这个时候“继续”按钮就可以使用。
部署：执行部署集群操作。
取消：放弃本次部署操作，并且在后台中将生成的集群相关的文件删除。
这里点击“部署”按钮，系统开始执行集群部署操作。执行过程截图如下：
图 4-13 初始化主数据库
图 4-14 启动数据库
图 4-15 启动集群
图 4-16 主备同步成功
到此，集群部署顺利完成。
4.1.3. 集群管理&日志查看
4.1.3.1. 修改节点
鼠标右键点击需要修改的节点,弹出菜单如下图所示：
图 4-17 修改节点
点击“修改节点”，编辑区新开窗口“修改节点77”窗口，节点的修改只允许修改名字，其他均不允许修改。如果需要改其他配置项，就需要将节点删除，重新创建。
4.1.3.2. 删除节点
鼠标右键点击需要删除的节点,弹出菜单如下图所示:
图 4-18 删除节点
点击“删除节点”，系统会弹出确认提示窗口如下图所示：
图 4-19 删除节点-确认
点击“正常”，执行删除节点操作。
点击“取消”，取消本次删除操作。
4.1.3.3.
删除主备同步
展开“主备同步”节点，选择需要删除的集群，鼠标右键点击，系统开启菜单如下图所示：
图 4-20 删除主备同步
点击“删除主备同步”，将会弹窗确认是否删除集群，如下图所示：
图 4-21 删除主备同步-确认
点击“正常”，执行删除节点操作。
点击“取消”，取消本次删除操作。
4.1.3.4. 查看集群属性
展开“主备同步”节点，选择需要查看的集群，鼠标右键点击，系统开启菜单如下图所示：
图 4-22 查看集群属性
点击“属性”，将会新开窗口展示集群的属性，如下图所示：
图 4-23 集群属性
窗口将会展示在部署集群时，填写的各项属性(这里只能查看，无法修改)。点击“下一步”进入到Cluster配置的属性窗口，如下图所示：
图 4-24 Cluster配置属性
点击“上一步”，返回到数据库配置的属性窗口。
点击“取消”，关闭当前属性查看窗口。
4.1.3.5. 集群状态查看
回到左侧的树形菜单，展开“主备同步”节点，就可以看到刚刚创建的集群，双击“5clusters”节点。系统开启“5clusters”监控管理界面，如下图：
图 3-25 集群状态查看
4.1.3.6. DB管理
在上图中选中需要管理的一个DB，鼠标右键单击，系统展开菜单，如下图所示：
图 4-26 DB管理
鼠标移动到“DB”上，开启二级菜单，功能解释如下：
启动：启动当前选中节点的数据库。如果当前数据库已启动，该选项将不可以。
停止：停止当前选中节点的数据库。如果当前数据库已停止，该选项将不可以。
重启：重启当前选中节点的数据库。
三个选项点击后，都有确认弹窗，要求用户再次确认。如下图所示：
图 4-27 DB管理-确认
点击“是”，就执行对应的操作，点击“否”，放弃本次操作。
4.1.3.7. 集群管理
在上图中选中一个DB，鼠标右键单击，系统展开菜单，如下图所示：
图 4-28 集群管理
鼠标移动到“集群”上，开启二级菜单，功能解释如下：
启动：启动集群。如果当前数据库已启动，该选项将不可以。
停止：停止集群。如果当前数据库已停止，该选项将不可以。
重启：重启集群。
三个选项点击后，都有确认弹窗，要求用户再次确认。如下图所示：
图 4-29 集群管理-确认
点击“是”，就执行对应的操作，点击“否”，放弃本次操作。
4.1.3.8. 日志查看
在上图中选中一个DB，鼠标右键单击，系统展开菜单，如下图所示：
图 4-30 日志查看
鼠标移动到“日志查看”上，开启二级菜单，功能解释如下：
查看failover.log：查看选中节点的Cluster发出的切换日志。一般有节点故障时，由master KingbaseCluster产生。
查看recovery.log：查看选中节点的恢复日志。当前节点由于故障或主机改变而产生的回复操作。
查看cluster_restart.log：查看选中节点的Cluster的重启日志。
查看cluster.log：查看选中节点的KingbaseCluster管理节点的详细日志。
点击查看对应的日志后，工具将会新开弹窗展示近期1000条的日志记录。日志查看窗口可以一次性开启多个，可以查看A节点的failover.log，并且同时开启B节点的recovery.log。开启效果如下图所示：
图 4-31 日志记录
窗口的大小可以调整，鼠标拖住边缘移动即可。日志的显示方式是按照日志的记录顺序来展示的，所以最新的日志在弹窗的最下方。拖动滚动条即可查看。点击“关闭”按钮和右上角的红“X”都可以关闭查看窗口。
4.1.3.9. DB配置下发
在上图中选中一个DB，鼠标右键单击，系统展开菜单，如下图所示：
图 4-32 DB配置下发
鼠标移动到“日志查看”上，开启二级菜单，这里是修改DB的配置文件kingbase.conf。点击“kingbase.conf配置文件修改”后，系统会将当前选中的DB的配置文件kingbase.conf的所有属性展示在新开弹窗中，如下所示：
图 4-33 配置文件属性
界面按钮说明：下发至本节点：当前修改的属性只会下发到选中DB的kingbase.conf中，而不会影响到DB。
下发至所有节点：当前修改的属性会下发到集群中所有DB的kingbase.conf中，会影响整个集群的DB配置。
确定：确认本次修改，并向工具提交本次修改内容。
取消：放弃本次修改，并关闭弹窗。
具体操作如下：
找到修改的属性，(无论是注释与否，均可再次修改)，点击对应的“值”那一列，即可修改属性的值。如下图所示：
图 4-34 修改属性
这里我们把值改为“54322”，然后再修改一个max_connections的值为“110”。
选择修改属性发送的范围，是本节点还是集群所有节点，这里勾选“下发至本节点”
点击“确定”按钮，工具会新开确认窗口并且会给出相关提示，如下图：
图 4-35 修改属性-确认
图中可以看到以下信息：
由于部分属性修改之后，是需要重启集群才会生效的，这里会给出提示。
展示原值和新值，避免误操作。
部分属性的修改是必须发送到每个节点的，比如图中修改的端口port，不允许单独修改某一个节点的port，所以即使选择了下发至本节点，但由于修改了类似port之类的属性，工具会直接将所有修改下发到集群的所有节点。
再次点击“确定”按钮，工具就开始下发所有的修改项。检测到有需要重启集群才生效的项，工具会自动重启集群。所以修改属性需要慎重，避免因为集群重启影响到实际业务的使用。集群重启如下图所示：
图 4-36 集群重启
注：如果修改了port，还得关闭当前的编辑窗口“5clusters监控管理”，集群的状态图才会正常显示，如下图所示。
图 4-37 5clusters监控管理
4.1.3.10. Cluster配置下发
在上图中选中一个Cluster，鼠标右键单击，系统展开菜单，如下图所示：
图 4-38 cluster配置下发
具体的配置操作和流程与DB配置下发一致。
图中的查看日志操作，与日志查看一致。
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
