升級 Oracle GoldenGate Microservices - 以 GUI 為基礎

瞭解使用 GUI 升級 Oracle GoldenGate Microservices 的步驟。

此時，您應該要有新的 Oracle GoldenGate 26ai Microservices 本位目錄，以及 Oracle GoldenGate MA 的任何先前版本本位目錄。

升級服務管理程式

安裝最新的 Oracle GoldenGate MA 版本之後，下一步就是升級 Service Manager。

如果使用 Oracle Grid Infrastructure 代理程式 (XAG)，請先停用 GoldenGate 執行處理，再升級 Service Manager：

$ agctl disable goldengate <goldengate_name>

以下是執行 Service Manager 升級的步驟：

  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，則升級的 Service Manager 所管理的部署也必須升級。不支援使用不同 GoldenGate 軟體版本在 Service Manager 下執行任何部署至 Service Manager。

升級部署

若要升級部署，請執行下列動作：

  1. 正常停止所有 Extract 和 Replicat 處理作業：

    • 檢查未結 (長時間執行) 交易和「限制的復原」，因為它可能需要較長的時間來正常停止 Extract。

    • 如果可看見任何不必要的未結交易，例如 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. 返回 「服務管理程式首頁」。

  10. 按一下部署之動作欄位中的重新啟動圖示，然後按一下確定以重新啟動部署。

  11. 重新登入新的「管理服務」，並啟動所有 Extract 和 Replicat。

    如果使用 XAG，請在升級部署後重新啟用 GoldenGate 執行處理：

     $ agctl enable goldengate <GoldenGate Name>

重新啟動 Service Manager 和部署後，便完成升級。

注意：如果是 Oracle GoldenGate for PostgreSQL，請參閱啟動任何 Extract 之前的升級後步驟。