联系方式
IBSurgeon
此页面为机器翻译。请阅读英文原文。 English

Firebird 独立监控

Firebird 独立监控

如何安装和配置 Firebird 高级监控独立版

1. 安装

1.1. 在“Firebird 在线工具”上注册以获取文件 keyanswers.txt

为了使用高级监控，您需要在门户网站“Firebird 在线工具”上创建免费账户：https://cc.ib-aid.com/，然后下载文件 keyanswers.txt，以将您的账户和服务器关联起来。

对于使用私有 Control Center 的用户，相应的账户必须由管理员创建。

1.1.1. 注册步骤

1. 打开 https://cc.ib-aid.com/ 并点击“创建新账户”：

注册 Firebird 在线工具

2. 然后，填写有效的电子邮件、用户名和公司（可选）：

填写注册表单

3. 之后，等待 2-3 分钟以接收确认电子邮件，并点击确认链接。它将打开一个表单，您需要输入密码及其确认，之后您就可以登录“Firebird 在线工具”门户网站。

1.1.2. 下载 keyanswers.txt

登录后，您将看到“下载 Firebird 监控代理”小部件：

从在线工具下载 keyanswers.txt

为所需操作系统下载代理（目前仅支持 Windows 7+/ Server 2008+ 以及带 systemd 的 Linux）。

同时，下载文件 keyanswers.txt。

Keyanswers.txt 包含将 Control Center 账户与高级监控关联的必要信息，然后继续进行安装。

1.2. 在 Windows 上安装

Windows 上高级监控的代理发行版是一个 zip 归档文件：install_fbcc.zip。

将安装归档文件 fbcc.zip 解压到 Firebird 文件夹，例如 C:\Program Files\Firebird\Firebird_3_0\fbcc，然后将上一步中的文件 keyanswers.txt 复制到 fbcc 文件夹中。

最终，该文件夹应如下所示：

包含高级监控文件的文件夹应位于 Firebird 文件夹内：

同时，确保 keyanswers.txt 位于包含高级监控文件的文件夹中：

fbcc 文件夹中的 keyanswers

然后，以“以管理员身份运行”选项运行命令文件 install_fbcc.cmd。该 cmd 文件将执行以下操作：

  1. 创建 2 个服务：FBHQbird Monitor 4 和 FBHQbird Trace 4
  2. 在任务计划程序中创建任务，于 23:50 重启监控
  3. 查找 Firebird（如果它位于标准路径中）并对其进行配置。高级监控安装会自动尝试使用默认用户/密码配置对 Firebird 的访问，并检查与示例数据库 employee.fdb 的连接。如果您的所有者用户不是 SYSDBA 或密码不是 masterkey，安装将要求您提供用户和密码。
  4. 连接到 keyanswers.txt 中指定的 Control Center 门户，并在您的账户中注册服务器。

1.2.1. 使用默认 SYSDBA/masterkey 安装

以下是使用默认用户/密码（SYSDBA/masterkey）的 Firebird 安装日志示例：

Code 
c:\Firebird30\fbcc>install_fbcc.cmd
The Service FBHQbirdMON4 has been installed
2022-02-12 09:41:40 ERROR MainCreateConf:287 - Not found location, return empty string

Checking access to Firebird Monitoring Portal...
Connected to Portal: Ok
Determined architecture: SuperServer and version: 3.0.6
Verified connection with Firebird user: SYSDBA: Ok.
Using autodiscovery to watch for all active databases.

Registering server in Firebird Monitoring Control Center
Registered new server with name=SRV-DESKTOP-NS28RCG-2202012214,  GUID=99c54d1jjqxj0r   (id=314285)
Successful! Now you can see your server in Firebird Control Center: https://cc.ib-aid.com
The Service FBHQbirdTrace4 has been installed
SUCCESS: The scheduled task "Restart Mon4 Service (Firebird Monitoring)" has successfully been created.
The FBHQbird Monitor 4 service is starting.
The FBHQbird Monitor 4 service was started successfully.

The FBHQbird Trace 4 service is starting.
The FBHQbird Trace 4 service was started successfully.

c:\Firebird30\fbcc>

1.2.2. 使用自定义用户名/密码安装

如果使用非默认用户名和/或密码，在 cmd 中的安装过程中系统将要求您输入它们。

1.2.3. 在 Windows 上卸载高级监控

