Kingbase repmgr 使用说明文档

原创 于 2025-11-06 13:51:51 发布 · 650 阅读 · 16 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#数据库

Kingbase repmgr 使用说明文档

概述

repmgr (Replication Manager) 是 Kingbase 数据库的复制管理工具，用于管理主从复制集群的高可用性。本文档基于已验证的 KingbaseES V008R006C008M020B0025 版本。

版本信息

验证版本: repmgr (Kingbase) V008R006C008M020B0025 (5.0.0.0.0 f69bfa3:1268a95a92ed)

安装路径: /opt/Kingbase/ES/V8/kingbase/bin/repmgr

基本语法

repmgr [OPTIONS] <command> <subcommand>

主要命令分类

1. Primary 节点管理

# 注册主节点
repmgr primary register
# 注销主节点
repmgr primary unregister

2. Standby 节点管理

# 注册备节点
repmgr standby register
# 注销备节点
repmgr standby unregister
# 克隆备节点
repmgr standby clone
# 提升备节点为主节点
repmgr standby promote
# 备节点跟随新的主节点
repmgr standby follow
# 主备切换
repmgr standby switchover

su kingbase
repmgr cluster show --verbose
repmgr standby switchover --siblings-follow
repmgr cluster show --verbose

在这里插入图片描述

3. 节点管理

# 查看节点状态
repmgr node status
# 检查节点健康状态
repmgr node check
# 重新加入集群
repmgr node rejoin
# 节点服务管理
repmgr node service

4. 集群管理

# 显示集群概览
repmgr cluster show
# 查看集群事件
repmgr cluster event
# 显示集群矩阵
repmgr cluster matrix
# 交叉检查集群状态
repmgr cluster crosscheck
# 清理集群资源
repmgr cluster cleanup

5. 服务管理

# 查看服务状态
repmgr service status
# 暂停服务
repmgr service pause
# 恢复服务
repmgr service unpause

6. 守护进程管理

# 启动 repmgrd 守护进程
repmgr daemon start
# 停止 repmgrd 守护进程
repmgr daemon stop
# 重新加载配置
repmgr daemon reload

7. 配置管理

# 显示配置项
repmgr config show
# 显示指定配置项
repmgr config show <name>
# 显示所有配置项
repmgr config showall
# 检查配置文件
repmgr config check

在这里插入图片描述

常用选项

通用选项

  • -?, --help: 显示帮助信息
  • -V, --version: 显示版本信息
  • --version-number: 仅显示版本号
  • --dry-run: 模拟运行，不执行实际操作
  • -F, --force: 强制执行潜在危险操作

配置选项

  • -f, --config-file=PATH: 指定配置文件路径
  • -b, --sys_bindir=PATH: Kingbase 二进制文件路径

数据库连接选项

  • -d, --dbname=DBNAME: 数据库名称 (默认: “root”)
  • -h, --host=HOSTNAME: 数据库服务器主机
  • -p, --port=PORT: 数据库端口 (默认: “54321”)
  • -U, --username=USERNAME: 数据库用户名 (默认: “root”)

节点特定选项

  • -D, --sysdata=DIR: 节点数据目录位置
  • --node-id: 通过节点ID指定节点
  • --node-name: 通过节点名称指定节点

日志选项

  • -L, --log-level: 设置日志级别
  • --log-to-file: 记录到配置文件定义的日志文件
  • -q, --quiet: 静默模式，仅显示错误
  • -t, --terse: 简洁输出模式
  • -v, --verbose: 详细输出模式

实际使用示例

1. 查看集群状态

# 在 kingbase 用户下执行
su - kingbase -c '/opt/Kingbase/ES/V8/kingbase/bin/repmgr cluster show'

输出示例：

 ID | Name     | Role    | Status    | Upstream | Location | Priority | Timeline | LSN_Lag | Connection string
----+----------+---------+-----------+----------+----------+----------+----------+---------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------
 1  | replica0 | primary | * running |          | default  | 100      | 1        |         | host=245.0.0.164 user=esrep dbname=esrep port=54321 connect_timeout=5 keepalives=1 keepalives_idle=2 keepalives_interval=2 keepalives_count=3 tcp_user_timeout=9000
 2  | replica1 | standby |   running | replica0 | default  | 100      | 1        | 0 bytes | host=245.0.8.188 user=esrep dbname=esrep port=54321 connect_timeout=5 keepalives=1 keepalives_idle=2 keepalives_interval=2 keepalives_count=3 tcp_user_timeout=9000

