安装与更新
安装 毫无意外
每个 Firebird 系列一个安装程序。它会查找服务器上的 Firebird、旧版 HQbird 和代理,显示计划,在你点击“是”之前不做任何更改。之后,代理会自行更新自身、控制台和 Firebird,并带有检查和回滚。
- 4 个安装程序:Firebird 2.5 · 3.0 · 4.0 · 5.0
- 在你确认计划前 0 项更改
- 无需互联网 一切都在一个文件中
- Windows 和 Linux 向导、静默模式、.run
- 回滚 如果安装或更新失败
setup.exe · .run
套件中包含什么
安装程序是一个文件:Windows 上为 hqbird2027-fb50-setup-<version>.exe,Linux 上为 hqbird2027-fb50-linux-<version>.run。它包含服务器所需的一切。不会下载任何内容。
每个安装程序安装一个 Firebird 系列。请选择你的数据库所运行的系列。安装由套件内的代理完成:它检查服务器、构建计划并执行计划。
| 组件 | 功能 | Windows | Linux |
|---|---|---|---|
| Firebird,HQbird 构建版 | 新服务器或就地更新。对于已安装的服务器,会在 firebird.conf 中添加一行:MonitoringPlugin = fblwmon。对于新服务器,安装程序还会设置端口。databases.conf、安全数据库和 SYSDBA 密码不会更改。 | 服务 FirebirdServer… | /opt/firebird |
| fbagent 代理 | 备份、监控、维护、更新。 | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50,用户 firebird |
| HQbird Monitor | 此服务器的 Web 控制台。端口 = 20000 + Firebird 端口:对于 3050 则为 23050。端口在安装时选定,之后不会更改,即使你更改 Firebird 端口。 | HQbirdMonitor-fb50 | hqbirdmonitor-fb50 |
| 集群组件 | 集群程序会被放置到服务器上,但不会启用:RCM 和配对窗口默认关闭。RCM 使服务器成为新集群的中心,并打开端口 7443 和 7444。配对窗口会打开端口 7450–7459 持续 24 小时:通过它,另一台服务器的 RCM 可以邀请此服务器。你也可以在安装后启用两者。 | 向导页面“Replication and cluster setup”;/RCM、/DISCOVERY | --rcm on、--cluster-pairing on |
| fbmcp MCP 服务器 | 供 AI 客户端访问 Firebird。默认仅限本服务器。 | 向导中的复选框或 /NOFBMCP | --no-fbmcp |
| Firebird 调试文件 | 用于分析 Firebird 崩溃的符号。 | — | 是,--no-debug 可将其关闭 |
- Windows支持:Windows 10 和 11、Windows Server 2016 及更高版本,64 位。需要管理员权限。安装程序由 IBSurgeon Software 签名:Windows 会在权限提示中显示发布者。
- 向导或静默模式每个向导页面也可作为开关使用:
/VERYSILENT /YES /LOG=…。适合脚本和上百台服务器。 - 8 种语言的向导英语、葡萄牙语(巴西)、德语、俄语、西班牙语、波兰语、土耳其语、简体中文。默认为 Windows 语言。开关:
/LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN。 - 服务器名称向导会询问新代理的名称;HQCenter 会以此名称显示服务器。默认为计算机名称。静默模式:
/AGENTID=,Linux 上为--agent-id。已安装的代理会保留其名称。
- Linuxx86_64,内核 3.2 或更高版本,systemd,root。Ubuntu、Debian、AlmaLinux、Rocky、RHEL、Oracle Linux、openSUSE、RED OS 以及其他使用 apt、dnf、yum 或 zypper 的系统。
- 无互联网的服务器安装程序会从仓库获取一些操作系统库(libtommath、ICU)。如果没有仓库,它会打印确切的命令,并且不做任何更改。
套件会被检查两次。解包前:整个套件的 sha256。安装 Firebird 和代理前:每个文件的签名。损坏的下载会在对 Firebird、代理或控制台做任何更改之前停止安装。
fbagent --install-plan
先规划,后变更
首先,安装程序只读取:服务、注册表、Firebird 和 HQbird 文件夹。然后它会显示发现了什么以及将做什么。在你点击“是”之后才开始更改。
选择服务器上的内容并查看计划。文本经过缩短和翻译;顺序和决策与 Firebird 5.0 安装程序相同。
- 1服务器检查权限、位数;Linux 上还包括 systemd 和内核
- 2套件检查解包前检查 sha256;安装前检查文件签名
- 3计划发现了什么以及将做什么
- 4问题HQCenter 的服务器名称;停止 Firebird?其他版本?
- 5安装Firebird、代理、控制台、服务
- 6✓ 结果服务、控制台地址、登录
如果出现问题
在计划阶段被拒绝(端口被占用、文件夹非空)不会改变任何内容:安装程序会说明原因。在向导中,只要某个值有误,就无法离开该页面。
安装过程中、代理服务启动之前发生失败:服务会恢复到之前的状态。旧的 HQbird 如果曾被停止,会重新启动。
| 代码 | 含义(Linux .run) |
|---|---|
| 0 | 完成 |
| 1 | 被拒绝:服务器、开关或计划。未做任何更改 |
| 2 | 安装失败,更改已回滚 |
| 3 | 回滚不完整:结果中说明了需要检查的内容 |
| 4 | 需要回答:没有终端且没有 --yes |
| 5 | 安装包未通过检查:请重新下载 |
| 6 | 没有操作系统库且没有软件仓库 |
| 7 | Firebird 来自发行版软件包 |
| 代码 | 含义(Windows setup.exe) |
|---|---|
| 0 | 已安装 |
| 1 | 安装前被拒绝:开关或文件错误、已安装较新版本、没有管理员权限 |
| 4 | 安装程序有疑问,但没有 /YES 开关 |
| 7 | 服务器检查或安装失败。原因见日志和结果文件 |
| 10 | 已安装,但连接 HQCenter 失败 |
-p3050);新安装使用 -fb50。FBDataGuard → fbagent
从 HQbird 2024 迁移
安装程序会找到旧的 HQbird 及其所服务的 Firebird。此 Firebird 将就地更新,FBDataGuard 作业迁移到代理,旧服务被停止。数据库、配置和密码保持不变。
- 不变的内容
databases.conf或aliases.conf、安全数据库、SYSDBA 密码、数据库、备份和旧 HQbird 文件。在firebird.conf中,仅添加MonitoringPlugin = fblwmon这一行(如果缺失)。 - 旧 Firebird 的副本旧 Firebird 的程序文件夹会保留在其旁边,命名为
<folder>.old_<time>。 - 作业gbak 和 nbackup 备份、sweep、索引统计。导入只运行一次,并通过新配置的检查;旧配置会保留。
- 旧备份代理将 FBDataGuard 日志中的备份纳入自己的记录。保留规则和恢复对它们的处理方式与新备份相同。nbackup 级别的名称保持不变。
- 作业名称作业名称以 FBDataGuard 中的数据库名称结尾,例如“Verified backup - MANUAL”。组作业会重复源文件夹的树结构。
- 旧服务:三个选项自动(推荐):当 FBDataGuard 所服务的每个 Firebird 都有代理时禁用它们。全部禁用:
/DISABLEHQBIRD。保持原样:/NOHQBIRD。 - 可以回退每个服务在被禁用之前的状态保存在
fbagent-hqbird-takeover.json中。使用此文件可以重新启用旧 HQbird。 - 许可证旧 HQbird 许可证不会延续。在获取新许可证或连接到 HQCenter 之前,试用期有效。
- 路径不明确如果导入无法展开 FBDataGuard 路径中的替换项,会保持原样并将作业保留为禁用状态。修正路径后启用该作业。
如果作业已导入但旧服务仍在运行(例如,服务器在 FBDataGuard 下有两个 Firebird 服务器),作业会以禁用状态到达。这样,一个作业不会运行两次。
端口 · 文件夹 · 服务
一台机器上的多个 Firebird 服务器
每个 Firebird 一个代理。新实例安装在其他实例旁边,使用自己的端口、自己的代理和自己的控制台。已安装的实例不会改变。
添加 Firebird 服务器,查看安装程序选择哪些名称和端口。
- 按产品线分配端口服务器上的第一个 Firebird 获得 3050。下一个:2.5 为 3052,3.0 为 3053,4.0 为 3054,5.0 为 3055。安装程序不会占用已被使用的端口。
- 同一产品线的第二个实例文件夹和服务名称中带编号
-2。在 Windows 上,这是向导选项“安装另一个实例”;端口是该产品线范围内的第一个空闲端口。
- 仅在同一产品线内更新5.0.x → 5.0.y。从 3.0 迁移到 5.0 意味着在第一个实例旁边安装第二个实例;由人工通过备份和还原迁移数据库。
- Windows 上的 XNET不在 3050 端口上的 Firebird 会获得自己的名称
IpcName = FIREBIRD_<port>。到第二个服务器的本地 XNET 连接可以正常工作。 - 每个代理一个控制台HQbird Monitor 位于 20000 + Firebird 端口:23050、23055。服务器上所有实例共用一个登录文件。
- 端口是固定的控制台和代理本地 API 的端口在安装时写入。如果之后更改 Firebird 端口,它们保持不变。代理不接受相同的端口。
- 集群:每个代理一个槽位服务器上的每个代理获得自己的槽位,从 0 到 9:配对端口 7450 + 槽位,节点端口 7051 + 槽位和 7061 + 槽位。因此,同一台服务器的两个代理可以加入一个集群。
--pairing-port开关可显式设置槽位。
镜像 · compose · 端口
Docker 中的 HQbird
每条 Firebird 产品线都有现成的镜像。Firebird、代理和 HQbird Monitor 在容器中运行。当服务器加入集群时,代理会在容器内部自行安装集群节点。仅当此服务器被指定为集群 RCM 时,才会安装 RCM。
| 镜像 | Firebird | Firebird 端口 | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- 首次启动从套件中复制
compose.yaml,将 SYSDBA 密码放入密钥文件,删除secrets:行中的#,然后运行docker compose up -d。当docker compose ps显示healthy时,服务器即准备就绪。 - Firebird 端口
HQBIRD_FB_PORT变量,默认为 3050。HQbird Monitor 监听 20000 + 此端口。 - 镜像签名镜像使用 cosign 工具签名。用于校验的公钥尚未发布。
- 同一主机上的多个实例Firebird 位于 3050 + N,HQbird Monitor 位于 20000 + Firebird 端口,集群节点位于 7051 + N。主机上只有一个实例可以拥有 RCM。
- 外部和内部使用相同的端口号发布
3051:3051,而不是3051:3050。代理和集群报告它们在容器内部看到的端口。 - 集群成员地址是 Docker 主机的地址。发布节点端口,对于 RCM,还需发布端口 7443 和 7444。
Docker 发布的端口会绕过 ufw。“仅端口 22”的 ufw 规则不会关闭容器端口。请将端口发布到一个主机地址上,或使用外部防火墙将其关闭。
云和 Docker:设置、卷、端口、更新代理 · 控制台 · 集群 · Firebird
安装后的更新
连接到 HQCenter 后,代理会自行更新自身、HQbird Monitor、集群组件、fbmcp 和 Firebird。没有 HQCenter 的服务器也会自行更新:代理从 IBSurgeon 更新服务器获取新版本。
代理会在一分钟内于 HQCenter 中看到自身的新版本。HQbird Monitor、fbmcp 和 Firebird 的新版本:在一小时内。每次更新都遵循同一模式:检查、保存回滚点、替换、确认其正常工作。如果无法正常工作,则恢复旧版本。
没有 HQCenter 时的更新
- 自行更新的内容代理、HQbird Monitor 和 MCP 服务器。检查每 6 小时运行一次。
- Firebird 等待命令Firebird 包会被下载并等待。由管理员应用:通过“更新”页面上的按钮或命令
fbagent --firebird-update --apply。 - 由你选择模式安装开关
--auto-update all|agent|off,在 Windows 上为/AUTOUPDATE=all|agent|off。agent是默认值。all还会在更新窗口内安装 Firebird。off不检查任何内容。
- HQbird Monitor 中的更新页面显示代理从何处获取版本、模式以及服务器的最后响应、Firebird、控制台和 MCP 服务器更新的状态。管理员可以更改模式并应用 Firebird 包。
- 来源检查更新服务器会根据固定的密钥进行检查。始终需要供应商签名。
- 集群通过中心进行集群节点和 RCM 不会以这种方式更新:由 HQCenter 或 RCM 更新它们。
代理自更新
- 仅向前Agent 不会安装比自身更旧的版本,即使是强制版本也不行。检查在下载第一个字节之前进行。这样,伪造的服务器无法恢复旧的易受攻击构建。例外是 Agent 自身配置中允许的一个旧版本(
allow_downgrade_to)。 - 签名发布版本使用 Ed25519 密钥签名;公钥内置于 Agent 中。签名错误一律拒绝。“仅签名"模式在 Agent 自身配置中开启,而非从服务器开启。
- 手动回滚Agent 旁边有一个脚本
rollback_to_version_NNN:它恢复之前的 Agent 和配置,并封锁失败的版本。保留最近两个回滚点;更早的会自动删除。 - Linux:root 只运行自己的副本Agent 以
firebird身份运行。替换由仅 root 可写文件夹中的已验证副本完成。
Firebird 更新
Firebird 仅在其产品线内更新,且仅更新到更新的构建。Agent 可以随时下载并准备软件包,但只在更新窗口内停止 Firebird。
- 1准备下载、签名、构建不旧于引擎
- 2窗口每日窗口;强制发布也等待窗口
- 3作业gbak、nbackup 或 SQL 脚本正在运行:尝试被推迟
- 4替换旧引擎文件被移开,配置保留
- 5检查Firebird 启动并在其端口上响应
- 6✓ 或回滚旧文件恢复,该构建被封锁
| 更新内容 | 保护 | 失败时 |
|---|---|---|
| fbagent agent | 签名、仅更新、180 秒内就绪并运行 45 秒 | 回滚、暂停 30 分钟;第二次失败封锁该版本 |
| HQbird Monitor、集群、fbmcp | 签名、仅更新于已安装版本 | 保留之前的版本;保留最近 2 个副本 |
| Firebird | 窗口、等待备份、启动后检查 | 旧引擎恢复,该构建进入封锁列表 |
被封锁的版本不会再次安装,但下一个版本照常安装。这样,服务器不会陷入"更新 → 回滚 → 更新"的循环。
文件夹 · 日志 · 卸载
文件位置及卸载方法
Windows
C:\HQbird\ Firebird50\ Firebird 5.0、配置、安全数据库 fbagent-fb50\ agent 和 HQbird Monitor agent_config.json agent 配置 logs\ bak\ update\ 日志、副本、更新缓存 C:\HQbirdData\ agent 和控制台工作数据 config\access.properties 控制台登录 C:\ProgramData\fbagent\ 安装结果和日志
Linux
/opt/firebird/ Firebird 5.0(第二条线:/opt/fb50) /opt/hqbird/ conf/access.properties 控制台登录,0600 fbagent-fb50/ agent 和 HQ Monitor agent_config.json agent 配置 logs/ bak/ update/ 日志、副本、更新缓存 /var/lib/hqmonitor/ 控制台数据 /var/log/fbagent/install.log 安装日志,不含密码
- 卸载不会触碰您的数据库您的数据库和备份(
*.fdb、*.gdb、*.fbk、*.nbk)始终保留。删除数据仅删除安全数据库和 Firebird 包中的示例。 - Windows"应用":移除 agent、控制台、此 agent 的 RCM、防火墙规则以及此安装程序作为新安装所安装的 Firebird。如果其他 agent 使用此 agent 的 RCM,向导会询问"仍要移除此实例吗?";静默卸载需要
/FORCE。已更新的 Firebird 会保留。仅当您选择"删除数据"时才会移除配置和安全数据库。
- Linux
--uninstall移除 agent 和控制台服务、此 agent 的 RCM、sudoers 规则以及安装程序在 firewalld 或 ufw 中开放的端口。Agent 会先离开集群。如果其他 agent 使用其 RCM,则需要--force开关。Firebird 会保留。--remove-data还会移除配置、日志和控制台数据。 - 旧版 HQbird卸载 HQbird 2027 不会重新启用旧服务:管理员通过状态文件决定此事。
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2