OCI GoldenGateデプロイメントの管理

GoldenGateのバージョン、アップグレード、通知の受信またはスヌーズの方法とタイミング、およびアップグレードのロールバック方法について学習します。

GoldenGateバージョンについて

OCI GoldenGateは、複数の同時バージョン(Oracle GoldenGate、Oracle GoldenGate for Big Data、Oracle GoldenGate for MySQLなど)をサポートし、いくつか例を挙げます。適切なバージョンの詳細は、バージョン・リファレンスを参照してください。

すべてのリリースにはビルド番号があります。リリースには3つのタイプがあります。

  • メジャー: ビルド番号の最初の数字はメジャー・リリースを示します。例、 21
  • バンドル: 2番目の数字はバンドル・リリースを示します。バンドル・リリースは、メジャー・リリースの一連のバグ修正です。例: 215
  • マイナー: 末尾の数値はマイナー・リリースを示します。マイナー・リリースは、バンドル・リリースでの1つ以上のバグ修正で構成されます。例: 21.5.0.0.0
ノート

すべてのリリース・タイプには、セキュリティ修正を含めることができます。

リリースのタイプおよびセキュリティ修正が含まれているかどうかに応じて、新しいバージョンが使用可能になったときにデプロイメントをアップグレードする特定の時間があります。

リリース・タイプ 重度 バンドル 軽度
非セキュリティ修正 365日 180日 該当なし
セキュリティ修正 該当なし 14日 14日

指定した時間枠内に手動でアップグレードしない場合、デプロイメントは、この時間枠の最後に自動的に最新バージョンにアップグレードされます。

ノート

バージョンがサポートされる日付は、「アップグレード・デプロイメント」画面および「アップグレード」リストに表示されるまで表示できます。

バージョンの廃止

GoldenGateバージョンは、リリース日から非推奨の日付まで使用できます。バージョンが非推奨になると、デプロイメントの作成またはアップグレードのために選択できなくなります。

非推奨期間では、バージョン・アップグレードと同じ時間枠が使用されます。例:

  • メジャーバージョンリリースから365日後、以前のメジャーバージョンは非推奨になりました。
  • バンドル・バージョン・リリースから180日後、同じメジャー・リリースの以前のバンドル・バージョンは非推奨になりました。
  • セキュリティ修正リリース(バンドルまたはマイナー・リリースの場合)の14日後、同じメジャー・リリースの以前のバージョンはすべて非推奨になりました。
ノート

リリース日はリージョン間で異なる場合があります。

アップグレードのスケジュール

新しいGoldenGateバージョンが使用可能な場合に、デプロイメントをアップグレードする期間の開始を定義するメンテナンス・ウィンドウをカスタマイズできます。メンテナンス・ウィンドウを定義しない場合、OCI GoldenGateでは、最新バージョンのリリース日に基づいてデプロイメントをアップグレードする最適な時間が計算されます。

ノート

メンテナンス・ウィンドウが定義されていない場合、OCI GoldenGateは、自動アップグレード期間の計算された終了に最も近い週末にアップグレードをスケジュールします。

デプロイメントの作成時にOCI GoldenGateメンテナンス・ウィンドウをカスタマイズすることも、後でデプロイメントの詳細ページからカスタマイズすることもできます。新しいGoldenGateバージョンが使用可能な場合、選択した正確な日時でデプロイメントが自動的にアップグレードされます。ただし、手動アップグレードのための新しいバージョンの時間枠がカスタマイズされたメンテナンス・ウィンドウの範囲外になる場合、デプロイメントは選択した日時より前に自動的にアップグレードできます。

たとえば、2023年1月1日にデプロイメントをアップグレードする残り30日があるとすると、1月31日火曜日まで手動でアップグレードできます。ただし、カスタマイズされたメンテナンス・ウィンドウは日曜日の午後10時に開始されます。このメンテナンス・ウィンドウでは、OCI GoldenGateによってカスタマイズしたウィンドウが常に優先されるため、2月4日日曜日の午後10時にOCI GoldenGateによってデプロイメントがアップグレードされます。

カスタマイズされたメンテナンス・ウィンドウを編集するには:

  1. デプロイメントの詳細ページの「デプロイメント情報」領域のGoldenGateにある「メンテナンス」で、「編集」をクリックします。
  2. 「メンテナンス・パラメータの編集」ダイアログで:
    1. (オプション)「メンテナンス・ウィンドウのカスタマイズ」を選択して、次のフィールドをデフォルト値から変更します。
    2. 「メジャー・リリースの自動アップグレード期間(日数)」に、0から365までの値を入力します。
    3. バンドル・リリースの自動アップグレード期間(日数)に、0から180までの値を入力します。
    4. 「セキュリティ・パスの自動アップグレード期間(日数)」に、0から14までの値を入力します。
    5. (オプション)「マイナー・リリースの自動アップグレードの有効化」を選択し、「マイナー・リリースの自動アップグレード期間(日数)」に値を入力します。
  3. 「変更の保存」をクリックします。

