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

本指南面向从服务器上移除 HQbird 2027 的管理员。 内容涵盖 Windows 安装程序 hqbird2027-fbNN-setup-<version>.exe 和 Linux 安装程序 hqbird2027-fbNN-linux-<version>.run。

示例使用 Firebird 5.0(fb50)。对于 Firebird 2.5、3.0 和 4.0,请在 文件名、文件夹名和服务名中使用 fb25、fb30、fb40。安装过程参见 Windows 安装 和 Linux 安装。

HQbird 2024 请使用之前的说明移除。

1. 开始之前

  1. 做好备份:对每个数据库执行备份(gbak 或 nbackup),并将备份复制到 另一块磁盘或另一台服务器。移除操作不会删除数据库文件,但 备份可以防止误操作。
  2. 停止使用数据库的应用程序。在 Windows 上,移除操作会 停止安装程序所安装的 Firebird。
  3. 集群服务器: 如果此服务器运行集群控制台 RCM,请先在 RCM 中删除 集群并解除其代理的关联(第 4 节)。
  4. HQCenter: 移除操作不会删除 HQCenter 中的服务器记录。 如果之后不打算重新安装 HQbird,请在移除后在那里删除该代理。
  5. 许可证: 带数据选项的移除会删除代理的许可证状态。 如果之后打算重新安装 HQbird,请保留许可证文件。

2. 移除的内容与保留的内容

项目 Windows Linux
HQbird 代理(服务或单元、程序) 移除 移除
HQbird Monitor(服务或单元、防火墙规则) 移除 移除
HQbird 2027 全新安装的 Firebird 移除(服务、程序文件、防火墙规则) 保留
之前已存在、仅被更新的 Firebird 保留 保留
数据库文件(*.fdb、*.gdb、*.fbk、*.nbk) 始终保留 始终保留
代理配置、日志、许可证状态、HQbird Monitor 数据 保留;使用数据选项时移除 保留;使用 --remove-data 时移除
Firebird 的安全数据库和 *.conf 文件 保留;使用数据选项时移除 保留
更新时被关闭的旧版 HQbird(2024 及更早版本)服务 保持关闭 保持关闭

Windows 上的数据选项只移除 HQbird 2027 安装程序创建的内容。 在首次 HQbird 2027 安装之前就已存在的代理数据会保留。

3. Windows

应用和功能 中的一项 = 一个 Firebird 产品线。某一产品线的卸载程序会移除 该产品线的所有实例。请以管理员身份运行它。

3.1. 移除整个产品线

  1. 打开 设置 → 应用 → 应用和功能(或 程序和功能)。
  2. 选择 HQbird 2027 (Firebird 5.0),然后单击 卸载。
  3. 确认移除。
  4. 回答关于数据的问题:否 保留配置和 安全数据库,是 则一并移除。
  5. 等待显示 HQbird 已被移除的消息。

对服务器上的每个 Firebird 产品线重复这些步骤(每个产品线 对应一项)。

3.2. 移除单个实例

当某个产品线有多个实例而您只想移除其中一个时,请使用此方法。

  1. 打开 开始 → HQbird 2027 (Firebird 5.0) 维护。
  2. 选择 移除实例,然后选择该实例。
  3. 确认,然后回答关于数据的问题。

当您移除最后一个实例时,该产品线的 HQbird 2027 即被移除。

3.3. 静默移除

Command
# programs and services; databases, configs and the security database stay
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT
# the same, and the agent data, HQbird Monitor data, the security database and *.conf too
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT /REMOVEDATA
# remove also an instance that runs the RCM of a cluster (section 4)
& 'C:\HQbird\setup\fb50\unins000.exe' /VERYSILENT /FORCE

卸载程序所在的文件夹为 <HQbird folder>\setup\fb50。由 2027.2.8 之前的 安装程序安装的产品线,其卸载程序位于 C:\Program Files\IBSurgeon\HQbird 2027\fb50。确切的文件夹是 应用条目中的 InstallLocation 值:

Command
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString

3.4. 检查结果

Command
Get-Service | Where-Object Name -match 'HQbird|Firebird|hqbirdrcm|hqclusternode'
Test-Path 'HKLM:\SOFTWARE\IBSurgeon\HQbird2027\fb50'
Get-NetFirewallRule -DisplayName 'HQbird Monitor*', 'Firebird *' -ErrorAction SilentlyContinue

预期结果:该产品线没有 HQbird 服务,且注册表项返回 False。 卸载程序仅在完全移除后才会删除注册表项。如果 该项仍然存在,请再次运行卸载程序。

3.5. 磁盘上保留的内容

文件夹 内容 是否手动删除?
C:\HQbird\Firebird50\ 数据库文件;未使用数据选项时还包括安全数据库和 *.conf 在移走数据库之后
C:\HQbird\fbagent-fb50\ 代理配置和日志(当您保留了数据时) 是,如果不需要它们
C:\HQbirdData\ 代理工作数据、HQbird Monitor 数据和登录文件(当您保留了数据时) 是,如果不需要它们
C:\HQbird\hqbirdrcm\ RCM 数据(仅在数据选项下才会移除) 是,在集群已不存在之后
C:\ProgramData\fbagent\ install.log,上次安装程序运行的结果 是
C:\ProgramData\HQbird\fbagent\ 静默安装的 SYSDBA 密码文件 是
<Firebird folder>.old_<time> 更新时旧 Firebird 程序文件夹的副本 是,在确认更新之后

fbmcp 服务由服务器上的所有产品线共享。当另一个产品线仍在使用它时, 它会保留;它随最后一个产品线一起被移除。

4. 集群中的服务器

运行 RCM 的代理持有集群 CA。当其他代理使用 该 RCM 时,移除操作会被拒绝,且不会更改任何内容。

