本文档列出 HQbird 2027 的变更,最新的在前。每一部分 以发布编号及其日期开头。新发布把它的 部分加在顶部;它下面的部分保持原样。

  • 2027.2.34 及以后:每个发布一个部分。
  • 2027.2.33:该发布时的整个 HQbird 2027,与 HQbird 2024 相比。
  • 从 2027.2.8 到 2027.2.33 的每个套件的说明位于 hqbird2027-whats-new-2027.2.8-2027.2.33.md ,在下载站点上。

安装程序:HQbird 2027 下载。

下载:https://ib-aid.com/download/hqbird/v2027/ (适用于 Firebird 2.5、3.0、4.0 和 5.0 的 Windows 安装程序 .exe 和 Linux .run; SHA256SUMS 含有校验和)。 Docker 镜像:ghcr.io/ibsurgeon/hqbird2027-fb25、-fb30、-fb40、-fb50。


2027.2.35 (2026-11-18)

版本

组件 版本 是否变更
HQbird 代理(fbagent、enroll) 3.6.0 是
HQbird Monitor 1.59.0 是
配置编辑器(位于 HQbird Monitor 中) 1.63.0 是
HQbird RCM 2027.5.13 是
HQCluster 节点 2027.5.13 是
fbmcp(面向 Firebird 的 MCP 服务器) 2027.2.24 否
Firebird 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 否

集群:主库数据库备份并还原之后的重新初始化

  • 对主库数据库做备份并还原(gbak)会给它一个新的 GUID,副本便无法再 应用该主库的复制日志。节点在几秒内看到这一点,暂停向每个副本的传输(原因是 master_db_replaced),并把主库设为 NEEDS_REINIT,和以前一样。
  • 新增:RCM 按 rcm.json 中的设置 auto_reinit.on_master_restore 决定下一步做什么(设置页面上也有这项设置):
    • auto:RCM 自行重新初始化该数据库的每一个副本,等待 300 秒之后(auto_reinit.master_restore_settle_sec);
    • window:RCM 在其自动重新初始化窗口中重新初始化它们;
    • propose:RCM 不启动任何东西,并等待操作员。
  • 没有这项设置时没有任何变化:自动重新初始化开启时为 window, 关闭时为 propose。
  • 数据库页面上主库数据库的那一行说明发生了什么,以及 RCM 做什么。新按钮 立即重新初始化全部副本开始逐个重新初始化全部副本。暂停会把它推迟。
  • 节点对数据库文件的任何替换都有反应:手工做的还原,或代理的 备份-还原循环。已在 Firebird 2.5、3.0 和 5.0 上检查。警报 master_db_replaced 发到 RCM 的通知通道。

集群:HQbird 2024(FBDataGuard)的复制转到 RCM

  • 在从 HQbird 2024 更新而来的服务器上,代理读取 FBDataGuard 的复制 设置(角色、复制日志文件夹和归档文件夹、副本目标),并把它们交给 RCM。
  • RCM 自行链接副本主机。它无法链接的主机在链接主机页面上显示为候选。
  • 然后 RCM 按原样接管这些数据库的复制。它不重新初始化副本,不重启 Firebird,也不删除文件。FBDataGuard 仍在运行时,它会等待。
  • 页面设置 → 从 FBDataGuard 导入显示导入的状态,并重新执行这次导入。命令行有 hqbirdrcm dg-import status 和 hqbirdrcm dg-import retry。
  • 节点读取 FBDataGuard 写在 replication.conf 中的块,以及它重命名为 .uploaded 的日志段。
  • 该导入已在 Linux 服务器上测试。

RCM:数据库页面

  • 发布开启的主库那一行显示发布中有多少张表,以及操作员取出了多少张,例如 publication on · tables: 118 · taken out: 2。

安装程序:第一个 RCM 密码

  • 带 RCM 的安装完成之后,Linux 安装程序在终端上显示生成的 rcmadmin 密码,并给出该密码文件的路径。Windows 安装程序在结果页上显示该密码。
  • 密码只在终端上显示。它不会写入日志、管道或安装结果文件。

HQbird Monitor:时间范围的时间

  • 时间范围的时间字段(仪表板、数据库页面、日志、 错误)是两个键入字段,小时和分钟,用来代替列表。 向上和向下的箭头把一个值改变 1,: 从小时移到 分钟,一个短列表按 15 分钟一步给出选项。