2. 查看节点详细状态

su - kingbase -c '/opt/Kingbase/ES/V8/kingbase/bin/repmgr node status'

输出示例：

Node "replica0":
	Kingbase version: KingbaseES V008R006C008M020B0025 on x86_64-pc-linux-gnu
	Total data size: 1863 MB
	Conninfo: host=245.0.0.164 user=esrep dbname=esrep port=54321 connect_timeout=5 keepalives=1 keepalives_idle=2 keepalives_interval=2 keepalives_count=3 tcp_user_timeout=9000
	Role: primary
	WAL archiving: enabled
	Archive command: /opt/Kingbase/ES/V8/archive_push.sh %p && sys_rman version > /dev/null
	WALs pending archiving: 0 pending files
	Replication connections: 1 (of maximal 32)
	Replication slots: 1 physical (of maximal 32; 0 missing)
	Replication lag: n/a

3. 节点健康检查

su - kingbase -c '/opt/Kingbase/ES/V8/kingbase/bin/repmgr node check'

4. 查看服务状态

su - kingbase -c '/opt/Kingbase/ES/V8/kingbase/bin/repmgr service status'

输出示例：

 ID | Name     | Role    | Status    | Upstream | repmgrd | PID  | Paused? | Upstream last seen
----+----------+---------+-----------+----------+---------+------+---------+--------------------
 1  | replica0 | primary | * running |          | running | 1447 | no      | n/a
 2  | replica1 | standby |   running | replica0 | running | 1886 | no      | 2 second(s) ago

5. 查看配置信息

su - kingbase -c '/opt/Kingbase/ES/V8/kingbase/bin/repmgr config show'

重要注意事项

  1. 权限要求: repmgr 必须以非特权用户（通常是 kingbase 用户）运行
  2. 配置文件: 默认配置文件路径为 /opt/Kingbase/ES/V8/kingbase/etc/repmgr.conf
  3. 服务用户: 复制用户默认为 esrep，数据库名为 esrep
  4. 默认端口: Kingbase 默认端口为 54321
  5. 日志文件:
    • hamgr.log: /opt/Kingbase/ES/V8/kingbase/log/hamgr.log
    • kbha.log: /opt/Kingbase/ES/V8/kingbase/log/kbha.log

Kubernetes 环境使用

在 Kubernetes 环境中，可以通过 kubectl exec 命令在 Pod 中执行 repmgr：

# 设置 kubeconfig
export KUBECONFIG=/bpx/.25-admin.conf

# 执行 repmgr 命令
kubectl exec -n qfusion-admin <pod-name> --insecure-skip-tls-verify -- \
  bash -c "su - kingbase -c '/opt/Kingbase/ES/V8/kingbase/bin/repmgr <command>'"

验证环境信息

  • 命名空间: qfusion-admin
  • Pod: kingbase-f2eaf61d-replica0-0, kingbase-f2eaf61d-replica1-0
  • 架构: 主备模式 (primary-standby)
  • 验证时间: 2025-11-05

配置参数说明

基于实际验证的配置：

  • ha_running_mode='DG': 数据卫士模式
  • failover='automatic': 自动故障切换
  • synchronous='quorum': 同步复制模式为仲裁
  • trusted_servers: 可信服务器列表
  • node_id: 节点唯一标识
  • node_name: 节点名称
  • conninfo: 连接字符串参数

此文档已在实际环境中验证，配置和命令均基于 KingbaseES V008R006C008M020B0025 版本测试通过。

