Postgres主从（2）Repmgr基本命令

最新推荐文章于 2025-06-18 17:10:00 发布
原创 最新推荐文章于 2025-06-18 17:10:00 发布 · 2.6k 阅读 · 6 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文详细介绍了repmgr工具的各个命令，包括主节点注册、注销，从节点克隆、注册、注销、提升，主从切换，节点状态检查、复制检查、重新加入，以及集群管理和监控历史清理等功能。repmgr是PostgreSQL高可用解决方案的关键组件，用于管理和监控PostgreSQL集群。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

命令简介

命令说明
repmgr primary register安装pg的repmgr扩展并注册为主节点
repmgr primary unregister注销不活动的主节点
repmgr standby clone从其他节点复制数据到从节点
repmgr standby register注册从节点（添加从的信息到repmgr元数据）
repmgr standby unregisterrepmgr元数据中移除从的信息
repmgr standby promote将从提升为主
repmgr standby follow将从跟随新主
repmgr standby switchover将从提升为主并将主降级为从
repmgr witness register注册一个观察节点
repmgr witness unregister移除一个观察节点
repmgr node status显示节点的基本信息和复制状态
repmgr node check从复制的角度对节点进行健康监测
repmgr node rejoin重新加入一个失效节点到集群
repmgr cluster show显示所有集群中注册的节点信息
repmgr cluster matrix在所有节点运行show并汇总
repmgr cluster crosscheck在节点间两两交叉监测连接
repmgr cluster event输出时间记录
repmgr cluster cleanup清理监控历史

repmgr primary register注册主

说明

在集群中注册一个主节点，并配置PostgreSQL安装repmgr扩展，必须在所有从节点注册前注册

参数

  • -f：指定配置文件
  • –dry-run：测试命令执行条件是否满足，但不实际执行

将触发primary_register事件

repmgr primary unregister注销主

说明

注销非活动状态的主，典型场景是当主宕机，新主已产生时用本命令注销老主

参数

  • –node-id：要注销的主的nodeId
  • –dry-run：测试命令执行条件是否满足，但不实际执行

将触发primary_unregister 事件

repmgr standby clone克隆数据到从

说明

从其他节点（一般是主节点）克隆数据，并自动创建recovery.conf文件

克隆后并未启动从，需要先用repmgr standby register注册从，然后再启动数据库

PGDATA中postgresql.conf, postgresql.auto.conf, pg_hba.conf和pg_ident.conf等所有文件都将被复制，需要修改配置文件

自动创建recovery.conf

自动创建的以下配置

  • standby_mode：值总是on
  • recovery_target_timeline：值总是’latest’
  • primary_conninfo
  • primary_slot_name (如果使用复制槽)

如果repmgr.conf下配置了以下参数也将被复制到recovery.conf

  • restore_command
  • archive_cleanup_command
  • recovery_min_apply_delay

参数

  • –dry-run：测试命令执行条件是否满足，但不实际执行
  • -c, --fast-checkpoint：强制fast checkpoint
  • 其他参数见https://repmgr.org/docs/repmgr.html#REPMGR-STANDBY-CLONE

将触发standby_clone 事件

repmgr standby register 注册从

参数

  • –upstream-node-id：可选,复制源的NodeID
  • –dry-run：测试命令执行条件是否满足，但不实际执行

将触发standby_register 事件

repmgr standby unregister 注销从

并不会影响复制，只将元数据中删除从信息

参数

  • –node-id：可选,要注销的NodeId

将触发standby_unregister 事件

repmgr standby promote 提升从

说明

当主宕机时将从提升为主

执行成功成为主后，不需要重启PG。其他的从需要跟随新主（使用repmgr standby follow）

示例

$ repmgr -f /etc/repmgr/10/repmgr.conf standby promote

将触发standby_promote 事件

repmgr standby follow从跟随新主

示例

测试

repmgr -f /etc/repmgr.conf standby follow --dry-run

执行操作

repmgr -f /etc/repmgr.conf standby follow

将触发standby_follow 事件

事件参数

  • %p：新主的NodeID
  • %c：conninfo字符串
  • %a：本节点的node name

repmgr standby switchover主从切换

说明

提升从为主，并将主降级为从

需要主和从间可进行无密码的SSH连接

需要任何节点的repmgrd处于关闭状态

参数

  • –always-promote：即使主从不一致也将执行提升（原来的主将被关闭）
  • –dry-run：检查
  • –siblings-follow：让其他从跟随新主
  • –force-rewind[=/path/to/pg_rewind]：当主从不一致时使用pg_rewind重新同步主从

