Oracle GoldenGate Microservices Architecture用のパッチのインストール

Oracle GoldenGateのパッチ適用とは、一時的な個別ソフトウェア修正および累積ソフトウェア・バンドル・パッチを、適用されるパッチと同じリリース・ラベルにある既存の下位バージョンのソフトウェアに適用することです。Oracle GoldenGateの累積パッチおよび個別パッチは、基本リリースまたは以前にパッチを適用したリリースに加えて適用でき、また特定のOracle GoldenGateバージョンに適用する必要がある個別パッチであることもあります。

Oracle GoldenGateのパッチは、My Oracle Supportで入手可能な場合、MOSの「パッチと更新版」セクションにあります。

ノート:

すでにデプロイメントおよび共有Service Managerが構成されている複数のインストールにパッチを適用する場合、Service Managerにパッチが適用されるのは、Service Managerが最初に作成されたOracle GoldenGateインストールにパッチが適用されるときのみです。

Oracle GoldenGateのパッチのダウンロード

Oracle GoldenGate構成の一部となる各システムのOracle GoldenGateのビルドに適したパッチをダウンロードします。

  1. ブラウザを使用して、https://support.oracle.comに移動します。
  2. Oracle IDとパスワードでログインします。
  3. 「パッチと更新版」タブを選択します。
  4. 「検索」タブで、「製品またはファミリ」をクリックします。
  5. 「製品」フィールドに、Oracle GoldenGateと入力します。
  6. 「リリース」ドロップダウン・リストから、ダウンロードするパッチ・バージョンを選択します。
  7. オプションで、検索結果にリストされるパッチの数を制限するには、「プラットフォーム」ドロップダウン・リストから必要なプラットフォームを選択します。
  8. 「検索」をクリックします。
  9. 「パッチの詳細検索結果」リストで、基準に最も合うパッチを選択します。

    パッチを選択すると、ビルドの説明の下にダイアログ・ボックスがポップアップし、パッチ詳細ページに進みます。

  10. パッチの「ダウンロード」リンクをクリックし、ファイルをシステムに保存します。

ノート:

パッチをインストールする前に、Oracle Databaseのリリース・ノートを参照し、新機能、パラメータの変更、パッチ適用要件、既知の問題、または現在の構成に影響するバグ修正がないか確認してください。

OPatchを使用したOracle GoldenGate Microservices Architectureへのパッチ適用

パッチをダウンロードしたら、パッチをインストールする前に、次の前提条件を設定します:

  1. OPatchの最新リリースをダウンロードしてインストールし、OPatchの最新リリースをインストールしたインストール・ディレクトリをメモします。

    OPatchのダウンロード場所の詳細は、最新のOPatch (6880880)バージョンのダウンロードおよびインストール方法(ドキュメントID 274526.1)を参照してください。

  2. Oracle GoldenGateパッチをダウンロードし、パッチZIPファイルの内容を格納するための場所を維持します。この場所または絶対パスは、後続のステップではpatch_top_dirと呼ばれます。

  3. patch_top_dirディレクトリに移動し、次のコマンドを実行して、パッチZIPファイルのコンテンツを以前に作成した場所に抽出します。

    cd patch_top_dir

    unzip patch_number_version_platform.zip

  4. 解凍したパッチ・ディレクトリに移動します:

    cd patch_top_dir/patch_number_dir

  5. ORACLE_HOME環境変数を、パッチを適用するOracle GoldenGateのインストール・ディレクトリに設定します。

    Linuxの場合: $ export ORACLE_HOME=GoldenGate_Installation_Path

    Windowsの場合: > set ORACLE_HOME=GoldenGate_Installation_Path

  6. ORACLE_HOMEおよびOPatchディレクトリの場所を含めるようにPATH環境変数を設定します。

    Linuxの場合: $ export PATH=$PATH:$ORACLE_HOME:/OPatch

    Windowsの場合: >set PATH=%PATH%;%ORACLE_HOME%;C:\OPatch

  7. パッチをインストールする際にOPatchがアクセスするOracleインベントリを確認します。インベントリを確認するには、次のコマンドを実行します。

    opatch lsinventory

    このコマンドでエラーが表示された場合は、Oracleサポート・サービスに問い合せて問題を解決してください。

  8. OPatchの前提条件チェックを実行し、成功することを確認します。

    opatch prereq CheckConflictAgainstOHWithDetail -ph ./

    エラーが表示された場合は、エラー・タイプを特定します。OPatchでは、競合は次のタイプに分けられます:

    • ORACLE_HOMEにすでに適用されているパッチとの競合: この場合、パッチのインストールを停止し、Oracleサポート・サービスに連絡してください。

    • 適用しようとしているパッチのサブセットである、ORACLE_HOMEにすでに適用されているパッチとの競合: この場合、新しいパッチにはORACLE_HOMEの既存のパッチの修正がすべて含まれているため、パッチのインストールを続けます。サブセットのパッチは、新しいパッチのインストール前に自動的にロールバックされます。

  9. Oracle GoldenGateにパッチを適用する前に、インストール用のデプロイメントがある場合は、Extract、Replicat、分散パスなどのすべてのプロセスを停止し、デプロイメントのすべてのサービスを停止してください。

    これは、管理サービスおよびサービス・マネージャのWebUIまたは管理クライアントで実行できます。

    管理クライアントを使用している場合は、次のステップを実行して各デプロイメントに接続し、すべてのプロセスを停止します。

  10. 管理クライアントを使用している場合は、各デプロイメントに接続し、すべてのプロセスを停止します。

    1. 管理クライアントを起動し、デプロイメントに接続します。

      /GoldenGate_Installation_Path/bin/adminclient

      OGG (not connected) 1>CONNECT https://host:srv_mgrport

      DEPLOYMENT <deployment-name> AS <user> PASSWORD <password>

    2. ExtractおよびReplicatプロセスおよび分散パスを停止します。
      STOP ER *
