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

REST APIを使用してOracle GoldenGate MicroservicesをOracle GoldenGate Microservices 23aiにアップグレードする方法について学習します。

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

Oracle Technology NetworkまたはeDeliveryから最新のOracle GoldenGate Microservices 23aiソフトウェアをダウンロードします。
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
```
Oracle GoldenGate Microservices 23aiソフトウェアを、以前のリリースのOracle GoldenGate Microservicesが存在しているサーバー上のステージングの場所にアップロードします。
変更内容を保存してService Managerのホームページに戻ります。
デプロイメントの「アクション」ドロップダウンを選択し、「再開」を選択します。
「管理サービス」にログインし、「Replicat」セクションの「アクション」ボタンをクリックします。
「パラメータ・ファイル」タブをクリックし、BATCHSQLパラメータの値をBATCHESPERQUEUEの値の2倍に変更します。Replicatを起動する前にこれを実行する必要があります。たとえば: BATCHSQL BATCHESPERQUEUE 40000000
「管理サービス」に再度ログインし、ExtractおよびReplicatを起動します。

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/21c/gghome_1のような、新しいOracle GoldenGateホーム・ディレクトリの絶対パスを入力します。

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

ps -ef|grep -i servicemanager

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

cd $NEW_OGG_HOME/bin
$ ./ServiceManager

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

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

すべてのExtractおよびReplicatプロセスを正常に停止します。
- Extractの正常な停止に時間がかかる可能性があるため、オープン(長時間実行)トランザクションおよびBounded Recoveryがあるか確認します。
- 不要なオープン・トランザクション(SEND EXTRACT group_name SHOWTRANSなど)が表示されている場合は、それらのトランザクションをスキップするか、ただちに強制的に停止できます。この場合、次のコマンドを使用してBounded Recoveryチェックポイントを取得できます。
  
  SEND EXTRACT group_name, BR BRCHECKPOINT immediate

次の例に示すように、デプロイメントの環境変数を変更します。

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": "ORACLE_HOME" , "value": "/u01/app/oracle/product/21c/gghome_1/lib/instantclient"}
                                 , {"name": "LD_LIBRARY_PATH" , "value": "/u01/app/oracle/product/21c/gghome_1/lib/instantclient:/u01/app/oracle/product/21c/gghome_1/lib"}
                                 , {"name": "JAVA_HOME" , "value": "/u01/app/oracle/product/21c/gghome_1/jdk"}
                                 , {"name": "TNS_ADMIN" , "value": "/u01/app/oracle/network/admin"} ] }'

次の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"}'

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

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