repmgr.conf

  • reconnect_attempts: 在原主执行关闭后进行完全关闭检查的次数
  • reconnect_interval: 在原主执行关闭后进行完全关闭检查的间隔时间
  • replication_lag_critical: 复制延迟（秒）超过该值退出主从切换
  • standby_reconnect_timeout: 原主降级重启后尝试连接到其的超时秒数.

新主将触发standby_switchover和standby_promote 事件

standby_switchover参数

  • %p：旧主的node id

旧主将触发node_rejoin 事件

repmgr node status节点状态

检查当前节点的基本信息和复制状态

例如：

$ repmgr node status
Node "node1":
    PostgreSQL version: 10beta1
    Total data size: 30 MB
    Conninfo: host=node1 dbname=repmgr user=repmgr connect_timeout=2
    Role: primary
    WAL archiving: off
    Archive command: (none)
    Replication connections: 2 (of maximal 10)
    Replication slots: 0 (of maximal 10)
    Replication lag: n/a

repmgr node check 节点复制检查

从复制的角度对本地节点进行检查

例如

$ repmgr -f /etc/repmgr.conf node check
Node "node1":
    Server role: OK (node is primary)
    Replication lag: OK (N/A - node is primary)
    WAL archiving: OK (0 pending files)
    Downstream servers: OK (2 of 2 downstream nodes attached)
    Replication slots: OK (node has no replication slots)

参数说明：

  • –role: 检查角色是否如预期
  • –replication-lag: 检查延迟是否超过repmgr.conf配置的replication_lag_warning或replication_lag_critical
  • –archive-ready: 检查WAL文件是否被存档
  • –downstream: 检查下游节点是否如预期
  • –slots: 检查是否有非活动的复制槽

repmgr node rejoin节点重新加入

说明

将休眠（已停止）节点重新加入到复制群集

可选择使用pg_rewind来重新加入脱离集群的节点，通常是发生故障的主节点。

提示： 如果节点正在运行并且需要连接到当前的主节点，请使用 repmgr standby follow

参数

repmgr node rejoin

  • -d:必须，指定集群中任何可访问的节点的conninfo
  • –dry-run：测试
  • –force-rewind[=/path/to/pg_rewind]：需要时使用pg_rewind
  • –config-files：逗号间隔的保留文件，pg_rewind会重写所有文件，这里可指定保留的文件
  • –config-archive-dir：临时存放config-files的位置，默认/tmp

触发node_rejoin 事件

repmgr cluster show集群状态

repmgr cluster matrix集群连通性矩阵

repmgr cluster event 事件查询

参数

  • –all: 输出所有数据
  • –limit: 设置最大输出数量 (default: 20)
  • –node-id: 查询指定node id的事件
  • –node-name: 查询指定node name的事件
  • –event: 查询指名称的事件

repmgr cluster cleanup

如果监控数据在repmgr.conf中设置以下参数

  • monitoring_history：yes/no,是否启用监控
  • #monitor_interval_secs：监控间隔时间

监控数据量很大需要定期清理

本命令通过参数-k/–keep-history只保留指定天数的数据

例如保留30天