アップグレードの前に

デプロイメントをアップグレードする前に、次のタスクを完了し、長時間実行トランザクションがないか確認してください。

アーカイブ・ログがリカバリに使用可能であることの確認

管理クライアントで次のコマンドを使用して、Extractの開始時にリストアが必要になる可能性のある最も古いアーカイブ・ログを判断します。Recovery Checkpointフィールドに、リカバリに必要な最も古いログが表示されます。
Admin Client > INFO EXTRACT group_name, SHOWCH

アップグレード・アクティビティはピーク時間外に実行することをお薦めします。実行時間の長いトランザクションがある場合は、ソース・システムで、新しいExtractが通常のリカバリ・チェックポイントから処理を開始する必要があり、バインド・リカバリ・チェックポイントより、Extractを停止した時点で最も古いオープン・トランザクションの最初のレコードが、システムではなくログにある場合。

実行時間の長いトランザクションのクリア

長時間実行トランザクションをクリアするには、次の2つのオプションがあります。

  • アーカイブを、次に示すリカバリ・チェックポイントで示されている時点までリストアします。
    Admin Client > INFO EXTRACT
    (ソース・データベースでこれがサポートされている場合。)
  • アップグレードしているExtractに適用されるトランザクションで、長時間実行されているものを消去します。これは、トランザクションをスキップするか、コミット済トランザクションとして強制的に証跡に書き込むことで実行します。トランザクションをスキップするとデータが失われる可能性があり、トランザクションを強制的に証跡に書き込むと、トランザクションのロールバック時に、不要なデータが追加される可能性があります。トランザクションのスキップまたは強制を実行するには:
    1. オープン・トランザクションの表示:
      Admin Client > SEND EXTRACT group_name, SHOWTRANS
    2. クリーンアップする任意のトランザクションのトランザクションIDを記録します。
    3. SEND EXTRACTおよびSKIPTRANSオプションを使用してトランザクションをスキップするか、FORCETRANSを使用してコミット済トランザクションとして現在の状態を強制的に証跡に書き込む。例:
      Admin Client > SEND EXTRACT group_name, {SKIPTRANS | FORCETRANS transaction_ID [THREAD n] [FORCE]
    4. 長時間実行されているトランザクションのクリーンアップが終了したら、バインド・リカバリ・チェックポイントを強制します。
      Admin Client> SEND EXTRACT group_name, BR BRCHECKPOINT IMMEDIATE

Replicatの同期

パラレルReplicatを使用するデプロイメントの場合、アップグレードする前にReplicatを同期してください。
Admin Client > SYNCHRONIZE REPLICAT group_name

詳細は、SYNCHRONIZE REPLICATコマンドライン・インタフェース・リファレンスを参照してください。

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

最初に「アップグレード前」ステップを完了していることを確認します。

デプロイメントをアップグレードすると、

  • デプロイメントは停止され、アップグレードの完了後に再起動されます。
  • すべてのOracle GoldenGateプロセスは停止され、自動起動するように構成されている場合は再起動されます。
デプロイメントをアップグレードするには:
  1. 「デプロイメント」ページで、アップグレードするデプロイメントを選択します。
  2. デプロイメントの詳細ページで、「アクション」メニューから「アップグレード」を選択します。
  3. 「デプロイメントのアップグレード」パネルで、アップグレード先として使用可能なGoldenGateバージョンを選択し、「アップグレード」をクリックします。
    ノート

    バージョンについてさらに学習します。

アップグレードの完了には数分かかります。「アップグレード」をクリックすると、アップグレードの完了後、またはアップグレード・プロセス中に問題が発生した場合に、デプロイメントの詳細ページで「アップグレード」が表示されます。

ハートビート表のアップグレード
ハートビート表がデプロイメントで使用されている場合は、それらもアップグレードする必要があります。アップグレードの完了後、次のいずれかを実行できます。
  • 管理クライアントでUPGRADE HEARTBEATTABLEコマンドを実行して、表およびラグのビューに追加の列を追加します。GoldenGateは、これらの追加列を使用して、Extractの再開位置を追跡します。さらに学ぶ
  • デプロイメント・コンソールで管理コンソールのナビゲーション・メニューを開き、「構成」をクリックします。データベースへの接続ハートビート表が表示されたら、「アクション」メニューから「アップグレード」を選択します。

アップグレード通知

OCI GoldenGateは、アップグレードがいつ使用可能で、アップグレードがスケジュールされるかのイベント通知を送信します。詳細は、GoldenGateアップグレード・イベント・タイプまたはイベントの詳細を参照してください。

アップグレードの時期 180日未満 30日未満 7日未満
通知期間 30日 7日 毎日
ノート

OCI GoldenGateは、セキュリティ修正の通知を毎日送信します。

また、今後のアップグレードについては、デプロイメントの詳細ページに表示される通知バナーから学習することもできます。

通知のスヌーズ

イベントおよびバナー通知をスヌーズまたは遅延できます。手動アップグレードの時間枠の最後に近づくと、スヌーズ期間が変わります。

アップグレードの時期 180日未満 30日未満 7日未満
スヌーズ期間 30日 7日 使用不可
ノート

マイナー・アップグレードまたはバンドル・アップグレードのセキュリティ修正のスヌーズは許可されていません。

スヌーズはいつでもキャンセルできます。

アップグレードのロールバック

デプロイメント・バージョンを前のバージョンにロールバックできます。ロールバックは、以前のバージョンに成功した最新のアップグレードでのみ許可されます。

ノート

ロールバック中、デプロイメント・ファイル・システムはアップグレード前に最後の状態にリストアされます。

以前のバージョンが非推奨の場合、ロールバックは許可されません。

アップグレードをロールバックするには:

  1. 「デプロイメント」ページから、ロールバックするデプロイメントを選択します。
  2. デプロイメントの詳細ページで、「アップグレード」を選択します。
  3. 「アップグレード」リストで、最新バージョンの前のバージョンを見つけ、「アクション」メニューから「ロールバック」を選択します。
  4. ロールバック先のバージョンを選択し、「ロールバック」をクリックします。
    ノート

    使用可能なバージョンのリストは、バージョン・リファレンスを参照してください。

デプロイメントのステータスは更新中に変更され、完了までに数分かかります。

アップグレードの再スケジュール

自動スケジュールされたアップグレードを再スケジュールできます。アップグレードをより近い日付に再スケジュールするか、後で延期できます。
ノート

再スケジュールでは、メンテナンス・ウィンドウは考慮されません。新規にスケジュールした日付は、OCI GoldenGateの定義した値より後の日付にできません。詳細は、「GoldenGateのバージョンについて」を参照してください。

アップグレードを再スケジュールするには:

  1. 「デプロイメント」ページで、アップグレードを再スケジュールするデプロイメントを選択します。
  2. デプロイメントの詳細ページで、「アップグレード」を選択します。
  3. 「アップグレード」リストで、最新バージョンの前のバージョンを見つけ、「アクション」メニューから「再スケジュール」を選択します。
  4. 「デプロイメント・アップグレードの再スケジュール」ウィンドウで、アップグレードを実行する日時を選択します。
  5. 「変更の保存」をクリックします。

「アップグレード」リストでは、スケジュールされた日時に変更が反映されます。

アップグレードの取消

自動スケジュール済アップグレードを取り消すことができるのは、ターゲット・バージョンがマイナー・リリースの場合のみです。
ノート

マイナー・リリースへのアップグレードを取り消しても、マイナー・リリースの自動アップグレードは暗黙的に無効になることはなく、手動で無効にする必要があります。マイナー・リリースの自動アップグレードは、デプロイメントの詳細ページから無効にできます。詳細は、アップグレードのスケジュールを参照してください。

アップグレードを取り消すには:

  1. 「デプロイメント」ページから、アップグレードを取り消すデプロイメントを選択します。
  2. デプロイメントの詳細ページで、「アップグレード」を選択します。
  3. 「アップグレード」リストで、最新バージョンの前のバージョンを見つけ、「アクション」メニューから「取消」を選択します。
  4. 「デプロイメント・アップグレードの取消」ウィンドウで、「デプロイメント・アップグレードの取消」をクリックします。

アップグレードのステータスが[取消済み]に更新されます。

既知の問題

21.15または23.xビルドから21.14へのロールバック中に発生した問題

21.15または23.xビルドのロールバックを試行する場合:

  • Oracle (21.14.0.0.0_240525)
  • ビッグ・データ(21.14.0.0_240515)
  • MySQL (21.14.0.0.0.0_240404)
  • MSSQL (21.14.0.0.0_240404)

次のいずれかの問題が発生する可能性があります。

  • 21.15以降に導入された新しいウォレット暗号化機能による接続/資格証明の問題の欠落。

    回避策: デプロイメントへの既存の接続の割当てを解除して再割当てし、使用中の分散パスまたは受信パスに必要な欠落しているユーザーを再作成する必要があります。

  • 23.xから21.14へのロールバックでパフォーマンス・メトリック・サービスに問題があるため、サービス・マネージャの起動に失敗します。この問題が発生した場合は、Oracle Supportに連絡してください。
  • Oracle GoldenGateプロセスは、「OGG-02431 Invalid record header found in Checking file」というエラーで失敗します。

    回避策: シリーズで使用可能な最新の21.14ビルドにデプロイメントをアップグレードします。問題が続く場合は、Oracle Supportに連絡してください。