维护 OCI GoldenGate 部署

了解 GoldenGate 版本、如何以及何时升级、接收或推迟通知，以及如何回滚升级。

关于 GoldenGate 版本

OCI GoldenGate 支持多个并发版本，例如 Oracle GoldenGate、Oracle GoldenGate for Big Data 和 Oracle GoldenGate for MySQL。有关适合您的版本的详细信息，请参阅版本参考。

每个版本都有一个版本号。有三种类型的发行版：

• 主修：构建编号中的第一个编号表示主发行版。例如： 21。

• 捆绑包：第二个编号指示捆绑包发行版。捆绑包发行版是主要发行版的一组 bug 修复。例如： 21。5

• 次要版本：尾随编号指示次要版本。次要发行版包含对捆绑包发行版的一个或多个 bug 修复。例如： 21.5。0.0.0。

注：所有发行版类型都可以包含安全修复。

根据发行版的类型以及它是否包括安全修复，当新版本可用时，您有特定的时间来升级部署：

发行版类型	主要	捆绑包	次要
非安全修复	365 天	180 天	不适用
安全修复	不适用	14 天	14 天

如果您未在给定时间范围内手动升级，则您的部署将在此时间范围结束时自动升级到最新版本。

注：您可以在“升级”部署屏幕和“升级”列表中查看版本支持的日期。

弃用版本

GoldenGate 版本从发布到弃用的日期一直可用。版本已弃用时，您无法再选择它进行部署创建或升级。

弃用期间使用与版本升级相同的时间范围。例如：

• 在主版本发布 365 天后，以前的主版本已过时。

• 在捆绑包版本发布 180 天后，同一主发行版的先前捆绑包版本将被弃用。

• 在安全修复发行版（对于捆绑包或次要发行版）发布 14 天后，同一主要发行版的所有以前版本都已弃用。

注：从 2027 年 4 月开始，所有 21 c 数据复制部署都将自动升级到最新的可用发行版版本。发放日期可能因地区而异。

安排更新

您可以定制定义何时升级部署的维护窗口。如果您未定义维护窗口，OCI GoldenGate 将根据最新版本的发布日期计算升级部署的最佳时间，然后在距离自动升级期计算结束最近的周末自动升级部署。

注：发布主发行版、捆绑包或辅发行版的新版本后，OCI GoldenGate 将根据您适用的时间表为您安排升级（主发行版为 365 天，捆绑包为 180 天，具有安全修复功能的辅发行版为 14 天）。如果同一发行版的较新版本可用，则该服务将使用可用的最新版本升级您的部署，但计划日期保持不变。

您可以在创建部署或编辑现有部署时定制 OCI GoldenGate 维护窗口。当新的 GoldenGate 版本可用时，部署将在所选的确切日期和时间自动升级。但是，当您选择的手动升级升级升级时间范围不在维护窗口中时，部署可能会在所选日期和时间之前自动升级。

例如，假设在 1 月 1 日，您还有 30 天时间来升级您的部署，那么您必须在 1 月 31 日星期二之前手动升级。但是，您的自定义维护窗口将于周日晚上 10 点开始。借助此维护窗口，OCI GoldenGate 将在下周日下午 10 点升级您的部署，因为 OCI GoldenGate 始终优先考虑您的定制窗口。

要编辑定制的维护窗口，请执行以下操作：

1. 在部署详细信息页的“部署信息”区域的 GoldenGate 下，为“维护”选择编辑。

2. 在“编辑维护参数”对话框中：

   1. （可选）选择自定义维护窗口以更改以下字段的默认值。

   2. 对于主发行版自动升级期间（以天为单位），输入介于 0 和 365 之间的值。

   3. 对于捆绑包发行版自动升级期间（以天为单位），输入介于 0 和 180 之间的值。

   4. 对于安全路径自动升级期间（以天为单位），输入介于 0 和 14 之间的值。

   5. （可选）选择启用次要发行版自动升级，然后为次要发行版自动升级期间（以天为单位）输入值。

3. 选择 Save changes 。

升级之前

