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

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

次の手順に従って、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ホーム・ディレクトリにソフトウェアをインストールします。
Linuxの場合は、次の例を使用します。
```
mkdir -p
/u01/app/pracle/GoldenGate/23aicd
/u01/oracle/stage/bo_ggs_Linux_x64_Oracle_services_shiphome/Disk1/runInstaller
```
これにより、Oracle GoldenGateインストーラ・ウィザードが起動します。
このOracle GoldenGateインストール用のデータベースを選択し、「次」をクリックします。
Oracle GoldenGateをインストールする場所を指定します。前に作成したディレクトリ(空)を選択し、「次」をクリックします。
このインストールのメタデータを含むorainventoryディレクトリを指定し、「次」をクリックします。
ソフトウェアをインストールし、必要な場合はレスポンス・ファイルを保存します。

この時点で、新しい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/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を起動します。

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