HQbird 服务器维护
无需夜班的维护
Sweep、数据库验证、索引统计信息重算、您的 SQL 脚本和 Firebird 更新都会在夜间按计划运行。组 sweep、SQL 脚本和 Firebird 更新只会在各自的时间窗口内启动。代理不会妨碍备份和用户。如果出现问题,代理会自行恢复之前的状态。
- 4 个维护作业
- 每个数据库 1 个重型操作
- 每台服务器 2 个重型任务
- 03:30–04:00 Firebird 更新窗口
- 检查失败时自动回滚
默认计划
服务器夜间
维护在夜间运行,每个作业都有自己的时间。以下是默认时间和窗口。您可以在代理配置编辑器中更改它们。
Sweep、gfix 验证、索引重算和 SQL 脚本默认关闭:您需要为您的数据库启用它们。时间使用代理的时区。
周日夜间按以下顺序运行:02:30 进行 gfix 验证,03:00 进行 sweep,04:00 进行索引重算。先检查,再垃圾回收,最后对实时数据统计。
sweep · gfix · indexes · SQL
四个维护作业
每个作业都是普通的 Firebird 命令。代理添加了 DBA 通常手动完成的工作:计划、窗口、数据库锁、日志和明确的错误原因。
| 作业 | 作用 | 哪些数据库 | 默认 |
|---|---|---|---|
| Sweep | gfix -sweep:删除旧的记录版本。 | 显式数据库列表 | 周日 03:00 |
| 组 sweep | 对文件夹中所有数据库执行相同的 sweep。掩码、排除项、扫描深度。 | 文件夹,掩码 *.fdb | 00:15–01:15 |
| gfix 验证 | gfix -v -full:检查每个数据库页面。 | 仅显式列表 | 周日 02:30 |
| 索引重算 | 对用户索引执行 SET STATISTICS。还会查找非活动索引。 | 数据库列表 | 周日 04:00 |
| SQL 脚本 | 来自传入脚本文件夹或队列的 DDL 和 DML。 | 每个脚本一个数据库 | 03:00–04:00 |
- sweep 前的长事务作为选项,代理会断开事务超过 5 小时的连接(阈值可配置)。它不会触碰 gbak、gfix、gstat 和 fbsvcmgr。
- 组不会停止一个数据库出错不会停止其他数据库的扫描。
- 明确的原因Firebird 3 及更高版本不允许在有用户连接的情况下验证数据库。代理会明确说明这一点,而不是只显示错误代码。
- SQL:代理添加 COMMITDDL:每条语句后 COMMIT,DML:每 100 条语句后。
SET BAIL ON:第一个错误停止脚本。 - 危险 SQL 不会运行
DROP DATABASE、用户和角色、GRANT和REVOKE、ALTER DATABASE:此类脚本会整体进入隔离区。 - 运行日志哪个命令、何时以及结果如何。对于 sweep 和 gfix 验证,代理保留命令历史:每个作业最多 50 条,编辑器中可见最后两条。密码永远不会写入日志。
窗口 · 锁 · 槽位
如果服务器繁忙,作业会等待或跳过数据库
启动前,代理会检查多个条件。如果条件不满足,作业会等待或跳过数据库。它不会中断其他工作。
打开左侧的条件,看看在对其文件夹进行组 sweep 期间,代理会如何处理 sales.fdb 数据库。
| 规则 | 计入内容 | 代理做什么 |
|---|---|---|
| 维护窗口 | 组 sweep 00:15–01:15,SQL 脚本 03:00–04:00,性能测试周六 22:00 — 周日 06:00。 | 窗口外作业不会启动。如果窗口剩余时间不足一分钟,也不会启动。 |
| 每个数据库一个重型操作 | 备份、sweep、验证、索引重算、还原和 SQL 脚本会获取数据库锁。 | 备份最多等待 60 分钟,直到数据库空闲。Sweep、验证和索引重算会跳过繁忙的数据库,直到下一次计划运行。立即运行会等待并重试。 |
| 每台服务器不超过 2 个重任务 | 备份、恢复、sweep、验证、索引重算、SQL 脚本、完整 gstat、测试。代理自身的重工作也会占用一个槽位:跟踪和日志的处理。 | 第三个任务等待空闲槽位。你在设置中更改数量;新值在代理重启后生效。 |
.delta 文件 | 数据库旁边存在 .delta 文件:nbackup 正在占用该数据库。 | Sweep 会跳过此类数据库。 |
| 组中某个数据库出错 | 组中某个数据库的 sweep 以错误结束。 | 组 sweep 继续处理下一个数据库。如果关闭了继续执行,则只有此作业停止。出错的数据库会在作业结果中列出。 |
如果同一数据库的 gbak 备份和 nbackup 落在同一分钟,gbak 备份会推迟 15 分钟。使用“立即运行”手动启动不会推迟。
一个按钮
立即运行:现在就启动
需要在软件更新前备份,或者现在就执行 sweep?“立即运行”按钮位于作业行上,会启动该作业一次。计划不会改变。
“立即运行”适用于备份、恢复、sweep、索引重算和 gfix 验证。你也可以运行一次已禁用的作业:运行后它仍保持禁用。代理会检查与计划运行相同的条件,并显示它在等待什么。
- 你能看到它在等待什么数据库正忙于另一项操作、作业在等待其窗口、磁盘空间不足。
- 取消当运行处于排队或等待状态时,你可以取消它。已启动的作业不会被取消。
- 请求有效期为 60 分钟如果代理在此时间内没有接收它,该运行会被视为已过期,而不是丢失。
- 你能看到将运行哪个数据库运行窗口从数据库字段开始。对于组作业,这些是数据库的复选框以及“已选择 M 个中的 N 个”这一行。
- 按需生成性能报告“立即运行”可为最长 24 小时的任意范围生成报告,并可按数据库、持续时间和程序进行筛选。这与报告页面上的“生成报告…”按钮是同一次运行。
- 本地和从中心本地控制台直接连接到代理。从中心发起时,请求会经过 goafts。代理会在下一次同步时接收它,大约一分钟。
- 数据库替换是单独的带替换的恢复以及备份-恢复-替换循环:你必须输入数据库文件名并拥有单独的权限。此类作业的远程启动在服务器上默认关闭。
- 保存后立即“立即运行”会等待代理接受新配置,然后才启动作业。
引擎更新
新的 Firebird 构建是常规的夜间操作
代理会自行下载新的 Firebird 构建,等待维护窗口,安装并检查它。如果检查失败,代理会恢复之前的版本,并且不再安装此构建。
- 窗口默认 03:30–04:00。在窗口之外,已下载的构建会等待窗口打开。如果更新在窗口内被推迟,代理会在 10 分钟后重试。代理大约在一小时内会在中心发现新构建。
- 不能被打断的作业如果 gbak、nbackup、恢复或 SQL 脚本正在运行,更新会等到下一次检查。Sweep、gfix 验证和 gstat 不会阻止它:它们可以重复执行。
- 一次一个引擎在具有多个 Firebird 实例的服务器上,一次只更新一个。
- 空间和锁定文件在 Firebird 停止之前会检查可用空间和被其他程序占用的文件。如果某个文件无法替换,Firebird 不会停止。
- 你的文件会保留代理只替换发行版文件。firebird.conf、databases.conf、replication.conf、安全数据库、UDF 和第三方插件会保留。只有缺失的必需参数会被添加到 firebird.conf。
- 回滚被替换的文件会保留在更新备份中。回滚会将它们放回。保留最近 2 个备份。
- 版本阻止被回滚的构建(无论是自动还是手动)会被阻止。一条命令即可移除阻止。
- 未完成的更新如果进程中途停止,在管理员回滚或完成之前的更新之前,不会启动新的更新。
代理不会更新从操作系统软件包(apt、dnf)安装的 Firebird:文件归包管理器所有。如何将此类服务器迁移到 HQbird 将在下文描述。
测试 · databases.conf · 迁移
管理员工具
服务器性能测试
代理每周运行一次 IBSurgeon 测试:在临时数据库中对一百万行执行 INSERT、UPDATE 和 DELETE。测试历史显示服务器在硬件、磁盘或设置变更前后的运行情况。
该测试会给磁盘带来负载,因此只在其自己的窗口中运行。Firebird 本身会删除临时数据库。如果代理在测试期间崩溃,该文件会在下次启动时被删除。
| 时间窗口 | 周六 22:00 — 周日 06:00 |
|---|---|
| 开始时间 | 周日 01:00 |
| 行数 | 1 000 000 |
| 可用磁盘空间 | 约 7.2 GiB,否则测试不会启动 |
| 历史记录 | 最近 30 次运行 |
| 同时运行 | 一个测试;第二次运行会被跳过 |
Firebird 用户:Security.fdb/Users
一个单独的设置页面显示服务器的安全数据库:共享的、私有的以及嵌入在数据库中的。标签会显示问题:没有用于读取的登录、列表未刷新、条目已过期。
创建用户按钮通过代理创建 Firebird 用户。在窗口中:名称、两次密码、来自 UserManager 设置的插件,以及“活动”和“管理员”标志。管理员权限会在第二步中确认。在运行之前,你会看到命令文本,密码被隐藏。
创建功能在本地代理下可用,在 Firebird 2.5 下不可用。
databases.conf 编辑器
该文件以数据库路径列表的形式显示。每个路径都有其别名和一个参数块。参数列表仅包含此 Firebird 版本为单个数据库接受的参数。旁边显示来自 firebird.conf 的值。
重复的别名和同一路径的第二个块都是错误:你无法保存这样的文件。参数名称拼写错误会得到提示。保存时,代理会再次检查文件,并在旁边保留前一个文件的副本。如果在你编辑期间文件发生了变化,代理会拒绝,你的文本会保留在编辑器中。表单中的编辑不会触及文件中的注释。每次保存都会写入审计日志。
从中心,文件通过 goafts 传递。代理会在大约一分钟内应用它并报告结果:已接受或已拒绝。
迁移到 HQbird 及设置更改
FBDataGuard
旧的 HQbird 设置会自动迁移
首次启动时,代理会找到 FBDataGuard 配置并迁移备份、sweep 和索引统计作业。导入只运行一次。默认情况下,作业以禁用状态到达。如果安装程序禁用了 FBDataGuard,它会启用 FBDataGuard 运行过且导入时没有警告的作业。因此服务器不会没有备份。其他作业保持禁用:请检查并自行启用它们。代理会将 FBDataGuard 日志中的旧备份纳入自己的记录:保留和恢复都能看到它们。
apt · dnf
来自操作系统软件包的 Firebird
安装程序会发现来自软件包的 Firebird 并停止,不做任何更改。它会打印命令,用于移除软件包并保留安全数据库、databases.conf 和数据库。然后安装程序安装 HQbird 并接管旧服务器的用户和别名。已在 Firebird 2.5、3.0、4.0 和 5.0 上测试。
无需重启
新设置,带检查
代理会检查新配置,复制旧配置,并在不重启的情况下应用新配置。如果新配置无法加载,代理会恢复前一个配置。大多数设置无需重启即可生效。数据文件夹、代理日志、Local API、与中心的连接、Prometheus、集群、负载限制和代理时区需要重启。代理会报告哪些更改在等待重启。