在升级部署之前，请确保完成以下任务并检查是否存在长时间运行的事务处理。

确保归档日志可用于恢复

使用管理客户端中的以下命令确定在提取启动时可能需要恢复的最早归档日志。Recovery Checkpoint 字段显示恢复所需的最早日志。

Admin Client > INFO EXTRACT group_name, SHOWCH

最好在高峰时间之外执行升级活动。如果有大量且长时间运行的事务处理，则可以考虑在源系统上，新提取可能需要从正常恢复检查点开始处理，而不是如果停止提取时最早打开的事务处理的第一个记录位于不在系统上的日志中，则该记录比有边界恢复检查点多。

清除长时间运行的事务处理

要清除长时间运行的事务处理，有两个选项：

• 可以将归档恢复回（包括）所显示的恢复检查点中的归档，其中包含：

  Admin Client > INFO EXTRACT

  （如果源数据库支持此功能。）

• 可以清除应用于要升级的提取的长期运行的事务处理。这可以通过跳过事务处理或强制它们作为已提交的事务处理进入线索来完成。跳过事务处理可能会导致数据丢失，如果事务处理回退，则将事务处理强制添加到线索中可能会将不需要的数据添加到线索中。要跳过或强制执行事务处理，请执行以下操作：

  1. 查看未结事务处理：

     Admin Client > SEND EXTRACT group_name, SHOWTRANS

  2. 记录要清除的任何事务处理的事务处理 ID。

  3. 使用 SEND EXTRACT 和 SKIPTRANS 选项清除旧事务处理以跳过事务处理，或者使用 FORCETRANS 将处于当前状态的事务处理作为已提交事务处理强制发送到线索。例如：

     Admin Client > SEND EXTRACT group_name, {SKIPTRANS | FORCETRANS transaction_ID [THREAD n] [FORCE]}

  4. 完成清理长时间运行的事务处理后，强制执行有边界恢复检查点。

     Admin Client> SEND EXTRACT group_name, BR BRCHECKPOINT IMMEDIATE

同步副本

对于具有并行复制的部署，请确保在升级之前同步复制：

Admin Client > SYNCHRONIZE REPLICAT group_name

有关更多信息，请参见 SYNCHRONIZE REPLICAT 命令行界面参考。

升级部署

请确保先完成升级之前步骤。

升级部署时，

• 部署将停止，然后在升级完成后重新启动。

• 所有 Oracle GoldenGate 进程都将停止，然后重新启动（如果它们配置为自动启动）。

要升级部署，请执行以下操作：

1. 在“Deployments（部署）”页面上，选择要升级的部署。

2. 在部署详细信息页的操作菜单中，选择升级。

3. 在升级部署面板中，选择要升级到的可用 GoldenGate 版本，然后选择升级。

注：了解有关版本的更多信息。

完成升级需要几分钟时间。在升级完成后，在部署详细信息页上选择升级以查看升级历史记录，或者在升级过程中是否遇到问题。

升级心跳表

如果心跳表用于您的部署，则还必须升级它们。完成升级后，您可以：

• 在管理客户机中运行 UPGRADE HEARTBEATTABLE 命令，为表和滞后视图添加额外的列。GoldenGate 使用这些额外的列来跟踪提取重新启动位置。了解更多信息。

• 在部署控制台中，打开管理控制台的导航菜单，然后选择“Configuration（配置）”。连接到数据库。显示脉动表时，从“操作”菜单中选择“升级”。

升级通知

OCI GoldenGate 将在有升级可用以及安排升级时向您发送事件通知。有关更多信息，请参见 GoldenGate Upgrade Event Types ，或了解有关事件的更多信息。

升级时间	< 180 天	< 30 天	< 7 天
通知期间	每 30 天	每 7 天	每日

注： OCI GoldenGate 每天都会发送安全修复通知。

您还可以从部署详细信息页上显示的通知横幅了解即将进行的升级。

鸣响通知

您可以推迟或延迟事件和横幅通知。随着您接近手动升级的时间范围结束，暂停期间也会发生变化。