repmgr cluster cleanup -k30
【PG高可用】四 PostgreSQL高可用之repmgr管理手册
DBA之路的博客
11-16 936
与其他repmgr 操作的不同之处在于，它还在其他服务器（降级候选服务器，以及可选的任何遵循新主服务器的其他服务器）上执行操作，这意味着从执行的服务器到这些服务器需要无密码 SSH 访问。repmgr standby follow可用于使“孤立”备用服务器成为新的主服务器的从 并追赶上其当前状态。这将执行任何必要的检查并通知成功/失败，并在运行第一个实际命令（关闭当前的主节点）之前停止。如果主服务器发生故障或需要从复制集群中删除，则必须指定新的主服务器，以确保集群继续正常运行。确保可以从升级候选者（
【PG高可用】五 PostgreSQL高可用之repmgr命令手册
DBA之路的博客
07-16 1416
描述在流复制集群中注册主节点，并将其配置为与repmgr一起使用，包括安装repmgr扩展。此命令需要在。执行执行该--dry-run选项来检查在没有实际注册主服务器的情况下会发生什么。用户权限要求用户repmgr必须是超级用户，repmgr 才能够安装该repmgr扩展。如果不是这种情况，repmgr可以在执行之前手动安装该扩展。未来的repmgr版本将能够 为扩展的安装 提供名称。选项--dry-run检查先决条件但实际上并不注册主要项。-F--force覆盖现有节点记录事件通知。
故障节点恢复为备库（node rejoin）
weixin_41761667的博客
01-03 591
1.Node101 由于数据库宕机，primary 切换到 node102。2.执行命令将 原主库node101 重新加入集群。#在故障的数据库节点执行。#可以执行简化后的命令。
Repmgr（含 Repmgrd）与 Patroni 的全面对比
最新发布
喝醉酒的小白
06-18 730
Repmgr 以。
PostgreSQL数据库管理第十章Repmgr
syjhct的博客
06-02 1924
PostgreSQL数据库管理第十章Repmgr 概述 repmgr是一套开源工具，用于管理PostgreSQL服务器群集内的复制和故障转移。它支持并增强了PostgreSQL的内置流复制，该复制流提供了一个读/写主服务器以及一个或多个只读备用数据库，其中包含主服务器数据库的近实时副本。可以设置热备份服务器、监控复制、执行管理任务（故障转移、手工切换等）。 Repmgr流复制管理系统有repmgr和repmgrd两个命令。其中repmgr命令实现对集群节点的管理，如注册主/备节点、Clone节点，Pr
通过repmgr实现PostgreSql主从数据同步
weixin_46471797的博客
04-17 2000
至此简单的主从流复制配置完成，可连接数据库进行操作进行检验，从库为只读库，可以在主库执行下列命令查询从库相关信息。分别按上述流程对 node2 和 node3 进行集群注册，注册成功后，检查集群状态。原因： .ssh 目录没有 ssh_home_t 标签，通过下列命令重置。解决方法：在对应的家目录下新建 .pgpass 文件配置密码。若未配置环境变量，需到对应文件夹下执行相关操作。对主库进行数据库操作，查看到从库实现数据同步。注册完成后主机配置结束，可以查看注册结果。测试无异常报错，则可实际执行克隆操作。
KingbaseES R6 集群repmgr.conf参数'recovery'测试案例(一)
lyu1026的博客
03-04 853
KingbaseES R6集群repmgr.conf参数'recovery'测试案例(一) 案例说明： 在KingbaseES R6集群中，主库节点出现宕机(如重启或关机)，会产生主备切换，但是当主库节点系统恢复正常后，如何对原主库节点进行处理，保证集群数据的一致性和安全，可以通过对repmgr.conf文件中配置recovery参数来解决。本案例记录了对‘recovery’参数的三种配置的详细...
金仓数据库V8R6主备集群repmgr常用命令
weixin_41549328的博客
01-02 796
repmgr standby register 注册从节点（添加从的信息到repmgr元数据）repmgr primary register 安装pg的repmgr扩展并注册为主节点。repmgr standby clone 从其他节点复制数据到从节点。repmgr standby unregister repmgr元数据中移除从的信息。repmgr cluster show 显示所有集群中注册的节点信息。repmgr standby follow 将从跟随新主。
postgres主从部署（repmgr故障自动切换）
小新没有蜡笔
06-28 1314
这个hba文件是为了配置repmgr用户无密码访问repmgr数据库的，所以上面创建用户的时候没有设置密码，trust就是这个意思，还有其他的配置项可以看配置文件里的解释。repmgrd 作为运行在集群中每个节点上的一个管理和监控的守护程序，可以自动进行故障转移和维护复制关系，并提供有关每个节点状态的监控信息。到此已经完成了pg的主从搭建，目前也可以故障转移，但是需要手动操作，后面接着部署repmgr自动故障切换。下面安装的是14匹配的repmgr，如果是其他版本把14换成其他版本即可。
使用repmgr进行postgres的主从复制
tteas的博客
09-28 409
一 准备工作 以下部分将介绍如何使用 repmgr 命令行工具设置具有主服务器和备用服务器的基本复制集群。 我们假设主节点名为 node1，IP 地址为 39.107.136.217，备用节点名为 node2，IP 地址为 82.156.51.24 必须在两台服务器上安装以下软件： PostgreSQL repmgr(匹配安装的 PostgreSQL 主要版本) PostgreSQL安装如下所示：主库全部进行，从库不需要初始化和启动服务 yum...
如何搭建PostgreSQL高可用方案repmgr？详解安装部署与关键组件疑问
ProXiaoduo的博客
07-30 1738
repmgr：是一个用于增强和管理PostgreSQL数据库内建复制和故障转移机制的开源工具集。其主要功能包括：设置备用服务器、监控复制状态、以及在故障发生时自动或手动执行故障转移和切换操作。
PG数据库使用repmgr手动切换
一个老Java开发的自白
07-14 343
siblings-follow 表示从节点或者witness节点也跟随切换。–siblings-follow 表示从节点或者witness节点也跟随切换。测试完毕，切回134 master， 135 salve。在standy（134）节点 上查看。在standy（135）节点 上查看。测试完毕，能正常手动切换。134是从，135是主。在主库（135）上查看。134是主，135是从。在主库（134）上查看。
pg高可用之repmgr（一）
三思的博客
05-19 9681
文章目录一、repmgr初识1.1 repmgr基本概念1.2 PostgreSQL + repmgr 基本架构1.3 repmgr常用命令二 repmgr安装部署2.1 部署规划2.2 OS基本环境配置2.3 PostgreSQL数据库服务安装2.3 repmgr安装部署 一、repmgr初识 repmgr是一套开源的PostgreSQL集群管理工具，具有非常轻量级的使用特性。具体表现有以下特点： 配置操作简单，可一键式完成相关部署操作； 支持Auto Failover和Manual Switchov
repmgr学习
Captains-Felix的专栏
06-22 2868
https://repmgr.org/docs/4.0/using-repmgrd.htmlrepmgrd是在复制群集中的每个节点上运行的管理和监视守护进程。它可以自动执行诸如故障转移和更新备用数据库等操作以跟踪新的主数据库，并提供关于每个备用数据库状态的监视信息。一、基本配置1、如要使用 repmgrd，必须在 postgresql.conf中 配置关联库（需要重启pg服务方可生效）shared...
KingbaseES V8R6集群管理运维案例之---repmgr standby switchover故障
lyu1026的博客
08-13 1269
案例说明： 在KingbaseES V8R6集群备库执行“repmgr standby switchover”时，切换失败，并且在执行过程中，伴随着“repmr standby follow”操作，本案例详细记录了解决此问题的过程。 适用版本： KingbaseES V8R6 集群节点信息： 一、备库执行switchover操作 1、执行switchover切换 [kingbase@nod...
postgresql 高可用 repmgr 的使用之八 常用的几个命令
一名数据库爱好者的专栏
09-25 992
stop pgsql $ pg_ctl -D /var/lib/postgresql/9.6/main -m fast stop 或者 $ sudo pg_ctlcluster 9.6 main stop clone standby $ repmgr -h 10.101.70.90 -U repmgr -d repmgr -f /etc/repmgr.conf standby clone --d...
Postgresql基于repmgr（1主2从+1witness）实现自动和手动故障切换的集群安装
qq_39169917的博客
06-30 1590
root@localhost ~]#yum list installed | grep docker#查看是否已安装docker列表[root@localhost ~]#yum -y install docker#安装[root@localhost ~]#systemctl start docker#启动[root@localhost ~]#systemctl enable docker#开机启动[root@localhost ~]#systemctl status docker#查看状态。
KingbaseES V8R6 集群运维系列 -- 命令行部署repmgr管理集群+switchover测试
lyu1026的博客
03-02 7448
本次部署未使用securecmd/kbha工具，无需普通用户到root用户的互信。 一、环境准备 1、创建OS用户 建立系统数据库安装用户组及用户，在所有的节点执行。 root用户登陆服务器，创建用户组及用户并且设置密码 [root@ora19c ~]# groupadd -g 6000 kes86 [root@ora19c ~]# useradd -G kes86 -g 6000 -u 600...
pgsql3个节点repmgr重新初始化
03-18
<think>好的，我现在需要处理用户关于PostgreSQL三个节点使用repmgr重新初始化的问题。首先，我得理解用户的具体需求。用户提到的是三个节点的repmgr集群需要重新初始化，可能是因为整个集群出现了无法修复的故障，或者需要完全从头开始配置。这时候，重新初始化可能比逐个修复更高效。 接下来，我应该考虑用户的使用场景。用户可能是一个数据库管理员，负责维护高可用性的PostgreSQL集群。他们可能遇到了数据不一致、主从同步失败或者其他严重问题，导致现有的集群无法正常运行。因此，他们需要将整个集群重置，确保所有节点回到一个干净的状态，然后重新搭建环境。 用户的需求可能不仅仅是步骤性的操作指南，还可能包括注意事项和潜在风险。例如，在重新初始化之前，是否需要备份数据？如何确保所有节点上的旧数据被彻底清除？此外，用户可能还想知道如何验证重新初始化后的集群是否正常运作。 然后，我需要回忆repmgr的相关知识。repmgr是一个用于PostgreSQL流复制的管理工具，支持自动故障转移和节点管理。重新初始化整个集群通常涉及以下步骤：停止所有节点的PostgreSQL服务，清理数据目录，重新初始化主节点，配置主节点的repmgr，然后注册备用节点，并重新建立复制关系。 在这个过程中，需要注意每个步骤的顺序是否正确，例如必须先停止所有节点的服务，避免数据写入导致不一致。清理数据目录时，要确保使用正确的命令，比如pg_ctl stop -m immediate来立即停止服务，以及rm -rf来删除数据目录，但必须小心操作，防止误删其他重要文件。 注册主节点时，需要使用repmgr primary register命令，而备用节点则需要使用repmgr standby clone和repmgr standby register。此外，参数如--force在必要时使用，比如当旧节点信息仍然存在时需要强制注册。 可能用户会遇到的问题包括节点注册失败、网络配置错误、或者权限问题。例如，防火墙设置可能阻止节点之间的通信，或者PostgreSQL的pg_hba.conf文件没有正确配置复制用户的访问权限。这时候需要检查日志文件，如/var/log/postgresql/postgresql-XX-main.log，来排查错误。 另外，用户可能会问是否需要重新生成新的流复制槽，或者在重新初始化后如何监控集群状态。这时候可以建议使用repmgr cluster show来验证集群拓扑是否正确，以及检查复制延迟等指标。 还有，用户可能会关心数据备份的问题。在重新初始化之前，如果还有可用的数据，应该先进行备份，避免数据丢失。即使集群需要重置，备份也是一个好习惯。 最后，需要提醒用户，重新初始化会清除所有数据，所以必须确保这是必要的操作，并且已经做好了相应的备份和迁移准备。同时，建议在测试环境中先演练整个过程，熟悉步骤后再在生产环境中执行，以减少风险。</think>以下是对PostgreSQL三节点repmgr集群重新初始化的分步说明： --- ### **重新初始化repmgr集群的必要场景** - 集群出现无法修复的脑裂/数据不一致 - 主备节点全部故障且无有效备份 - 需要彻底重建集群拓扑结构 --- ### **准备工作** 1. **停止所有节点服务** ```bash # 在所有节点执行 pg_ctl stop -m immediate ``` 2. **清理旧数据** ```bash # 在所有节点执行 rm -rf /var/lib/postgresql/XX/main/* # 确保目录存在且权限正确 mkdir -p /var/lib/postgresql/XX/main && chown postgres:postgres /var/lib/postgresql/XX/main ``` --- ### **初始化主节点（原主节点或新节点）** 1. **初始化数据库** ```bash sudo -iu postgres initdb -D /var/lib/postgresql/XX/main --data-checksums ``` 2. **配置postgresql.conf** ```conf listen_addresses = '*' wal_level = replica max_wal_senders = 10 hot_standby = on ``` 3. **启动主库并创建复制用户** ```sql CREATE USER repuser REPLICATION LOGIN CONNECTION LIMIT 3; ALTER USER repuser PASSWORD 'SecurePass123!'; ``` --- ### **注册主节点到repmgr** ```bash repmgr primary register -f /etc/repmgr.conf --force ``` **关键参数说明**： - `--force`：强制覆盖已有注册信息 - 验证注册：`repmgr cluster show` --- ### **备节点初始化（以node2为例）** 1. **克隆主节点数据** ```bash repmgr standby clone \ -h <primary-ip> \ -U repuser \ -d repmgr \ --recovery-conf-only \ --force ``` 2. **注册备用节点** ```bash repmgr standby register -f /etc/repmgr.conf --force ``` 3. **启动备节点服务** ```bash pg_ctl start -D /var/lib/postgresql/XX/main ``` --- ### **验证集群状态** 1. **检查集群拓扑** ```bash repmgr cluster show ``` 预期输出应显示1个primary + 2个standby 2. **检查复制状态** ```sql SELECT client_addr, state, sync_state FROM pg_stat_replication; ``` --- ### **故障排查要点** 1. **日志检查路径** ```bash tail -f /var/log/postgresql/postgresql-XX-main.log ``` 2. **常见错误处理** - **流复制中断**：检查`pg_hba.conf`是否允许repuser从备节点IP访问 - **节点注册冲突**：使用`repmgr node unregister`清理旧记录 - **时间不同步**：确保所有节点已配置NTP服务 --- ### **注意事项** 1. **数据安全** - 重新初始化会**完全清除原有数据** - 操作前必须确认无可用备份需要恢复 2. **网络要求** - 节点间必须开放5432（PostgreSQL）和22（SSH）端口 - 建议配置SSH互信免密登录 3. **参数一致性** - 所有节点的`postgresql.conf`中`max_connections`等核心参数必须一致 --- 通过以上步骤可完成三节点repmgr集群的彻底重建。建议在维护窗口期操作，并提前做好全量备份。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值