14 アップグレード
この項では、OracleデータベースのためのOracle GoldenGate Microservices Architectureをアップグレードする手順について説明します。
トピック:
Oracle GoldenGateディストリビューションの入手
Oracle GoldenGateを入手するには、次のステップを実行します。
Oracle Fusion Middleware製品の検索やダウンロードの詳細は、Oracle Technology NetworkでOracle Fusion Middlewareのダウンロード、インストールおよび構成のREADMEファイルを参照してください。
親トピック: アップグレード
前提条件
Oracle GoldenGate Microservices Architectureをアップグレードするための前提条件について学習します。
ベスト・プラクティスとして、まず最小または基本アップグレードを実行します。これは、新機能や追加または必須でないパラメータを追加せずにアップグレードを実行することを意味します。
Oracle GoldenGateがExtractの存在するソース側でアップグレードされた場合、証跡ファイルの形式は変わりません。上位のFORMAT RELEASE
がEXTTRAIL
ファイルに調整された場合、またはETROLLOVER
が実行された場合にのみ、証跡ファイルは上位のリリースにアップグレードされます。これにより、Replicatが存在するターゲット・システムを独立してアップグレードできます。すべてのターゲット・システムがアップグレードされたら、EXTTRAIL
パラメータの形式リリースを更新して、上位の証跡ファイル形式に依存する新機能を利用できます。プロセスを再配置する必要はありません。
環境が正常にアップグレードされたことを確認した後、必要に応じて新機能および追加パラメータを実装できます。
アップグレード手順には、ソースまたはターゲット・データベースとOracle GoldenGateを同時にアップグレードするためのステップも含まれています。
Oracle GoldenGateのアップグレードに関する考慮事項
アップグレードを開始する前に、ExtractおよびReplicatのアップグレードに関する情報を確認してください。
ソース・インストールとターゲット・インストールの両方ではなく、どちらか1つのみをアップグレードする場合でも、アップグレードにはすべてのプロセスが関係します。どのコンポーネントをアップグレードするかに関係なく、すべてのプロセスをアップグレードの適切な順序で停止し、空になるまで証跡を処理する必要があります。
証跡ファイル・フォーマットを調整する必要がないように、ソースではなくターゲットからアップグレードを開始することをお薦めします。
インストール・バイナリおよびデプロイメント
Microservice Architectureでは、ソフトウェアがインストールされている場所と、パラメータ・ファイル、レポート・ファイルおよび証跡ファイルを含むOracle GoldenGateインスタンスのデプロイメント・ディレクトリ構造との間に強力な分離があります。どちらの領域でも、ソフトウェア・バイナリとデプロイメントは厳密に分離されています。そのため、デプロイメントに関連する新旧のソフトウェア・インストールの間に干渉はありません。ソフトウェアのアップグレード中に、新しいソフトウェアは個別にインストールされます。古いソフトウェアを使用しているデプロイメントは停止されます。その後、デプロイメント環境は新しいソフトウェアに調整され、デプロイメントが再起動されます。
ホスト・マシンにOGG_HOME/lib/utl/reverseproxy/ReverseProxySettings
で生成されたリバース・プロキシ構成がある場合は、それを再構成して、Oracle GoldenGate 21c (21.3)以降のリリースで使用可能な拡張ReverseProxySetting
ユーティリティを利用することを検討してください。
サービス・マネージャおよびその他のデプロイメントのアップグレードに関する考慮事項
Oracle GoldenGateをアップグレードする場合は、最初にサービス・マネージャを更新する必要があります。サービス・マネージャのソフトウェア・バージョンは、デプロイメントのバージョン以上である必要があります。サービス・マネージャが最も高いバージョンで実行され、デプロイメントがそれより低いバージョンで実行されていても問題はありません。
アップグレードが完了したら、UPGRADE HEARTBEATTABLE
コマンドを実行して、表とラグのビューに追加の列を追加します。これらの追加の列は、Extractの再開位置の追跡に使用されます。詳細は、UPGRADE HEARTBEATTABLE
を参照してください。
トピック:
Extractのアップグレードに関する考慮事項
統合構成(多数のソースと1つのターゲット)で動作する複数のExtractプロセスをアップグレードする場合は、一度に1つのExtractをアップグレードします。
出力証跡ファイルはExtractの再起動時に自動的にロールオーバーされ、統合Extractバージョンはアップグレードされます。
Oracle GoldenGate 21cではTIMEZONE
データ型が異なる方法で管理されるため、Extractバージョン1によって書き込まれた古い証跡ファイルを使用した後に、ALTER REPLICAT extseqno
コマンドを実行して新しい証跡ファイルと同期する必要がある場合があります。
Replicatのアップグレードに関する考慮事項
すべてのReplicatインストールを同時にアップグレードする必要があります。全ターゲット・システムのすべてのReplicatグループにつながる証跡すべてを、アップグレード手順に従って、空になるまで処理することが重要です。
Oracle GoldenGateの19cリリースより前のリリースからアップグレードする場合は、ReplicatでSOURCEDEF
パラメータを使用しないでください。そうしないと、Replicatが異常終了します。ただし、証跡ファイル形式が12.2より前である場合は、証跡ファイル内にメタデータが存在しないため、SOURCEDEF
が必要です。
Oracle GoldenGate 21cではTIMEZONE
データ型が異なる方法で管理されるため、Extractによって書き込まれた古い証跡ファイルを使用した後に、ALTER REPLICAT extseqno
コマンドを実行して新しい証跡ファイルと同期する必要がある場合があります。
Oracle GoldenGate Microservicesのアップグレード – GUIベース
GUIを使用してOracle GoldenGate Microservicesをアップグレードするステップについて学習します。
次の手順に従って、Oracle GoldenGateインストール・ソフトウェアを取得し、アップグレード用にディレクトリを設定します。
-
Oracle Technology NetworkまたはeDeliveryから最新のOracle GoldenGate Microservices 21cソフトウェアをダウンロードします。
-
Oracle GoldenGate 21c 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 21cソフトウェアを、以前のリリースのOracle GoldenGate Microservicesが存在しているサーバー上のステージングの場所にアップロードします。
-
変更を保存してサービス・マネージャの概要ページに戻ります。
-
デプロイメントの「アクション」ドロップダウンを選択し、「再開」を選択します。
-
「管理サービス」にログインし、「Replicat」セクションの「アクション」ボタンをクリックします。
-
「パラメータ・ファイル」タブをクリックし、
BATCHSQL
パラメータの値をBATCHESPERQUEUE
の値の2倍に変更します。Replicatを起動する前にこれを実行する必要があります。例:BATCHSQL BATCHESPERQUEUE 40000000
。 -
「管理サービス」に再度ログインし、ExtractおよびReplicatを起動します。
この時点で、新しいOracle GoldenGate 21c MAホームと、Oracle GoldenGate MAの以前のリリース・ホームが必要です。
サービス・マネージャのアップグレード
-
URL https://hostname:servicemanager_portからサービス・マネージャにログインします。
-
サービス・マネージャの概要ページの「デプロイメント」セクションで「サービス・マネージャ」リンクを選択します。
-
「デプロイメントの詳細」セクションの横にある鉛筆アイコンをクリックし、GoldenGateホーム・パスを編集するためのダイアログ・ボックスを開きます。
-
「GoldenGateホーム」を、新しいOracle GoldenGateホームへのフルパスで更新します。
-
「適用」をクリックします。
-
「アクション」ドロップダウンを使用して、サービス・マネージャを再起動します。
デプロイメントのアップグレード
デプロイメントは、サービス・マネージャと同じステップでアップグレードすることも、サービス・マネージャのアップグレード後にアップグレードすることもできます。
デプロイメントをアップグレードするには、次の手順に従います。
親トピック: アップグレード
REST APIを使用したOracle GoldenGate Microservicesのアップグレード
REST APIを使用してOracle GoldenGate MicroservicesをOracle GoldenGate Microservices 21cにアップグレードする方法を説明します。
次の手順に従って、Oracle GoldenGateインストール・ソフトウェアを取得し、アップグレード用にディレクトリを設定します。
-
Oracle Technology NetworkまたはeDeliveryから最新のOracle GoldenGate Microservices 21cソフトウェアをダウンロードします。
-
Oracle GoldenGate 21c 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 21cソフトウェアを、以前のリリースの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を起動します。
サービス・マネージャまたはデプロイメントが再起動すると、アップグレードが完了します。
親トピック: アップグレード