HQbird 2027 移除
本指南面向从服务器上移除 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. 开始之前
- 做好备份:对每个数据库执行备份(
gbak或nbackup),并将备份复制到 另一块磁盘或另一台服务器。移除操作不会删除数据库文件,但 备份可以防止误操作。 - 停止使用数据库的应用程序。在 Windows 上,移除操作会 停止安装程序所安装的 Firebird。
- 集群服务器: 如果此服务器运行集群控制台 RCM,请先在 RCM 中删除 集群并解除其代理的关联(第 4 节)。
- HQCenter: 移除操作不会删除 HQCenter 中的服务器记录。 如果之后不打算重新安装 HQbird,请在移除后在那里删除该代理。
- 许可证: 带数据选项的移除会删除代理的许可证状态。 如果之后打算重新安装 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. 移除整个产品线
- 打开 设置 → 应用 → 应用和功能(或 程序和功能)。
- 选择 HQbird 2027 (Firebird 5.0),然后单击 卸载。
- 确认移除。
- 回答关于数据的问题:否 保留配置和 安全数据库,是 则一并移除。
- 等待显示 HQbird 已被移除的消息。
对服务器上的每个 Firebird 产品线重复这些步骤(每个产品线 对应一项)。
3.2. 移除单个实例
当某个产品线有多个实例而您只想移除其中一个时,请使用此方法。
- 打开 开始 → HQbird 2027 (Firebird 5.0) 维护。
- 选择 移除实例,然后选择该实例。
- 确认,然后回答关于数据的问题。
当您移除最后一个实例时,该产品线的 HQbird 2027 即被移除。
3.3. 静默移除
# 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 值:
Get-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*' | Where-Object DisplayName -like 'HQbird 2027*' | Select-Object DisplayName, InstallLocation, UninstallString3.4. 检查结果
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 时,移除操作会被拒绝,且不会更改任何内容。
建议的顺序:
- 在 RCM 控制台中删除集群并解除其代理的关联。
- 从成员服务器上移除 HQbird。
- 从运行 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
# the agent and HQbird Monitor; Firebird, databases, configuration and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.33.run --uninstall# 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 停止并列出
它们的文件夹。请指定文件夹:
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 示例:
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. 检查结果
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 文件丢失 |
重新下载同一版本行的安装程序;同一版本行的较新版本也可以使用 |