升级 Oracle GoldenGate 微服务 - 基于 GUI

了解使用 GUI 升级 Oracle GoldenGate 微服务的步骤。

此时，您应该拥有新的 Oracle GoldenGate 26ai Microservices 主目录和 Oracle GoldenGate MA 的任何先前发行版主目录。

升级服务管理器

安装最新的 Oracle GoldenGate MA 版本后，下一步是升级服务管理器。

如果使用 Oracle Grid Infrastructure 代理 (XAG)，请在升级服务管理器之前禁用 GoldenGate 实例：

$ agctl disable goldengate <goldengate_name>

以下是执行服务管理器升级的步骤：

  1. 从 URL 登录到服务管理器： https：//hostname:servicemanager_port

  2. 展开“服务管理器概览”页的部署部分中的 ServiceManager 链接。

  3. 单击详细信息，然后单击“部署详细信息”部分旁边的铅笔图标以打开用于编辑 GoldenGate 主目录路径的对话框。

  4. 使用新 Oracle GoldenGate 主目录的完整路径更新 Oracle GoldenGate 主目录路径。

  5. 单击应用。

  6. 使用操作下拉列表重新启动服务管理器。

    如果使用 XAG，请更新 GoldenGate 实例参数：

     $ agctl modify goldengate <GoldenGate Name>  --gg_home <New OGG_HOME directory> --oracle_home <New OGG_HOME directory>/lib/instantclient

    注意：如果使用 XAG，则还必须升级由升级的服务管理器管理的部署。不支持使用服务管理器的其他 GoldenGate 软件发行版在服务管理器下运行任何部署。

升级部署

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

  1. 正常停止所有提取和复制进程：

    • 检查是否打开（长时间运行）事务和有边界恢复，因为正常停止提取可能需要较长时间。

    • 如果任何不必要的未结事务处理可见（例如 SEND EXTRACT group_name SHOWTRANS），则可以跳过或立即强制停止这些事务处理。在这种情况下，可以使用以下命令检索边界恢复检查点：

      SEND EXTRACT group_name, BR BRCHECKPOINT immediate

  2. 从服务管理器验证 Oracle GoldenGate 26ai 主目录的当前位置。

    1. 登录到服务管理器：http://hostname:servicemanager_port

    2. 展开“服务管理器”主页的“部署”部分中的 ServiceManager 链接。

    3. 复制 Oracle GoldenGate 主目录路径。

  3. 返回到部署部分并展开要升级的部署的链接。

  4. 依次单击详细信息和部署详细信息部分旁边的铅笔图标可打开用于编辑 GoldenGate 主目录路径的对话框。

  5. 使用新 Oracle GoldenGate 主目录的完整路径更新 Oracle GoldenGate 主目录路径。

  6. 单击提交并确认 Oracle GoldenGate 主目录路径已更新。

  7. 根据要升级的部署的数据库，可能会对环境变量设置进行其他更改。

    如果需要，单击配置可修改环境变量的设置。

    （仅限 Oracle GoldenGate for Oracle AI Database）“统一构建”功能仅要求将 TNS_ADMIN 调整为 Oracle GoldenGate 中的 Oracle Database Client 软件。

    TNS_ADMIN = tnsnames.ora 和 sqlnet.ora 的位置

    OGG_HOME 环境变量可以自动检测 DATABASE_HOME、LD_LIBRARY_PATH 和 JAVA_HOME。注：从 21c 升级到 26ai 时，无需执行此步骤。如果从 Oracle GoldenGate 19c（或更早版本）升级到 26ai，则只需要 TNS_ADMIN 环境变量。

    （仅限 Oracle GoldenGate for SQL Server）Oracle GoldenGate 26ai for SQL Server on Linux 包含用于数据库连接的 ODBC 驱动程序。虽然不是必需的，但建议使用打包的驱动程序。要使用打包的驱动程序，需要创建两个新的环境变量，并且需要更新以前创建的任何 odbc.ini 文件。

    将以下环境变量添加到部署中：

    • ODBCSYSINI = ${OGG_HOME}/msodbc

    • ODBCINI = ${OGG_HOME}/msodbc/odbc.ini

    创建新环境变量后，将现有 odbc.ini 文件复制到 GoldenGate msodbc 文件夹，并将任何 DSN 条目的 ODBC 驱动程序值更改为以下值：

    Driver=Microsoft ODBC Driver for SQL Server

  8. 单击提交以保存对环境变量所做的更改。

  9. 返回到 Service Manager 主页。

  10. 单击部署的操作字段中的重新启动图标，然后单击确定以重新启动部署。

  11. 重新登录到新的管理服务并启动所有提取和复制。

    如果使用 XAG，请在升级部署后重新启用 GoldenGate 实例：

     $ agctl enable goldengate <GoldenGate Name>

服务管理器和部署重新启动后，升级即告完成。

注：对于适用于 PostgreSQL 的 Oracle GoldenGate，请参阅升级后步骤，然后再启动任何提取。