此页面为机器翻译。请阅读英文原文。 English

无需夜班的维护

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 通常手动完成的工作:计划、窗口、数据库锁、日志和明确的错误原因。

作业作用哪些数据库默认
Sweepgfix -sweep:删除旧的记录版本。显式数据库列表周日 03:00
组 sweep对文件夹中所有数据库执行相同的 sweep。掩码、排除项、扫描深度。文件夹,掩码 *.fdb00: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 传递。代理会在大约一分钟内应用它并报告结果:已接受或已拒绝。

    databases.conf 编辑器。左侧是路径和别名;右侧是所选路径的别名和参数。firebird.conf 列显示服务器值。
    配置历史。代理在每次更改时保存 databases.conf、firebird.conf 和 replication.conf 的副本。你可以看到更改了什么以及何时更改。

    迁移到 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、集群、负载限制和代理时区需要重启。代理会报告哪些更改在等待重启。

    ← 返回 HQbird 2027 概览 · 备份详情 → · 服务器健康 →