Kingbase数据库V8R6高可用集群工具repmgr介绍
weixin_42415175的博客
09-06 737
5.切换（switchover）：某些情况下，如硬件或者操作系统故障，必须使主节点所在服务器脱机，需要以受控方式（主动）从复制集群中移除现有主节点服务器，并从备用服务器中选择新主，进行提升。3.上游节点（upstream node）：备用服务器连接的节点，数据同步的上游节点（一般是主服务器或在级联复制情况下，是另一个备用服务器的父节点）。主节点发生故障，repmgr自动将备节点提升为主；主节点发生故障，repmgr自动在两个备节点中选择最合适的节点提升为新主，切换过程中剩下的节点仍可提供读请求。
KingbaseES V8R6 集群运维系列 -- 命令行部署repmgr管理集群+switchover测试
lyu1026的博客
03-02 7553
本次部署未使用securecmd/kbha工具，无需普通用户到root用户的互信。 一、环境准备 1、创建OS用户 建立系统数据库安装用户组及用户，在所有的节点执行。 root用户登陆服务器，创建用户组及用户并且设置密码 [root@ora19c ~]# groupadd -g 6000 kes86 [root@ora19c ~]# useradd -G kes86 -g 6000 -u 600...
金仓数据库KingbaseES主备和读写分离集群使用手册（集群组件与功能介绍）
arthemis_14的博客
10-12 1962
金仓数据库KingbaseES主备和读写分离集群使用手册（集群组件与功能介绍）
金仓数据库KingbaseES V8R6 命令行部署repmgr管理集群+switchover测试（三）配置备节点
arthemis_14的博客
05-22 2618
为确保当前的 repmgrd 日志文件(repmgr.conf配置文件中用参数log_file指定的文件)不会无限增长，请将您的系统配置logrotate为定期轮换它。密码文件为普通文本文件，可以vi创建，也可以使用kingbase提供的工具sys_encpwd工具来生成密码文件。ksql登录时，会去数据库安装用户家目录下的密码文件.encpwd中读取用户信息，然后登陆数据库；备库：repmgrd监控本地数据库和主数据库，负责自动切换、复制槽删除。该工具包含5个参数，5个参数均需要输入才能配置成功。
金仓数据库KingbaseES V8R6 命令行部署repmgr管理集群+switchover测试（一）环境准备
arthemis_14的博客
05-22 2855
本次部署未使用securecmd/kbha工具，无需普通用户到root用户的互信。
kingbase常用操作文档/大全
寂夜了无痕的博客
09-18 1757
kingbase常用操作文档/大全
KingbaseES 集群节点管理系列 01 -- repmgr standby clone 与 sys_basebackup 创建备库
lyu1026的博客
07-26 508
案例说明： KingbaseES V8R6集群可以通过执行'repmgr clone standby' 创建备库，在一些场景，执行clone命令出现故障时，可以通过执行sys_basebackup命令分析和排除故障。本案例详细描述两种方案创建备库的区别。 适用版本：KingbaseES V8R6 节点信息： [kingbase@node202 ~]$ cat /etc/hosts 192.16...
KingbaseES流复制问题排查处理指南
最新发布
Nuzbb的博客
09-22 590
KingbaseES流复制问题排查指南 摘要：本手册提供KingbaseES主备流复制的系统化故障排查方法，涵盖版本差异适配、常见报错处理和维护建议。重点包括： 排查前需收集版本信息、复制状态、配置和日志等关键数据 针对V8R3/V8R6/V9等不同版本的核心差异进行分析适配 详细说明网络连接、认证失败等典型问题的处理流程 提供日常维护脚本和预防措施建议 手册采用标准化处理流程，结合具体命令和配置示例，帮助DBA快速定位和解决流复制中断、数据不一致等问题，确保数据库高可用性。适用于企业级生产环境的运维需求。
【金仓数据库征文】CentOS7 上玩转 KingbaseES V9：全链路部署实操指南
shunwahma的博客
05-23 1244
本文详细介绍了在Linux系统上安装金仓 KingbaseES（MySQL兼容版）V9数据库的全过程，包括安装前准备、数据库安装、数据库使用与管理以及与其他数据库系统的对比。通过实操命令流程，读者可以清晰地了解金仓 KingbaseES 的安装和使用方法。
人大金仓数据库KingbaseES repmgr之主备切换
arthemis_14的博客
12-25 1623
KingbaseES、repmgr、主备切换、人大金仓、KingbaseES。
KingbaseES V8R6集群运维案例之---repmgr standby promote应用案例
lyu1026的博客
09-16 601
案例说明： 在容灾环境中，跨区域部署的异地备节点不会自主提升为主节点，在主节点发生故障或者人为需要切换时需要手动执行切换操作。若主节点已经失效，希望将异地备机提升为主节点。$bin/repmgr standby promote 适用版本： KingbaseES V8R6 集群节点信息： ID | Name | Role | Status | Upstream | repmgr...
repmgr+pgbouncer实现对业务透明的高可用切换
weixin_41690116的博客
07-21 1044
repmgr02节点，在该节点上执行了触发脚本，成功被提升为主库，并且node-3节点作为从节点。此模板是为了在故障转移时生成pgbouncer配置文件的[pgbouncer]部分。repmgr03节点，作为repmgr02节点的STANDBY成功连接。准备一套1主2从的repmgr集群，部署过程参考我的另一篇文章。所有节点的pgbouncer配置文件已被修改为指向新的主节点。用于初次部署集群时，启动pgbouncer服务。repmgr01节点失去连接。
人大金仓数据库KingbaseES repmgr-02-集群故障节点恢复流程
arthemis_14的博客
12-06 688
总结：需要注意的是，standby节点的故障恢复是由primary节点服务器上的repmgrd守护进程来实现，而primary节点的故障是由kbha第三方守护进程来实现。备机repmgrd服务持续监控主机数据库的状态，主机故障后可自动完成故障的转移。每个节点的repmgrd之间是没有通信的，服务监控的对象是Kingbase实例。DoRemoteCommand()：在故障服务器上执行具体的恢复命令，真正对故障节点进行恢复。1.1、对失效节点的自动恢复流程图：（备库恢复由主库的repmgrd来实现）
KingbaseES V8R6集群管理运维案例之---repmgr standby switchover故障
lyu1026的博客
08-13 1333
案例说明： 在KingbaseES V8R6集群备库执行“repmgr standby switchover”时，切换失败，并且在执行过程中，伴随着“repmr standby follow”操作，本案例详细记录了解决此问题的过程。 适用版本： KingbaseES V8R6 集群节点信息： 一、备库执行switchover操作 1、执行switchover切换 [kingbase@nod...
金仓数据库KingbaseES V8R6 命令行部署repmgr管理集群+switchover测试（二）部署过程
arthemis_14的博客
05-22 1879
备注：use_scmd='off' 未使用securecmdd必须显式设置为off。注释或者默认都是on。备注：后期进行数据库备份使用相对路径启动的话，备份会有问题。在系统数据库用户家目录上传db.zip文件。至此主节点数据库已配置完成。通过kbha工具添加虚拟ip。
金仓数据库KingbaseES V8R6 命令行部署repmgr管理集群+switchover测试（四）switchover切换测试
arthemis_14的博客
05-22 688
启动repmgrd守护进程命令(如果使用sys_monitor.sh管理Kingbase数据库启停,不用额外执行命令启动repmgrd服务,sys_monitor.sh脚本会自动启动repmgrd服务)建议：如果不使用autofailover，建议不要开启kbha服务。只需启动repmgrd守护进程就可以。测试使用非root权限sys_monitor.sh脚本启停数据库。过程中没有有warning/error信息说明可以正常切换。到此switchover切换测试验证通过。
KingbaseES R6 集群repmgr.conf参数'recovery'测试案例(一)
lyu1026的博客
03-04 876
KingbaseES R6集群repmgr.conf参数'recovery'测试案例(一) 案例说明： 在KingbaseES R6集群中，主库节点出现宕机(如重启或关机)，会产生主备切换，但是当主库节点系统恢复正常后，如何对原主库节点进行处理，保证集群数据的一致性和安全，可以通过对repmgr.conf文件中配置recovery参数来解决。本案例记录了对‘recovery’参数的三种配置的详细...
KingbaseES V8R6 手工创建主备流复制集群案例
arthemis_14的博客
11-18 1386
目录 案例说明： 1. 系统环境 1.1. 集群架构 1.2. 数据库版本 1.3. 系统CPU架构（鲲鹏920） 1.4. 系统内存信息 1.5. 网卡信息 1.6. 系统内核信息 2. 配置系统环境（all nodes） 2.1.创建kingbase用户 2.2.关闭主机系统防火墙 2.3.配置selinux 3. 通过脚本构建集群 3.1.配置部署环境 3.2. 执行脚本部署 4. 查看集群部署后的状态 4.1.查看数据库服务状态（主库） 4.2.主备...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值