OCI GoldenGateデプロイメントのメンテナンス

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

GoldenGateバージョンについて

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

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

• メジャー: ビルド番号の最初の番号はメジャーリリースを示します。例 21

• バンドル: 2番目の番号はバンドル・リリースを示します。バンドル・リリースは、メジャー・リリースのバグ修正のセットです。例 215

• マイナー: 末尾の番号はマイナー・リリースを示します。マイナー・リリースは、バンドル・リリース上の1つ以上のバグ修正で構成されます。例 21.50.0.0

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

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

リリース・タイプ	メジャー	Bundle	マイナー
非セキュリティ修正	365日	180 days	該当しません
セキュリティ修正	該当しません	14 days	14 days

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

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

バージョンの非推奨

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

非推奨期間は、バージョン・アップグレードと同じタイム・フレームを使用します。たとえば:

• メジャー・バージョン・リリースから365日後、以前のメジャー・バージョンは非推奨になりました。

• バンドル・バージョン・リリースから180日後、同じメジャー・リリースの以前のバンドル・バージョンは非推奨になりました。

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

ノート: 2027年4月以降、すべての21cデータ・レプリケーション・デプロイメントは、使用可能な最新のリリース・バージョンに自動アップグレードされます。リリース日は地域によって異なる場合があります。

予定アップグレード

デプロイメントをアップグレードするタイミングを定義するメンテナンス・ウィンドウをカスタマイズできます。メンテナンス・ウィンドウを定義しない場合、OCI GoldenGateは、最新バージョンのリリース日に基づいてデプロイメントをアップグレードする最適な時間を計算し、計算された自動アップグレード期間の終了に最も近い週末にデプロイメントを自動的にアップグレードします。

ノート:メジャー、バンドルまたはマイナー・リリースの新規バージョンがリリースされると、OCI GoldenGateは、該当するタイムライン(メジャーの場合は365日、バンドルの場合は180日、マイナーの場合は14日、セキュリティ修正の場合は180日)に基づいてアップグレードをスケジュールします。同じリリースの新しいバージョンが使用可能になった場合、サービスは使用可能な最新バージョンを使用してデプロイメントをアップグレードしますが、スケジュールされた日付は変更されません。

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

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

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

1. 「デプロイメントの詳細」ページの「デプロイメント」情報領域の「GoldenGate」で、「メンテナンス」として「編集」を選択します。

2. 「メンテナンス・パラメータの編集」ダイアログで、次の手順を実行します。

   1. (オプション)「メンテナンス・ウィンドウのカスタマイズ」を選択して、次のフィールドをデフォルト値から変更します。

   2. 「メジャー・リリース自動アップグレード期間(日数)」に、0から365までの値を入力します。

   3. バンドル・リリースの自動アップグレード期間(日数)には、0から180の間の値を入力します。

   4. 「セキュリティ・パスの自動アップグレード期間(日数)」に、0から14までの値を入力します。

   5. (オプション)「マイナー・リリース自動アップグレードの有効化」を選択し、マイナー・リリース自動アップグレード期間(日数)の値を入力します。

3. 「Save changes」を選択します。

アップグレードする前に

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

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

管理クライアントで次のコマンドを使用して、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

レプリケートの同期

Parallel Replicatsを使用したデプロイメントでは、アップグレード前にReplicatsを同期してください:

Admin Client > SYNCHRONIZE REPLICAT group_name

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

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

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

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

• デプロイメントは停止され、アップグレードの完了後に再起動されます。

• すべてのOracle GoldenGateプロセスは停止され、自動起動するように構成されている場合は再起動されます。

デプロイメントをアップグレードするには:

1. 「デプロイメント」ページで、アップグレードするデプロイメントを選択します。

2. デプロイメントの詳細ページで、「アクション」メニューから「アップグレード」を選択します。

3. 「デプロイメントのアップグレード」パネルで、アップグレード先の使用可能なGoldenGateバージョンを選択し、「アップグレード」を選択します。

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

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

ハートビート表のアップグレード

デプロイメントで使用されている場合は、ハートビート表もアップグレードする必要があります。アップグレードの完了後、次のいずれかを実行できます。

• 管理クライアントでUPGRADE HEARTBEATTABLEコマンドを実行して、表とラグのビューに列を追加します。GoldenGateは、これらの追加列を使用してExtractの再起動位置を追跡します。さらに学ぶ。

• デプロイメント・コンソールで、管理コンソールのナビゲーション・メニューを開き、「Configuration」を選択します。データベースへの接続ハートビート表が表示されたら、「Action」メニューから「Upgrade」を選択します。

アップグレード通知

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

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

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

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

通知のスヌーズ

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

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

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

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

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

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

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

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

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

1. 「デプロイメント」ページで、ロールバックするデプロイメントを選択します。

2. デプロイメントの詳細ページで、「アップグレード」を選択します。

3. 「アップグレード」リストで、最新の以前のバージョンを検索し、その「アクション」メニューから「ロールバック」を選択します。

4. ロールバック先のバージョンを選択し、「ロールバック」を選択します。

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

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

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

自動スケジュール済アップグレードを再スケジュールできます。アップグレードをより近い日付に再スケジュールしたり、より後の日付に延期したりできます。

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

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

1. 「デプロイメント」ページから、アップグレードを再スケジュールするデプロイメントを選択します。

2. デプロイメントの詳細ページで、「アップグレード」を選択します。

3. 「アップグレード」リストで、最新の以前のバージョンを見つけ、その「アクション」メニューから「再スケジュール」を選択します。

4. 「デプロイメント・アップグレードの再スケジュール」ウィンドウで、アップグレードを実行する日時を選択します。

5. 「Save changes」を選択します。

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

取消アップグレード

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

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

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

1. 「デプロイメント」ページから、アップグレードを取り消すデプロイメントを選択します。

2. デプロイメントの詳細ページで、「アップグレード」を選択します。

3. 「アップグレード」リストで、最新の以前のバージョンを見つけ、その「アクション」メニューから「取消」を選択します。

4. 「デプロイメント・アップグレードの取消」ウィンドウで、「デプロイメント・アップグレードの取消」を選択します。

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

既知問題

Oracle GoldenGate 23.26.xへのアップグレード後、デプロイメント・コンソール502不正ゲートウェイ・エラーまたはログイン後のGoldenGateプロセスのリスト失敗

Oracle Cloud Infrastructure GoldenGate 23.26デプロイメントは、以前のラベルからバージョン23.26.xにアップグレードした後、または23.26.xデプロイメントで停止/起動操作を実行した後に異常になる可能性があります。

回避策:アップグレードによって影響を受けるOracleデプロイメントをラベルoggoracle:23.26.1.0.0_260331に変更して、この問題を修正します。

Big Dataおよびその他のOracle以外のラベルについては、まもなく修正が発表されます。影響を防ぐために、暫定的な手動緩和についてサポートに連絡してください。

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

21.15または23.xビルドを次のいずれかのビルドにロールバックしようとする場合:

• Oracle(21.14.0.0.0_240525)

• ビッグデータ(21.14.0.0.0_240515)

• MySQL(21.14.0.0.0_240404)

• MSSQL(21.14.0.0.0_240404)

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

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

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

• 23.xから21.14へのロールバックでPerformance Metrics Serviceに問題があるため、Service Managerの起動に失敗します。この問題が発生した場合は、Oracle Supportに連絡してください。

• Oracle GoldenGateプロセスは、"OGG-02431無効なレコード・ヘッダーがチェックポイント・ファイルに見つかりました"というエラーで失敗します。

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