HQbird Windows 安装指南
本指南说明如何用 Setup 程序 hqbird2027-fbNN-setup-<version>.exe 在 Windows 服务器上安装 HQbird 2027。它有两部分:
较旧 HQbird 的更新、Setup 的维护模式、卸载和故障排除在完整指南中:
hqbird2027-windows-setup-guide.md。
屏幕截图显示的是干净的 Windows 10 上、面向 Firebird 5.0 的 Setup 2027.2.33。Firebird 2.5、3.0 和 4.0 的 Setup 页面相同。静默运行的屏幕截图取自一个测试构建。
1. 开始之前
选择 Setup。 一个 Setup 安装一个 Firebird 版本:
| Setup | Firebird | 默认端口 |
|---|---|---|
hqbird2027-fb50-setup-<version>.exe |
5.0 | 3050 |
hqbird2027-fb40-setup-<version>.exe |
4.0 | 3050 |
hqbird2027-fb30-setup-<version>.exe |
3.0 | 3050 |
hqbird2027-fb25-setup-<version>.exe |
2.5 | 3050 |
要求:
- Windows 10 或 11,或 Windows Server 2016 或更新版本,64 位。
- 管理员帐户。Setup 会请求提升。
- 不需要互联网连接。Setup 包含全部文件。
Setup 安装的内容:
| 组件 | Windows 服务 | 默认位置 |
|---|---|---|
| Firebird 服务器(HQbird 构建) | FirebirdServerHQBirdInstanceFB5 |
C:\HQbird\Firebird50,端口 3050 |
| HQbird 代理(备份、监控、更新) | HQbirdFBAgent-fb50 |
C:\HQbird\fbagent-fb50 |
| HQbird Monitor(Web 控制台) | HQbirdMonitor-fb50 |
http://localhost:23050/ |
| fbmcp,面向 AI 客户端的 MCP 服务器(可选) | fbmcp |
C:\HQbird\fbmcp |
代理和 HQbird Monitor 的工作数据放到 C:\HQbirdData。上面的名称用于 Firebird 5.0。Firebird 4.0 的名称包含 fb40 和 FB4,其余版本依此类推。
语言。 向导有 8 种语言:英语、巴西葡萄牙语、德语、俄语、西班牙语、波兰语、土耳其语和简体中文。启动 Setup 时,它显示语言列表。Windows 的语言处于选中状态。
2. 交互式安装
启动 Setup 文件,并接受 Windows 的提升提示。选择语言,然后单击确定。
在准备安装页单击安装之前,Setup 不会更改计算机上的任何内容。每个页面都可以单击上一步。
步骤 1:欢迎

该页显示 HQbird 版本和 Firebird 版本。单击下一步。
步骤 2:许可协议

阅读协议。选择我接受该协议,然后单击下一步。
然后 Setup 解包它的文件并检查计算机。这需要几秒钟。
步骤 3:服务器检查结果

该页显示两个列表:
- 在这台计算机上发现:较旧的 HQbird、HQbird 代理和 Firebird 服务器。
- 计划的操作:Setup 将用默认设置安装的内容。
如果不需要 fbmcp,请清除复选框安装 fbmcp,即面向 AI 客户端的 MCP 服务器。单击下一步。
如果 Setup 发现同一版本的 Firebird 或较旧的 HQbird,下一页是安装类型(更新,或一个新实例)。请看完整指南 hqbird2027-windows-setup-guide.md。
步骤 4:安装文件夹

- HQbird 文件夹:Firebird 和 HQbird 代理进入此文件夹的子文件夹。
- 数据文件夹:HQbird 代理和 HQbird Monitor 的工作数据,以及 HQbird Monitor 的登录文件。数据库不存放在这里。
使用两个不同的文件夹。
步骤 5:Firebird 服务器

- Firebird 文件夹:默认是 HQbird 文件夹中的
Firebird50。 - 端口:默认是 3050。使用没有其他程序使用的端口。
- Firebird 服务名:仅当另一个 Firebird 使用相同名称时才更改它。
最后几行显示 HQbird 代理和 HQbird Monitor 的文件夹与服务名。
步骤 6:SYSDBA 密码