建议的顺序:

  1. 在 RCM 控制台中删除集群并解除其代理的关联。
  2. 从成员服务器上移除 HQbird。
  3. 从运行 RCM 的服务器上移除 HQbird。

如果仍要移除 RCM 所有者:

  • Windows,对话框: 卸载程序会询问“仍要移除此实例吗? 集群将失去其 RCM CA。”回答 是。
  • Windows,静默: 添加 /FORCE。否则运行 RCM 的实例会保留,日志中会说明原因。
  • Linux: 安装程序会以退出码 5 停止。请使用 --force 再次运行它。

强制移除后,集群将没有 CA:无法签发新证书,也无法 添加新成员。要让另一个代理成为新 RCM 的所有者,请在那里运行 fbagent --cluster-init <id> --rcm-takeover,然后重新关联成员。

5. Linux

以 root 身份运行安装 HQbird 时所用的同一个 .run 文件(或同一产品线的 更新版本)。示例使用版本 2027.2.33。

5.1. 移除代理和 HQbird Monitor

Command
# the agent and HQbird Monitor; Firebird, databases, configuration and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall
Command
# the same, and the agent folder (configuration, logs, license state) and HQbird Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --remove-data

该命令会停止并移除单元 hqbirdfbagent-fb50 和 hqbirdmonitor-fb50、程序 fbagent 和 hqmonitor,以及 代理的 sudoers 规则。它会关闭安装时在 firewalld 或 ufw 中 打开的 HQbird Monitor 端口。

5.2. 一台主机上的多个实例

如果不指定 --agent-dir,安装程序会移除 /opt/hqbird 中唯一的代理。如果有多个代理,它会以退出码 1 停止并列出 它们的文件夹。请指定文件夹:

Command
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

对每个代理运行一次该命令。共享的 HQbird Monitor 登录 文件会保留,直到最后一个代理被移除。

5.3. 移除 Firebird(可选,手动)

安装程序从不在 Linux 上移除 Firebird。只有在您 做好备份并将数据库移出 Firebird 文件夹之后,才手动执行此操作。

Firebird 单元名称:

Firebird 文件夹 版本行 单元
/opt/firebird 2.5, 4.0, 5.0 firebird
/opt/firebird 3.0 firebird-superserver
另一个文件夹,例如 /opt/fb50-2 4.0, 5.0 firebird.opt_fb50-2
另一个文件夹,例如 /opt/fb30 3.0 firebird.opt_fb30-superserver

位于 /opt/fb50-2 的 Firebird 示例:

Command
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _)          # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*"             # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B

警告: rm -rf 会删除该文件夹中的所有内容,包括其中的数据库和安全数据库。请先检查该文件夹。

5.4. 检查结果

Command
systemctl list-unit-files 'hqbird*' 'hqclusternode*' 'firebird*' --no-legend
ls /opt/hqbird /var/lib/hqmonitor 2>/dev/null

预期:没有 hqbirdfbagent-fb50 和 hqbirdmonitor-fb50 单元。除非你手动删除了 Firebird,否则 Firebird 单元仍然存在。

5.5. 磁盘上剩余的内容

路径 内容 是否手动删除?
/opt/hqbird/fbagent-fb50/ 代理配置和日志(未使用 --remove-data) 是,如果你不需要它们
/var/lib/hqmonitor/ HQbird Monitor 数据(未使用 --remove-data) 是,如果你不需要它们
/opt/hqbirdrcm/ RCM,当主机的其他代理仍在使用它时 集群消失后
/opt/fbagent-update-backup/ 被更新替换的 Firebird 程序文件 是,在确认更新后
/opt/hqbird/fbagent-hqbird-takeover.json 更新前较旧 HQbird 单元的状态 如果你计划回退到较旧的 HQbird,请保留它
/opt/firebird(或你的 Firebird 文件夹) Firebird 及其数据库 第 5.3 节

5.6. --uninstall 的退出代码

代码 含义 如何处理
0 已移除 —
1 拒绝:主机上有多个代理,或选项错误 添加 --agent-dir 并指定列表中的文件夹
5 拒绝:此代理运行主机的 RCM,且其他代理正在使用它 第 4 节

6. 移除后的较旧 HQbird

当 HQbird 2027 替换较旧的 HQbird(2024 及更早版本)时,更新会关闭较旧 HQbird 的服务。移除 HQbird 2027 不会 再次开启它们。它们在更新前的状态保存在:

  • Windows:<HQbird folder>\fbagent-hqbird-takeover.json
  • Linux:/opt/hqbird/fbagent-hqbird-takeover.json

使用此文件查看哪些服务处于活动状态,如果你回退到较旧的 HQbird,请手动启动它们。

7. 故障排除

问题 如何处理
Windows:移除后 应用和功能 中的条目仍然存在 某个实例未被移除(通常是运行 RCM 的那个)。再次运行卸载程序;关于 RCM 所有者,请参见第 4 节
Windows:出现一般错误和来自旧卸载程序的命令 代理已自行更新到 3.1.0 或更新版本,并拒绝移除 RCM 所有者。在显示的命令中添加 --force,或运行较新安装程序的卸载程序
Windows:测试版本 2027.0.1 和 2027.0.2 它们对所有版本行使用同一个条目。请使用它们自带的卸载程序移除
Linux:--uninstall 被拒绝,退出代码 1 主机上有多个代理:添加 --agent-dir(第 5.2 节)
Linux:--uninstall 被拒绝,退出代码 5 该代理运行主机的 RCM:第 4 节
Linux:run as root (sudo sh ...) 使用 sudo 或以 root 身份运行安装程序
Linux:.run 文件丢失 重新下载同一版本行的安装程序;同一版本行的较新版本也可以使用