HQbird Monitor 中的配置编辑器

  • 时间戳是精确的时间。它距今多久(“23 分钟前”)显示在工具提示中。
  • 备份作业的结果面板有一行大小:该次运行的备份文件,以及 它的测试还原所建立的数据库。
  • 代理的配置页面适合手机和 1280 px 的屏幕:选项卡行会换行,设置把各项显示为一条滚动的行, 作业表和备份表在 1280 px 时不再横向滚动。

修复

  • 从 HQbird 2024 更新而来的服务器上,HQbird 3.0 在集群设置之后没有启动 (“Incorrect version of replication config file”):Firebird 从 plugins 文件夹加载了复制插件的旧副本。 该副本现在留在该文件夹之外。
  • 节点应用 limits.rescan_interval_sec 的变更,无需重启。

升级

  • 使用 2027.2.35 的 Windows 安装程序或 Linux .run 进行安装或更新。开启自动更新的 服务器会自行取得代理 3.6.0 和 HQbird Monitor 1.59.0。
  • 在集群中,请在节点之前更新 RCM,或同时更新。RCM 2027.5.13 可以与较旧的节点一起工作;从 FBDataGuard 导入需要节点 2027.5.13。
  • 集群的主库数据库上的计划备份-还原循环:把 auto_reinit.on_master_restore 设为 auto。否则,循环之后副本收不到 变更,直到操作员开始重新初始化。
  • Docker:拉取 2027.2.35 镜像,并在相同 卷上启动新容器。

2027.2.34 (2026-11-17)

版本

组件 版本 是否变更
HQbird 代理(fbagent、enroll) 3.5.0 是
HQbird Monitor 1.58.0 是
配置编辑器(位于 HQbird Monitor 中) 1.62.0 是
fbmcp(面向 Firebird 的 MCP 服务器) 2027.2.24 否
HQbird RCM 2027.5.12 否
HQCluster 节点 2027.5.12 否
Firebird 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 否

gbak 作业的日志被完整保留

  • 以前,代理会把大于 16 MiB 的 gbak 日志中间部分裁掉。现在, 备份或还原作业每一阶段的日志是一个 .log.zip 归档, 包含 gbak 打印的全部内容。
  • 归档旁边,代理保留一个小文本文件,其中有输出和错误的最后 100 行。
  • 在配置编辑器中,下载日志保存该归档。新按钮 最后几行位于作业的日志行和还原历史中,显示 日志的末尾,无需下载。
  • 大于 30 MB 的归档不会发送到 HQCenter。它的行写着 仅保留在服务器上,下载日志显示 归档在服务器上的路径。最后几行仍会发送。
  • 较早版本写入的日志(.log.gz)予以保留,并按 以前的方式下载。

手机上的 HQbird Monitor

  • 在宽度为 768 px 或更窄的屏幕上,页眉是一行:返回箭头、 服务器名称和一个菜单按钮。该按钮以面板形式打开服务器菜单、 设置、语言和注销。以前,页眉占 三行,并显示七个菜单项中的四个。
  • 时间范围是一个按钮。它以面板形式打开日期、间隔和 预设。日志、错误和冲突的包含与排除过滤器折叠在过滤器按钮下。
  • 在宽度为 600 px 或更窄的屏幕上,服务器、仪表板的数据库、 错误和日志记录显示为卡片。没有内容横向滚动。
  • 按钮和字段至少高 44 px,字段文字为 16 px,因此在 iPhone 上的 Safari 中点按字段时页面不会缩放。

HQbird Monitor 中的数据库页面

  • 数据库页面保留服务器菜单:日志、配置、错误、冲突、 性能报告、作业和备份只需一次点击。以前,数据库 项占据了服务器菜单的位置。
  • 数据库项(数据库、指标、客户端版本、统计、 性能报告)排在页眉下方的一行中。该行以 DB标签和数据库名称开头,滚动时保持在原位。
  • 单击数据库名称可查看该服务器的数据库:每个数据库的名称、 路径和大小。另一个数据库在同一页面、同一天 和同一时间范围打开。从 8 个数据库起,列表带有搜索字段。
  • 当某个数据库在数据库列表中被选中时,性能报告显示该数据库的行。
  • 数据库页面上的徽标不再是指向仪表板的链接; 服务器名称才是该链接。
  • 用户指南(英语和巴西葡萄牙语)已更新,并有新的 图片。

