KingbaseES数据库部署工具使用指南.pdf

KingbaseES 数据库部署工具使用指南 金仓数据库管理系统 KingbaseES 文档版本：V9（V009R001C001B0024） 发布日期：2023 年 10 月 12 日 北京人大金仓信息技术股份有限公司 目 目 录 录 第 1 章 前言 1 1.1 适用读者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2 相关文档 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.3 术语 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.4 手册约定 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 第 2 章 简介 3 第 3 章 运行数据库部署工具 4 第 4 章 环境配置 5 4.1 硬件准备 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 4.2 系统环境配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 第 5 章 集群部署 (通用机) 8 5.1 创建项目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 5.2 创建集群 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 5.2.1 节点通用配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 5.2.2 db&repmgr 配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 5.3 新增节点 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 5.3.1 ssh 配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 5.3.2 节点配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 5.3.3 节点环境检测 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 5.3.4 预览信息 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 5.3.5 集群部署 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 5.4 新增 Witness 节点 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 5.5 删除节点 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 5.6 日志查询功能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 5.6.1 新建日志查询 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 5.6.2 日志查看 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 5.6.3 修改日志查询 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 5.6.4 删除日志节点 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 I 5.7 5.8 目 录 开发者模式 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 5.7.1 开启开发者模式 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 5.7.2 关闭开发者模式 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 集群管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 5.8.1 集群查看 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 5.8.2 恢复至集群 (需开启开发者模式) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 5.8.3 提升为主库 (需开启开发者模式) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42 5.8.4 保留此主库 (需开启开发者模式) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44 5.8.5 节点查看 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 5.8.6 启动/关闭集群 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 5.8.7 暂停/恢复功能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 5.8.8 主备切换功能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 5.8.9 一键检查功能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 5.8.10 修改参数配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61 5.8.11 修改集群密码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65 5.8.12 启动此节点数据库 (需开启开发者模式) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67 第 6 章 集群部署 (专用机) 70 6.1 创建项目 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70 6.2 创建集群 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72 6.2.1 节点通用配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73 6.2.2 db&repmgr 配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74 6.3 新增节点 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 6.3.1 节点配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80 6.3.2 节点环境检测 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82 6.3.3 预览信息 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84 6.3.4 集群部署 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85 6.4 新增 Witness 节点 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88 6.5 删除节点 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90 6.6 日志查询功能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 6.6.1 新建日志查询 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92 6.6.2 日志查看 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94 6.6.3 修改日志查询 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 6.6.4 删除日志节点 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97 开发者模式 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 6.7.1 开启开发者模式 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98 6.7.2 关闭开发者模式 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100 6.7 6.8 集群管理 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 6.8.1 集群查看 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 6.8.2 恢复至集群 (需开启开发者模式) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 6.8.3 提升为主库 (需开启开发者模式) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103 6.8.4 保留此主库 (需开启开发者模式) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105 II 目 录 6.8.5 节点查看 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106 6.8.6 启动/关闭集群 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110 6.8.7 暂停/恢复功能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113 6.8.8 主备切换功能 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 6.8.9 修改参数配置 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119 6.8.10 修改集群密码 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124 6.8.11 启动此节点数据库 (需开启开发者模式) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126 版权声明 129 服务周期承诺 130 III 第 1 章 前言 1 第 章 前言 前言部分包含以下主题： • 适用读者 • 相关文档 • 术语 • 手册约定 1.1 适用读者 KingbaseES 数据库面向所有使用 KingbaseES 的用户，主要是数据库管理员和应用程序开发人员。 1.2 相关文档 • 有关 ksql 的更多信息，请参阅《KingbaseES ksql 工具用户指南及参考》 • 有关 initdb 的更多信息，请参阅《KingbaseES 服务器应用参考手册》 1.3 术语 无。 1.4 手册约定 本文档中可能出现“注意、提示、警告、另请参阅”等标志，它们所代表的含义如下： 1 第 1 章 前言 注意: 用于突出重要/关键信息、最佳实践等。 提示: 用于突出小窍门、捷径等。 警告: 用于传递设备或环境安全警示信息，若不避免，可能会导致设备损坏、数据丢失、设备性能降低或其 它不可预知的结果。 另请参阅: 用于突出参考、参阅等。 以下程序代码书写约定适用于本文档： 符号 说明 [] 表示包含一个或多个可选项。不需要输入中括号本身。 {} 表示包含两个以上（含两个）的候选，必须在其中选取一个。不需要输入花括号本身。 | 分割中括号或者花括号中的两个或两个以上选项。不需要输入“|”本身。 ... 表示其之前的元素可以被重复。 斜体 表示占位符或者需要提供特定值的变量。 大写 表示系统提供的元素，以便与用户定义的元素相互区分。除出现在方括号中的元素外，应当按 照顺序逐字输入。当然，部分元素在系统中是大小写不敏感的，因此用户可以根据系统说明以 小写形式输入。 小写 表示由用户提供的元素。 2 第 2 章 简介 2 第 章 简介 数据库部署工具由纯 java 编写，用户仅需知道所需部署服务器的 ip、port 等信息，再根据工具的引导，输入 集群脚本的关键参数，完成集群的引导步骤即可部署一套完整的集群服务，同时还提供集群状态监控服务。部署完成 后，集群状态可被实时监控，在出现错误后提供日志供予错误分析，还可在查看监控的同时，修改集群参数，进行配 置下发，以达到最好的状态。 功能概括： a. 集群项目名称：首先，创建一个项目。R6 用项目来概括一个集群的总单位。项目管理是对集群进行一个分组的 管理，将隶属于一个项目的集群放在一起统一进行管理。例如：XX 所的集群 A、集群 B，两个集群并列显示。 b. 集群：包含创建集群、集群删除、集群启停、暂停/恢复自动功能、主备切换、集群状态查看、修改集群密码、 修改配置参数为一体的功能模块。集群创建时，根据用户输入，创建集群的“节点通用配置”，创建完成后， 集群名称下生成三个子节点：“节点通用配置”、“节点管理”、“监控管理”。 c. 节点通用配置：在创建集群时，填写参数配置集群的所有节点的操作系统、数据库、repmgr 通用配置，目的是 为了减少在创建节点的过程中，重复的填写相同的内容。 d. 节点管理：对当前部署集群的节点进行管理，包含新增节点，删除节点，节点信息查看等功能。节点部署过程 中，可对节点进行环境检测，并提供“一键修改系统参数”、“关闭防火墙”等功能。 e. 监控管理：是对整个集群的运行状态进行监控，包括：服务器状态和数据库状态。 警告: 部署工具部署集群后，不支持手工在服务器修改集群相关配置参数，若进行修改，会导致工具无法获 取其修改信息而导致集群异常。 3 第3章 3 第 章 运行数据库部署工具 运行数据库部署工具 Windows 中启动部署工具的三种方式： a. 选择『开始』|『程序』|『KingbaseES V9』|『Client Tools』|『数据库部署工具』，启动数据库部署工具。 b. 在 Windows 资源管理器中进入到数据库安装目录下 $InstallDir/ClientTools/guitools/DeployTools，双击 deploy.exe 或在 deploy.exe 上右键打开，启动数据库部署工具，此方式只限于 windows 版本。 c. 命令行进入到安装目录下 $InstallDir/ClientTools/guitools/DeployTools，执行 deploy.exe，启动数据库部署工 具。 Linux 中启动部署工具的方式： a. 命令行进入到安装目录下 $InstallDir/ ClientTools/ guitools/ DeployTools，执行./ deploy，启动数据库部署工 具。 4 第4章 环境配置 4 第 章 环境配置 4.1 硬件准备 1. 最小配置要求 表 4.1.1: 最小配置要求 4.2 项 最低标准 CPU 主流的 32 位或 64 位 CPU 内存 1GB 以上 硬盘 1GB 以上空闲空间 系统环境配置 在系统环境配置中，应均在 root 用户下操作。 1. sshd_config 文件配置 键入命令：vim /etc/ssh/sshd_config。 允许 root 登录，修改 PermitRootLogin 的参数为 yes。 Root 下执行 service sshd restart。 测试 root ssh 自己 ip 和其他设备 ip 的耗时，若超过 5s 以上均为异常，需解决，否则会影响部 署及 HA 的流程。 建议的参数调整： • GSSAPIAuthentication 改为 no • UseDNS 改为 no （谨慎） 5 第4章 环境配置 1. limits.conf 文件配置 键入命令：vim /etc/security/limits.conf *soft nofile 65536 *hard nofile 65535 *soft nproc 65536 *hard nproc 65535 *soft core unlimited *hard core unlimited • * 表示所有用户，这里也可只设置 root 和要安装的 kingbase 用户设置其值 • nofile 是打开文件最大数目，nproc 为进程最大数目，core 为生成内核文件大小的上限 • soft 代表一个警告值，hard 为真正的阈值，超过就会报错，可以适当继续往高调 • PAM 的调整针对单个会话生效，调整后需重新登录 root 和 kingbase，用 ulimit -n 查看生效情况 • 注意：设置 nofile 的 hard limit 不能大于/proc/sys/fs/nr_open，否则注销后将无法正常登陆 3. sysctl.conf 文件配置 键入命令：vim /etc/sysctl.conf kernel.sem = 5010 641280 5010 256 # 增加信号量 fs.file-max = 2000000 # 增加系统最大打开句柄数量 root> sysctl -p # 操作系统下执行，重载配置生效 4. rc.local 文件配置 键入命令：vim /etc/rc.d/rc.local echo deadline > /sys/block/{DEVICE-NAME}/queue/scheduler {DEVICE-NAME} = 硬盘名称 机械硬盘，推荐 deadline 调度算法，较为适合业务单一并且 IO 比较重的业务，比如数据库。 固态硬盘，推荐 noop 调度算法。 查看系统支持 IO 调度算法： -bash-4.2# dmesg | grep -i scheduler [ 1.203287] io scheduler noop registered [ 1.203289] io scheduler deadline registered (default) [ 1.203311] io scheduler cfq registered [ 1.203314] io scheduler mq-deadline registered [ 1.203316] io scheduler kyber registered 6 第4章 环境配置 查看某块盘的 IO 调度算法 -bash-4.2# cat /sys/block/sda/queue/scheduler cfq 5. logind.conf 文件配置 键入命令：vim /etc/systemd/logind.conf RemoveIPC=no # 修改 IPC ，某些操作系统会默认打开， 会造成程序信号丢失等问题 (只有 redhat7 及以上和一些特殊的国产 linux 的版本需要修改，改之前可先查看此配置项中的此项是否为默认 yes) systemctl daemon-reload systemctl restart systemd-logind.service # 重启服务 6. system.conf 文件配置 键入命令：vim /etc/systemd/system.conf systemd 228 版本存在 limit 限制过低问题，会导致 服务启动的程序超过限制后资源不可用的情况。 用 service cron status 任一服务，查看其状态 root@greatwall-os:~# service cron status � cron.service - Regular background program processing daemon Loaded: loaded (/lib/systemd/system/cron.service; enabled;xxx...) Active: active (running) since 五 2019-08-16 11:28:58 CST; 1 weeks ago Docs: man:cron(8) Main PID: 3120 (cron) Tasks: 204 (limit: 512) 可以观察到出现 limit : 512 默认限制。 在出现此情况时，修改 DefaultTasksAccounting=no 会默认关闭 所有服务 limit 限制，修改后用 systemctl daemon-reload ; systemctl daemon-reexec 生效。之后用同样方式查看 服务 cron limit，若还未去除，需重启系统生效。 7 第5章 5 第 章 集群部署 (通用机) 集群部署 (通用机) 通用机：具有一般计算机的基本标准形态，通过装配不同的应用软件，以基本雷同的面目应用在社会的各种领 域，其典型产品为 PC 机。 5.1 创建项目 1、在开启的“数据库部署工具”中，关闭欢迎窗口。然后点击左上角的“窗口”菜单 图 5.1.1: 数据库部署工具 2、鼠标右键单击“集群项目名称”，工具弹出右键菜单，选择“创建项目”，如下图： 8 第5章 集群部署 (通用机) 图 5.1.2: 创建项目 界面开启如下图： 图 5.1.3: 创建项目-项目名称 在此创建集群项目信息。界面属性介绍如下： projectName：新建项目的名称，只能是英文、数字、下划线或者三者组合，不能为空 根据实际的情况填入信息，然后点击界面右下角的按钮。按钮功能如下： 9 第5章 集群部署 (通用机) OK：验证当前所输入的信息是否正确有效之后，创建项目，并将该信息记录到隐藏文件下的配置文件中。 Cancel：放弃本次操作，并关闭当前创建项目的窗口 成功创建项目后提示如下图： 图 5.1.4: 创建项目-创建成功 5.2 创建集群 右键单击刚刚创建的项目节点，弹出菜单，选择“创建集群”。右键菜单如下图： 图 5.2.1: 创建集群 工具打开创建集群窗口，分为节点通用配置和 db&repmgr 配置两项： 5.2.1 节点通用配置 集群创建成功后，节点通用配置参数不能再修改。界面如下： 10 第5章 集群部署 (通用机) 图 5.2.2: 节点通用配置 界面属性介绍如下： 表 5.2.1: 创建集群-界面属性 输入项 描述 集群名称 新建的集群名称，只能是英文、数字、下划线或者三者组合，不能为空。 节点通用配置 当前配置适用于整个集群的所有节点，可以免除创建节点时重复填写相同 的值。 节点类型 选择当前创建的集群是通用机或者专用机，默认为通用机。 securecmd 端口 工具连接节点或者直接向节点发起指令时，创建连接所使用到的 securecmd 服务端口号，默认为 8890, 可根据环境修改 常规用户 部署集群所使用的账户，集群将会创建在该账户之下。如果用户不存在， 工具负责创建（创建用户命令为：useradd -g -m ）, 并设置默认密码 （123456）。 默认路径 集群安装的路径，路径由工具根据项目名称，集群名称拼接而成且不可修 改。 11 第5章 集群部署 (通用机) 5.2.2 db&repmgr 配置 填写完成后点击“下一步”进入到 db&repmgr 配置，如下图： 图 5.2.3: db&HAmgr 配置 界面属性介绍如下： 表 5.2.2: db&repmgr 配置-界面属性 输入项 描述 选择数据库 zip 包 点击选择按钮，选择 db.zip。 大小写不敏感 默认不勾选，即大小写敏感 max_connections 数据库最大连接数，默认 100 个，不能为空。参数最小值不能小于 100，最 大值无限制。 listenerPort 数据库监听端口号，默认 54321，不能为空。 dbUser 数据库用户名，默认 system，不能为空。 dbPassword 数据库密码，默认 12345678ab，不能为空。 replication mode 同步/异步模式：1.quorum 2.sync 3.async 4.all。 archive_path 数据库归档路径。 见续表 12 第5章 集群部署 (通用机) 表 5.2.2 – 续表 输入项 描述 dbmode 数据库兼容模式，Oracle、PostgreSQL 两种模式，默认兼容 Oracle。 加密算法 数据库认证采取的加密方式，scram-sha-256、md5，默认是 scram-sha256。 ip 类型 支持 IPV4 和 IPV6 两种地址类型。 trust_server 集群的信任网关，网关可以填写多个用英文逗号分隔，多个信任网关中有 一个可用即可。 使用 hostname 开启后工具支持多网段域名部署 使用多网冗余部署 开启后 connection_timeout 参数改为 10，关闭为 5。此功能需开启“使用 hostname”才可使用。 ping_path 系统环境中 ping 指令所在路径。 hamgr_dbname 默认是 esrep，且不可修改。repmgr 所依赖的表就存放在此数据库中。 hamgr_dbuser 默认是 esrep，且不可修改。登录 esrep 数据库的用户为 esrep。 data_directory 集群数据库 data 存放路径。 sys_bindir 集群数据库 bin 存放路径。 repmgrd_pid_file 记录 repmgrd pid 文件路径，默认值：${cluster_path}/kingbase/etc/repmgrd.pid，参数值不允许修改。写入 repmgr.conf 文件，参数名为：repmgrd_pid_file 记录 kbha pid 文件路径，默认值：$ {cluster_path}/ kingbase/ etc/ kbha_pid_file kbha.pid， 参 数 值 不 允 许 修 改。 写 入 repmgr.conf 文 件， 参 数 名 为： kbha_pid_file 记录 repmgrd 日志文件路径，默认值：$ {cluster_path}/ kingbase/ log/ repmgrd_log_file hamgr.log，参数值不允许修改。写入 repmgr.conf 文件，参数名为： log_file 记录 kbha 日志文件路径，默认值：$ {cluster_path}/ kingbase/ log/ kbha_log_file kbha.log， 参 数 值 不 允 许 修 改。 写 入 repmgr.conf 文 件， 参 数 名 为： kbha_log_file。 running_under_fa ure_trusted_se rvers il- 网关故障后数据库是否继续运行，可选值为 on 或 off，默认为 on。on：网 关故障后，数据库不受影响，正常运行；off：网关故障后，集群会关闭数 据库保证数据不发生分歧。 见续表 13 第5章 集群部署 (通用机) 表 5.2.2 – 续表 输入项 描述 data_checksums 用于控制是否开启数据校验和功能，默认是开启状态。on：开启数据校验 和功能；off：关闭数据校验和功能；写入 repmgr_config.conf 文件，参数 名为：data_checksums。 流复制通信超时时间 流复制之间的数据传输超时时间，超过这个时间没有数据传输则表示流复 制断开了，会进行重连。 警告: 1.max_connections 的值只能修改为更大的值，不能修改为更小的值。2. 执行 which ping 命令，查看 操作系统中真实的 ping_path 路径，修改 ping_path 路径为查看的实际路径。3. 集群部署完成后，请不要修改 repmgrd_pid_file、kbha_pid_file 参数的值，修改后可能会造成同时启动多个 kbha 或 repmgrd 进程。 点击“高级设置”选项卡，如下图所示： 图 5.2.4: 高级设置 14 第5章 集群部署 (通用机) 表 5.2.3: “高级设置”选项卡 输入项 描述 wal_keep_segments 最小预留 xlog 文件个数，默认为 512 个，不能为空。 max_wal_senders 支 持 最 大 集 群 备 机 个 数， 默 认 为 32， 此 配 置 项 不 能 大 于 max_connections，最少是 n+4 个，n 为集群节点个数，不能为空。 hot_standby_feedback 备机读事物时避免主机 vacuum 造成的数据无法查询的取消冲突，默认为 on，开启状态。 control_file_copy 控制文件多副本，最多可配置 8 个文件，写入到 es_rep.conf 里 审计表空间加密 若勾选，则初始化数据库时增加’-t’ 作为参数执行。若输入框中输入内容， 则初始化数据库时增加’-t -K ${输入的内容}’ 作为参数执行。 log_checkpoints 数据库日志中记录检查点和重启点。包括一些统计信息，写入缓冲区的数 据和写入所花的时间。on、off。默认为 on。 log_replication_commands 数据库日志中记录每一个复制命令。on、off。默认为 on。 wal_compression 打开此参数可以减小 WAL 所占的空间且无需承受不可恢复的数据损坏风 险。但代价是需要额外的 CPU 开销，以便在 WAL 记录期间进行压缩以及 在 WAL 重放时解压。on、off。默认为 on。 db_other_options 在 Oracle 兼容模式下，initdb 初始化数据库流程需添加兼容 V7 参数– scenario-tuning，调用 scenario_tuning.sql SQL 脚本，生成 V7 兼容视图、 字段，以支持 V7 部分系统视图。 encoding 模板数据库的编码格式，默认数据库的编码格式，未选择 encoding 的情况 下不可选择 Collate 和 CType ，默认为 default，将设置为服务器环境配置 的字符集 Collate 这个值决定了字符串类型排序的规则，值为“C”时表示没有规则，即以二 进制值大小为比较规则。在初始化设置后不能被修改。 CType 这个值决定了字符的分类，例如大小写和数字，值为“C”时表示没有规 则，即以二进制值大小为比较规则。在初始化设置后不能被修改。 virtual_ip DB 节点的虚拟 ip（用于切换时 ip 的移动，一直跟随着主 DB）。目前支 持多 cluster，VIP 就可以为空。如果要填写则必须为有效的 IP 格式，且必 须为无法 ping 通的 IP 地址。 virtual_ip_mask 虚拟 ip 的掩码长度，默认为 24。掩码长度需要配置为加载虚拟 ip 的网卡 的实际掩码长度。 ip_path 系统环境中 ip 指令所在路径。 见续表 15 第5章 集群部署 (通用机) 表 5.2.3 – 续表 输入项 描述 auto_cluster_recovery_level 全故障自动恢复配置。0: 关闭；1: 打开，默认为 1。 waldir 指定链接的 wal 日志目录，将 data 目录中 sys_wal 目录作为软连接的形式 存在。 scmd_options 集群节点 ssh 通信的配置项，连接超时 10 秒。 conn_options 集群节点连接的配置项。 failover 节点故障自动切换，automatic、manual，默认值为 automatic。 服务可用优先 /数据保护优先 单选项。根据选项不同，reconnect_attempts，reconnect_interval，recovery，synchronous_commit 四个参数的默认值不同。默认选项为数据保护 优先 reconnect_attempts 集群中连接的重试次数。服务可用优先默认值为 3，数据保护优先默认值为 10。 reconnect_interval 集群中连接的重试间隔。服务可用优先默认值为 5，数据保护优先默认值为 6。 recovery 节点故障自动恢复，automatic、standby、manual。manual，关闭自动恢 复，故障节点无论是主机还是备机，都不进行自动恢复；standby，故障节 点是备机才自动恢复；automatic，所有故障节点都自动恢复。服务可用优 先默认值为 automatic，数据保护优先默认值为 standby。 synchronous_commit 指定在命令返回”success” 指示给客户端之前，一个事务是否需要等待 WAL 记录被写入磁盘。on、off、local、remote_write、remote_apply。服务可 用优先默认值为 on，数据保护优先默认值为 remote_apply 警告: 在使用 NetworkManager 管理网络服务的情况下，如果手动删除了 virtual_ip 所在网卡上所有的物理 IP，有可能导致 virtual_ip 丢失，且在物理 IP 被重新添加上之前，virtual_ip 不会自动添加。 警告: 执行 which ip 命令，查看操作系统中真实的 ip_path 路径，修改 ip_path, 路径为查看的实际路径。 点击上图中“确定”按钮，创建成功如下图： 16 第5章 集群部署 (通用机) 图 5.2.5: 创建成功 5.3 新增节点 展开当前创建的集群，右键选择菜单的“新增节点”，如下图所示： 图 5.3.1: 新增节点 5.3.1 ssh 配置 工具开启“增加节点”流程窗口，如下图所示： 17 第5章 集群部署 (通用机) 图 5.3.2: ssh 配置 表 5.3.1: “ssh 配置”选项卡 输入项 描述 使用 ssh 启动 securecmd 单选项，默认选中。此项选中时，ssh 端口、root 密码、选择 securecmd 文 件、securecmd 路径四项需配置。可使用 ssh 方式上传并启用 securecmd。 主机名或 IP 地址 当前节点（服务器）的 IP 地址或主机名。当“开启 hostname”选项未勾 选时，此处名称为 IP 地址。 ssh 端口 节点所在的物理机器的 ssh 端口，默认 22。不可为空。 root 密码 节点所在的物理机器的 root 密码，不能为空。 选择 securecmd 文件 securecmd 安装包，不可为空。 securecmd 路径 节点服务器上 securecmd 部署路径，不可为空。必须位于/home/${常规用 户} 目录下。 使用已部署的 securecmd 单选项，默认不选中此项。选中时，securecmd 需要用户手动在节点服务中 配置，用户可点击“下一步”进入节点配置页面。 5.3.2 节点配置 工具开启“增加节点”流程窗口，如下图所示： 18 第5章 集群部署 (通用机) 图 5.3.3: 增加节点 表 5.3.2: “节点配置”选项卡 输入项 描述 显示名称 用户自定义的节点名称（服务器的别名），最终将会显示在左侧的树形菜 单中。 主机名或 IP 地址 当前节点（服务器）的 IP 地址或主机名。当“开启 hostname”选项未勾 选时，此处名称为 IP 地址。 securecmd 端口，常规用户，默认路 此三项均来自通用配置中，无需再次填写，且无法修改。详细介绍参见通 径 用配置参数介绍。 系统节点名称 系统节点名称记录在数据库配置文件中的节点（服务器）别名，目前采用 node + ip 最后一段的拼接的方式命名。 网卡名称 此项主要是针对填写 VIP 选项的集群。使用 VIP 必须填写该 VIP 要绑定的 对应网卡名称。支持获取多个网卡。点击“获取网卡”，列出所有状态 UP 的网卡列表，并将与当前节点服器 IP 相同的网卡名称显示列表第一位。可 以从获取的网卡列表中选择一个，也可以手动进行填写。 网卡物理 IP 地址 此项主要是针对填写 VIP 选项的集群。填写网卡名称后，需要输入对应的 网卡 IP 地址。点击“获取”，工具显示对应的物理 IP 地址。若存在多个 地址，默认只显示第一个。也可手动进行填写。 见续表 19 第5章 集群部署 (通用机) 表 5.3.2 – 续表 输入项 描述 选择 license 文件 此项主要是针对非保密机集群。需要选择集群节点所需要的 license 的上传 路径。 点击上图中“下一步”按钮，工具先对当前界面填写的信息进行检测，如下图所示： 图 5.3.4: 信任网关检测 5.3.3 节点环境检测 检测合格后进入到系统环境检测步骤界面，此时需点击下方的检测按钮。如下图所示： 20 第5章 集群部署 (通用机) 图 5.3.5: 节点环境检测 点击“检查”按钮，环境参数的信息检测都会输出到这个界面中。输出信息中可能会出现红色和黄色提示，被标 为红色 ERROR 的提示，意为不允许安装集群，用户需解决后，才可继续进行下一步。黄色 Warning 意为不解决可 能会导致集群出现问题隐患。例如： (1) 防火墙，有些用户和系统必须开，那么就需要用户将集群使用到的端口号添加到防火墙白名单中。 (2) 检查发现 [ulimit.open proc] is null，则需要检查一下集群用户的 shell 环境。如下图所示： 图 5.3.6: 环境参数 21 第5章 集群部署 (通用机) 点击“一键修改系统参数”按钮，修改的系统参数项，都会输出到这个界面中。如下图所示： 图 5.3.7: 修改系统参数 点击“关闭防火墙”按钮，关闭防火墙的日志打印，都会输出到这个界面中。如下图所示： 图 5.3.8: 关闭防火墙 22 第5章 5.3.4 集群部署 (通用机) 预览信息 点击上图中“下一步”按钮，系统进入预览信息界面，当前界面将会把配置信息进行汇总并显示，如下图所示： 图 5.3.9: 预览信息 5.3.5 集群部署 点击上图中“确定”按钮，系统进入集群部署界面，如下图： 23 第5章 集群部署 (通用机) 图 5.3.10: 集群部署 图中按钮功能如下： 1. 重新部署：当集群安装过程中出现中断（例如：数据库启动超时），部署集群的流程也随之中断，这个时候根 据报错排查问题后，“重新部署”按钮就可以重新部署集群。 2. 部署：执行部署集群操作。 3. 取消：放弃本次部署操作，并且在后台中将生成的集群相关的文件删除。 这里点击“部署”按钮，系统开始执行集群部署操作。执行过程截图如下： 图 5.3.11: 节点部署成功 部署时的界面打印。此界面将执行命令，返回结果等均进行输出，便于错误时候的查询报错信息。也便于学习和 理解 KingbaseES 的部署流程步骤。 24 第5章 集群部署 (通用机) 图 5.3.12: 部署界面打印 到此，集群部署顺利完成。 以此类推，进行第二个节点的部署。 图 5.3.13: 新增节点 25 第5章 集群部署 (通用机) 图 5.3.14: 节点配置 图 5.3.15: 集群部署 5.4 新增 Witness 节点 witness 节点是一个正常的 KingbaseES 实例，不是流复制群集的一部分；其目的是，如果发生故障转移情况， 则提供证明它是主服务器本身不可用的证据，而不是例如在不同物理位置之间的网络分裂。 26 第5章 集群部署 (通用机) 展开当前创建的集群，右键选择菜单的“新增 Witness 节点”，如下图所示： 图 5.4.1: 新增 witness 节点 工具开启“新加 Witness 节点”流程窗口，ssh 配置同新增节点章节，节点配置如下图所示： 图 5.4.2: 增加 witness 节点 27 第5章 集群部署 (通用机) 图 5.4.3: witness 节点配置 表 5.4.1: “Witness 节点配置”选项卡 输入项 描述 Witness 名称 用户自定义的 Witness 节点名称（服务器的别名），最终将会显示在左侧 的树形菜单中。 主机名或 IP 地址 当前节点（服务器）的 IP 地址或主机名当“开启 hostname”选项未勾选 时，此处名称为 IP 地址。 securecmd 端口、常规用户、默认路 此三项均来自通用配置中，无需再次填写，且无法修改。详细介绍参见通 径 用配置参数介绍。 系统节点名称 系统节点名称是用于记录在数据库配置文件中的节点（服务器）别名，目 前采用 node + ip 最后一段的拼接的方式命名。 选择 license 文件 此项主要是针对非保密机集群。需要填写集群节点所需要的 license 的上传 路径。 点击上图中“下一步”按钮，工具先对当前界面填写的信息进行检测，如下图所示： 28 第5章 集群部署 (通用机) 图 5.4.4: 信任网关检测 其操作步骤与新增节点相同，详细描述见 < 新增节点 > 章节。 5.5 删除节点 鼠标右键点击需要删除的节点, 弹出菜单如下图所示: 图 5.5.1: 删除节点 点击“删除节点”，系统弹窗提示如下图： 29 第5章 集群部署 (通用机) 图 5.5.2: 删除提示 若集群整体处于已停止状态，所有节点允许删除。若集群处于已启用状态，主节点不允许删除。删除节点成功 后，提示用户“只删除工具端配置文件，服务器数据未删除”，需要用户手动删除。 点击“正常”，执行删除节点操作。 点击“取消”，取消本次删除操作。 图 5.5.3: 删除提示 5.6 日志查询功能 此功能对特定节点进行日志输出功能。 5.6.1 新建日志查询 右键单击“日志查询”节点，弹出菜单，选择“选择新建日志查询”，右键菜单如下图： 30 第5章 集群部署 (通用机) 图 5.6.1: 新建日志查询 工具打开新建日志查询窗口，如下图： 图 5.6.2: 新建日志查询 界面属性介绍如下： 31 第5章 集群部署 (通用机) 输入项 描述 显示名称 新建的日志节点名称，只能是英文、数字、下划线或者三者组合，不能为空。 主机名或 IP 当前节点（服务器）的 IP 地址或主机名。当“开启 hostname”选项未勾选时，此处 地址 名称为 IP 地址。 securecmd 端 工具连接节点或者直接向节点发起指令时，创建连接所使用到的 securecmd 服务端口 口 号，默认为 8890, 可根据环境修改 securecmd 用 工具连接节点需要通过指定用户连接的用户名 户名 securecmd 密 对应用户名的用户密码 码 数据库 Data 节点所安装的数据库对应的 Data 目录的路径 路径 点击“检查”测试是否正常连接到节点，如下图所示： 图 5.6.3: 提示信息 如提示错误信息，则按照对应的错误提示信息进行修改。检查通过后点击“保存”即可完成新建日志节点，在 “日志查询”下将会有一个日志节点。如下图所示： 32 第5章 集群部署 (通用机) 图 5.6.4: 日志节点 5.6.2 日志查看 右键单击日志节点，弹出菜单，选择“日志查看”，右键菜单如下图： 图 5.6.5: 日志节点菜单 显示日志查看窗口，如下图所示： 33 第5章 集群部署 (通用机) 图 5.6.6: 日志查看 此窗口最多显示 300 条最新数据，每十秒会执行自动刷新操作更新日志信息。 当端口出现异常或关闭时，将提示连接失败，如下图： 图 5.6.7: 连接失败 点击提示完成后，日志查看窗口将变为无数据。 34 第5章 集群部署 (通用机) 图 5.6.8: 无数据 当端口正常后，已经打开的日志查看窗口将自动更新日志信息并输出。 5.6.3 修改日志查询 在日志节点菜单中选择“修改日志查询”，打开修改日志查询界面，如下图所示： 图 5.6.9: 修改日志查询 35 第5章 集群部署 (通用机) 可对参数进行修改。 5.6.4 删除日志节点 在右键日志节点中选择“删除”，然后提示删除成功后，则删除完成，如下图所示： 图 5.6.10: 删除成功 5.7 开发者模式 开发者模式为特殊情况下进入开发人员模式，进行一系列对数据库集群有关的操作（具体有：启动此节点数据 库、恢复至集群、提升为主库、保留此主库）。此模式会在集群部署工具重新启动时自动关闭。此操作存在丢数危 险，请谨慎操作。 5.7.1 开启开发者模式 点击集群部署工具的工具栏中的“帮助”，选择“开发者模式”进行开启，如下图所示: 36 第5章 集群部署 (通用机) 图 5.7.1: 开发者模式 图 5.7.2: 开启开发者模式 输入密码“rdjc12#$”，选择“正常”开启开发者模式。在开发者模式下点击“开发者模式”会提示到您已经在 此模式下，如下图所示: 37 第5章 集群部署 (通用机) 图 5.7.3: 开启开发者模式后弹窗 图 5.7.4: 开启成功后状态显示 5.7.2 关闭开发者模式 点击集群部署工具的工具栏中的“帮助”，选择“关闭开发者模式”进行关闭，如下图所示: 图 5.7.5: 关闭开发者模式 38 第5章 集群部署 (通用机) 图 5.7.6: 关闭开发者模式后弹窗 5.8 集群管理 5.8.1 集群查看 双击集群名称后，显示集群状态。弹出菜单如下图所示: 39 第5章 集群部署 (通用机) 图 5.8.1: 集群查看 显示集群状态中包含：上游节点、PID、是否暂停、最后一次观测到的时间等。右下角有刷新按钮，方便更新集 群状态。 图 5.8.2: 集群状态 集群运行信息： ID -- 数据库节点 ID Name -- 数据库在集群内部名称 Role -- 数据库节点角色，有 primary 和 standby 两种 Status -- 状态，*running 和 running 两种状态是正常运行状态，还有其他的状态，都是异常 40 第5章 集群部署 (通用机) -- 例如：! running、failed 等状态都是异常状态 Upstream -- 上游节点名称，即：从哪个节点同步数据 Hamgrd -- 管理软件 remgrd 的运行状态 PID -- 管理软件 repmgrd 的进程 ID Paused -- 管理软件 repmgrd 是否暂停 -- 暂停后 repmgrd 虽然在运行，但不再负责数据库自动切换、恢复 Upstream last seen-- 本节点距离上一次同步数据的时间（单位：秒） 以下为异常状态示例： 图 5.8.3: 备机故障停机 图 5.8.4: 管理软件暂停自动恢复功能 5.8.2 恢复至集群 (需开启开发者模式) 若原主节点宕机或出现异常，并且集群通过若干时间提升出一个正常的主节点时，右键异常的原主节点，”恢复 至集群”按钮变为可点击状态： 41 第5章 集群部署 (通用机) 图 5.8.5: 恢复至集群按钮 点击”恢复至集群”按钮效果如下图所示： 图 5.8.6: 点击恢复至集群按钮弹窗 点击“确定”，执行恢复至集群操作。点击“取消”，取消本次操作。 图 5.8.7: 恢复至集群成功 5.8.3 提升为主库 (需开启开发者模式) 所有主节点全部宕机或异常时，右键正常运行的备节点，”提升为主库”按钮变为可点击状态： 42 第5章 集群部署 (通用机) 图 5.8.8: 提升为主库按钮 点击”提升为主库”按钮效果如下图所示： 图 5.8.9: 点击提升为主库按钮后弹窗 点击“确定”，执行提升为主库操作。点击“取消”，取消本次操作。 图 5.8.10: 提升为主库操作成功 警告: 在故障主节点无法上电，仅有备节点但备节点未运行的场景，使用此功能需先将备节点启动后再执行 升主操作。见“启动此节点数据库”章节。 43 第5章 5.8.4 集群部署 (通用机) 保留此主库 (需开启开发者模式) 存在多个正常的主节点时，右键其中一个主节点，”保留此主库”按钮变为可点击状态： 图 5.8.11: 保留此主库按钮 点击”保留此主库”按钮效果如下图所示： 图 5.8.12: 点击保留此主库按钮后弹窗 点击“确定”，执行保留此主库操作。点击“取消”，取消本次操作。 44 第5章 集群部署 (通用机) 图 5.8.13: 保留此主库运行中 图 5.8.14: 保留此主库操作成功 5.8.5 节点查看 左键双击需要查看的节点名称，查看节点信息： 45 第5章 集群部署 (通用机) 图 5.8.15: 操作系统信息 图 5.8.16: 数据库信息 图 5.8.17: HAmgr 配置 46 第5章 集群部署 (通用机) 图 5.8.18: sys_wal 信息 图 5.8.19: archive 信息 图 5.8.20: 用户占用数据库连接数量 图 5.8.21: IP 占用数据库连接数量 47 第5章 集群部署 (通用机) 图 5.8.22: 数据库连接状态 图 5.8.23: License 信息 5.8.6 启动/关闭集群 鼠标右键选择集群，选择菜单中的停止集群，如下图所示: 48 第5章 集群部署 (通用机) 图 5.8.24: 关闭集群 点击“确定”按钮后工具执行指令并做出相应提示，如下图所示: 图 5.8.25: 关闭集群-提示 49 第5章 集群部署 (通用机) 图 5.8.26: 关闭集群-提示 鼠标右键选择集群，选择菜单中的启动集群，如下图所示: 图 5.8.27: 启动集群 点击“确定”按钮后工具执行指令并做出相应提示，如下图所示: 50 第5章 集群部署 (通用机) 图 5.8.28: 启动集群-提示 图 5.8.29: 启动集群-提示 5.8.7 暂停/恢复功能 鼠标右键选择集群，选择菜单中的暂停自动功能，暂停功能是将集群的处于运行状态的自动功能停止掉，例如： 自动切换、自动恢复。如下图所示: 51 第5章 集群部署 (通用机) 图 5.8.30: 暂停自动功能 该窗口为确认窗口，并对暂停自动功能有相应的提示和说明。图中有复选框 dry-run，如果勾选复选框，工具会 先尝试执行一次暂停自动功能的操作，尝试成功则直接执行暂停指令。反之，失败则不执行暂停指令。如果未勾选复 选框，工具会直接执行暂停集群功能的指令。界面如下图所示: 图 5.8.31: 暂停自动功能-提示 集群功能被暂停后，在集群状态窗口可以查看到集群此时的状态。暂停状态会被现实成红色，并且有弹窗提示。 如下图所示: 52 第5章 集群部署 (通用机) 图 5.8.32: 集群状态 图 5.8.33: 暂停自动功能-提示 鼠标右键选择集群，选择菜单中的恢复自动功能，恢复功能是将集群的处于暂停状态的自动功能重新启动。如下 图所示: 53 第5章 集群部署 (通用机) 图 5.8.34: 恢复自动功能 该窗口为确认窗口，并对恢复自动功能有相应的提示和说明。途中有复选框 dry-run，如果勾选复选框，工具会 先尝试执行一次恢复自动功能的操作，尝试成功则直接执行恢复指令。反之，失败则不执行恢复指令。如果未勾选复 选框，工具会直接执行恢复集群功能的指令。界面如下图所示: 图 5.8.35: 恢复自动功能-提示 集群功能被恢复后，在集群状态窗口可以查看到集群此时的状态。集群状态恢复正常，无弹窗提示报错。如下图 所示: 54 第5章 集群部署 (通用机) 图 5.8.36: 集群状态 图 5.8.37: 恢复自动功能-提示 5.8.8 主备切换功能 鼠标右键选择集群，选择菜单中的主备切换功能，该功能可以将指定的备机提升为主机，剩下的所有备机继续跟 随主机。如下图所示: 55 第5章 集群部署 (通用机) 图 5.8.38: 主备切换功能 在集群列表的中选中需要执行切换命令的备机，鼠标单击选中即可，然后点击“切换按钮”。如下图所示: 图 5.8.39: 切换命令 56 第5章 集群部署 (通用机) 图 5.8.40: 主备切换 成功完成切换指令后，如下图所示: 图 5.8.41: 主备切换-提示 成功完成切换指令后执行期间的输出也会显示在下方的文本中，如下图所示: 57 第5章 集群部署 (通用机) 图 5.8.42: 执行结果 5.8.9 一键检查功能 此功能提供集群中每个节点的全面检查，将提示节点每个检查项是否正常，并给出非正常检查项的原因说明。可 将检查结果导出到指定位置生成检查报告。此功能需存在大于等于一个正常运行的主/备节点才可进行检查。 1. 打开一键检查功能：鼠标右键选择集群，选择菜单中的一键检查功能，如下图所示。 58 第5章 集群部署 (通用机) 图 5.8.43: 一键检查按钮 图 5.8.44: 一键检查运行中 59 第5章 集群部署 (通用机) 图 5.8.45: 一键检查后效果 在一键检查结束后，点击“导出”按钮，选择检查报告存储路径进行导出。如下图所示： 图 5.8.46: 导出按钮 可自定义文件名后选择路径进行存储。 60 第5章 集群部署 (通用机) 图 5.8.47: 将检查日志导出到路径 5.8.10 修改参数配置 展开需要修改的集群，在节点通用配置选择集群然后右键，修改参数配置，进入配置界面。如下图： 默认展示“数据库参数”选项卡，如下图： 61 第5章 集群部署 (通用机) 图 5.8.48: 数据库参数修改 表 5.8.1: 数据库参数配置 输入项 描述 参数名称 下拉选项（包括可配置的数据库参数） 参数值 输入参数名称对应的值 说明 参数值范围等相关说明 点击“集群参数”选项卡，如下图： 62 第5章 集群部署 (通用机) 图 5.8.49: 集群参数修改 表 5.8.2: 集群参数配置 输入项 描述 参数名称 下拉选项（包括可配置的集群参数） 参数值 输入参数名称对应的值 说明 参数值范围等相关说明 点击“确定”按钮后工具执行检验操作，若参数值输入不正确，做出相应提示，如下图所示： 63 第5章 集群部署 (通用机) 图 5.8.50: 更新参数配置-检验错误 若集群状态异常，或者集群流复制状态异常，做出相应提示，如下图所示： 图 5.8.51: 更新参数配置-集群异常 图 5.8.52: 更新参数配置-集群流复制异常 若修改的参数中包含需要重启才能生效的，会做出相应提示，如下图所示： 64 第5章 集群部署 (通用机) 图 5.8.53: 更新参数配置-重启生效 检验无误后，工具执行更新，相应提示如下，如下图所示： 图 5.8.54: 更新参数配置-提示 图 5.8.55: 更新参数配置-提示 5.8.11 修改集群密码 选择需要修改的集群，右键弹框选择，修改集群密码： 65 第5章 集群部署 (通用机) 图 5.8.56: 集群密码修改 66 第5章 集群部署 (通用机) 点击“确定”按钮后工具执行检验操作，若集群状态异常，或者集群流复制状态异常，做出相应提示，如下图所 示： 图 5.8.57: 修改集群密码-集群异常 图 5.8.58: 修改集群密码-集群流复制异常 修改集群密码成功后，工具做出相应提示，如下图所示: 图 5.8.59: 集群密码修改成功 5.8.12 启动此节点数据库 (需开启开发者模式) 当前节点数据库关闭，点击此按钮启动数据库可启动数据库，界面效果如图所示： 67 第5章 集群部署 (通用机) 图 5.8.60: 启动此节点数据库 点击”启动此节点数据库”按钮后，没有开启开发者模式效果如下图所示： 图 5.8.61: 未开启开发者模式时弹窗 点击”启动此节点数据库”按钮后，节点数据库正常效果如下图所示： 图 5.8.62: 数据库正常时弹窗 点击”启动此节点数据库”按钮，节点为主时数据库确定为关闭状态下，或者节点为备，数据库关闭并且不存在 正常运行的主节点时，效果如下图所示： 68 第5章 集群部署 (通用机) 图 5.8.63: 启动此节点数据库提示信息 点击“确定”，执行启动此节点数据库操作。点击“取消”，取消本次操作。 图 5.8.64: 启动此节点数据库成功 69 第6章 6 第 章 集群部署 (专用机) 集群部署 (专用机) 专用机是非通用计算机形态的计算机应用，它以潜入系统核心部件的形式隐藏在各种装置、设备、产品和系统 中。 集群部署工具安装后，使用前，需要用户手动启动节点服务器上的 securecmd 服务，并删除安装后生成的 data 目录。 6.1 创建项目 1、在开启的“数据库部署工具”中，关闭欢迎窗口。然后点击左上角的“窗口”菜单 图 6.1.1: 数据库部署工具 2、鼠标右键单击“集群项目名称”，工具弹出右键菜单，选择“创建项目”，如下图： 70 第6章 集群部署 (专用机) 图 6.1.2: 创建项目 界面开启如下图： 图 6.1.3: 创建项目-项目名称 在此创建集群项目信息。界面属性介绍如下： projectName：新建项目的名称，只能是英文、数字、下划线或者三者组合，不能为空 根据实际的情况填入信息，然后点击界面右下角的按钮。按钮功能如下： 71 第6章 集群部署 (专用机) OK：验证当前所输入的信息是否正确有效的同时，创建项目，并将该信息记录到隐藏文件下的配置文件中。 Cancel：放弃本次操作，并关闭当前创建项目的窗口 成功创建项目后提示如下图： 图 6.1.4: 创建项目-创建成功 6.2 创建集群 右键单击刚刚创建的项目节点，弹出菜单，选择“创建集群”。右键菜单如下图： 72 第6章 集群部署 (专用机) 图 6.2.1: 创建集群 工具打开创建集群窗口，分为节点通用配置和 db&repmgr 配置两项： 6.2.1 节点通用配置 集群创建成功后，节点通用配置参数不能再修改。界面如下： 图 6.2.2: 节点通用配置 73 第6章 集群部署 (专用机) 界面属性介绍如下： 表 6.2.1: 创建集群-界面属性 输入项 描述 集群名称 新建的集群名称，只能是英文、数字、下划线或者三者组合，不能为空。 节点通用配置 当前配置适用于整个集群的所有节点，可以免除创建节点时重复填写相同 的值。 节点类型 选择当前创建的集群是通用机或者专用机，此处选择专用机。 securecmd 端口 工具连接节点或者直接向节点发起指令时，创建连接所使用到的 securecmd 服务端口号，默认为 8890, 可根据环境修改 常规用户 默认 root，无法修改 默认路径 集群安装的路径，默认为/opt/Kingbase/ES/V9，且不允许修改。 6.2.2 db&repmgr 配置 填写完成后点击“下一步”进入到 db&repmgr 配置，如下图： 图 6.2.3: db&HAmgr 配置 界面属性介绍如下： 74 第6章 集群部署 (专用机) 表 6.2.2: db&repmgr 配置-界面属性 输入项 描述 选择数据库 zip 包 点击选择按钮，选择 db.zip。 大小写不敏感 默认不勾选，即大小写敏感 max_connections 数据库最大连接数，默认 100 个，不能为空。参数最小值不能小于 100，最 大值无限制。 listenerPort 数据库监听端口号，默认 54321，不能为空。 dbUser 数据库用户名，默认 system，不能为空。 dbPassword 数据库密码，默认 12345678ab，不能为空。 replication mode 同步/异步模式：1.quorum 2.sync 3.async 4.all。 archive_path 数据库归档路径。 dbmode 数据库兼容模式，Oracle、PostgreSQL 两种模式，默认兼容 Oracle。 加密算法 数据库认证采取的加密方式，scram-sha-256、md5，默认是 scram-sha256。 ip 类型 支持 IPV4 和 IPV6 两种地址类型。 trust_server 集群的信任网关，网关可以填写多个用英文逗号分隔，多个信任网关中有 一个可用即可。 使用 hostname 开启后工具支持多网段域名部署 使用多网冗余部署 开启后 connection_timeout 参数改为 10，关闭为 5。此功能需开启“使用 hostname”才可使用。 ping_path 系统环境中 ping 指令所在路径。 hamgr_dbname 默认是 esrep，且不可修改。repmgr 所依赖的表就存放在此数据库中。 hamgr_dbuser 默认是 esrep，且不可修改。登录 esrep 数据库的用户为 esrep。 data_directory 集群数据库 data 存放路径。 sys_bindir 集群数据库 bin 存放路径。 repmgrd_pid_file 记录 repmgrd pid 文件路径，默认值：${cluster_path}/kingbase/etc/repmgrd.pid，参数值不允许修改。写入 repmgr.conf 文件，参数名为：repmgrd_pid_file 见续表 75 第6章 集群部署 (专用机) 表 6.2.2 – 续表 输入项 描述 kbha_pid_file 记录 kbha pid 文件路径，默认值：$ {cluster_path}/ kingbase/ etc/ kbha.pid， 参 数 值 不 允 许 修 改。 写 入 repmgr.conf 文 件， 参 数 名 为： kbha_pid_file 记录 repmgrd 日志文件路径，默认值：$ {cluster_path}/ kingbase/ log/ repmgrd_log_file hamgr.log，参数值不允许修改。写入 repmgr.conf 文件，参数名为： log_file 记录 kbha 日志文件路径，默认值：$ {cluster_path}/ kingbase/ log/ kbha_log_file kbha.log， 参 数 值 不 允 许 修 改。 写 入 repmgr.conf 文 件， 参 数 名 为： kbha_log_file。 running_under_fa ure_trusted_se rvers il- 网关故障后数据库是否继续运行，可选值为 on 或 off，默认为 on。on：网 关故障后，数据库不受影响，正常运行；off：网关故障后，集群会关闭数 据库保证数据不发生分歧。 data_checksums 用于控制是否开启数据校验和功能，默认是开启状态。on：开启数据校验 和功能；off：关闭数据校验和功能；写入 repmgr_config.conf 文件，参数 名为：data_checksums。 流复制通信超时时间 流复制之间的数据传输超时时间，超过这个时间没有数据传输则表示流复 制断开了，会进行重连。 警告: 1.max_connections 的值只能修改为更大的值，不能修改为更小的值。2. 执行 which ping 命令，查看 操作系统中真实的 ping_path 路径，修改 ping_path 路径为查看的实际路径。3. 集群部署完成后，请不要修改 repmgrd_pid_file、kbha_pid_file 参数的值，修改后可能会造成同时启动多个 kbha 或 repmgrd 进程。 点击“高级设置”选项卡，如下图所示： 76 第6章 集群部署 (专用机) 图 6.2.4: 高级设置 表 6.2.3: “高级设置”选项卡 输入项 描述 wal_keep_segments 最小预留 xlog 文件个数，默认为 512 个，不能为空。 max_wal_senders 支 持 最 大 集 群 备 机 个 数， 默 认 为 32， 此 配 置 项 不 能 大 于 max_connections，最少是 n+4 个，n 为集群节点个数，不能为空。 hot_standby_feedback 备机读事物时避免主机 vacuum 造成的数据无法查询的取消冲突，默认为 on，开启状态。 control_file_copy 控制文件多副本，最多可配置 8 个文件，写入到 es_rep.conf 里 审计表空间加密 若勾选，则初始化数据库时增加’-t’ 作为参数执行。若输入框中输入内容， 则初始化数据库时增加’-t -K ${输入的内容}’ 作为参数执行。 log_checkpoints 数据库日志中记录检查点和重启点。包括一些统计信息，写入缓冲区的数 据和写入所花的时间。on、off。默认为 on。 log_replication_commands 数据库日志中记录每一个复制命令。on、off。默认为 on。 wal_compression 打开此参数可以减小 WAL 所占的空间且无需承受不可恢复的数据损坏风 险。但代价是需要额外的 CPU 开销，以便在 WAL 记录期间进行压缩以及 在 WAL 重放时解压。on、off。默认为 on。 见续表 77 第6章 集群部署 (专用机) 表 6.2.3 – 续表 输入项 描述 db_other_options 在 Oracle 兼容模式下，initdb 初始化数据库流程需添加兼容 V7 参数– scenario-tuning，调用 scenario_tuning.sql SQL 脚本，生成 V7 兼容视图、 字段，以支持 V7 部分系统视图。 encoding 模板数据库的编码格式，默认数据库的编码格式，未选择 encoding 的情况 下不可选择 Collate 和 CType ，默认为 default，将设置为服务器环境配置 的字符集 Collate 这个值决定了字符串类型排序的规则，值为“C”时表示没有规则，即以二 进制值大小为比较规则。在初始化设置后不能被修改。 CType 这个值决定了字符的分类，例如大小写和数字，值为“C”时表示没有规 则，即以二进制值大小为比较规则。在初始化设置后不能被修改。 virtual_ip DB 节点的虚拟 ip（用于切换时 ip 的移动，一直跟随着主 DB）。目前支 持多 cluster，VIP 就可以为空。如果要填写则必须为有效的 IP 格式，且必 须为无法 ping 通的 IP 地址。 virtual_ip_mask 虚拟 ip 的掩码长度，默认为 24。掩码长度需要配置为加载虚拟 ip 的网卡 的实际掩码长度。 ip_path 系统环境中 ip 指令所在路径。 auto_cluster_recovery_level 全故障自动恢复配置。0: 关闭；1: 打开，默认为 1。 waldir 指定链接的 wal 日志目录，将 data 目录中 sys_wal 目录作为软连接的形式 存在。 scmd_options 集群节点 ssh 通信的配置项，连接超时 10 秒。 conn_options 集群节点连接的配置项。 failover 节点故障自动切换，automatic、manual，默认值为 automatic。 服务可用优先 /数据保护优先 单选项。根据选项不同，reconnect_attempts，reconnect_interval，recovery，synchronous_commit 四个参数的默认值不同。默认选项为数据保护 优先 reconnect_attempts 集群中连接的重试次数。服务可用优先默认值为 3，数据保护优先默认值为 10。 reconnect_interval 集群中连接的重试间隔。服务可用优先默认值为 5，数据保护优先默认值为 6。 见续表 78 第6章 集群部署 (专用机) 表 6.2.3 – 续表 输入项 描述 recovery 节点故障自动恢复，automatic、standby、manual。manual，关闭自动恢 复，故障节点无论是主机还是备机，都不进行自动恢复；standby，故障节 点是备机才自动恢复；automatic，所有故障节点都自动恢复。服务可用优 先默认值为 automatic，数据保护优先默认值为 standby。 synchronous_commit 指定在命令返回”success” 指示给客户端之前，一个事务是否需要等待 WAL 记录被写入磁盘。on、off、local、remote_write、remote_apply。服务可 用优先默认值为 on，数据保护优先默认值为 remote_apply 警告: 在使用 NetworkManager 管理网络服务的情况下，如果手动删除了 virtual_ip 所在网卡上所有的物理 IP，有可能导致 virtual_ip 丢失，且在物理 IP 被重新添加上之前，virtual_ip 不会自动添加。 警告: 执行 which ip 命令，查看操作系统中真实的 ip_path 路径，修改 ip_path, 路径为查看的实际路径。 点击上图中“确定”按钮，创建成功如下图： 图 6.2.5: 创建成功 79 第6章 6.3 集群部署 (专用机) 新增节点 展开当前创建的集群，右键选择菜单的“新增节点”，如下图所示： 图 6.3.1: 新增节点 6.3.1 节点配置 工具开启“增加节点”流程窗口，如下图所示： 80 第6章 集群部署 (专用机) 图 6.3.2: 增加节点 表 6.3.1: “节点配置”选项卡 输入项 描述 显示名称 用户自定义的节点名称（服务器的别名），最终将会显示在左侧的树形菜 单中。 主机名或 IP 地址 当前节点（服务器）的 IP 地址或主机名。当“开启 hostname”选项未勾 选时，此处名称为 IP 地址。 securecmd 端口，常规用户，默认路 此三项均来自通用配置中，无需再次填写，且无法修改。详细介绍参见通 径 用配置参数介绍。 系统节点名称 系统节点名称记录在数据库配置文件中的节点（服务器）别名，目前采用 node + ip 最后一段的拼接的方式命名。 网卡名称 此项主要是针对填写 VIP 选项的集群。使用 VIP 必须填写该 VIP 要绑定的 对应网卡名称。支持获取多个网卡。点击“获取网卡”，列出所有状态 UP 的网卡列表，并将与当前节点服器 IP 相同的网卡名称显示列表第一位。可 以从获取的网卡列表中选择一个，也可以手动进行填写。 网卡物理 IP 地址 此项主要是针对填写 VIP 选项的集群。填写网卡名称后，需要输入对应的 网卡 IP 地址。点击“获取”，工具显示对应的物理 IP 地址。若存在多个 地址，默认只显示第一个。也可手动进行填写。 81 第6章 集群部署 (专用机) 点击上图中“下一步”按钮，工具先对当前界面填写的信息进行检测，如下图所示： 图 6.3.3: 信任网关检测 6.3.2 节点环境检测 检测合格后进入到系统环境检测步骤界面，此时需点击下方的检测按钮。如下图所示： 图 6.3.4: 节点环境检测 82 第6章 集群部署 (专用机) 点击“检查”按钮，环境参数的信息检测都会输出到这个界面中。输出信息中可能会出现红色和黄色提示，被标 为红色 ERROR 的提示，意为不允许安装集群，用户需解决后，才可继续进行下一步。黄色 Warning 意为不解决可 能会导致集群出现问题隐患。例如： (1) 防火墙，有些用户和系统必须开，那么就需要用户将集群使用到的端口号添加到防火墙白名单中。 (2) 检查发现 [ulimit.open proc] is null，则需要检查一下集群用户的 shell 环境。如下图所示： 图 6.3.5: 环境参数 点击“一键修改系统参数”按钮，修改的系统参数项，都会输出到这个界面中。如下图所示： 83 第6章 集群部署 (专用机) 图 6.3.6: 修改系统参数 点击“关闭防火墙”按钮，关闭防火墙的日志打印，都会输出到这个界面中。如下图所示： 图 6.3.7: 关闭防火墙 6.3.3 预览信息 点击上图中“下一步”按钮，系统进入预览信息界面，当前界面将会把配置信息进行汇总并显示，如下图所示： 84 第6章 集群部署 (专用机) 图 6.3.8: 预览信息 6.3.4 集群部署 点击上图中“确定”按钮，系统进入集群部署界面，如下图： 图 6.3.9: 集群部署 图中按钮功能如下： 85 第6章 集群部署 (专用机) 1. 重新部署：当集群安装过程中出现中断（例如：数据库启动超时），部署集群的流程也随之中断，这个时候根 据报错排查问题后，“重新部署”按钮就可以重新部署集群。 2. 部署：执行部署集群操作。 3. 取消：放弃本次部署操作，并且在后台中将生成的集群相关的文件删除。 这里点击“部署”按钮，系统开始执行集群部署操作。执行过程截图如下： 图 6.3.10: 节点部署成功 部署时的界面打印。此界面将执行命令，返回结果等均进行输出，便于错误时候的查询报错信息。也便于学习和 理解 KingbaseES 的部署流程步骤。 图 6.3.11: 部署界面打印 到此，集群部署顺利完成。 以此类推，进行第二个节点的部署。 86 第6章 集群部署 (专用机) 图 6.3.12: 新增节点 图 6.3.13: 节点配置 87 第6章 集群部署 (专用机) 图 6.3.14: 集群部署 6.4 新增 Witness 节点 展开当前创建的集群，右键选择菜单的“新增 Witness 节点”，如下图所示： 图 6.4.1: 新增 witness 节点 88 第6章 集群部署 (专用机) 工具开启“新加 Witness 节点”流程窗口，ssh 配置同新增节点章节，节点配置如下图所示： 图 6.4.2: 增加 witness 节点 图 6.4.3: witness 节点配置 点击上图中“下一步”按钮，工具先对当前界面填写的信息进行检测，如下图所示： 89 第6章 集群部署 (专用机) 图 6.4.4: 信任网关检测 其操作步骤与新增节点相同，详细描述见 < 新增节点 > 章节。 6.5 删除节点 鼠标右键点击需要删除的节点, 弹出菜单如下图所示: 90 第6章 集群部署 (专用机) 图 6.5.1: 删除节点 点击“删除节点”，系统弹窗提示如下图： 图 6.5.2: 删除提示 若集群整体处于已停止状态，所有节点允许删除。若集群处于已启用状态，主节点不允许删除。删除节点成功 后，提示用户“只删除工具端配置文件，服务器数据未删除”，需要用户手动删除。 点击“正常”，执行删除节点操作。 点击“取消”，取消本次删除操作。 91 第6章 集群部署 (专用机) 图 6.5.3: 删除提示 6.6 日志查询功能 此功能对特定节点进行日志输出功能。 6.6.1 新建日志查询 右键单击“日志查询”节点，弹出菜单，选择“选择新建日志查询”，右键菜单如下图： 图 6.6.1: 新建日志查询 工具打开新建日志查询窗口，如下图： 92 第6章 集群部署 (专用机) 图 6.6.2: 新建日志查询 界面属性介绍如下： 输入项 描述 显示名称 新建的日志节点名称，只能是英文、数字、下划线或者三者组合，不能为空。 主机名或 IP 当前节点（服务器）的 IP 地址或主机名。当“开启 hostname”选项未勾选时，此处 地址 名称为 IP 地址。 securecmd 端 工具连接节点或者直接向节点发起指令时，创建连接所使用到的 securecmd 服务端口 口 号，默认为 8890, 可根据环境修改 securecmd 用 工具连接节点需要通过指定用户连接的用户名 户名 securecmd 密 对应用户名的用户密码 码 数据库 Data 节点所安装的数据库对应的 Data 目录的路径 路径 点击“检查”测试是否正常连接到节点，如下图所示： 93 第6章 集群部署 (专用机) 图 6.6.3: 提示信息 如提示错误信息，则按照对应的错误提示信息进行修改。检查通过后点击“保存”即可完成新建日志节点，在 “日志查询”下将会有一个日志节点。如下图所示： 图 6.6.4: 日志节点 6.6.2 日志查看 右键单击日志节点，弹出菜单，选择“日志查看”，右键菜单如下图： 94 第6章 集群部署 (专用机) 图 6.6.5: 日志节点菜单 显示日志查看窗口，如下图所示： 图 6.6.6: 日志查看 此窗口最多显示 300 条最新数据，每十秒会执行自动刷新操作更新日志信息。 当端口出现异常或关闭时，将提示连接失败，如下图： 95 第6章 集群部署 (专用机) 图 6.6.7: 连接失败 点击提示完成后，日志查看窗口将变为无数据。 图 6.6.8: 无数据 当端口正常后，已经打开的日志查看窗口将自动更新日志信息并输出。 96 第6章 6.6.3 集群部署 (专用机) 修改日志查询 在日志节点菜单中选择“修改日志查询”，打开修改日志查询界面，如下图所示： 图 6.6.9: 修改日志查询 可对参数进行修改。 6.6.4 删除日志节点 在右键日志节点中选择“删除”，然后提示删除成功后，则删除完成，如下图所示： 图 6.6.10: 删除成功 97 第6章 6.7 集群部署 (专用机) 开发者模式 开发者模式为特殊情况下进入开发人员模式，进行一系列对数据库集群有关的操作（具体有：启动此节点数据 库、恢复至集群、提升为主库、保留此主库）。此模式会在集群部署工具重新启动时自动关闭。此操作存在丢数危 险，请谨慎操作。 6.7.1 开启开发者模式 点击集群部署工具的工具栏中的“帮助”，选择“开发者模式”进行开启，如下图所示: 图 6.7.1: 开发者模式 98 第6章 集群部署 (专用机) 图 6.7.2: 开启开发者模式 输入密码“rdjc12#$”，选择“正常”开启开发者模式。在开发者模式下点击“开发者模式”会提示到您已经在 此模式下，如下图所示: 图 6.7.3: 开启开发者模式后弹窗 图 6.7.4: 开启成功后状态显示 99 第6章 6.7.2 集群部署 (专用机) 关闭开发者模式 点击集群部署工具的工具栏中的“帮助”，选择“关闭开发者模式”进行关闭，如下图所示: 图 6.7.5: 关闭开发者模式 图 6.7.6: 关闭开发者模式后弹窗 100 第6章 6.8 集群管理 6.8.1 集群查看 集群部署 (专用机) 双击集群名称后，显示集群状态。弹出菜单如下图所示: 图 6.8.1: 集群查看 显示集群状态中包含：上游节点、PID、是否暂停、最后一次观测到的时间等。右下角有刷新按钮，方便更新集 群状态。 图 6.8.2: 集群状态 集群运行信息： 101 第6章 集群部署 (专用机) ID -- 数据库节点 ID Name -- 数据库在集群内部名称 Role -- 数据库节点角色，有 primary 和 standby 两种 Status -- 状态，*running 和 running 两种状态是正常运行状态，还有其他的状态，都是异常 -- 例如：! running、failed 等状态都是异常状态 Upstream -- 上游节点名称，即：从哪个节点同步数据 Hamgrd -- 管理软件 remgrd 的运行状态 PID -- 管理软件 repmgrd 的进程 ID Paused -- 管理软件 repmgrd 是否暂停 -- 暂停后 repmgrd 虽然在运行，但不再负责数据库自动切换、恢复 Upstream last seen-- 本节点距离上一次同步数据的时间（单位：秒） 以下为异常状态示例： 图 6.8.3: 备机故障停机 图 6.8.4: 管理软件暂停自动恢复功能 6.8.2 恢复至集群 (需开启开发者模式) 若原主节点宕机或出现异常，并且集群通过若干时间提升出一个正常的主节点时，右键异常的原主节点，”恢复 至集群”按钮变为可点击状态： 102 第6章 集群部署 (专用机) 图 6.8.5: 恢复至集群按钮 点击”恢复至集群”按钮效果如下图所示： 图 6.8.6: 点击恢复至集群按钮弹窗 点击“确定”，执行恢复至集群操作。点击“取消”，取消本次操作。 图 6.8.7: 恢复至集群成功 6.8.3 提升为主库 (需开启开发者模式) 所有主节点全部宕机或异常时，右键正常运行的备节点，”提升为主库”按钮变为可点击状态： 103 第6章 集群部署 (专用机) 图 6.8.8: 提升为主库按钮 点击”提升为主库”按钮效果如下图所示： 图 6.8.9: 点击提升为主库按钮后弹窗 点击“确定”，执行提升为主库操作。点击“取消”，取消本次操作。 图 6.8.10: 提升为主库操作成功 警告: 在故障主节点无法上电，仅有备节点但备节点未运行的场景，使用此功能需先将备节点启动后再执行 升主操作。见“启动此节点数据库”章节。 104 第6章 6.8.4 集群部署 (专用机) 保留此主库 (需开启开发者模式) 存在多个正常的主节点时，右键其中一个主节点，”保留此主库”按钮变为可点击状态： 图 6.8.11: 保留此主库按钮 点击”保留此主库”按钮效果如下图所示： 图 6.8.12: 点击保留此主库按钮后弹窗 点击“确定”，执行保留此主库操作。点击“取消”，取消本次操作。 105 第6章 集群部署 (专用机) 图 6.8.13: 保留此主库运行中 图 6.8.14: 保留此主库操作成功 6.8.5 节点查看 左键双击需要查看的节点名称，查看节点信息： 106 第6章 集群部署 (专用机) 图 6.8.15: 操作系统信息 图 6.8.16: 数据库信息 107 第6章 集群部署 (专用机) 图 6.8.17: HAmgr 配置 图 6.8.18: sys_wal 信息 108 第6章 集群部署 (专用机) 图 6.8.19: archive 信息 图 6.8.20: 用户占用数据库连接数量 图 6.8.21: IP 占用数据库连接数量 图 6.8.22: 数据库连接状态 109 第6章 集群部署 (专用机) 图 6.8.23: License 信息 6.8.6 启动/关闭集群 鼠标右键选择集群，选择菜单中的停止集群，如下图所示: 图 6.8.24: 关闭集群 点击“确定”按钮后工具执行指令并做出相应提示，如下图所示: 110 第6章 集群部署 (专用机) 图 6.8.25: 关闭集群-提示 图 6.8.26: 关闭集群-提示 鼠标右键选择集群，选择菜单中的启动集群，如下图所示: 111 第6章 集群部署 (专用机) 图 6.8.27: 启动集群 点击“确定”按钮后工具执行指令并做出相应提示，如下图所示: 图 6.8.28: 启动集群-提示 112 第6章 集群部署 (专用机) 图 6.8.29: 启动集群-提示 6.8.7 暂停/恢复功能 鼠标右键选择集群，选择菜单中的暂停自动功能，暂停功能是将集群的处于运行状态的自动功能停止掉，例如： 自动切换、自动恢复。如下图所示: 图 6.8.30: 暂停自动功能 该窗口为确认窗口，并对暂停自动功能有相应的提示和说明。图中有复选框 dry-run，如果勾选复选框，工具会 先尝试执行一次暂停自动功能的操作，尝试成功则直接执行暂停指令。反之，失败则不执行暂停指令。如果未勾选复 选框，工具会直接执行暂停集群功能的指令。界面如下图所示: 113 第6章 集群部署 (专用机) 图 6.8.31: 暂停自动功能-提示 集群功能被暂停后，在集群状态窗口可以查看到集群此时的状态。暂停状态会被现实成红色，并且有弹窗提示。 如下图所示: 图 6.8.32: 集群状态 114 第6章 集群部署 (专用机) 图 6.8.33: 暂停自动功能-提示 鼠标右键选择集群，选择菜单中的恢复自动功能，恢复功能是将集群的处于暂停状态的自动功能重新启动。如下 图所示: 图 6.8.34: 恢复自动功能 该窗口为确认窗口，并对恢复自动功能有相应的提示和说明。途中有复选框 dry-run，如果勾选复选框，工具会 先尝试执行一次恢复自动功能的操作，尝试成功则直接执行恢复指令。反之，失败则不执行恢复指令。如果未勾选复 选框，工具会直接执行恢复集群功能的指令。界面如下图所示: 115 第6章 集群部署 (专用机) 图 6.8.35: 恢复自动功能-提示 集群功能被恢复后，在集群状态窗口可以查看到集群此时的状态。集群状态恢复正常，无弹窗提示报错。如下图 所示: 图 6.8.36: 集群状态 116 第6章 集群部署 (专用机) 图 6.8.37: 恢复自动功能-提示 6.8.8 主备切换功能 鼠标右键选择集群，选择菜单中的主备切换功能，该功能可以将指定的备机提升为主机，剩下的所有备机继续跟 随主机。如下图所示: 图 6.8.38: 主备切换功能 117 第6章 集群部署 (专用机) 在集群列表的中选中需要执行切换命令的备机，鼠标单击选中即可，然后点击“切换按钮”。如下图所示: 图 6.8.39: 切换命令 图 6.8.40: 主备切换 成功完成切换指令后，如下图所示: 118 第6章 集群部署 (专用机) 图 6.8.41: 主备切换-提示 成功完成切换指令后执行期间的输出也会显示在下方的文本中，如下图所示: 图 6.8.42: 执行结果 6.8.9 修改参数配置 展开需要修改的集群，在节点通用配置上右键选择，修改参数配置，进入配置界面。如下图： 119 第6章 集群部署 (专用机) 默认展示“数据库参数”选项卡，如下图： 120 第6章 集群部署 (专用机) 图 6.8.43: 数据库参数修改 表 6.8.1: 数据库参数配置 输入项 描述 参数名称 下拉选项（包括可配置的数据库参数） 参数值 输入参数名称对应的值 说明 参数值范围等相关说明 点击“集群参数”选项卡，如下图： 121 第6章 集群部署 (专用机) 图 6.8.44: 集群参数修改 表 6.8.2: 集群参数配置 输入项 描述 参数名称 下拉选项（包括可配置的集群参数） 参数值 输入参数名称对应的值 说明 参数值范围等相关说明 点击“确定”按钮后工具执行检验操作，若参数值输入不正确，做出相应提示，如下图所示： 122 第6章 集群部署 (专用机) 图 6.8.45: 更新参数配置-检验错误 若集群状态异常，或者集群流复制状态异常，做出相应提示，如下图所示： 图 6.8.46: 更新参数配置-集群异常 图 6.8.47: 更新参数配置-集群流复制异常 若修改的参数中包含需要重启才能生效的，会做出相应提示，如下图所示： 123 第6章 集群部署 (专用机) 图 6.8.48: 更新参数配置-重启生效 检验无误后，工具执行更新，相应提示如下，如下图所示： 图 6.8.49: 更新参数配置-提示 图 6.8.50: 更新参数配置-提示 6.8.10 修改集群密码 选择需要修改的集群，右键弹框选择，修改集群密码： 124 第6章 集群部署 (专用机) 图 6.8.51: 集群密码修改 125 第6章 集群部署 (专用机) 点击“确定”按钮后工具执行检验操作，若集群状态异常，或者集群流复制状态异常，做出相应提示，如下图所 示： 图 6.8.52: 修改集群密码-集群异常 图 6.8.53: 修改集群密码-集群流复制异常 修改集群密码成功后，工具做出相应提示，如下图所示: 图 6.8.54: 集群密码修改成功 6.8.11 启动此节点数据库 (需开启开发者模式) 当前节点数据库关闭，点击此按钮启动数据库可启动数据库，界面效果如图所示： 126 第6章 集群部署 (专用机) 图 6.8.55: 启动此节点数据库 点击”启动此节点数据库”按钮后，没有开启开发者模式效果如下图所示： 图 6.8.56: 未开启开发者模式时弹窗 点击”启动此节点数据库”按钮后，节点数据库正常效果如下图所示： 图 6.8.57: 数据库正常时弹窗 点击”启动此节点数据库”按钮，节点为主时数据库确定为关闭状态下，或者节点为备，数据库关闭并且不存在 正常运行的主节点时，效果如下图所示： 127 第6章 集群部署 (专用机) 图 6.8.58: 启动此节点数据库提示信息 点击“确定”，执行启动此节点数据库操作。点击“取消”，取消本次操作。 图 6.8.59: 启动此节点数据库成功 128 版权声明 版权声明 北京人大金仓信息技术股份有限公司（简称：人大金仓）版权所有，并保留对本手册及本声明的一切权利。 未得到人大金仓的书面许可，任何人不得以任何方式或形式对本手册内的任何部分进行复制、摘录、备份、修 改、传播、翻译成其他语言、将其全部或部分用于商业用途。 免责声明 本手册内容依据现有信息制作，由于产品版本升级或其他原因，其内容有可能变更。人大金仓保留在没有任何通 知或者提示的情况下对手册内容进行修改的权利。 本手册仅作为使用指导，人大金仓在编写本手册时已尽力保证其内容准确可靠，但并不确保手册内容完全没有错 误或遗漏，本手册中的所有信息也不构成任何明示或暗示的担保。 技术支持 • 人大金仓官方网站：http://www.kingbase.com.cn/ • 人大金仓文档中心：http://help.kingbase.com.cn/ • 全国服务热线：400-601-1188 • 人大金仓技术支持与反馈信箱：support@kingbase.com.cn 129 服务周期承诺 服务周期承诺 由于市场需求在不断变化，技术创新和发展的进程不断加剧，产品的版本更迭不可避免。人大金仓对于产品版本 生命周期的有效管理，有助于您提前规划项目，更好地从产品服务终止上过渡。 表 3: KingbaseES 产品生命周期里程碑 关键里程碑点 定义 产品发布日期 产品正式发布版本，即 GA（general availability）版本的发布日期。 停止销售日期 正式停止销售的日期，版本停止接受订单日。该日之后，产品将不再销售。 停止功能升级日期 在该日期之后，不再提供新特性和新硬件支持。但依旧提供错误修复、安全修复、功 能维护等服务。 停止功能维护日期 在该日期之后，不再维护功能，修复问题。但依旧提供安全修复等服务 停止安全维护日期 在该日期之后，不再发布补丁版本修复中高风险漏洞，仅提供有限的支持。 产品服务终止日期 停止提供产品服务和支持的日期。包括软件维护版本，缺陷修复，以及针对该产品的 所有服务支持（包括服务热线和远程/现场支持）。 服务周期策略 金仓数据库管理系统 KingbaseES 产品确保以下的服务周期： 1）产品自发布之日起至产品停止功能升级（包含新特性、新硬件支持）之日不少于 5 年。 2）产品停止功能升级之日起至产品停止功能维护（主要包括问题修复）之日不少于 4 年。 3）产品功能维护停止之日起至产品停止安全维护（包括中高风险漏洞修复）之日不少于 2 年。 服务终止策略 金仓数据库管理系统 KingbaseES 产品确保在销售后，至少提供 6 年的服务支持。 注意: 人大金仓将会综合各方因素来确定产品服务终止日期。并将在实际产品服务终止日期之前至少 90 天，通过公 130 服务周期承诺 开方式宣布产品服务终止日期。 131