如果您在安装过程中出错，或看到任何错误，或只是决定移除高级监控代理，请运行 remove_fbcc.cmd，它将停止并移除服务和任务计划程序任务，卸载日志将如下所示：

Code 
c:\Firebird30\fbcc>remove_fbcc.cmd
The FBHQbird Monitor 4 service is stopping.
The FBHQbird Monitor 4 service was stopped successfully.

The FBHQbird Trace 4 service is stopping.
The FBHQbird Trace 4 service was stopped successfully.

The FBHQbird Monitor 4 service is not started.

More help is available by typing NET HELPMSG 3521.

[SC] DeleteService SUCCESS
The FBHQbird Trace 4 service is not started.

More help is available by typing NET HELPMSG 3521.

[SC] DeleteService SUCCESS
SUCCESS: The scheduled task "Restart Mon4 Service (Firebird Monitoring)" was successfully deleted.
c:\Firebird30\fbcc>

1.3. 在 Linux 上安装

从“Firebird 在线工具”下载文件 install_fbcc.sh（详见 1.1.2）：

Code 
sudo wget /download/fbcc/install_fbcc.sh

此文件包含适用于 Linux 的 Firebird 高级监控安装程序。

安装程序会将必要文件安装到 /opt/fbcc 位置，因此请确保该位置有足够的可用空间。

1.3.1 先决条件：Java 8 和 jsvc

Java 8

您需要在运行监控的服务器上安装 Java 8。

我们建议安装 OpenJDK 8 Correto（来自 Amazon）：

Code 
wget -O- https://apt.corretto.aws/corretto.key | sudo apt-key add -
 sudo add-apt-repository 'deb https://apt.corretto.aws stable main'

sudo apt-get update; sudo apt-get install -y java-1.8.0-amazon-corretto-jdk
Code 
更多详情：https://docs.aws.amazon.com/corretto/latest/corretto-8-ug/generic-linux-install.html

jsvc

jsvc 是一个将 Java 应用程序作为服务启动的工具，Firebird 高级监控代理使用它。

在 CentOS 上安装 jsvc

Code 
yum install jsvc

在 Ubuntu 上

Code 
apt install jsvc

1.3.3. 将 keyanswers.txt 放在 install_fbcc.sh 旁边

从 1.1.2 获取 keyanswers.txt 并将其放在 install_fbcc.sh 旁边。

请注意，没有 wget 命令，因为 keynaswers.txt 是在门户网站上动态生成的，需要注册用户登录并下载。 <4>1.3.4. 安装步骤 使安装脚本可执行：

Code 
sudo chmod +x install_fbcc.sh

运行安装：

Code 
sudo install_fbcc.sh

这是安装前应就位的文件示例：

Code 
total 18624
drwxr-xr-x  3 root root     4096 May  3 23:32 ./
drwxr-xr-x 20 root root     4096 Feb 14 02:06 ../
drwxr-xr-x 12 root root     4096 May  3 23:19 firebird/
-rwxr-xr-x  1 root root 19050609 Sep 29  2021 install_fbcc.sh*
-rwxrwxrwx  1 root root      110 May  3 23:26 keyanswers.txt*

之后，运行 install_fbcc.sh。

请注意，脚本期望 Firebird 已从官方 tar 归档手动安装到 /opt/firebird。

如果您从软件仓库安装了 Firebird，我们建议将其卸载，并从 www.firebirdsql.org 网站安装官方 tar 归档。

2. 故障排除

成功排除故障的一般建议

检查 Firebird 监控安装的 Bin 文件夹中的 *.log 文件。

日志文件的名称与 jar 名称对应，即启动器的日志将是 launcher.log。

日志文件默认包含错误和重要消息。

问题：未使用 keyasnwers.txt 进行安装尝试

如果您没有将文件 keyanswers.txt 放在与 install_fbcc.cmd（在 Windows 上）或 install_fbcc.sh（在 Linux 上）相同的文件夹中，服务将被安装，但不会被配置：

Code 
c:\Firebird30\fbcc>install_fbcc.cmd
服务 FBHQbirdMON4 已安装

 安装已停止：在 install_fbcc.cmd 附近未找到 keyanswers.txt 文件。
 请从 cc.ib-aid.com 下载该文件，或使用手动模式安装。
 要重新尝试安装，请先运行 remove_fbcc 脚本，然后再次运行 install_fbcc。

解决方案：

