Oracle GoldenGate Microservicesのアップグレード- GUIベース

GUIを使用してOracle GoldenGate Microservicesをアップグレードするステップについて学習します。

この時点で、新しいOracle GoldenGate 26ai Microservicesホームと、Oracle GoldenGate MAの以前のリリース・ホームが必要です。

サービス・マネージャのアップグレード

最新のOracle GoldenGate MAバージョンをインストールした後、次のステップはサービス・マネージャをアップグレードすることです。

Oracle Grid Infrastructure Agent (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を使用する場合は、アップグレードしたService Managerによって管理されるデプロイメントもアップグレードする必要があります。サービス・マネージャへの別のGoldenGateソフトウェア・リリースを使用してサービス・マネージャでデプロイメントを実行することはサポートされません。

デプロイメントのアップグレード

デプロイメントをアップグレードするには:

  1. すべてのExtractおよびReplicatプロセスを正常に停止します。

    • Extractの正常な停止に時間がかかる可能性があるため、オープン(長時間実行)トランザクションおよびBounded Recoveryがあるか確認します。

    • 不要なオープン・トランザクション(SEND EXTRACT group_name SHOWTRANSなど)が表示されている場合は、それらのトランザクションをスキップするか、ただちに強制的に停止できます。この場合、次のコマンドを使用してBounded Recoveryチェックポイントを取得できます。

      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のみ) Linux上のOracle GoldenGate 26ai for SQL Serverには、データベース接続用のODBCドライバが含まれています。必須ではありませんが、パッケージ・ドライバを使用することをお薦めします。パッケージ・ドライバを使用するには、2つの新しい環境変数を作成し、以前に作成した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. デプロイメントの「アクション」フィールドで「再起動」アイコンをクリックし、「OK」をクリックしてデプロイメントを再起動します。

  11. 新しい管理サービスに戻り、すべてのExtractおよびReplicatを起動します。

    XAGを使用している場合は、デプロイメントのアップグレード後にGoldenGateインスタンスを再度有効にします。

     $ agctl enable goldengate <GoldenGate Name>

Service Managerおよびデプロイメントが再起動されると、アップグレードは完了します。

ノート: Oracle GoldenGate for PostgreSQLについては、Extractを起動する前にアップグレード後のステップを参照してください。