このドキュメントでは、Oracle GoldenGate Enterprise Manager Plug-In 13c (13.5.2.0.0)リリースの新機能、主な変更点および既知の問題について説明します。

1.1 新機能と変更点

この項では、Oracle GoldenGate Enterprise Manager Plug-Inの様々なリリースに導入されている新機能の概要を示します。

1.1.1 リリース13.5.2.0.3 - 2024年1月

セカンダリ・エージェントは、EMCLI動詞を使用して検出されたときに、GoldenGateターゲットに割り当てられるようになりました。

新しいターゲットの検出中に、セカンダリEnterprise Managerエージェントをマークできるようになりました。agentURLパラメータに、カンマ区切りのagentURLsのリストを含めることができるようになりました。詳細は、『Oracle GoldenGate System Monitoring Plug-In』ドキュメントのEM CLIを使用したOracle GoldenGate Enterprise Manager Plug-in Microservicesインスタンスの検出およびEM CLIを使用したOracle GoldenGate Enterprise Manager Plug-in Classicインスタンスの検出を参照してください。

1.1.2 リリース13.5.2.0.0 — 2022年10月

Oracle GoldenGateのイベント・メッセージが画面に表示されます。Oracle GoldenGateイベントのアラートを表示およびスケジュールできます。

GoldenGateイベントのアラートをモニターおよびスケジュールできます。これは、デプロイメント・レベル(クラシックの場合はOracle GoldenGateターゲット、Microservices Architectureの場合はOracle GoldenGateデプロイメント)または個々のターゲット・レベルで実行できます。すべてのターゲット(サービス・マネージャを除く)について、イベント・メッセージでの特定のパターンに対してアラートをスケジュールできます。アラートを作成する、メッセージ・テキスト、重大度およびエラー・コードでの任意のパターンを選択できます。それにより、イベント・メッセージにおいてそのようなパターンが生成されたときにアラートがトリガーされます。詳細は、Oracle GoldenGate System Monitoring Plug-Inイベントのアラートの設定を参照してください。

1.2 インストールとアップグレード

インストールおよびアップグレード手順は、Oracle GoldenGate System Monitoring Plug-Inインストールおよびアップグレードを参照してください。

1.3 修正された問題

具体的なBugDBバグ識別番号またはサービス・リクエスト(SR)チケット番号に関する質問は、Oracleカスタマ・サポートにお問い合せください。

1.3.1 リリース13.5.2.0.4 — 2024年4月

バグ35055994 - 複数の(または単一の)デプロイメントの場合、およびPMSRVRが停止している場合に、GoldenGateターゲットが検出されない

この問題は修正されました。デプロイメント、管理サービス、レシーバ・サービス、パフォーマンス・メトリック・サービス、分散サービスなどのすべてのターゲットが検出されます(PMSRVRがDOWNになっているデプロイメントのExtractおよびReplicatターゲットは除く)。診断ログに、PMSRVRが停止していることを示す警告メッセージが表示されます。たとえば、警告: URL 'http://<HostName>:<pmsrvrPort>/services/v2/mpoints/processes'がDOWNになっていますなどです。したがって、PMSRVRがDOWNになっている場合、デプロイのプロセス'http://<HostName>:<srvmgrPort>/services/v2/deployments'が無視されます。

バグ35810121 - 'agctl stop goldengate'後のGGMAターゲットの可用性評価エラー
以前は、agctl stop goldengateコマンドまたはstopSM.shスクリプトの実行中にサービス・マネージャが停止すると、すべてのターゲットのステータス(ExtractおよびReplicatを除く)が可用性評価エラーとして表示されていました。この問題は修正されました。
  • サービス・マネージャではなくパフォーマンス・メトリック・サーバーからステータスがフェッチされるため、サービス・マネージャが停止している場合でも正しいステータスが表示されます。
  • パフォーマンス・メトリック・サーバーが停止している場合、ターゲットのステータスも可用性評価エラー(AVL)ではなくDOWNに設定されます。

    詳細は、『Oracle GoldenGate System Monitoring Plug-In』ドキュメントのOracle GoldenGate Microservicesターゲットの誤ったアラートのトラブルシューティングを参照してください。

バグ36340236 - Oracle GoldenGate Enterprise Manager Plug-inリリース13.5.2.0.3以降に対するいくつかの環境パッチの適用で、Oracle GoldenGateのマイクロサービス管理サービス、レシーバ・サービス、パフォーマンス・メトリック・サービスおよび分散サービスのターゲットのステータスがDOWNとして表示される。

この問題は修正されました。