运行卸载命令文件（在 Windows 上为 uninstall.cmd，右键选择“以管理员身份运行”，在 Linux 上为 /opt/fbcc/uninstall.sh）。它将卸载监控，输出类似如下：

Code 
c:\Firebird30\fbcc>remove_fbcc.cmd
FBHQbird Monitor 4 服务未启动。

输入 NET HELPMSG 3521 可获得更多帮助。

FBHQbird Trace 4 服务未启动。

输入 NET HELPMSG 3521 可获得更多帮助。

FBHQbird Monitor 4 服务未启动。

输入 NET HELPMSG 3521 可获得更多帮助。

[SC] DeleteService 成功
FBHQbird Trace 4 服务未启动。

输入 NET HELPMSG 3521 可获得更多帮助。

[SC] DeleteService 成功
成功：计划任务“Restart Mon4 Service (Firebird Monitoring)”已成功删除。
C:\fbcc>

之后，将 keyanswers.txt 放到 install_fbcc.cmd 附近的文件夹中，然后重新安装。

问题：安装包找不到 Firebird 文件夹

如果监控安装包找不到 Firebird 文件夹，将输出以下内容：

Code 
c:\Firebird30\fbcc>install_fbcc.cmd

服务 FBHQbirdMON4 已安装
2022-02-12 09:11:23 错误 MainCreateConf:287 - 未找到位置，返回空字符串
2022-02-12 09:11:23 错误 MainCreateConf:287 - 未找到位置，返回空字符串
2022-02-12 09:11:23 错误 MainCreateConf:287 - 未找到位置，返回空字符串

正在检查对 Firebird 监控门户的访问...
已连接到门户：正常
2022-02-12 09:11:24 错误 MainCreateConf:592 - 找不到测试数据库 - 将版本设置为 3.0.0，架构设置为 Classic
已检查的路径：
2022-02-12 09:11:24 错误 MainCreateConf:594 - /../examples/empbuild/employee.fdb
2022-02-12 09:11:24 错误 MainCreateConf:594 - /../help/help.fdb
2022-02-12 09:11:24 错误 MainCreateConf:594 - /examples/empbuild/employee.fdb
2022-02-12 09:11:24 错误 MainCreateConf:594 - /help/help.fdb

请输入 Firebird 数据库的所有者用户，或按 Enter 使用 SYSDBA

上面“未找到位置，返回空字符串”的消息表明安装脚本在 Windows 上的以下路径中未找到 Firebird：

Code 
"C:/Program Files/Firebird/Firebird_4_0",
"D:/Program Files/Firebird/Firebird_4_0",
"E:/Program Files/Firebird/Firebird_4_0",
"F:/Program Files/Firebird/Firebird_4_0",
"C:/Program Files/Firebird/Firebird_3_0",
"C:/Program Files/Firebird/Firebird_2_5/bin",
"D:/Program Files/Firebird/Firebird_3_0",
"D:/Program Files/Firebird/Firebird_2_5/bin",
"E:/Program Files/Firebird/Firebird_3_0",
"E:/Program Files/Firebird/Firebird_2_5/bin",
"F:/Program Files/Firebird/Firebird_3_0",
"F:/Program Files/Firebird/Firebird_2_5/bin",
"C:/HQbird/Firebird40",
"D:/HQbird/Firebird40",
"E:/HQbird/Firebird40",
"F:/HQbird/Firebird30",
"C:/HQbird/Firebird30",
"C:/HQbird/Firebird25/bin",
"D:/HQbird/Firebird30",
"D:/HQbird/Firebird25/bin",
"E:/HQbird/Firebird30",
"E:/HQbird/Firebird25/bin",
"F:/HQbird/Firebird30",
"F:/HQbird/Firebird25/bin"

以及在 Linux 上

Code 
"/opt/firebird/bin"

解决方案：

要么将 Firebird 安装到标准路径（Windows 上为 C:\Program Files\Firebird\Firebird_N_N，或 Linux 上为 /opt/firebird），要么使用支持自定义 Firebird 路径的 HQbird 高级监控。

问题：在没有配置文件的情况下启动监控会在日志中产生错误

Code 
正在启动服务...Windows 10
当前文件夹 = E:\fbcc\_OUT
2022-02-09 10:43:20 错误 Main:350 - 正在停止：在 ../conf/mainconfig.enc 中未找到 mainconfig.enc 或 mainconfig.json

解决方案：

使用控制中心中的 keyanswers.txt 文件进行正确的安装

← Все новости