STOP DISTPATH ALL

    3. デプロイメントのサービスを停止し、すべて停止していることを確認します:

      STOP SERVICE *
STATUS SERVICE *

    4. 管理クライアントを終了し、サービス・マネージャを停止します:

      OGG (https://host:port deployment-name) exit

      ##Command for Service Manager not registered as a service/daemon

      export OGG_VAR_HOME=OGG_SRVMGR_DIRECTORY/var

      export OGG_ETC_HOME=OGG_SRVMGR_DIRECTORY/etc

      OGG_SRVMGR_DIRECTORY/bin/stopSM.sh

      ##Command for Service Manager registered as a service/daemon

      Linuxの場合: $ sudo systemctl stop OracleGoldenGate

      Windowsの場合: To stop the Service Manager for Windows, use the Windows Services applet (services.msc) and stop the Oracle GoldenGate Service Manager service.

  11. デプロイメントに対するすべてのユーザー・セッションを切断し、実行中のすべてのOracle GoldenGateプログラム(管理クライアントを含む)をクローズします。

    次のステップを実行してパッチをインストールします:

  12. 次のコマンドを実行してパッチをインストールします。

    opatch apply

    OPatchコマンドが起動すると、パッチが検証され、Oracle GoldenGateリリースのORACLE_HOMEにすでにインストールされているソフトウェアと競合しないことが確認されます。

  13. パッチのインストールが完了したら、次のコマンドを実行して、Oracleインベントリにインストールされたパッチが含まれていることを確認します:

    opatch lsinventory

    ノート:

    Oracle GoldenGate for PostgreSQLインストールにパッチを適用してリリース・バージョン21.8.0.0.2以降にした場合は、ExtractやReplicatを再起動する前に、新しいドライバ・バージョンを利用するように odbc.iniファイル内のDSNエントリを更新します。

  14. パッチのインストールが完了したら、サービス・マネージャ、サービスおよびOracle GoldenGateプロセスを起動します。

    1. サービス・マネージャを起動します。

      Linuxの場合:

      ##Command for Service Manager not registered as a service/daemon

      $ export OGG_VAR_HOME=OGG_SRVMGR_DIRECTORY/var

      $ export OGG_ETC_HOME=OGG_SRVMGR_DIRECTORY/etc

      $ OGG_SRVMGR_DIRECTORY/bin/startSM.sh

      ##Command for Service Manager registered as a service/daemon

      $ sudo systemctl start OracleGoldenGate

      Windowsの場合: Use the Windows Services applet (services.msc) and start the Oracle GoldenGate Service Manager service.

    2. 管理クライアントを起動し、デプロイメントに接続します。

      /GoldenGate_Installation_Path/bin/adminclient

      OGG (not connected) 1>CONNECT https://host:srvmgr_port DEPLOYMENT deployment-name AS user PASSWORD password

    3. デプロイメントのサービスを起動し、すべて実行されていることを確認します: 

      START SERVICE *
STATUS SERVICE *

    4. Extract、Replicatおよび分散パスを起動します:

      START ER *
START DISTPATH ALL

OPatchを使用したOracleおよびOracle以外のデータベースのパッチのアンインストール

パッチをアンインストールするには、次のステップに従います。

  1. 最新のOPatchバージョンをインストールし、必要な環境変数を設定し、Oracle GoldenGateのプロセスおよびサービスを停止します。パッチのインストール手順は、前のトピックに記載されています。

  2. patch_top_dir/patch_numberディレクトリに移動します。
    $ cd patch_top_dir/patch_number

  3. 次のコマンドを実行してパッチをアンインストールします。

    $ opatch rollback -id patch_number

  4. Oracle GoldenGateホームからサービスを開始します。