Linux 安装程序

  • ALT Linux。在干净的 ALT 11 上,Firebird 3.0、4.0 和 5.0 的套件 以代码 6 停止,因为安装程序询问的是 Debian 软件包名称。 安装程序现在识别 ALT Linux,并安装正确的软件包。
  • 仅一个组可使用 sudo。在只有某个组可以运行 sudo 的系统上(ALT Linux:组 wheel),安装会回滚。 安装程序现在把代理的账户加入该组,并说明这一点。当该组可以不输入 密码运行每一条命令,或只有 root 可以运行 sudo 时,它会 停止,并给出原因。
  • 失败的安装不留下任何东西。回滚现在会停止 从已删除文件夹运行并占用端口的 Firebird 服务,并 删除代理文件夹及其 sudoers 文件。下一次尝试从 干净状态开始。
  • SELinux。在 AlmaLinux 8 上,HQbird Monitor 没有被安装:它的单元 文件有错误的 SELinux 标签。安装程序现在会设置该标签。

Docker 镜像

  • 集群路由器(HAProxy)现在在容器中启动。以前, 路由器服务在镜像中不会启动。
  • 在旧容器的卷上新建容器,且卷上已有路由器时, 不再停在重启循环中。

修复

  • 手机上的 HQbird Monitor:对于其代理没有配置编辑器的 服务器,显示出了作业和备份项。

升级

  • 使用 2027.2.34 的 Windows 安装程序或 Linux .run 进行安装或更新。开启自动更新的 服务器会自行取得代理 3.5.0 和 HQbird Monitor 1.58.0。
  • HQCenter 需要 HQbird Monitor 1.58.0 才能下载其代理的新 .log.zip 日志。请在代理之前更新 HQCenter,或同时 更新。
  • 位于 HQbird Monitor 前面、过滤响应内容类型的前置代理 必须允许 api/joblog 上的 application/zip。
  • Docker:拉取 2027.2.34 镜像,并在相同 卷上启动新容器。

2027.2.33 (2026-11-16):HQbird 2027 与 HQbird 2024 的比较

源代码状态截至 2026-11-16。已发布的套件是 2027.2.33 (2026-11-16)。这一部分给出相对于 HQbird 2024 的完整全貌。

1. 概述

  • Java 工具 FBDataGuard 已被替换。它的工作现在由 服务 fbagent 和 Web 控制台 HQbird Monitor 完成。
  • 新增:HQbird Cluster。集群管理器(RCM)和每台服务器上的一个节点 可从网页设置副本、切换、故障转移和重新加入。
  • 新增:HQCenter。您自己的中央服务器,用于多台 HQbird 服务器:一个 控制台、配置下发、更新、许可证、问题监视。
  • 新增:fbmcp。一个 MCP 服务器,让 AI 助手能够作为 Firebird DBA 工作。关键变更需要 AI 客户端之外的人员批准。
  • 新安装程序。每个 Firebird 主版本一个离线安装程序,适用于 Windows (.exe)和 Linux(.run),一台服务器上可有多个 Firebird 主版本和多个 实例。每个主版本都有 Docker 镜像。
  • 新许可。签名的许可证文件、7 天无需注册的 试用、许可证区域 EU / RU / BR。
  • 自动更新代理、HQbird Monitor、fbmcp、集群 程序和 Firebird,带有签名校验和回滚。
  • 引擎。NGRAM 索引、物化视图、CREATE INDEX CONCURRENTLY、 CREATE TABLE AS SELECT、高级 trace 选项、每个数据库的连接数限制、 Linux 上的 Active Directory 登录。

2. 组件:2024 与 2027

HQbird 2024 HQbird 2027
FBDataGuard(Java,端口 8082 上的 Web 控制台) fbagent(服务)+ HQbird Monitor(Web 控制台)+ Monitor 内的配置编辑器
Advanced Monitoring Viewer(AMV)、桌面工具 HQbird Monitor 页面:仪表板、性能报告、错误、冲突、统计
手动或在 FBDataGuard 中设置复制,手动故障转移 HQbird Cluster:RCM + 节点、切换、故障转移、路由器
无中央服务器 用于服务器群的 HQCenter(Linux)
无 AI 工具 fbmcp,一个约有 120 个工具的 MCP 服务器
一个带组件的 Windows 安装程序、一个 Linux 脚本 每个 Firebird 主版本一个离线安装程序,.exe 和 .run,Docker 镜像
通过电子邮件和密码激活 签名的许可证文件、试用、许可证区域
来自 FBDataGuard 的电子邮件警报 来自 HQCenter 状态监视的电子邮件;来自代理的 Telegram、webhook 和电子邮件