把 Firebird 管理员(SYSDBA)的密码输入两次。如果两个字段都留空,Setup 使用 Firebird 的默认密码 masterkey。在生产服务器上,使用强密码。
步骤 7:HQbird Monitor

HQbird Monitor 是 HQbird 的 Web 控制台。
- 端口:默认是 20000 + Firebird 端口(23050)。Setup 在 Windows 防火墙中打开此端口。
- 用户名:默认是
admin。 - 密码:7 到 128 个字符,包含字母和数字。输入两次。
用此用户名和密码登录 HQbird Monitor。
步骤 8:服务器名称

服务器名称是新 HQbird 代理的代理 id。HQCenter 用此名称显示该服务器。默认是小写的计算机名。名称可以有 1 到 128 个字符:字母、数字、- 或 _。
步骤 9:复制与集群设置(可选)

两个选项默认都是关闭的。以后可以在 HQbird Monitor 中打开它们。
- 打开复制节点发现模式:如果将在接下来的 24 小时内在此实例上配置复制,请选择它。
- 在此服务器上安装 Replication Cluster Manager(RCM):RCM 是把服务器连成复制集群的 Web 控制台。只在集群的一台服务器上安装它。
步骤 10:试用期(可选)

不注册时,试用期为 7 天。要把它延长到 30 天:
- 输入你的工作电子邮箱。
- 选择邮件的语言。
- 选择我同意 Setup 将我的电子邮件地址发送给 IBSurgeon。
然后你会收到一封带有 6 位数字代码的电子邮件。在 HQbird Monitor 中输入该代码。要跳过此步骤,请把地址留空并单击下一步。
步骤 11:自动更新

当服务器未连接到 HQCenter 时,Setup 显示此页。这时 HQbird 可以到 IBSurgeon 更新服务器检查新版本。选择 HQbird 自行更新的内容:
- 仅 HQbird(推荐):HQbird 代理、HQbird Monitor 和 fbmcp 自行更新。新的 Firebird 版本会被下载,并等待管理员。
- HQbird 和 Firebird:Firebird 也自行更新,在夜间 03:30 到 04:00。更新会重新启动 Firebird。
- 关闭:不检查更新。要更新,请运行新版本 HQbird 的 Setup。
以后可以在 HQbird Monitor 中更改此设置。如果以后把服务器连接到 HQCenter,则由 HQCenter 控制更新。
当 Setup 的文件夹中包含 attach.json 时,Setup 跳过此页。
步骤 12:许可证文件(可选)

如果有 HQbird 许可证文件(.json 或 .lic),请选择它。没有许可证文件时,HQbird 在试用模式下工作。以后可以用开始菜单快捷方式HQbird 2027(Firebird 5.0)维护安装许可证。
步骤 13:连接到 HQCenter(可选)

如果公司使用 HQCenter,请选择从 HQCenter 下载的连接文件(attach.json)。如果不是,请跳过此步骤。该文件包含一个秘密访问令牌:安装之后删除它。
步骤 14:准备安装

该页列出任务、操作、文件夹、服务名和自动更新的模式。滚动列表以查看所有行。阅读该列表。单击上一步更改某项设置,或单击安装开始。
步骤 15:正在安装

Setup 安装 Firebird、HQbird 代理和 HQbird Monitor。这需要几分钟。不要关闭窗口。
步骤 16:安装完成

摘要显示:
- Firebird 的版本、文件夹和端口。
- HQbird 代理的文件夹、它的服务和服务器名称。
- HQbird Monitor 的地址:在这台计算机上,以及从另一台计算机。
- HQbird Monitor 的用户名。
- 关于 fbmcp、复制和可选步骤的说明。
打开 HQbird Monitor在浏览器中打开 Web 控制台。单击下一步。
步骤 17:完成

