此页面为机器翻译。请阅读英文原文。 English

其他语言:Русский、Português。

本指南介绍如何从两台干净的服务器搭建出可用的 Firebird 5.0 副本。 除安装和一个文件夹外,其余操作都在浏览器中的 RCM 控制台里完成。 截图来自 2026-11-17 的那次运行:套件 2027.2.33,RCM 和节点 2027.5.12,Ubuntu 24.04, 英文界面。更早一次 2026-11-08 运行的报告: hqbird2027-rcm-cluster-check-report.ru.md (俄文,章节“Прогон 2”)。只有命令、没有截图的版本: hqbird2027-linux-cluster-runbook.md。每个 RCM 页面的详细说明: RCM 用户指南(仓库 hqcluster-node,docs/user-guide/)。

本指南适用于套件 2027.2.24 及更高版本。对于套件 2027.2.22,请参阅 git 历史中 2026-11-07 版本的此文件。

要下载的套件是 2027.2.33(2026-11-16):agent 3.4.0,HQ Monitor 1.57.0,RCM 和节点 2027.5.12,Firebird 5.0.5.1917。本指南已于 2026-11-17 用它验证(两台服务器,Ubuntu 24.04,数据库分别为 3 MB 和 167 MB):所有步骤均通过。文中将那次运行的结果称为“2026-11-17 的运行”。 截图来自当天使用同一套件的第二轮运行(数据库分别为 3 MB 和 2.88 GB)。 其他数字仍来自 2026-11-08 的运行。2027.2.27 之后的套件对集群做了哪些更改:

套件 更改
2027.2.29(agent 3.1.0,RCM 2027.5.9) 默认不创建集群(见下文)。同一主机的多个 agent 可以加入一个集群:每个都有自己的配对端口(7450–7459)和节点端口。fbagent --cluster-leave。HQ Monitor 的 Clusters 页面
2027.2.30(RCM 2027.5.10) 服务的 switchover 和 failover,路由器
2027.2.31(agent 3.3.0,RCM 2027.5.11) 安装程序在终端中打开文本界面(步骤 1)。RCM 的 Services 页面。未连接到任何 HQCenter 的服务器会自行更新 agent、HQ Monitor 和 fbmcp
2027.2.33(agent 3.4.0,RCM 2027.5.12) RCM 将告警发送到 Telegram、webhook 或电子邮件(“接下来要关注什么”)。由两个 Docker 容器组成的集群:Docker 指南

所有更改:What’s New。

使用 agent(fbagent)3.1.0 及更高版本的套件(从 2027.2.29 起)默认不创建 集群:没有 RCM,没有配对窗口,集群端口在防火墙中保持关闭。在步骤 1 中,你在 master 上 开启 RCM,在 replica 上开启发现模式。

时间:约 30 分钟,外加复制数据库的时间(在 1 Gbit/s 网络上每 3 GB 约 1 分钟)。

你将得到