3. 版本

组件 套件 2027.2.33 中的版本
Firebird(HQbird 构建) 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917
fbagent 3.4.0
HQbird Monitor 1.57.0
配置编辑器(位于 Monitor 中) 1.61.0
HQbird RCM / 集群节点 2027.5.12
fbmcp 2027.2.24
HQCenter(goafts、站点栈) 1.22.0
fblogspacker(位于 fbagent 内) 1.5.12

4. Firebird 引擎(HQbird 构建)

HQbird 构建的 Firebird 具有服务器级功能(插件和核心 变更),同一版本的 vanilla Firebird 没有这些功能。下表 列出每项功能以及具备该功能的 Firebird 主版本。来源是 页面 HQbird 2027 服务器级改进。

功能 作用 参数 主版本
NGRAM 索引 对 VARCHAR 和文本 BLOB 的索引子串搜索(LIKE '%search%') - 5.0
物化视图 CREATE MATERIALIZED VIEW,用于 BI 和复杂查询。使用批量插入 - 5.0
以查询结果建表 CREATE TABLE AS SELECT。使用批量插入 - 5.0
负载下创建索引 CREATE INDEX ... CONCURRENTLY:表保持可用 - 5.0
更快的 MON$ 表 关闭不需要的数据采集 FillMonCompiledStatements, FillMonStatements, FillMonCallStack 5.0
便于迁移到 5.0 识别旧式字面量;为旧应用程序把 COUNT(*) 描述为 INT LegacyTimeLiterals, LegacyIntForCount 5.0
GSSAPI/SSPI 身份验证 用于 Active Directory 的 gssauth 插件;Windows 和 Linux 服务器与客户端 - 5.0
不记录 INET 错误 网络错误不写入 firebird.log DisableLogNetIOErrors 5.0
轻量监控 无负载地跟踪服务器状态 MonitoringPlugin 2.5, 3.0, 4.0, 5.0
数据库连接数限制 防止连接突增 WarnCountAttachments, MaxCountAttachments 3.0, 4.0, 5.0
高级 trace 选项 跟踪冲突(死锁)和变更(例如变更审计) - 3.0, 4.0, 5.0
即时查询替换 服务器替换查询文本。新文本在 trace 和 MON$ 中可见 SqlSubstDirectory 2.5, 3.0, 4.0, 5.0
临时空间中的 BLOB 缓存 BLOB 快 15-200% BlobTempSpace 2.5, 3.0, 4.0, 5.0
大排序查询的日志 查询文本写入 firebird.log TempSpaceLogThreshold 2.5, 3.0, 4.0, 5.0
外部数据源:MySQL 和 ODBC 通过 EXECUTE STATEMENT ... ON EXTERNAL 访问 MySQL 和 ODBC - 3.0, 4.0, 5.0
流式 / CDC(Kafka、RabbitMQ、JSON、Mongo) 基于复制,发送所选表的 INSERT/UPDATE/DELETE。按需提供 - 4.0, 5.0
全文搜索(Lucene) 开源 UDR,以及基于流式传输的插件 - 3.0, 4.0, 5.0
缓存参数自动校正 校正 firebird.conf / databases.conf 中错误的 DefaultDbCachePages 值 DefaultDbCachePages, MinDbCachePages, MaxDbCachePages 4.0, 5.0
HQbird 版本掩码 设置 Firebird API 是否返回 HQbird 版本字符串 HQbirdVersionString 2.5, 3.0, 4.0, 5.0
数据库加密(插件) AES-256,开销 4-20%。按需提供 - 3.0, 4.0, 5.0
JOIN 优化器 隐式内连接变为显式 LeftJoinConversion 3.0, 4.0
已准备查询的缓存 已准备的查询留在连接内存中 DSQLCacheSize 3.0, 4.0
多线程备份、还原、sweep、索引创建 备份和 sweep 最多快 4-6 倍,还原快 2-4 倍(8 核、SSD) - 2.5, 3.0, 4.0
原生复制 插件;可以排除没有 PK/UK 的记录 - 2.5, 3.0
大排序优化器 Refetch 计划 SortDataStorageThreshold 2.5, 3.0
并行数据读取 make_dbkey() 和共享快照 - 2.5, 3.0
外部连接池 对 Firebird 的并行外部查询 ExtConnPoolSize, ExtConnPoolLifeTime 2.5, 3.0
备份到 Amazon S3(插件) 按需提供 - 未说明