保持在浏览器中打开 HQbird Monitor为选中状态以打开 Web 控制台,然后单击完成。
安装之后
- HQbird Monitor:打开
http://localhost:23050/,用步骤 7 的用户名和密码登录。 - 开始菜单,组 HQbird 2027:HQbird Monitor(Firebird 5.0,端口 23050)、HQbird 文档(Firebird 5.0)、连接到 HQCenter(Firebird 5.0)和HQbird 2027(Firebird 5.0)维护。
- 服务:
FirebirdServerHQBirdInstanceFB5、HQbirdFBAgent-fb50和HQbirdMonitor-fb50正在运行,并自动启动。 - 文件夹:程序在
C:\HQbird,工作数据在C:\HQbirdData。
3. 命令行安装(静默)
静默运行不显示窗口,也不提问。在脚本中和远程安装时使用它。
命令
以管理员身份打开命令提示符并运行:
start /wait "" hqbird2027-fb50-setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /YES /LOG=C:\Temp\hqbird-setup.log
echo Exit code: %ERRORLEVEL%| 开关 | 含义 |
|---|---|
/VERYSILENT |
没有向导,也没有进度窗口。此次运行接受许可协议 |
/SUPPRESSMSGBOXES |
没有消息框 |
/YES |
用“是”回答 Setup 的问题(例如:停止 Firebird) |
/LOG=<file> |
写入 Setup 日志。始终加上它:静默运行的错误只在日志中 |
start /wait 等待 Setup 结束,并把它的退出代码放入 %ERRORLEVEL%。退出代码 0 = 已安装。
没有更多开关时,Setup 使用向导的默认值:文件夹 C:\HQbird 和 C:\HQbirdData,Firebird 端口 3050,HQbird Monitor 在端口 23050,无试用邮件,无许可证文件,自动更新仅为 HQbird。密码与向导不同:
- SYSDBA:Setup 生成一个密码。用
/SYSDBAPASSFILE=给出你自己的密码。 - HQbird Monitor:用户
admin,密码为生成的密码。密码在C:\HQbirdData\config\access.properties中(仅管理员)。用/HQMLOGIN=和/HQMPASSFILE=给出你自己的。
示例:使用自己的密码进行静默安装
cd /d C:\Temp
echo Sysdba-2027-Pass>sysdba.txt
echo Monitor-2027-Pass>hqm.txt
start /wait "" hqbird2027-fb50-setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /YES /SYSDBAPASSFILE=sysdba.txt /HQMLOGIN=admin /HQMPASSFILE=hqm.txt /LOG=C:\Temp\hqbird-setup.log
echo Exit code: %ERRORLEVEL%
del sysdba.txt hqm.txt
说明:
- 密码文件是 UTF-8 文本文件。Setup 读取它的第一行。
- 不要在
echo命令的>前面加空格:空格会成为密码的一部分。 - 相对文件路径从 Setup 的文件夹算起。
- 在 PowerShell 中,用
Set-Content -Encoding UTF8写文件。PowerShell 的>写入 UTF-16,Setup 会拒绝这样的文件。
PowerShell 中相同(以管理员身份运行):
Set-Content -Path C:\Temp\sysdba.txt -Value 'Sysdba-2027-Pass' -Encoding UTF8
Set-Content -Path C:\Temp\hqm.txt -Value 'Monitor-2027-Pass' -Encoding UTF8
$p = Start-Process -Wait -PassThru -FilePath C:\Temp\hqbird2027-fb50-setup-<version>.exe `
-ArgumentList '/VERYSILENT', '/SUPPRESSMSGBOXES', '/YES', `
'/SYSDBAPASSFILE=C:\Temp\sysdba.txt', '/HQMLOGIN=admin', '/HQMPASSFILE=C:\Temp\hqm.txt', `
'/LOG=C:\Temp\hqbird-setup.log'
$p.ExitCode # 0 = installed
Remove-Item C:\Temp\sysdba.txt, C:\Temp\hqm.txt向导设置的开关
向导的每一项设置都有一个开关:
| 向导页 | 开关 | 默认 |
|---|---|---|
| 服务器检查结果 | /NOFBMCP:不安装 fbmcp |
安装 fbmcp |
| 安装文件夹 | /HQBIRDROOT=<folder>:HQbird 文件夹 |
C:\HQbird |
| 安装文件夹 | /DATAROOT=<folder>:数据文件夹 |
C:\HQbirdData |
| Firebird 服务器 | /FBDIR=<folder>:Firebird 文件夹 |
C:\HQbird\Firebird50 |
| Firebird 服务器 | /FBPORT=<port>:Firebird 端口 |
3050 |
| Firebird 服务器 | /FBINSTANCE=<name>:服务为 FirebirdServer<name> |
HQBirdInstanceFB5 |
| SYSDBA 密码 | /SYSDBAPASSFILE=<file> |
生成 |
| HQbird Monitor | /HQMPORT=<port> |
20000 + Firebird 端口 |
| HQbird Monitor | /HQMLOGIN=<name> /HQMPASSFILE=<file> |
admin,生成的密码 |
| 服务器名称 | /AGENTID=<name> |
小写的计算机名 |
| 复制与集群设置 | /DISCOVERY:将发现模式打开 24 小时 |
关闭 |
| 复制与集群设置 | /RCM:在此服务器上安装 RCM |
关闭 |
| 试用期 | /EMAIL=<address> /ACCEPTPRIVACY [/MAILLANG=en|ru|pt-BR] |
无试用邮件 |
| 自动更新 | /AUTOUPDATE=all|agent|off:agent = 仅 HQbird,all = HQbird 和 Firebird,off = 不检查更新 |
agent |
| 许可证文件 | /LICENSE=<file> |
无 |
| 连接到 HQCenter | /ATTACH=<attach.json> |
若 Setup 的文件夹中有 attach.json,则使用它 |
| 语言列表 | /LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN |
Windows 的语言 |
/SYSDBAPASS=<password> 和 /HQMPASS=<password> 也能用,但密码随后会出现在 Setup 日志中。请优先使用密码文件。
/AUTOUPDATE= 只在服务器未连接到 HQCenter 时起作用。有 HQCenter 时,由 HQCenter 控制更新。
在静默运行中,/LANG= 设置日志里部分消息的语言。英语日志请使用 /LANG=en。
使用其他文件夹、另一个端口和一封试用邮件的示例:
start /wait "" hqbird2027-fb50-setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /YES ^
/HQBIRDROOT=D:\HQbird /DATAROOT=D:\HQbirdData /FBPORT=3055 ^
/SYSDBAPASSFILE=C:\Temp\sysdba.txt /HQMLOGIN=admin /HQMPASSFILE=C:\Temp\hqm.txt ^
/[email protected] /ACCEPTPRIVACY /MAILLANG=en ^
/LANG=en /LOG=C:\Temp\hqbird-setup.log退出代码
| 代码 | 含义 |
|---|---|
| 0 | 已安装 |
| 1 | 在安装之前被拒绝:开关或文件不正确、已安装更新的版本,或没有管理员权限。原因在日志中 |
| 4 | Setup 有一个问题,而命令中没有 /YES |
| 7 | 服务器检查或安装失败。错误在日志中,也在 %ProgramData%\fbagent\hqbird2027-setup-result.json 中 |
| 10 | 已安装,但连接到 HQCenter 失败 |
检查结果
sc query FirebirdServerHQBirdInstanceFB5 | findstr "SERVICE_NAME STATE"
sc query HQbirdFBAgent-fb50 | findstr "SERVICE_NAME STATE"
sc query HQbirdMonitor-fb50 | findstr "SERVICE_NAME STATE"三个服务的状态必须是 RUNNING。然后打开 http://localhost:23050/ 并登录 HQbird Monitor。
安装失败时停止的脚本:
@echo off
start /wait "" hqbird2027-fb50-setup-<version>.exe /VERYSILENT /SUPPRESSMSGBOXES /YES /LOG=C:\Temp\hqbird-setup.log
if errorlevel 1 (
echo HQbird setup failed with code %ERRORLEVEL%, see C:\Temp\hqbird-setup.log
exit /b %ERRORLEVEL%
)
echo HQbird 2027 installed静默卸载
start /wait "" "C:\HQbird\setup\fb50\unins000.exe" /VERYSILENT这会移除程序和服务。数据库、配置文件和 Firebird 安全数据库会保留。加上 /REMOVEDATA 可同时移除工作数据、安全数据库和配置文件。数据库文件始终保留。
4. 更多信息
- 更新、维护、多个实例、HQCenter、全部开关和故障排除:
hqbird2027-windows-setup-guide.md。 - Windows 和 Linux 上的卸载:卸载。
- Linux 安装程序:Linux 安装指南。