バグ36349817 - Plugin Server 13.5.2.0.3のインストール後、Oracle Enterprise Manager/Oracle GoldenGateホーム・ページ -> 「ADF_FACES-60096:PPR中のサーバー例外、#{9}」

この問題は修正されました。

1.3.2 リリース13.5.2.0.3 — 2024年1月

バグ35823552 - OGGPLGN 13.5.2.XでOGG MAターゲットの"Seconds Since Last OGG Checkpoint"メトリックがない(Extract)

この問題は修正されました。

バグ36028291 - Oracle GoldenGateが欠落しているパスのggserr.logおよびrecvsrvr.logファイルにエラーを継続的に記録する

ターゲットで開始されていないパス(分散サーバーのパス)の場合、Enterprise Managerモニタリングは不正なAPIを呼び出すために使用され、GoldenGateデプロイメントのggserr.logファイルおよびrecvsrvr.logファイルに複数のエラーが記録されます。この問題は修正されました。

1.3.3 リリース13.5.2.0.2 — 2023年8月

バグ34166330 - 受信サーバー・パス表の統計メトリック結果に繰返しキー値がある

ReceiverPathMetricのメトリック収集エラーが頻繁に受信されましたが、これは障害でした。この問題は修正されました。

バグ35579242 - モニタリング資格証明を変更できない

この問題は修正されました。

1.3.4 リリース13.5.2.0.1 — 2023年4月

バグ34719246 - 大規模なデプロイメントの場合、Oracle GoldenGateのホーム・ページはロードされないか、ロードに時間がかかります。

この問題は修正されました。修正を有効にするには、<domain_home>/config/fmwconfig/ggconfig.properties oracle.sysman.goldengate.enableperf=1に次のプロパティを含めます。

1.3.5 リリース13.5.2.0.0 — 2022年10月

バグ33532487 - ラグ・メトリックの値が大量にあるとプラグインでのGoldenGateターゲットのロードと表示に数分かかる

この問題は修正されました。

バグ34093897: 「すべてのターゲットト」ページからの移動時にパスが正しくない

この問題は修正されました。「すべてのターゲット」ページから移動したときに、レシーバ・サーバーおよび分散サーバーのパスとして、正しいパスが表示されるようになりました。

バグ34336636 - EMCLI -checkおよび-debug引数があると「認識できないコマンド」と表示されて終了する

この問題は修正されました。EMCLIを介して実行したときに、discover_ggおよびdiscover_ggma動詞でdebugフラグおよびcheckフラグが正しく機能するようになりました。

バグ34582978 - 分散パスおよびレシーバ・パスが停止ステータスに設定されたときの自動アラート

この問題は修正されました。分散パスまたはレシーバ・パスが停止すると、アラートが自動的に生成されます。

1.4 既知の問題

具体的なバグまたはチケット番号に関する質問は、Oracleカスタマ・サポートにお問い合せください。SRはOracle Support SR番号で、BugDBはバグ識別番号です。

1.4.1 リリース13.5.2.0.0 — 2022年10月

バグ34224887 - 複数のデプロイメントがありpmsrvrが停止している場合はターゲットが検出されない

複数のデプロイメントがあり、いずれかのパフォーマンス・サービス(PMSRVR)が停止している場合、Oracle GoldenGate Microservicesターゲットは検出されません。

回避策: 正常に検出できるようにそのPMSRVRを起動してください。必要なターゲットのみをプロモートできます。また、使用されていない、デプロイメントのPMSRVRはその後に停止できます。

バグ34612995 - EM UIにおいてスクロールバーでスクロールして最後の数個のログ・イベントを表示できない

Oracle Enterprise ManagerのUIにおいてスクロールして、データベースに格納されているすべてのイベントを表示することはできません。ページの下部にあるいくつかのエントリは、スクロールして表示できません。

回避策: スクロールバーではなく下矢印キーを使用します。

1.5 My Oracle Supportの利用

My Oracle Supportを使用して、お客様、パートナおよびOracle従業員から報告された解決策、回避策およびその他の情報を検索できます。My Oracle Supportでは、SRチケットをオープンすることもできます。SRの解決にパッチが必要な場合は、ダウンロード方法に関する手順をMy Oracle Supportから入手してください。

ノート:

Oracle GoldenGateおよびサポートをディストリビュータ経由で購入した場合は、My Oracle Supportを通してサービス・リクエストを作成するのではなく、ディストリビュータにお問い合せください。

1.5.1 Oracle GoldenGateナレッジ・ベースの表示