5. fbagent:取代 FBDataGuard 的代理

一个代理服务一个 Firebird 实例。一台主机上可以运行多个代理。 代理在 Windows 和 Linux 上与 Firebird 2.5、3.0、4.0 和 5.0 一起工作。

5.1 备份

  • 已验证备份(gbak),针对一个数据库或一组文件夹中的数据库, 可选测试还原。
  • 增量 nbackup,级别 0 到 4,简单、高级或组模式。
  • nbackup 计划模式:规则给出级别、日期和时间。编辑器 显示日历和存储预测。保留策略保留一个 0 级及其 增量。
  • 备份-还原循环:备份、还原并交换正在使用的数据库, 崩溃后可回滚。
  • 还原作业,来自 .fbk 或 .nbk,本地或来自 S3。
  • 压缩:deflate、zip、gz、zstd。
  • 加密:带密钥托管的 AES-256 zip 归档。
  • 云:流式备份到 S3,无需本地文件;复制到 S3 和 FTP/FTPS。
  • 备份清单:每个备份文件和每次还原的记录, 含大小、时间和验证结果。
  • 命令历史:每个作业最多 50 次启动,含 gbak 日志。

5.2 维护

  • sweep、索引统计、gfix 验证、带运行窗口的 SQL 脚本、 元数据跟踪。
  • 每个作业都有 cron 计划和执行窗口。
  • 重要作业的立即运行:本地,或通过 HQCenter 远程,带有 进度和取消。
  • 夜间窗口中的磁盘速度测试。

5.3 健康检查

  • 服务器状态大约每 10 分钟一次。每项发现有一个级别、一行 证据和一个提示。状态显示趋势(例如,磁盘写满前的 时间),并指出问题背后的事务或程序。
  • 主机指标:按程序的 CPU 和内存、每块磁盘的磁盘延迟和 IOPS、 哪个服务使用磁盘、操作系统缓存中的数据库。
  • Linux 限制:TasksMax、NPROC、NOFILE、OOM 杀死。
  • 磁盘空间:可用空间下限和快速填满检测。
  • 日志:firebird.log 和 replication.log 按 特征签名分类,例如可能的损坏。
  • 数据库状态来自头页:关闭、nbackup 锁、副本、 只读。
  • Firebird 模式:SuperServer、SuperClassic 或 Classic,当模式变更等待重启时有一项 发现。
  • 带令牌的 Prometheus /metrics 端点。
  • 资源守卫限制代理自身的 CPU 和内存。它从不暂停 备份。

5.4 性能

  • 带看门狗的持续 trace。
  • 按时间窗口的性能报告:按持续时间、频率、 总时间、提取、读取和写入排名;计划、过程、触发器;谁 运行了语句、何时、从何处;失败的运行。
  • 针对所选范围和数据库的按需性能报告。
  • 带双方 SQL 的锁冲突和死锁。
  • 按类别的trace 错误,含客户端应用程序和地址。
  • 通过 fblwmon 插件的轻量监控。

5.5 配置

  • 代理重新加载其配置而无需重启:验证、备份,以及 出错时回滚。
  • databases.conf 编辑器(2.5 上为 aliases.conf):按引擎 版本检查,保存前有备份副本,注释予以保留。
  • 用户:安全数据库的用户列表,以及创建用户。
  • 来自 HQCenter 的配置下发,每次变更有一个状态:已发送、 已应用、已拒绝、漂移。

5.6 日志投递(fblogspacker)

  • 代理只把新数据发送到 HQCenter:firebird.log 和 replication.log 的新尾部、按分钟的 trace 和监控文件、指标、 服务器状态。
  • 归档有大小上限(默认 120 MiB)。大文件分段发送。
  • 备份和数据库从不发送。

6. HQbird Monitor:新的 Web 控制台

