先决条件

了解升级 Oracle GoldenGate 微服务体系结构的先决条件。

作为最佳做法，首先执行最小或基本升级，这意味着无需添加任何新功能和附加或非强制性参数即可执行升级。

如果 Oracle GoldenGate 在存在提取的源端升级，则线索文件格式保持不变。仅当将更高版本的 FORMAT RELEASE 调整为 EXTTRAIL 参数或执行 ETROLLOVER 时，才会将线索文件升级到更高版本的版本。这为升级存在复制的目标系统提供了独立的机会。升级所有目标系统时，您可以更新 EXTTRAIL 参数的格式发行版，以利用依赖较高线索文件格式的新功能。不需要重新定位任何进程。

确认环境已成功升级后，可以根据需要实施新功能和其他参数。

升级说明还包括同时升级源或目标数据库和 Oracle GoldenGate 的步骤。

Oracle GoldenGate 升级注意事项

在开始升级之前，请查看有关升级提取和复制的信息。

作为最佳做法，首先执行最小或基本升级，这意味着无需添加任何新功能和附加或非强制性参数即可执行升级。确认环境已成功升级后，可以根据需要实施新功能和其他参数。

尽管您可能仅升级源或目标安装，而不是同时升级这两个安装，但升级中涉及所有进程。必须按正确的顺序停止所有进程以进行升级，无论您升级的是哪个组件，并且必须处理线索，直到为空。

Oracle 建议您使用目标而不是源开始升级，以避免需要调整线索文件格式。

安装二进制文件和部署

使用微服务体系结构，在安装软件的位置与 Oracle GoldenGate 实例的部署目录结构（包含参数文件、报告文件和线索文件）之间存在强隔离。对于这两个领域，软件二进制文件和部署是严格分开的。因此，与部署相关的旧软件安装和新软件安装之间没有干扰。

在软件升级期间，新软件将独立安装。将停止使用旧软件的部署。然后，部署环境将调整为新软件，部署将重新启动。

如果在使用 OGG_HOME/lib/utl/reverseproxy/ReverseProxySettings 生成的主机上具有反向代理配置，则考虑重新配置该配置以利用 Oracle GoldenGate 提供的增强型 ReverseProxySetting 实用程序。有关 ReverseProxySetting 实用程序的详细信息，请参见 Configure Oracle GoldenGate Reverse Proxy with NGINX 。

安全注意事项

不能将不安全的部署更改为将安全部署或安全部署更改为不安全的部署。部署安全性必须在创建部署时配置，并且无法更改。如果要更改为安全部署，则需要创建另一个安全部署，然后手动将提取、复制、接收方服务和分发服务移至该新部署。

服务管理器和部署

升级 Oracle GoldenGate 时，必须先更新服务管理器。除非启用了 XAG，否则 Service Manager 的软件版本必须高于或等于部署的版本。

注：如果使用 Oracle Grid Infrastructure 代理 (XAG)，则还必须升级由升级的服务管理器管理的部署。启用 XAG 时，不支持使用不同于 Service Manager 的 Oracle GoldenGate 软件发行版在 Service Manager 下运行任何部署。

提取升级注意事项

如果要升级在合并配置中运行的多个提取处理（多个源到一个目标），请一次升级一个提取。

当提取重新启动并升级提取版本时，输出线索文件将自动滚转。

对于 Oracle AI Database 的 Oracle GoldenGate，当数据库升级到更高的二进制版本，然后降级到更低的二进制版本时，任何现有捕获都无法继续挖掘。必须删除捕获，并且必须创建新提取才能继续。

注：从 Oracle GoldenGate 26ai 开始，默认情况下提取过滤器标记了 DDL 操作，导致从捕获中排除 Oracle Data Pump DDL（标记为 00）。要捕获这些 DDL，请配置 DDLOPTIONS INCLUDETAG 00，但在双向设置中使用谨慎，因为这可能包括其他标记的 DDL 并引入复制循环。

有关更多信息，请参见 UPGRADE HEARTBEATTABLE 。

复制升级注意事项

所有复制安装都应同时升级。根据升级说明，确保所有目标系统上通向所有复制组的所有线索都处理到空，这一点至关重要。

从 Oracle GoldenGate 的 19c 发行版之前的发行版升级时，请确保不要在 Replicat 中使用 SOURCEDEF 参数，否则 Replicat 将异常终止。但是，如果线索文件格式为 12.2 之前的版本，则仍需要 SOURCEDEF，因为线索文件中不存在元数据。

TIMEZONE 数据类型与 Oracle GoldenGate 21c 和更高发行版的管理方式不同。因此，在使用提取写入的旧线索文件之后，可能需要运行 ALTER REPLICAT EXTSEQNO 命令与较新的线索文件同步。有关详细信息，请参见 ALTER REPLICAT 命令。

线索文件注意事项

如果 Oracle GoldenGate 在存在提取的源端升级，则线索文件格式保持不变。但是，仅当将更高版本的 FORMAT RELEASE 调整到 EXTTRAIL 参数或执行 ETROLLOVER 时，才会将线索文件升级到更高发行版。这为升级存在复制的目标系统提供了独立的机会。升级所有目标系统时，您可以更新 EXTTRAIL 参数的格式发行版，以利用依赖较高线索文件格式的新功能。不需要重新定位任何进程。