REST APIを使用したOracle GoldenGate Microservicesのアップグレード

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

次の手順に従って、Oracle GoldenGateインストール・ソフトウェアを取得し、アップグレード用にディレクトリを設定します。

1. Oracle Technology NetworkまたはeDeliveryから最新のOracle GoldenGate Microservices 23aiソフトウェアをダウンロードします。

2. Oracle GoldenGate 23ai MAソフトウェアをステージング・フォルダに移動し、解凍します。

   Linuxの場合は、次の例を使用します。

   $ mv /home/user/fbo_ggs_Linux_x64_Oracle_services_shiphome.zip /tmp
   $ cd /tmp$ unzip fbo_ggs_Linux_x64_Oracle_services_shiphome.zip

3. インストーラを実行して、新しいOracle GoldenGateホーム・ディレクトリにソフトウェアをインストールします。

   Linuxの場合は、次の例を使用します。

   mkdir -p
   /u01/app/pracle/GoldenGate/23aicd
   /u01/oracle/stage/bo_ggs_Linux_x64_Oracle_services_shiphome/Disk1/runInstaller

   これにより、Oracle GoldenGateインストーラ・ウィザードが起動します。

4. このOracle GoldenGateインストール用のデータベースを選択し、「次」をクリックします。

5. Oracle GoldenGateをインストールする場所を指定します。前に作成したディレクトリ(空)を選択し、「次」をクリックします。

6. このインストールのメタデータを含むorainventoryディレクトリを指定し、「次」をクリックします。

7. ソフトウェアをインストールし、必要な場合はレスポンス・ファイルを保存します。

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

Service Managerのアップグレード

サービス・マネージャをアップグレードする場合、次のcURLの例を使用してOracle GoldenGateホームを更新できます。

curl -u adminname:adminpwd -X PATCH \
   https://hostname:port/services/v2/deployments/ServiceManager \
  -H 'cache-control: no-cache' \
  -d '{"oggHome":"new OGG_HOME_absolute_path", "status":"restart"}'

この構文では、/u01/app/oracle/product/23ai/gghome_1のような、新しいOracle GoldenGateホーム・ディレクトリの絶対パスを入力します。

次のコマンドを使用して、サービス・マネージャが新しい$OGG_HOMEから実行されているかどうかを確認します。

ps -ef|grep -i servicemanager

サービス・マネージャが実行中状態でない場合は、次のコマンドを実行します。

cd $NEW_OGG_HOME/bin
$ ./ServiceManager

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

デプロイメントをアップグレードするには、次の手順に従います。

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

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

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

     SEND EXTRACT group_name, BR BRCHECKPOINT immediate

2. 統合ビルド機能を使用するOracle GoldenGate for Oracle Databaseでは、TNS_ADMINのみをOracle GoldenGate内のOracle Database Clientソフトウェアに調整する必要があります。

   curl -k -u adminname:adminpwd -X PATCH \
   https://server.oracle.com:9000/services/v2/deployments/uat_01 \
   -H 'cache-control: no-cache' \
   -d '{"environment": [, {"name": "TNS_ADMIN" , "value": "/u01/app/oracle/network/admin"} ] }'

   ノート:

   21cから23aiにアップグレードする場合、この手順は不要です。Oracle GoldenGate 19c以前から23aiにアップグレードする場合は、TNS_ADMIN環境変数のみが必要です。

   OGG_HOME環境変数は、DATABASE_HOME、LD_LIBRARY_PATHおよびJAVA_HOMEを自動的に検出できます。

3. (SQL Serverのみ) Linux上のOracle GoldenGate 23ai for SQL Serverには、データベース接続用のODBCドライバが含まれています。必須ではありませんが、パッケージのドライバを使用することをお薦めします。パッケージのドライバを使用するには、2つの新しい環境変数を作成し、以前に作成したodbc.iniファイルを更新する必要があります。

   次の環境変数をデプロイメントに追加します:

   curl -k -u adminname:adminpwd -X PATCH \
   https://server.oracle.com:9000/services/v2/deployments/uat_01 \
   -H 'cache-control: no-cache' \
   -d '{"environment": [ , {"name": "ODBCSYSINI" , "value": "${OGG_HOME}/msodbc"} 
                         , {"name": "ODBCINI"    , "value": "${OGG_HOME}/msodbc/odbc.ini"}] }'

   新しい環境変数を作成したら、既存のodbc.iniファイルをOracle GoldenGateのmsodbcフォルダにコピーし、DSNエントリのODBCドライバ値を次のように変更します:

   Driver=Microsoft ODBC Driver for SQL Server

4. 次のcURLコマンドを実行して、Oracle GoldenGateデプロイメントをアップグレードします。

    curl -u SM username:SM password -X PATCH 
   http://hostname:servicemanager port/services/v2/deployments/Deployment-name 
   -H 'cache-control: no-cache'
   -d '{"oggHome":"new OGG_HOME complete path","status":"restart"}'

5. すべてのExtractおよびReplicatを起動します。

サービス・マネージャまたはデプロイメントが再起動すると、アップグレードが完了します。