每个 Firebird 实例一个控制台(端口为 20000 加上 Firebird 端口,例如 23050),或供一个 HQCenter 的全部服务器使用的一个中央控制台。

  • 服务器:所有服务器及其状态、Firebird 版本和模式、代理 版本、许可证和小图表。
  • 仪表板:CPU、内存、连接;按程序的 CPU;谁使用磁盘 和内存;临时文件;磁盘空间、延迟和速度;带状态徽章的数据库表。 单击某一分钟即显示该分钟。
  • 服务器健康报告:18 个系统在 24 小时、7 天或 14 天内的矩阵;问题年表;按区域的发现;磁盘、 事务、复制、错误、查询和备份的表。操作按钮 在编辑器中打开修复。
  • 数据库页面:监控、I/O 和事务的图表;所选分钟的 热门查询和连接。
  • 性能报告:10 项排名、按小时的运行、两个窗口的比较、 一条语句的 30 天历史、按需报告。
  • 错误和冲突:带 CSV 导出的 trace 错误;按分钟的锁冲突和 死锁。
  • 统计:带建议、趋势和预测的 gstat 分析, Excel 和 JSON 导出。
  • 日志和配置:按天并带过滤器的 firebird.log 和 replication.log; .conf 文件的变更历史。
  • 作业、备份、活动:嵌入的配置编辑器和备份 清单。
  • 许可证、更新、用户、集群、设置。
  • 通知页面(按钮在服务器页面上):谁发送 (代理、HQCenter、两者或无人)、通道、测试消息、 Telegram 机器人的聊天 ID、最近 50 次投递。该页面从不显示 已存储的令牌、URL 或密码。
  • 语言:英语、俄语、德语、巴西葡萄牙语、西班牙语。
  • 访问:一个登录,或多个带服务器列表和管理员角色的用户; 审计日志;浅色、深色和高对比度主题;掩盖 名称和 SQL 字面量的演示模式。无需互联网即可工作。

7. HQbird Cluster:RCM 和节点

HQbird 2024 有复制,但没有集群管理器。HQbird 2027 增加了一个。

  • 组成部分。每个 Firebird 实例旁一个节点,每个集群一个 RCM, 带 Web 控制台(HTTPS,端口 7444)、命令行和 API。
  • 复制是异步的。Firebird 4.0 和 5.0 使用原生 复制。HQbird 2.5 和 3.0 使用复制插件。
  • 没有 HQCenter 的集群。fbagent --cluster-init 创建 RCM 和第一个管理员。链接主机页面用一次性 令牌加入其他服务器。集群默认关闭;在安装时或 从 HQbird Monitor 打开它。
  • 从控制台设置副本:登记数据库、设置 发布、初始化。副本用 nbackup 制作。平滑重新初始化 等待长时间的写入事务。节点从不覆盖正在工作的 数据库。
  • 接管已经从手工配置进行复制的数据库。
  • 一个主库的多个副本。
  • 每个数据库的状态和滞后(同步、滞后、需要重新初始化,以及 其他),每一项都有原因。
  • 验证:按需或按 计划比较主库和副本的行数。
  • 服务:一个逻辑数据库位于多台主机上。
    • 切换不丢失数据,然后旧主库作为 副本重新加入。
    • 主库主机丢失时的手动故障转移,带数据丢失 报告。
    • 按服务的自动故障转移,默认关闭。它需要路由器。
    • 路由器(HAProxy,Linux)给客户端一个稳定地址。
  • 控制台:6 种语言、只读查看者角色、审计日志、每个代码带操作手册的 警报。
  • 严重性为 warn 及以上的问题的警报通道(Telegram、webhook、电子邮件)。警报页面上每个通道有一个测试按钮。
  • 安全:集群证书颁发机构下的双向 TLS、自动 证书续期、签名的发布。

限制:不通过集群进行同步复制;只有带 主键或唯一键的表才会发布;按许可证每个集群最多 3 台主机; 每个集群一个 RCM;路由器仅在 Linux 上。切换已在 Linux 上的 Firebird 5.0 进行实验室测试。

指南:集群指南、 集群操作手册。

