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

安装 毫无意外

每个 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 系列。请选择你的数据库所运行的系列。安装由套件内的代理完成:它检查服务器、构建计划并执行计划。

组件功能WindowsLinux
Firebird,HQbird 构建版新服务器或就地更新。对于已安装的服务器,会在 firebird.conf 中添加一行:MonitoringPlugin = fblwmon。对于新服务器,安装程序还会设置端口。databases.conf、安全数据库和 SYSDBA 密码不会更改。服务 FirebirdServer…/opt/firebird
fbagent 代理备份、监控、维护、更新。HQbirdFBAgent-fb50hqbirdfbagent-fb50,用户 firebird
HQbird Monitor此服务器的 Web 控制台。端口 = 20000 + Firebird 端口:对于 3050 则为 23050。端口在安装时选定,之后不会更改,即使你更改 Firebird 端口。HQbirdMonitor-fb50hqbirdmonitor-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. 1服务器检查权限、位数;Linux 上还包括 systemd 和内核
  2. 2套件检查解包前检查 sha256;安装前检查文件签名
  3. 3计划发现了什么以及将做什么
  4. 4问题HQCenter 的服务器名称;停止 Firebird?其他版本?
  5. 5安装Firebird、代理、控制台、服务
  6. 6✓ 结果服务、控制台地址、登录

如果出现问题

在计划阶段被拒绝(端口被占用、文件夹非空)不会改变任何内容:安装程序会说明原因。在向导中,只要某个值有误,就无法离开该页面。

安装过程中、代理服务启动之前发生失败:服务会恢复到之前的状态。旧的 HQbird 如果曾被停止,会重新启动。

代码含义(Linux .run)
0完成
1被拒绝:服务器、开关或计划。未做任何更改
2安装失败,更改已回滚
3回滚不完整:结果中说明了需要检查的内容
4需要回答:没有终端且没有 --yes
5安装包未通过检查:请重新下载
6没有操作系统库且没有软件仓库
7Firebird 来自发行版软件包
代码含义(Windows setup.exe)
0已安装
1安装前被拒绝:开关或文件错误、已安装较新版本、没有管理员权限
4安装程序有疑问,但没有 /YES 开关
7服务器检查或安装失败。原因见日志和结果文件
10已安装,但连接 HQCenter 失败
向导中的计划。“在此计算机上找到”和“安装程序将执行以下操作”。底部:在点击“安装”之前不会做任何更改。
结果。已安装的内容、从此计算机和从另一台计算机访问的控制台地址、登录密码所在位置。取自早期构建:其中代理服务和文件夹名称使用端口(-p3050);新安装使用 -fb50。

FBDataGuard → fbagent

从 HQbird 2024 迁移

安装程序会找到旧的 HQbird 及其所服务的 Firebird。此 Firebird 将就地更新,FBDataGuard 作业迁移到代理,旧服务被停止。数据库、配置和密码保持不变。

从 HQbird 2024 迁移:FBDataGuard 作业迁移到 HQbird 2027 代理,Firebird 就地更新,旧 HQbird 服务被禁用
  • 不变的内容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 开关可显式设置槽位。
同一产品线的两个实例。计划会识别两个 Firebird 服务器和两个代理,并且只更改选定的实例。

镜像 · compose · 端口

Docker 中的 HQbird

每条 Firebird 产品线都有现成的镜像。Firebird、代理和 HQbird Monitor 在容器中运行。当服务器加入集群时,代理会在容器内部自行安装集群节点。仅当此服务器被指定为集群 RCM 时,才会安装 RCM。

镜像FirebirdFirebird 端口HQbird Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050
  • 首次启动从套件中复制 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 自更新:检查、回滚点、替换、180 秒内就绪、运行 45 秒;失败时:回滚、暂停 30 分钟、第 2 次失败后封锁该版本
  • 仅向前Agent 不会安装比自身更旧的版本,即使是强制版本也不行。检查在下载第一个字节之前进行。这样,伪造的服务器无法恢复旧的易受攻击构建。例外是 Agent 自身配置中允许的一个旧版本(allow_downgrade_to)。
  • 签名发布版本使用 Ed25519 密钥签名;公钥内置于 Agent 中。签名错误一律拒绝。“仅签名"模式在 Agent 自身配置中开启,而非从服务器开启。
  • 手动回滚Agent 旁边有一个脚本 rollback_to_version_NNN:它恢复之前的 Agent 和配置,并封锁失败的版本。保留最近两个回滚点;更早的会自动删除。
  • Linux:root 只运行自己的副本Agent 以 firebird 身份运行。替换由仅 root 可写文件夹中的已验证副本完成。

Firebird 更新

Firebird 仅在其产品线内更新,且仅更新到更新的构建。Agent 可以随时下载并准备软件包,但只在更新窗口内停止 Firebird。

  1. 1准备下载、签名、构建不旧于引擎
  2. 2窗口每日窗口;强制发布也等待窗口
  3. 3作业gbak、nbackup 或 SQL 脚本正在运行:尝试被推迟
  4. 4替换旧引擎文件被移开,配置保留
  5. 5检查Firebird 启动并在其端口上响应
  6. 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 不会重新启用旧服务:管理员通过状态文件决定此事。
Linux,卸载一个实例(Firebird 和数据库保留):
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

← 返回 HQbird 2027 概览 · 服务器健康 →