服务器 1 服务器 2
角色 master + RCM 控制台 replica
数据库 /databases/master/*.fdb /databases/replica/<replica node>/<master node>/*.fdb
服务 firebird、hqbirdfbagent-fb50、hqbirdmonitor-fb50、fbmcp、hqbirdrcm、hqclusternode-master-p3050 相同,但为 hqclusternode-replica-p3050,且没有 hqbirdrcm(较旧的套件会在那里留下自己的 RCM,处于停止状态)

你需要准备

  • 两台 Linux x86-64 服务器(已在 Ubuntu 24.04 上验证),2 核,4 GB 内存。
  • 磁盘空间。Master:可用空间 ≥ 数据库大小的 105 %(.delta 文件 在锁定期间会增长)。Replica:可用空间 ≥ 数据库大小的 105 % 加上 下限 limits.free_space_floor_gb(默认 1 GB)。在现有 replica 上重新初始化时, 旧文件会保留到最后,因此 replica 卷需要约 2 × 数据库大小。使用 空间不足时删除旧 replica 复选框(步骤 8),105 % 加上下限就足够了。
  • 服务器之间的网络:端口 3050、7051、7443、7444、7450。这些 是服务器第一个实例(槽位 0)的端口。服务器的第二个 实例使用配对端口 7451 和节点端口 7052。
  • 你的 PC 能访问 master 的 7444 端口(RCM 控制台),可直接访问或 通过 SSH 隧道访问。
  • 一个具有 sudo 权限的用户。

防火墙。 安装程序会在已启用的 firewalld 或 ufw 中开放端口 (无论系统语言为何):3050 和 23050 始终开放,集群端口仅 针对步骤 1 中的选项开放。Master:7443、7444、7051。Replica:7450、7051。 当配对窗口结束或主机被关联后,agent 会再次关闭 7450。 在 Ubuntu 上,ufw 通常处于禁用状态。此时安装程序会写一行 提示,例如在 master 上: no active firewall (firewalld or ufw): ports 3050, 23050, 7443, 7444, 7051/tcp are not opened by this install; they are reachable from every network; close them or enable a firewall。在云环境中,请用云防火墙关闭端口: 对外只允许你的地址;服务器之间使用内部网络。

以下是本次运行的地址:master 10.114.0.5,replica 10.114.0.6(私有网络)。请使用你自己的地址。

步骤 1. 在两台服务器上安装

在每台服务器上:

Command
V=2027.2.33
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run.sha256
sha256sum -c hqbird2027-fb50-linux-$V.run.sha256
sudo sh hqbird2027-fb50-linux-$V.run

在终端中,安装程序会打开其文本界面(2027.2.31 起的套件)。第一页有一行 Cluster RCM off, discovery mode off。打开 Cluster 并更改一行:

Cluster 页面中的行 Master Replica
Cluster manager (RCM) on off
Discovery mode (24 h) off(此 agent 运行 RCM) on

Cluster id(默认:主机名)、RCM admin password (默认:自动生成)和 Pairing port(默认:第一个空闲端口, 7450)这几行可以保持原样。返回(Esc)并选择 Install。 安装程序会显示计划:按 Enter。然后它会询问 Nothing on this host was changed yet. Start the install now?。光标位于 No:将其 移到 Yes 并按 Enter。安装程序会自行添加缺失的库(例如 libtommath1)。完整的文本界面说明: hqbird2027-linux-setup-guide.md。

使用 --no-tui 时,以及在套件 2027.2.29–2027.2.30 中,安装程序会以 提问方式进行。第一个问题是 Install as planned? Yes/No:回答 y。然后 它会问两个集群问题。默认答案为 No(按 Enter):

问题 Master Replica
Install the cluster manager (RCM) on this host and make a new cluster? [y/N] y Enter(No)
Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N] 不询问:此 agent 运行 RCM y

或者以选项形式给出答案:在终端中,它们会在 Cluster 页面打开前设置其 值。在没有终端的情况下运行时也可使用它们: 单独使用 --yes 表示两者都选 No。

Command
sudo sh hqbird2027-fb50-linux-$V.run --rcm on               # master
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on   # replica

安装大约需要一分钟(2026-11-17 的运行:master 上 61 秒,replica 上 43 秒)。 以下是使用套件 2027.2.33 时 master 上输出的结尾部分(此处哈希已缩短;下面示例中的 集群 id 为 hq27d-m,来自 2026-11-08 的运行):

text
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1917 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
RCM:        https://10.114.0.5:7444 (cluster hq27d-m)
CA hash:    sha256:9754e0be…087cb195
Login:      rcmadmin
Password:   in /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password (read it with sudo; RCM asks for a new one at the first login)
Pairing:    not needed: this agent runs the RCM; other agents link through it
fbmcp:      2027.2.24, service running; local only (remote mode: sudo fbmcp ctl hqbird-install --allow-from CIDR)

在 replica 上:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    port 7450 open until 2026-11-09T16:25:27Z (fingerprint sha256:0d137a71…09fe44cf); an RCM may invite this host

旧版套件在主服务器上会打印 Pairing: not opened (this agent runs the RCM)。

记下主服务器的 RCM: 和 CA hash: 行,以及副本的 Pairing: 行。第 3 步需要用到 fingerprint。

旧版套件(3.1.0 之前的 agent,例如套件 2027.2.27)不会询问集群相关问题。它们会在每台服务器上安装 RCM,并在所有位置打开配对窗口。请使用主服务器的 RCM;第二台服务器的 RCM 会在建立链接后自行停止。

之后,不使用安装程序。 在服务器的 HQ Monitor 中,打开 Clusters,即 Cluster on this server 部分。在主服务器上:Enable the cluster console (RCM);HQ Monitor 会在防火墙中打开 7443 和 7444。在副本上:Open the pairing window for 24 hours。以 agent 用户身份执行相同操作的命令如下:

Command
cd /opt/hqbird/fbagent-fb50
sudo -u firebird ./fbagent --cluster-init hq27d-m     # master; open 7443 and 7444 yourself
sudo -u firebird ./fbagent --cluster-pairing on       # replica

配对窗口打开期间,agent 会在防火墙中打开其配对端口。当窗口结束或主机已链接时,它会关闭该端口。

输出中没有密码。RCM 密码在 Password: 行所指的文件中,SYSDBA 密码在 /root/fbagent-install-sysdba.txt 中,HQ Monitor 密码在 /opt/hqbird/conf/access.properties 中。

你不需要安装许可证:新的 agent 会自行启动 7 天试用,集群节点即可工作。

第 2 步。登录 RCM

打开主服务器 RCM: 行中的地址。如果 7444 端口对你的 PC 关闭,请使用 SSH 隧道和 https://localhost:7444:

Command
ssh -L 7444:127.0.0.1:7444 <user>@<master>

如果 7444 端口在你的 PC 上被占用,请使用另一个本地端口,例如 -L 17444:127.0.0.1:7444 和 https://localhost:17444。

浏览器会对证书发出警告:集群 CA 签署了 RCM 证书。登录页面会显示 Cluster CA hash:将其与安装程序输出中的 CA hash: 行进行比较。如果匹配,请将 CA 证书(同一页面上的 Download the CA certificate (hqcluster-ca.crt) 链接)安装为受信任证书,或接受警告。如果不匹配,请不要登录,并检查地址。

RCM sign-in
RCM sign-in

用户名为 rcmadmin。密码在 Password: 行所指的文件中:

Command
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password

RCM 会立即要求设置新密码(至少 12 个字符):

New password at the first sign-in
New password at the first sign-in

2027.5.12 之前的 RCM 可能会反复加载此页面。RCM 2027.5.12(套件 2027.2.33)已修复此问题。

更改密码后,主服务器的 agent 会在一分钟内自行删除 rcm-initial-password 文件。使用旧版套件时,第二台服务器也有自己的 RCM。建立链接后,agent 会将那个较早的集群移动到 cluster/left/ 文件夹。Agent 3.1.0 会在那里删除其 rcm-initial-password;较旧的 agent 不会。然后请自行删除该文件:

Command
# on server 2, after step 3
sudo find /opt/hqbird -name rcm-initial-password
sudo rm <path from the find output>

不要删除文件 /opt/hqbirdrcm/initial-admin.json:它只保存旧密码的哈希,如果没有它,丢失用户文件的 RCM 会以默认密码启动。

更改密码后,RCM 会立即打开 Settings → Link hosts:此时集群还没有节点。Releases in the mirror 列表显示 agent 用于安装节点的 hqbirdrcm 和 hqclusternode 发行版。

Link hosts after the sign-in
Link hosts after the sign-in

第 3 步。链接主机

列表的第一行已经填好(RCM 主机)。添加第二行:主服务器可以访问的副本地址。如果服务器没有公共 DNS,请输入 IP:RCM 会原样保留该字符串,节点通过它相互找到。

List of hosts
List of hosts

点击 Check hosts。对于没有端口的主机,RCM 会读取配对端口 7450–7459,并为每个响应的 agent 显示一行,格式为 host:port(此处为 10.114.0.6:7450)。写入 host:port 可只读取一个端口。RCM 主机不需要配对窗口:RCM 会在自己的注册表中找到其 agent。将 Certificate fingerprint 与安装程序输出(副本的 Pairing: 行)进行比较:它们必须匹配。第二台主机的状态为 Ready to link。 Member ID 列显示主机在集群中获得的名称:<host name>-<role>,例如 hq27d-m-master。仅当主机有多个 agent 时才会添加实例后缀(-fb50)。

Check of the hosts
Check of the hosts

每一行都有一个复选框、端口、实例和节点端口。Link 只接受已勾选的行。出错的行无法勾选,也不会阻止其他行。在表格下方,RCM 2027.5.12 会写入类似 10.114.0.6, no agent: closed or no answer: 7451-7459 的行:它们列出该主机上没有其他 agent 响应的配对端口。它们不是错误。

master 是生产数据库所在的主机。点击 Link 并确认:

Confirmation
Confirmation

进度:“Joining → Joined → The node starts → Running”。本次运行中,链接耗时 56 秒(2026-11-17 的运行:47 秒)。

Link progress
Link progress
Done
Done

Overview 现在显示两个节点:主服务器和副本。链接后,副本可能会在一分钟内显示为“stale”;之后会变为“online”。

Overview: two nodes
Overview: two nodes

如果你对已链接的主机再次点击 Check hosts,它会显示配对端口上没有 agent 响应,或主机不可达:该主机上的配对窗口已关闭,其防火墙中的配对端口也已关闭。这不是错误。

将一台主机加入已有 master 的集群。 单行链接会被拒绝并显示 lone_master:请说明该行将成为什么。添加 -replica-of <master member> 使其成为该 master 的副本,或添加 -new-master(Link hosts 页面上的复选框)使其成为自己的 master。

第 4 步。主服务器上的数据库文件夹

在 master 上,数据库必须位于用户 firebird 可以访问的文件夹中:

Command
sudo install -d -o firebird -g firebird -m 0770 /databases/master
# example: the sample database from the kit
sudo cp /opt/firebird/examples/empbuild/employee.fdb /databases/master/
sudo chown firebird:firebird /databases/master/employee.fdb

你不需要在副本上准备任何内容:Create folder

Initialize 对话框中的按钮会为副本创建文件夹(第 6 步)。

第 5 步。在主节点上登记数据库

Databases → 在 Nodes 表中,找到主节点所在的行 → Enroll。

  • 该服务器上的文件夹路径:/databases/master,递归。
  • 包含文件掩码:*.fdb。
  • 同步跟踪表:Verify 按钮会比较这些表的行数。你为每个登记的数据库分别设置该列表。将字段留空:此时数据库会统计其发布表。对于已被管理的数据库,请在主数据库页面上更改该列表。
Enroll form
Enroll 表单

Preview → 选择数据库 → Enroll selected 并确认。

Confirmation of the enrollment
登记确认

结果是“Enrolled: 2.”,并附带一条提示:主节点的 Firebird 必须重启。其下方的文字“No new databases matched.”不是错误:这些数据库已经登记。

Result of the enrollment
登记结果

数据库正在等待重启:

Waits for the restart
等待重启

在主节点任意数据库所在的行中点击 Restart Firebird of the master(一次重启对所有数据库都足够)并确认。所有到主节点 Firebird 的连接都会中断几秒钟(本次运行中为 4 秒):请选择合适的时间。

Restart of Firebird of the master
重启主节点的 Firebird

重启后,主节点为 CONFIGURED。每个数据库都带有 publication OFF 标记,副本显示“not paired”。

After the restart
重启之后

第 6 步。初始化副本

在数据库行中,副本列 → Initialize。该对话框的标题为“Initialize database?”。

Initialize dialog
Initialize 对话框
  • Publication。 当数据库的发布处于关闭状态时,Firebird 不会将更改写入日志,副本什么也收不到。对话框会说明这一点,并显示 Sync publication and initialize 按钮。点击它:RCM 会将所有带主键或唯一键的表添加到发布中,并立即开始初始化。发布关闭时 Initialize 按钮无济于事:主节点会拒绝(publication_off)。
  • Replica folder:对话框会建议 /databases/replica/<replica node>,本次运行中为 /databases/replica/hq27d-r-replica。主机的每个副本节点都需要自己的文件夹。保留它。如果字段显示“✗ The folder does not exist”,请点击 Create folder;随后你会看到“✓ The folder was created.”。副本会放到 /databases/replica/hq27d-r-replica/hq27d-m-master/。对于后续数据库,文件夹已经设置好,对话框不会更改它。
  • Method:Smooth(默认)。它会在加锁前检查写入事务。Standard 会立即锁定数据库。
  • 对于新副本,你不需要勾选“Let … stop its Firebird for this reinit”和“Remove the old replica if space is short”复选框。

首次发布同步后请重新连接应用程序。 在发布开启之前打开的到主数据库的连接,在再次连接之前不会被记入日志。在 2026-11-17 的运行中,一个在 Sync publication and initialize 之前打开的连接在复制之后写入了约 9,500 行,而副本一行都没有收到。RCM 对双方都显示“Ok”;只有 Verify(第 9 步)显示“Not ok (desynced)”。新连接的行会立即复制。因此,在数据库首次 Sync publication 之后:重新连接应用程序(或重启主节点的 Firebird),然后在没有写入的情况下运行 Verify。如果副本缺少行,请执行重新初始化(第 7 步)。

负载下的首次初始化。 当主节点的归档还没有日志段时,如果数据库正在被写入,Smooth 可能会拒绝。数据库行会显示 long_transactions: … the archive holds no segment yet,并以 UI 语言显示一条提示:

Refusal of the smooth method
Smooth 方法被拒绝

在本次运行中,这种情况在 Sync publication and initialize 之后也发生了(报告中的发现 G-04)。此时发布已经开启。等待主数据库显示“archive: 1 seg”或更多(本次运行中为 15 秒),然后再次以 Smooth 方法点击 Initialize。或者选择 Standard。在 2026-11-17 的运行中(来自一个连接的约 49 事务/秒),Smooth 没有被拒绝。

进度会显示在数据库行中:SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA。页面重新加载后进度仍然可见。在此期间 Initialize 按钮不可用。

Initialization progress
初始化进度

复制完成后,副本节点会在计划的时间自行重启副本的 Firebird。该行会说明时间;Restart Firebird of the replica 按钮会立即执行。此时所有到副本 Firebird 的连接都会中断。

Waits for the restart of Firebird of the replica
等待重启副本的 Firebird

大型数据库的工作方式相同。在本次运行中,bulk.fdb(3.13 GB)通过 Sync publication and initialize 按钮完成初始化,期间没有负载:

Copy of the large database
大型数据库的复制

当主节点和副本都显示“Ok”,并且副本的“last applied seg”达到主节点的“last seg”时,即告完成。没有新写入的数据库(此处为 bulk.fdb)对副本显示“Pending”且段为 0:这是正常的。

Both databases ready
两个数据库均已就绪

本次运行的测量结果(employee.fdb 在约 55 事务/秒的负载下):

数据库 大小 主节点:从开始到结束 主节点上的锁定 配对“Ok”
employee.fdb 4 MB 0.7 s 0.35 s 约 1 分钟后(等待副本重启)
bulk.fdb 3.13 GB 64 s(约 55 MB/s) 59 s 约 2 分钟后

2026-11-17 的运行(套件 2027.2.33):employee.fdb(3 MB)耗时 3 秒

在 master 上,bulk.fdb(167 MB)用时 15 秒。副本侧在启动后约 40 秒完成配对(它等待了副本的 Firebird 重启)。

在锁定期间,master 数据库仍可正常工作:变更会写入 .delta 文件。

后续发布。 当数据库中出现新表时,你需要使用 master 数据库的 Sync publication 按钮。它会在一个事务中让发布与表保持一致;Firebird 不会重启。

Sync publication
Sync publication

Publication tables 显示哪些表会被复制。没有键的表无法发布:请为它添加主键。

Publication tables
Publication tables

第 7 步。重新初始化

当副本与 master 不一致,或节点请求重新初始化(NEEDS_REINIT)时,你需要执行此操作。在副本行中 → Reinit,方法选择 Smooth。此时已有段归档,且平滑方法可在负载下工作。它会等待早于日志历史的写入事务,并显示这些事务。

Reinit, smooth method
Reinit, smooth method

进度与初始化时相同。重新初始化通常不需要重启副本的 Firebird。在 2026-11-17 的运行中,employee.fdb 的重新初始化确实重启了副本的 Firebird:请为副本连接中断做好准备。那次重新初始化在 master 上耗时 4 秒,负载约为 49 事务/秒;写入停止后,行数一致(两侧的负载表均为 14,418 行)。

Copy at the reinit
Copy at the reinit

该运行的测量结果:

数据库 负载 时间 锁定 其他
employee.fdb ≈55 事务/秒 1.7 秒 0.32 秒 从段中重放了 417 个事务
bulk.fdb 无 61 秒 55 秒 未重启副本的 Firebird

在负载下执行平滑重新初始化后,副本可能会显示 info 警报 replication_conflict_resolved(“正在插入的记录……已存在,改为更新”):副本重放了已在副本中的事务。数据一致:在本次运行中,所有表的行数均一致。你可以确认该警报(报告中的发现 G-07)。

第 8 步。副本磁盘空间不足

副本卷需要至少 105% 的数据库大小加上旧副本之上 1 GB 的可用空间:旧副本会保留到最后,而新文件会立即占用其完整大小。如果空间不足,对话框会显示需要多少空间、有多少可用空间,以及旧副本占用多少空间(RCM 估算;由副本节点决定)。如果在没有旧副本的情况下空间足够,对话框会建议勾选 Remove the old replica if space is short 复选框。

Low space: the “Remove the old replica if space is short” box
Low space: the “Remove the old replica if space is short” box

勾选该复选框后,副本节点会在 master 锁定之后停止副本的 Firebird、删除旧副本,然后再次启动 Firebird。在本次运行中(可用 2.97 GB,新副本需要 3.29 GB,旧副本为 3.13 GB),勾选该复选框后 bulk.fdb 的重新初始化耗时 65 秒。不勾选该复选框时,节点会以 insufficient disk space on replica 拒绝。

当仅缺少 1 GB 的下限时,对话框可能不显示任何数字。在 2026-11-17 的运行中(可用 1.1 GB,数据库为 167 MB),对话框未显示估算值,且不勾选该复选框的重新初始化在 3 秒内失败。数据库行和 Commands 页面显示了原因:insufficient disk space on replica: need 184125850 bytes (105% of the database) + 1073741824 bytes free_space_floor_gb; free 1152950272 … Removing the old replica copy would free 175357952 bytes: ask again with remove_old_replica。勾选该复选框的同一重新初始化耗时 9 秒。

该复选框的风险。 在复制运行期间,此数据库没有副本。如果重新初始化失败,配对状态为 NEEDS_REINIT,副本会有警报 replica_removed_for_reinit(warn),重试则是一次新的完整重新初始化。自动重新初始化仅在 RCM 键 auto_reinit.remove_old_replica_when_short 开启时才会删除旧副本(默认关闭)。

第 9 步。验证

副本行中的 Verify 会比较 master 和副本上跟踪表的 COUNT(*)。它不会比较行本身。“Table list source”一行会指明列表来源:数据库自身的列表、节点的列表、发布表,或 RDB$FIELDS。行数会带有数字分组。

在负载下,副本会落后几秒,Verify 会对正在写入的表给出“Not ok”:

Verify under load
Verify under load

在没有写入时,计数一致:

Verify without load
Verify without load

两个数据库中都不存在的表会显示为“not in the database”:这不是不匹配。仅在一侧存在的表会显示为“no table”:这是不匹配。

更安全的检查是在写入停止后比较两侧所有表的行数(脚本位于 hqbird2027-linux-cluster-runbook.md)。在本次运行中,全部 11 张表均一致(employee.fdb:10 张,bulk.fdb:1 张,共 2,800,000 行)。

定期检查(Data check)默认关闭。点击 Turn on for all nodes 并确认:每个节点会统计其行数,master 会比较这些计数。你不需要重启:RCM 会显示“Saved and in force now: the node needs no restart.”。首次检查会在一个间隔之后运行(默认 2 小时)。

Periodic check
Periodic check

接下来要关注什么

  • Overview:节点、它们的状态、数据库根目录以及磁盘空间。

    Overview
    Overview
  • Alerts:节点和数据库的问题。本次运行有两个警报,你可以确认这两个警报:平滑重新初始化后的 replication_conflict_resolved(第 7 步),以及 master 上的 parse_no_observations(“no events parsed from /opt/firebird/replication.log”)。master 的 Firebird 仅将错误写入 replication.log,因此日志为空是正常的(报告中的发现 G-06)。

    Alerts
    Alerts

    RCM 2027.5.12 及更高版本(套件 2027.2.33)可以将严重级别为 warn 及以上的警报发送到你自己的 Telegram 机器人、webhook 或电子邮件。你在文件 /opt/hqbirdrcm/rcm.json 的 notify.channels 键中设置通道,并重启 RCM(sudo systemctl restart hqbirdrcm)。此页面的 Notification channels 区块随后会列出这些通道,每个通道都有一个 Send test 按钮。没有通道时,它会显示“No channel is configured: RCM sends its alerts nowhere.”。一个 Telegram 通道:

json
  "notify": { "channels": [ { "name": "ops", "type": "telegram",
      "token_file": "secrets/telegram-ops.token", "chat_id": "-1001234567890" } ] }

2026-11-17 的那次运行在没有通道的情况下检查了该块;没有发送任何消息。

  • 服务(RCM 2027.5.11 及更高版本,套件从 2027.2.31 起):服务的主节点、副本和路由器,以及操作 switchover、failover 和 rejoin。本指南不涵盖这些内容:请参阅 RCM 用户指南。在使用它们之前,请将 RCM 和各节点更新到同一版本。

  • 命令:每个 RCM 操作及其结果。时间为浏览器的本地时间及其时区(例如 17:59:45 UTC+1);工具提示显示 UTC 时间。节点日志使用 UTC。

    Commands
    Commands
  • HQ Monitor:http://<server>:23050/,用户名 admin,密码位于 /opt/hqbird/conf/access.properties。它显示服务器和数据库。在带有 agent 3.1.0 及更高版本的套件中,HQ Monitor 具有 Clusters 页面。在主节点(RCM 主机)上,它通过 agent 显示集群,HQ Monitor 中没有 RCM 设置。在副本上,它显示 RCM 的主机名并链接到其控制台。HQ Monitor 1.49.0 没有复制状态,也没有指向 RCM 的链接。从套件 2027.2.33(agent 3.4.0)起,agent 还会将其服务器的问题发送到你的通道:Servers → Notifications。

更新集群

先更新 HQbird RCM,然后更新各节点。从套件 2027.2.31 起,未附加到任何 HQCenter 的服务器会自行更新 agent、HQ Monitor 和 fbmcp(参见 hqbird2027-linux-setup-guide.md 中的“Updates without HQCenter”);附加到 HQCenter 的服务器从该 HQCenter 获取更新。

将主机移出集群

Command
cd /opt/hqbird/fbagent-fb50
sudo ./fbagent --cluster-leave

agent 会停止并注销其节点服务,关闭它们的节点端口,删除其集群证书,并将 cluster.source 设置为 none。节点文件夹会保留(--remove-data 会删除它)。运行 RCM 的 agent 会被拒绝。当 RCM 撤销该 agent 或移除其最后一个成员时,agent 也会自行离开。卸载总是会离开集群:在同一文件夹中重新安装会从空闲状态开始。在 2026-11-17 的运行中,该命令打印了 Cluster: left <cluster id>,副本数据库保留在其文件夹中,而一分钟后 RCM 仍显示该主机的节点。从集群服务器(也包括运行 RCM 的服务器)中移除 HQbird 的方法: hqbird2027-removal-guide.md,第 4 节。

常见错误

你看到的内容 原因 该怎么做
初始化时出现 publication_off 发布已关闭,或者它没有表,尽管数据库中有带键的表 Sync publication and initialize 按钮(第 6 步)
long_transactions … the archive holds no segment yet 在数据库正被写入时使用平滑方法进行首次初始化,且主节点的归档为空 等待“archive: 1 seg”并重试 Smooth,或选择 Standard
reinit_pre_publication_transactions 一个写入事务在发布开启之前开始,并且打开时间超过一分钟 完成它(COMMIT 或 ROLLBACK)并重试
对话框中显示“✗ The folder does not exist on …” 没有人创建副本文件夹 对话框中的 Create folder 按钮,或在副本上执行 install -d -o firebird -g firebird -m 0770 <folder>
Verify 中显示“Not ok (desynced)” 数据库正被写入,且副本落后几秒 在无负载的情况下重试;查看 Match 列
在没有写入的情况下 Verify 中显示“Not ok (desynced)”;两侧都显示“Ok” 一个应用程序连接在发布开启之前打开:它未被日志记录 重新连接应用程序,然后 Reinit(第 6 步,关于首次发布同步的说明)
Link hosts 中主机显示“unreachable”或“no agent” 主机的配对窗口已关闭(默认关闭,或 24 小时已结束),或服务器之间的防火墙关闭了 7450–7459 在主机上打开窗口:HQ Monitor → Clusters → Open the pairing window for 24 hours,或 fbagent --cluster-pairing on;在云防火墙中打开该端口
重新初始化时出现 insufficient disk space on replica 旧副本会保留到最后,而新文件会占用其完整大小 在副本卷上旧文件之上释放 ≥ 数据库大小的 105% + 1 GB,或勾选 Remove the old replica if space is short 框(第 8 步)
Link hosts 之后节点未出现 RCM 镜像中没有已签名的 hqclusternode 发布 Link hosts 页面上的 Releases in the mirror(第 2 步)