本指南说明如何用 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 服务器

  • Firebird 文件夹:默认是 HQbird 文件夹中的 Firebird50。
  • 端口:默认是 3050。使用没有其他程序使用的端口。
  • Firebird 服务名:仅当另一个 Firebird 使用相同名称时才更改它。

最后几行显示 HQbird 代理和 HQbird Monitor 的文件夹与服务名。

步骤 6:SYSDBA 密码

SYSDBA 密码

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

步骤 7:HQbird Monitor

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 天:

  1. 输入你的工作电子邮箱。
  2. 选择邮件的语言。
  3. 选择我同意 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,请选择从 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. 命令行安装(静默)

静默运行不显示窗口,也不提问。在脚本中和远程安装时使用它。

命令

以管理员身份打开命令提示符并运行:

Command
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= 给出你自己的。

示例:使用自己的密码进行静默安装

Command
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 中相同(以管理员身份运行):

Command
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。

使用其他文件夹、另一个端口和一封试用邮件的示例:

Command
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 失败

检查结果

Command
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。

安装失败时停止的脚本:

Command
@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

静默卸载

Command
start /wait "" "C:\HQbird\setup\fb50\unins000.exe" /VERYSILENT

这会移除程序和服务。数据库、配置文件和 Firebird 安全数据库会保留。加上 /REMOVEDATA 可同时移除工作数据、安全数据库和配置文件。数据库文件始终保留。

4. 更多信息

  • 更新、维护、多个实例、HQCenter、全部开关和故障排除:hqbird2027-windows-setup-guide.md。
  • Windows 和 Linux 上的卸载:卸载。
  • Linux 安装程序:Linux 安装指南。