8. HQCenter:多台 HQbird 服务器的中央服务器

  • 它是什么。您网络中的一台 Linux 服务器。代理向它登记并 上传自己的数据。它有一个中央 HQbird Monitor 和一个管理面板。
  • 在 Ubuntu 22.04 / 24.04 / 26.04 或 AlmaLinux 9 / 10 上用一条命令安装。支持封闭网络:从随身携带的软件包安装。
  • 登记:代理创建自己的密钥。操作员批准它, 或在席位空闲时由许可证令牌批准。所有代理流量 使用双向 TLS。
  • 机群表:代理和 Firebird 版本、最后联系、发布 通道。
  • 向代理下发配置,带有历史和还原。可立即在 任意服务器上运行重要作业。
  • 机群更新:代理、HQbird Monitor、集群程序和 Firebird 来自 HQCenter 目录。校验供应商签名。
  • HQCenter 自行更新,来自已签名的栈,带有检查和自动 回滚。所有者可以关闭此功能。
  • 状态监视:所有服务器上新出现的、已升级的和已清除的问题,带 电子邮件和每周报告。Telegram、webhook 和 SMTP 通道、安静 时段和“静默服务器”事件。
  • 许可证:上传、分配给代理、席位计数。
  • 请求审计:谁在一台服务器上更改了什么。
  • 带作用域令牌的 API;Prometheus 指标,以及 HQCenter 自身的 Grafana 仪表板。
  • 管理面板有 4 种语言:英语、巴西葡萄牙语、俄语、 德语。

指南:site-install.md。

9. fbmcp:面向 AI 助手的 Firebird 工具

  • 数据库主机上的 MCP 服务器。AI 客户端(例如 Claude Desktop 或 Claude Code)用它检查和管理 Firebird 2.5 到 5.0。
  • 约 120 个工具:带计划和统计的查询、架构、会话、 索引建议、gstat、趋势;备份、测试还原、验证、sweep; DDL 和迁移;用户和授权;trace;firebird.conf;调度器; 约 30 个面向 fbagent 的工具(状态、报告、作业、许可证、更新); 集群(链接、登记、重新初始化、验证、切换、故障转移)。
  • 按层级的安全:
    • 读取无需批准。它在只读事务中运行。
    • 普通变更在 AI 客户端中用一次性令牌确认。
    • 高影响变更只能在 AI 客户端之外批准(Windows 上的托盘 窗口,或服务器上的一条命令)。它还需要一个打开的 维护窗口,以及一份不到 24 小时的已验证备份。
    • 删除数据库是关闭的。
  • 每个决定都进入审计日志。
  • HQbird 安装程序默认安装 fbmcp,仅供本地使用。远程 使用需要 HTTPS 和 API 密钥。

10. 安装程序

Windows

  • 四个安装程序,每个 Firebird 主版本一个(fb25、fb30、fb40、fb50)。 每个都是离线的:所有文件都在内部。
  • 每个安装程序安装 Firebird、fbagent、HQbird Monitor 和 fbmcp。 集群程序被复制,并保持关闭,直到您打开它们。
  • 一台服务器上有多个 Firebird 主版本,以及一个主版本的多个实例。
  • 向导页面用于试用、许可证文件、与 HQCenter 的连接 以及自动更新。
  • 静默安装,每一页都有开关。
  • 8 种向导语言:英语、巴西葡萄牙语、德语、俄语、 西班牙语、波兰语、土耳其语、简体中文。
  • 安装程序和卸载程序带有 Authenticode 签名。
  • 卸载移除一个实例或全部。数据库始终保留。

指南:HQbird Windows 安装指南。

Linux

  • 每个 Firebird 主版本一个离线 .run 文件。只下载缺少的操作系统软件包。
  • 主机:带 systemd 以及 apt、dnf/yum 或 zypper 的 x86_64(Ubuntu、Debian、 AlmaLinux、Rocky、RHEL、Oracle Linux、openSUSE、RED OS)。强制模式下的 SELinux 可以工作。
  • 默认是全屏文本界面,语言为英语、俄语、巴西 葡萄牙语和德语。--no-tui 给出纯文本模式。
  • 一台主机上可以有多个实例(Firebird 2.5:一个实例)。
  • 使用 --yes 和选项进行无人值守安装。

指南:HQbird Linux 安装指南。

Docker

  • 公共镜像 ghcr.io/ibsurgeon/hqbird2027-fb25、-fb30、-fb40、 -fb50。一个容器包含一个带全部组件的实例。
  • 镜像用 cosign 签名。
  • 集群角色 HQBIRD_CLUSTER_ROLE=master|replica,带 compose 文件。
  • 镜像文件夹对其他用户关闭,新容器保留 RCM 账户。

指南:Docker 指南。