升级时间	< 180 天	< 30 天	< 7 天
暂停期间	30 天	7 天	不允许

注：不允许暂停次要或捆绑包升级的安全修复。

您可以随时取消推迟。

回退升级

您可以将部署版本回退到上一个版本。只允许您最近成功升级到其先前版本进行回退。

注：在回退期间，部署文件系统将恢复到升级前的最后一个状态。

弃用上一个版本时，不允许回退。

要回退升级，请执行以下操作：

1. 在“Deployments（部署）”页中，选择要回退的部署。

2. 在部署详细信息页上，选择升级。

3. 在 "Upgrades"（升级）列表中，找到上一个最新版本，然后从其 "Action"（操作）菜单中选择 Rollback（回退）。

4. 选择要回退到的版本，然后选择回退。

注：有关可用版本的列表，请参阅版本参考。

您的部署的状态将更改为更新，需要几分钟才能完成。

重新安排升级

您可以重新安排自动安排的升级。您可以将升级重新安排到较近的日期，或者将其推迟到较晚的日期。

注：重新计划不考虑维护窗口。您的新计划日期不能晚于 OCI GoldenGate 定义的值。有关详细信息，请参阅关于 GoldenGate 版本。

要重新安排升级，请执行以下操作：

1. 从“部署”页面中，选择要重新安排其升级的部署。

2. 在部署详细信息页上，选择升级。

3. 在 "Upgrades"（升级）列表中，找到上一个最新版本，然后从其 "Action"（操作）菜单中选择 Reschedule（重新计划）。

4. 在“重新计划部署升级”窗口中，选择要执行升级的日期和时间。

5. 选择 Save changes 。

在“升级”列表中，计划日期和时间反映更改。

取消更新

如果目标版本是次要发行版，则只能取消自动安排的升级。

注：取消升级到次发行版不会隐式禁用次发行版的自动升级，并且必须手动禁用。可以从部署详细信息页面禁用次发行版自动升级。有关详细信息，请参阅安排升级。

要取消升级，请执行以下操作：

1. 从“部署”页面中，选择要取消其升级的部署。

2. 在部署详细信息页上，选择升级。

3. 在 "Upgrades"（升级）列表中，找到上一个最新版本，然后从其 "Action"（操作）菜单中，选择 Cancel（取消）。

4. 在“取消部署升级”窗口中，选择取消部署升级。

升级的状态将更新为“已取消”。

已知问题

升级到 Oracle GoldenGate 23.26.x 后，部署控制台 502 错误网关错误或登录后无法列出 GoldenGate 进程

在从早期的标签升级到版本 23.26.x 或对 23.26.x 部署执行停止/启动操作后，Oracle Cloud Infrastructure GoldenGate 23.26 部署可能会变得不健康。

解决方法：为了解决此问题，升级影响了将 Oracle 部署标记为 oggoracle:23.26.1.0.0_260331 的部署。

对于大数据和其他非 Oracle 标签，我们将很快宣布修复。请与技术支持联系，了解临时手动缓解以防止影响。

从 21.15 或 23.x 构建回退到 21.14 期间的问题

尝试将 21.15 或 23.x 构建回退到以下构建之一时：

• Oracle (21.14.0.0.0_240525)

• Big Data (21.14.0.0.0_240515)

• MySQL(21.14.0.0.0_240404)

• MSSQL (21.14.0.0.0_240404)

您可能会遇到以下问题之一：

• 由于引入了新的钱包加密功能，因此缺少连接/凭证问题 21.15。

  解决方法：必须取消分配现有连接并将其重新分配给部署，并重新创建使用中任何分发或接收方路径所需的缺失用户。

• 服务管理器无法启动，因为性能度量服务在 23.x 到 21.14 的回退中出现问题。如果您遇到此问题，请与 Oracle 技术支持联系。

• Oracle GoldenGate 进程失败，并显示错误“OGG-02431 检查点文件中找到的记录标头无效”。

  解决方法：将部署升级到系列中可用的最新 21.14 构建。如果问题仍然存在，请联系 Oracle 支持部门。