Oracle GoldenGateナレッジ・ベースを表示するには、次のステップに従います。

  1. My Oracle Support Webサイト(https://support.oracle.com/portal/)を参照します。
  2. 言語を選択し、電子メールとOracleパスワードでログインします。
  3. 「ナレッジ」タブをクリックします。
  4. 「製品または製品ラインを選択します」フィールドで、GoldenGateと入力し、Oracle GoldenGate製品を状況依存リストから選択して結果を絞り込みます。(このリストが表示されるまで数秒待機する必要が生じる場合があります)。
  5. 「検索条件の入力」フィールドで、検索キーワードまたは複数のキーワードを入力して、問合せを絞り込みます。

「ヘルプ」をクリックすると、このタブの使用方法の追加情報が取得されます。

1.5.2 Oracle GoldenGate SRチケットの作成

質問または問題に対する回答をナレッジ・ベースで見つけられない場合は、次のステップに従ってOracle Supportによるサポート・リクエスト・チケットをオープンできます。

  1. My Oracle Support Webサイト(https://support.oracle.com/portal/)を参照します。
  2. 言語を選択し、資格証明でサインインします。このWebサイトを使用するための登録がまだの場合は、登録する必要があります。
  3. 「サービス・リクエスト」タブをクリックします。
  4. 「SRの作成」をクリックします。
  5. サービス・リクエストの作成ウィザードを使用して、SRを完了して送信します。「ヘルプ」をクリックすると、このタブの使用方法の追加情報が取得されます。

1.6 対象読者

このガイドは、Oracle GoldenGateをインストール、構成および実行するデータベース管理者およびシステム管理者を対象としています。

1.7 関連情報

Oracle GoldenGate製品ドキュメント・ライブラリは、次のサイトにあります:

Oracle GoldenGateのドキュメント

Oracle GoldenGate for Big Dataのドキュメント:

https://docs.oracle.com/en/middleware/goldengate/big-data/index.html

Oracle GoldenGateの詳細は、次を参照してください。

https://www.oracle.com/middleware/technologies/goldengate.html

Oracle Database高可用性

1.8 表記規則

このドキュメントでは、次のテキスト表記規則が使用されます:

表記規則 意味

boldface

太字体は、操作に関連するグラフィカル・ユーザー・インタフェース要素("「ファイル」メニューから「保存」を選択します"など)を示します。太字は、本文中で定義されている用語および用語集に記載されている用語も示します。

italic

italic

イタリック体は、TABLE table_nameのようなパラメータ文など、ユーザーが特定の値を指定するプレースホルダ変数を示します。イタリック体は、ドキュメントのタイトルおよび強調にも使用されます。

monospace

MONOSPACE

等幅体は、ユーザー・イグジットやスクリプトなどのコードのコンポーネント、ファイルおよびデータベース・オブジェクトの名前、URLのパス、および画面に表示される入出力テキストを示します。大文字の等幅体は、Oracle GoldenGateのパラメータ、コマンド、ユーザーが構成可能な関数およびSQLコマンドとキーワードを表すために使用されます。

大文字

通常フォントの大文字は、特別な場合を除き、プロセスまたはユーティリティの名前を表します。大文字表記のキーワード(ADD EXTRACTADD EXTTRAILFORMAT RELEASE)。

小文字

小文字で書かれるプロセスの名前。例: ADD EXTRACT exteADD EXTRAIL ea

{ }

構文内の中カッコは、パイプ記号で区切ったオプションのセットを囲み、その中の1つを選択する必要があることを表します。たとえば、{option1 | option2 | option3}です。

[ ]

構文内の大カッコは、オプションの要素を示します。たとえば、CLEANUP REPLICAT group_name [, SAVEcount]という構文では、SAVE句はオプションです。オプション要素内の複数の要素は、[option1 | option2]のように、パイプ記号で区切ります。

場所の例

ExtractおよびReplicatの場所を示すために使用される東、西、北、南などのコンパス方位。

dc1dc2などの標準を使用するデータ・センター名。

グループ名

各プロセスの接頭辞は次のとおりです。
  • Extract: ext。場所の使用方法: extnnはコンパス方位「北」を示します。

  • Replicat: rep。場所の使用方法: repnnはコンパス方位「北」を示します。

  • 分散パス: dp。場所の使用方法: dpnnはコンパス方位「北」を示します。

  • チェックポイント表: ggs_checkpointtable

  • 証跡ファイル名: 証跡ファイルが配布パスのExtract用かどうかに応じて、eまたはd。アルファベット順に導出されるサフィックス。Extract証跡ファイルの使用方法: eaebec

  • 証跡ファイルのサブディレクトリ: 名前は、証跡サブディレクトリを参照するためにコンパス方位を使用します。証跡サブディレクトリ名の例は、/east/west/north/southになります。

1.9 ドキュメントのアクセシビリティ

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。