11. 许可和试用

  • 签名的许可证文件。代理检查供应商签名。许可 从不停止数据库。
  • 试用:7 天,无需联网步骤。工作电子邮件和 6 位代码 把它延长到 30 天。
  • 许可证区域 EU、RU 和 BR,各自有自己的密钥。
  • 离线:安装时提供许可证文件;Windows 安装程序可以生成 许可证请求文件。
  • 配合 HQCenter:许可证上传一次,并分配给代理。
  • 新许可证自行到达。通过试用请求获得许可证的代理 每小时向供应商的许可证服务器询问一次。它安装 服务器为它准备的许可证:更长的试用、由试用做成的付费许可证, 或订阅的下一期。服务器上无需做任何事。供应商的许可证服务器开始逐步 提供此类许可证。
  • 试用请求也可以在试用的 30 天之后发送: 该电子邮件地址可以属于已有许可证的客户。

12. 自动更新

  • 代理更新自身。它检查供应商签名,拒绝 降级,并且可以回滚。
  • 代理更新 HQbird Monitor、fbmcp、集群程序和 Firebird。Firebird 更新有备份、应用窗口、健康检查 和回退。
  • 配合 HQCenter:更新按发布 通道来自 HQCenter 目录。
  • 没有 HQCenter:更新来自供应商区域。模式:all、 agent(Firebird 等待管理员)、off。HQbird Monitor 中的更新页面 显示状态。

13. 警报和通知

  • HQCenter 状态监视发送关于机群问题的电子邮件。 集群控制台显示警报。
  • 代理发送自己的关于服务器问题的消息:当问题 是新的、当它变得更严重,以及当它消失时。一次状态 检查的所有变更放在一条消息中。
  • 通道是您自己的 Telegram 机器人、webhook(Slack、Teams、 Discord、Mattermost、Rocket.Chat、ntfy)和电子邮件(SMTP),带严重性 过滤器和安静时段。可以有多个通道。在您添加通道之前, 什么都不发送。
  • 每日摘要:每天一条消息,包含未解决的问题 (notify.daily_summary,默认关闭)。
  • 一台机器上有多个代理时,只有其中一个发送机器本身的问题 (磁盘、内存)。
  • 两个代理命令:--notify-history [N] 打印最近的投递, --notify-test <channel> 发送测试消息。
  • 当许可证不允许时,代理不发送。
  • HQbird Telegram 机器人:具有有效许可证的服务器或 HQCenter 用一次性代码链接一个聊天。不需要自己的机器人。供应商的 服务器尚未提供此服务;在此之前,请使用您自己的 Telegram 机器人、webhook 或电子邮件。
  • RCM 把集群警报发送到相同种类的通道(rcm.json 中的 notify.channels)。

14. 安全

  • 代理、HQCenter 和集群使用双向 TLS。
  • 签名的发布:代理拒绝没有有效供应商 签名的更新。
  • Windows 安装程序和程序上的 Authenticode;Docker 镜像上的 cosign。
  • 备份归档的 AES-256 加密。
  • 机密不出现在命令行和配置快照中。
  • 代理上有请求审计日志;HQbird Monitor、HQCenter、 RCM 和 fbmcp 中有审计日志。
  • 可以在服务器上关闭远程命令 (--remote-commands off)。

15. 从 HQbird 2024 升级

  • 2027 安装程序找到 HQbird 2024,就地更新 Firebird,并把 旧文件夹保留为副本。
  • FBDataGuard 作业在首次启动时导入一次:gbak、nbackup (级别 0 到 4)、组备份、sweep 和索引统计。代理 继续现有的备份集。
  • 不导入:复制、trace、文件传输、云备份、 还原、验证。请在编辑器中重新设置它们。
  • 2024 许可证不转移。新代理以试用 模式启动。请安装 2027 许可证。
  • 已移除:端口 8082 上的 FBDataGuard 控制台、AMV、VSS 备份、 FTP 服务器、SFTP 上传。
  • 2024 安装程序的脚本:具有 2027 等效项的开关被接受。 其他开关被拒绝,消息中指出替代项。
  • 导入把 FBDataGuard 的数据库登记到 Firebird 别名文件(databases.conf,或 Firebird 2.5 上的 aliases.conf)。旧 文件先被复制。路径已在 文件中、或其文件不存在的数据库被略过。带 include 指令的文件 不会被更改。
  • 导入移除 FBDataGuard 的旧监控日志(文件夹 mon\outcoming 和 mon\outtrace)。旧 HQbird 的服务仍在运行时,什么都不移除。 移除无法撤销。
  • 两者默认开启。要关闭它们,把 hqbird_import.register_databases 或 hqbird_import.clean_mon_logs 设为 false,或把 --no-register-databases 和 --no-clean-mon-logs 与 --import-hqbird-config 一起使用。