Oracle® GoldenGate

Oracle GoldenGate Monitorの管理

12c (12.1.3)

E56362-02(原本部品番号:E48290-03)

2014年7月

このガイドでは、Oracle GoldenGateプロセスのステータスを監視するために、Oracle GoldenGate Monitorをインストール、構成および実行する方法について説明します。Oracle Enterprise Manager Oracle GoldenGateプラグインでの監視を設定するための情報についても説明します。

Oracle GoldenGate Oracle GoldenGate Monitorの管理12c (12.1.3)

E56362-02

Copyright © 2011, 2014, Oracle and/or its affiliates.All rights reserved.

原本著者: Helen Haldeman

原本協力者: Edwin Spear

原本協力者:  Joseph DeBuzna、Sreenath Sreekantham

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007).Oracle America, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXはThe Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

新機能

- 新しいコンソール・アイコンでOracle GoldenGate Monitorプロセスの開始、停止および強制終了が可能

- 構成ファイルが編集可能

- 情報ファイルをOracle GoldenGate Monitorコンソールに表示

- JAgentをOracle GoldenGateeエージェントに置換え: 新機能の追加

- 部分的なソリューションを表示

- インスタンス・レベルでセキュリティの付与が可能

- "Delta"メトリックの新しいクラスを追加

- グローバライズされたオブジェクト名をパラメータ・ファイルでサポート

- z/OSサポートの追加

- SSL認証のサポート

- Java 1.7サポート(JRE)が必須

- インクルード・ファイルをハイパーリンクで表示可能

- すべての属性をグラフ化

1 Oracle GoldenGate監視の概要

- 1.1 概要

- 1.2 Oracle GoldenGate Monitorアーキテクチャ

- 1.2.1 Oracle GoldenGate

- 1.2.2 Oracle GoldenGate Monitorエージェント

- 1.2.3 Oracle GoldenGate Monitorサーバー

- 1.2.4 Oracle GoldenGate Monitorリポジトリ

- 1.3 検出プロセスについて

- 1.3.1 ソリューションの検出

- 1.3.2 部分的なソリューション

- 1.3.3 データベースの検出

- 1.4 12c (12.1.3)の前提条件

- 1.5 プラットフォームのサポート

2 Oracle GoldenGate Monitorサーバーの使用

- 2.1 Oracle GoldenGate Monitorサーバーの開始および停止

- 2.1.1 Oracle GoldenGate Monitorサーバーの開始

- 2.1.2 Oracle Golden Monitorサーバーの停止

- 2.2 Oracle GoldenGate Monitorコンソールの起動

- 2.2.1 複数セッションの実行

- 2.3 Oracle GoldenGate Monitorサーバーおよびリポジトリのパスワードの変更

- 2.3.1 パスワードの変更

- 2.4 メモリー割当ての変更

3 Oracle GoldenGate Monitorエージェントの使用

- 3.1 Oracle GoldenGate Monitorエージェントのインストール

- 3.2 Oracle GoldenGate Monitorエージェントの開始

- 3.3 Oracle GoldenGate Monitorエージェントのパスワードの更新

- 3.4 Oracle GoldenGate Monitorエージェントのメモリー割当ての変更

4 アラートの構成および使用

- 4.1 概要

- 4.2 電子メール・アラートの構成

- 4.2.1 電子メール・アラートのプロパティの設定

- 4.2.2 セキュア・モード用のパスワードの設定

- 4.3 CLIアラートの構成

- 4.3.1 コマンドライン・ハンドラの設定

- 4.3.2 サンプルのコマンドライン・ハンドラ

- 4.4 SNMPアラートの構成

- 4.4.1 MIBファイルのインポート

- 4.4.2 SNMPアラートの構成

- 4.5 アラートの有効化および無効化

5 SSL通信の使用

- 5.1 Secure Sockets Layer (SSL)の使用

- 5.1.1 SSL使用の考慮事項

- 5.1.2 用語

- 5.2 SSLの有効化

- 5.2.1 SSLプロパティの設定

- 5.2.2 キーストアの作成

- 5.3 自己署名証明書の作成

- 5.3.1 Monitorサーバーの自己署名証明書の確立

- 5.3.2 エージェントの自己署名証明書の確立

- 5.4 認証局(CA)ドキュメントの使用

- 5.4.1 証明書署名リクエストの生成

- 5.4.2 証明書のインポート

6 インスタンス・レベル・セキュリティについて

- 6.1 概要

- 6.2 インスタンス・アクセス・ルール

- 6.3 インスタンス・アクセス動作

- 6.4 ユーザー・インスタンス・マトリクス

7 コマンドおよびパラメータ

- 7.1 パラメータ

- 7.1.1 ENABLEMONITORAGENT

- 7.1.2 ENABLEMONITORING

- 7.1.3 AUTOSTART JAGENT

- 7.2 GGSCIコマンド

- 7.2.1 CREATE DATASTORE

- 7.2.2 ALTER DATASTORE

- 7.2.3 DELETE DATASTORE

- 7.2.4 INFO DATASTORE

- 7.2.5 REPAIR DATASTORE

- 7.2.6 INFO JAGENT

- 7.2.7 START JAGENT

- 7.2.8 INFO JAGENT

- 7.2.9 STOP JAGENT

8 プロパティ

- 8.1 Monitorサーバーのプロパティ

- 8.1.1 制限付きプロパティ

- 8.1.2 JMXサーバーのプロパティ

- 8.1.3 通信

- 8.1.4 アラート通知

- 8.1.5 接続のプロパティ

- 8.1.6 リポジトリのプロパティ

- 8.1.7 構成管理のプロパティ

- 8.2 エージェントのプロパティ

- 8.2.1 エージェントの定義

- 8.2.2 通信

- 8.2.3 ターゲットの監視

- 8.2.4 ポーリングのプロパティ

索引

はじめに

ここでは、Oracle GoldenGate Monitor管理者ガイドの情報および表記規則について説明します。

対象読者

このドキュメントは、Oracle GoldenGate Monitorをインストール、構成および実行するインストール実行者およびシステム管理者を対象としています。また、Oracle Enterprise Managerを使用してOracle GoldenGateインスタンスを監視するインストール実行者およびシステム管理者についても説明します。

ドキュメントのアクセシビリティについて

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

Oracle Supportへのアクセス

Oracleサポート・サービスでは、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を参照してください。

関連ドキュメント

詳細は、Oracle GoldenGate Monitorドキュメント・セットの次のドキュメントを参照してください。

- Oracle GoldenGate Monitorの使用

- Oracle GoldenGate Monitorサーバーのインストールおよび構成

- Oracle GoldenGate Monitorサーバー12.1.3へのアップグレード

- Oracle GoldenGate Monitorエージェントのインストールおよび構成

- Oracle GoldenGate Monitorのリリース・ノート

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

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

italic、イタリック体

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

大文字の固定幅フォント、固定幅フォント

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

大文字

通常フォントの大文字は、特別な場合を除き、ユーティリティの名前を表します。

{ }

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

[ ]

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

新機能

次のトピックでは、Oracle GoldenGate Monitor 12c (12.1.3)で導入された新機能および製品のその他の重要な変更について説明し、追加情報の参照先について紹介します。このドキュメントは、以前は『Oracle® GoldenGate Monitor管理者ガイド』というタイトルでしたが、その新版になります。

Oracle GoldenGate Monitor 12c (12.1.3)の新機能は次のとおりです。

- 新しいコンソール・アイコンでOracle GoldenGate Monitorプロセスの開始、停止および強制終了が可能

- 構成ファイルが編集可能

- 情報ファイルをOracle GoldenGate Monitorコンソールに表示

- JAgentをOracle GoldenGateeエージェントに置換え: 新機能の追加

- 部分的なソリューションを表示

- インスタンス・レベルでセキュリティの付与が可能

- "Delta"メトリックの新しいクラスを追加

- グローバライズされたオブジェクト名をパラメータ・ファイルでサポート

- z/OSサポートの追加

- SSL認証のサポート

- Java 1.7サポート(JRE)が必須インクルード・ファイルをハイパーリンクで表示可能

- インクルード・ファイルをハイパーリンクで表示可能

- すべての属性をグラフ化

新しいコンソール・アイコンでOracle GoldenGate Monitorプロセスの開始、停止および強制終了が可能

Oracle GoldenGate Monitorコンソールの「Data and Alerts View」タブ、「Log」タブ、「Configuration」タブおよび「Problem Summary」タブのダイアグラム領域から、次のいずれかのアイコンをクリックすることで、ReplicatまたはExtractプロセスを開始、停止および強制終了できるようになりました。

アイコン

用途

開始

停止

強制終了

構成ファイルが編集可能

構成ファイル(*.prm)を編集できるようになりました。「Configuration」タブでインスタンスを選択すると、そのインスタンスの構成ファイルがタブの下部に表示されます。パネルの右下隅の「Edit」をクリックすると、テキスト・エディタに変わり、必要に応じて構成を変更できます。

情報ファイルをOracle GoldenGate Monitorコンソールに表示

Oracle GoldenGate Monitorコンソールの下部のパネルに、破棄ファイルとレポート・ファイルおよびGSSERR.logメッセージを表示できるようになりました。

破棄ファイルとレポート・ファイル

選択したインスタンスの破棄ファイルとレポート・ファイルは、「Logs」タブの下部に表示されます。レポート・タイプは別のタブで確認できます。これらのタブは2つのセクションに分割され、レポートのリストが左側、レポートの内容が右側に表示されます。

- 「Discard」タブには、破棄ファイルが表示されます。このファイルには、ExtractまたはReplicatのそれぞれのセッションを失敗したデータに関する情報が含まれます。

- 「Report」タブには、特定のExtractまたはReplicatインスタンスに対して生成されたランタイム・レポートが表示されます。これらのレポートには、次の情報が表示されます。

- バージョン情報および選択した環境設定

- ランタイム・パラメータ

- ランタイム・メッセージおよび統計

「Logs」タブに表示されるGGSERR.logメッセージ

Oracle GoldenGateエラー・ログ・ファイルが「Logs」タブの下部に表示されるようになりました。メッセージは降順で配列され、最新のメッセージが最上部に表示されます。エラー・ログの各行には、タイムスタンプ、重大度、エラー・コード、メッセージをレポートするプロセス、および実際のメッセージが表示されます。これにより、関連するレポートのデータのエラーおよび警告を追跡できます。また、レポートの下部には、「Download ggserr.log」のリンクが表示されます。このリンクをクリックすると、ggserr.logをダウンロードして表示できます。

JAgentをOracle GoldenGateeエージェントに置換え: 新機能の追加

JAgentがOracle GoldenGateエージェントによって置き換えられました。エージェントは個別にダウンロードするため、個別のインストール・プロセスが必要です(『Oracle GoldenGate Monitor Agentのインストールおよび構成』を参照)。フル機能を実現し、すべてのコマンドおよび制御機能(ログの編集、停止、表示など)を利用するには、Oracle GoldenGateエージェント12c (12.1.3)をインストールする必要があります。また、バージョン12c (12.1.3)では、新規プロセス、または既存のプロセスが再起動なしに削除されていることをエージェントが認識します。詳細は、第3章「Oracle GoldenGate Monitorエージェントの使用」を参照してください。

部分的なソリューションを表示

以前のバージョンのOracle GoldenGate Monitorでは、プロセスのダイアグラム・ビューに完全なソリューション(データベースで開始および終了するプロセス)のみが表示されましたが、バージョン12c (12.1.3)では、データベースで開始および終了しない場合でも、つなぎ合せたプロセスがソリューション(部分的なソリューション)のダイアグラム・ビューに表示されるようになりました。

インスタンス・レベルでセキュリティの付与が可能

インスタンス・レベル・セキュリティは、選択したインスタンスにユーザー・アクセスを付与しますが、これは、Oracle GoldenGate Monitor 12c (12.1.3)の新機能です。現在の機能レベルのセキュリティに加えて、インスタンス・レベルのセキュリティは、異なるホスト/インスタンスへの異なるユーザーのアクセスを制限します。詳細は、次を参照してください。

- 第6章「インスタンス・レベル・セキュリティについて」

- 「Oracle GoldenGate Monitorの使用の「ユーザーへのインスタンスの割当て」。

"Delta"メトリックの新しいクラスを追加

Deltaメトリックは、既存のすべての合計件数メトリックの拡張で、サンプル間の変更を追跡します。たとえば、操作の合計数がサンプル期間で100から5000に変更されると、Delta操作メトリックは2番目のサンプル期間で4900になります。3番目の期間で変更が発生しない場合、Delta操作はゼロになります。

グローバライズされたオブジェクト名をパラメータ・ファイルでサポート

UTF-8キャラクタ・セットを含む、各種文字エンコーディングがパラメータ・ファイルでサポートされます。

z/OSサポートの追加

Oracle GoldenGate Monitor 12c (12.1.3)でIBMのz/OSオペレーティング・システムがサポートされるようになりました。詳細は、『DB2 z/OSのためのOracle GoldenGateのインストールおよび構成』を参照してください。

SSL認証のサポート

Oracle GoldenGate Monitor 12c (12.1.3)でSecure Sockets Layer認証がサポートされるようになりました。詳細は、第5章「SSL通信の使用」を参照してください。

Java 1.7サポート(JRE)が必須

Oracle GoldenGate Monitor 12c (12.1.3)では、Java 1.7 JREが必要です。詳細は、Oracle GoldenGate Monitorサーバーのインストールおよび構成のターゲット・マシンへのJDK 1.7のインストールに関する項を参照してください。

インクルード・ファイルをハイパーリンクで表示可能

コンソールの「Configuration」表の下部に、各インスタンスの構成(.prm)ファイルの内容が表示されます。構成ファイルには、1つ以上のインクルード・ファイルが含まれます。

extract ext1
userid oggsrc,password oggsrc
discardfile ./dirdat/ext1.dsc,purge
exttrail ./dirdat/e1
table oggsrc.tcustmer;
include dirprm/my.inc

ファイル名はハイパーリンクです。ファイル名をクリックすると。ファイルを表示できます。ファイルは、構成ファイルの領域内のインクルード・ファイルの名前のラベルが付いた個別のタブに表示されます。

すべての属性をグラフ化

インスタンスで収集されるすべての数値属性をグラフ・ビューのデータで表示できるようになりました。

1 Oracle GoldenGate監視の概要

この章では、Oracle GoldenGate Monitorを構成するコンポーネントについて確認し、その役割について説明します。ここでは、監視プロセスの概要および監視対象のターゲットの検出方法について説明します。

この章の内容は次のとおりです。

- 1.1項「概要」

- 1.2項「Oracle GoldenGate Monitorのアーキテクチャ」

- 1.3項「検出プロセスについて」

- 1.4項「12c (12.1.3)の前提条件」

- 1.5項「プラットフォームのサポート」

1.1 概要

Oracle GoldenGate Monitorは、すべてのOracle GoldenGateインスタンスおよび企業内で関連付けられているデータベースを一目で確認できるリアルタイムのWebベース監視コンソールです。Oracle GoldenGate構成のすべてのオブジェクトのパフォーマンスを監視し、ラグや異常終了したプロセスなどの問題、それらの問題の発生時間を検出するのに役立つ統計、ターゲット・ビューおよびアラートをすぐに表示できます。Oracle GoldenGate Monitorでは、アラート・メッセージを独自のコンソール・ワークスペースだけでなく、電子メール、SNMPおよびCLIクライアントにも送信できます。

Oracle GoldenGateインスタンスは、リモート・クライアントによる監視を構成できます。監視が有効になっている場合、Extract、ReplicatおよびManagerプロセスは、ステータス、ラグ、チェックポイントなどの監視ポイントを定期的に更新します。Managerは、クライアントと通信するJavaエージェントに、これらの監視ポイントを送信します。

注意:

このドキュメントは、Oracle GoldenGate Monitor 12c (12.1.3)をサポートしています。

Oracle GoldenGateリリース11.2.1以降も、Oracle Enterprise Managerでの監視をサポートしています。このオプションの詳細は、『Oracle Enterprise Manager System Monitoring Plug-inインストレーション・ガイドfor Oracle GoldenGate』を参照してください。

1.2 Oracle GoldenGate Monitorのアーキテクチャ

Oracle GoldenGate Monitorでは、ブラウザ・ベースのグラフィカル・ユーザー・インタフェースを使用して、Oracle GoldenGateインスタンスをリモートで監視します。図に示すようなコンポーネントが含まれています。

1.2.1 Oracle GoldenGate

Oracle GoldenGate Monitorサーバーは、Java Management Extensions (JMX)またはSecure Sockets Layer (SSL)を使用して、1つ以上のOracle GoldenGateインスタンスと通信します。各Oracle GoldenGateインスタンスのManagerプロセスは、インスタンスに関する情報をOracle GoldenGate Monitorサーバーに提供するOracle GoldenGateエージェントと関連付けられます。

1.2.2 Oracle GoldenGate Monitorエージェント

Oracle GoldenGateエージェントは、各Oracle GoldenGateインスタンスで使用する必要があります。インスタンスに関する情報を収集し、Oracle GoldenGate Monitorサーバーに送信します。

エージェントは個別にダウンロードするため、個別のインストール・プロセスが必要です(『Oracle GoldenGate Monitor Agentのインストールおよび構成』を参照)。フル機能を実現し、すべてのコマンドおよび制御機能(ログの編集、停止、表示など)を利用するには、Oracle GoldenGate Monitorエージェント12c (12.1.3)をインストールする必要があります。

1.2.3 Oracle GoldenGate Monitorサーバー

Oracle GoldenGate Monitorサーバーは、複数のOracle GoldenGateインスタンスの監視を調整します。Oracle GoldenGate Monitorサーバーは、1) Oracle GoldenGateエージェントからの情報を処理してWebブラウザに送信し、2)ユーザー・アクセス・ロール、履歴、情報の表示、およびイベントによってトリガーされる通知を管理します。

1.2.4 Oracle GoldenGate Monitorリポジトリ

Oracle GoldenGate Monitorサーバーは、データベースを中央リポジトリとして使用し、ユーザーやグループ、プロセスのステータス、イベントおよび他の情報を格納します。Oracle、MySQLおよびSQL Serverリポジトリがサポートされています。詳細は、My Oracle Supportの「Certifications」タブでオンラインで確認できます。

1.3 検出プロセスについて

Oracle GoldenGate Monitorには、ソリューションとデータベースを定義して自動的に検出する方法を決定する、事前設定された定義とルールがあります。

1.3.1 ソリューションの検出

Oracle GoldenGateプロセスを開始すると、エージェントがOracle GoldenGate Monitorサーバーに登録されます。サーバーでは、エージェントによって提供される情報を使用してソリューションを検出します。その後、ブラウザのユーザー・インタフェースにログインすると、これらのソリューションが表示されます。

完全なソリューションとして分類されるようにするには、ソース・データベースからターゲット・データベースに対する連続的なフロー・キャプチャ、および変更のレプリケートが存在する必要があります。検出プロセスでは、ソース・データベースから開始し、証跡を作成して、ターゲット・データベースに変更をレプリケートする完全なソリューション(単一のエンドツーエンド・ソリューション)が検索されます。または、ソース・データベースの変更をキャプチャし、ターゲットにそれらを配信する処理、およびターゲットからの変更をキャプチャし、ソースにそれらを配信する処理(双方向ソリューション)が検索されます。

1.3.2 部分的なソリューション

ソース・データベースからターゲット・データベースに連続的にリンクされているものとして登録されていない部分的なソリューションは、Oracle GoldenGate Monitorコンソールのダイアグラム・ビューには表示されません。これらはソリューション・ノードにありますが、ソリューションではなく、部分的なソリューションで開始するデフォルト名を持ちます。

この図は、Replicatは構成済だが開始されていない部分的なソリューションを表現したものです。Replicatは登録されていないため、サーバーではターゲットへの連続的なリンクとして認識されません。一部はツリー・ビューに表示されますが、構成はソリューション・リスト内に含まれません。

Managerの登録にはそのプロセスの名前が含まれるため、ExtractおよびReplicatの名前は、それらが登録されているかどうかに関係なく、ツリー・ビューにインスタンスとともにリストされます。リンクされたデータベースおよびリモート証跡はプロセスが登録されるまで表示されないため、例のリモート証跡およびターゲット・データベースは、ユーザーがReplicatを開始し、登録するまでリストされません。この例は、Replicatが登録されるとソリューションになります。

この2番目の例では、ソース・データベースからターゲット・データベースへの連続的なリンクが存在しますが、ターゲットにアタッチされているExtractからのリンクは存在しません。このため、部分的なソリューションとして表示されます。

1.3.3 データベースの検出

Oracle GoldenGate Monitorの処理によるソース・データベースおよびターゲット・データベースの認識は、データベース・タイプ、インストールされている場所および登録されているプロセスに応じて異なります。ソリューション検出プロセスでは、データベース・インスタンス、Managerのポートおよびホスト名が比較され、データベースが同じであるかどうかが判断されます。

2つの異なるManagerによって登録されている場合、同じホスト上にある同じデータベース・インスタンスは、別のデータベースとして分類されます。

1.4 12c (12.1.3)の前提条件

Oracle GoldenGate Monitor 12c (12.1.3)では、次のものが必要です。

- JDK 1.7

- WebLogic Server 12c (12.1.3)とJRF

- 次のいずれかのデータベース:

- Oracle 11gR1、11gR2、12c

- MySQL 5.5、5.6

- SQL Server 2008、2012

これらの前提条件の詳細は、Oracle GoldenGate Monitorサーバーのインストールおよび構成のインストールの準備に関する項を参照してください。

1.5 プラットフォームのサポート

Oracle GoldenGate Monitor 12c (12.1.3)のプラットフォームのサポートの詳細は、Oracle GoldenGate Monitorサーバーのインストールおよび構成のプラットフォームのサポートに関する項を参照してください。

2 Oracle GoldenGate Monitorサーバーの使用

この章では、Oracle GoldenGate Monitorサーバーの開始と停止、ユーザー・インタフェースの開始、パスワードの変更、メモリー割当てやタイムアウト間隔の設定の変更など、Oracle GoldenGate Monitorサーバーを使用するときに実行するタスクについて説明します。

この章の内容は次のとおりです。

- 2.1項「Oracle GoldenGate Monitorサーバーの開始および停止」

- 2.2項「Oracle GoldenGate Monitorコンソールの起動」

- 2.3項「Oracle GoldenGate Monitorサーバーおよびリポジトリのパスワードの変更」

- 2.4項「メモリー割当ての変更」

2.1 Oracle GoldenGate Monitorサーバーの開始および停止

この項では、Oracle GoldenGate Monitorサーバーの開始および停止の方法について説明します。

2.1.1 Oracle GoldenGate Monitorサーバーの開始

Oracle GoldenGate Monitorサーバーの開始は、2つまたは3つの手順のプロセスです。

1. WebLogic Administration Serverを開始します。

2. 必要に応じて、Oracle GoldenGate Monitorサーバーの資格証明を更新します。

3. WebLogic管理対象サーバーの起動

詳細は、Oracle GoldenGate Monitorサーバーのインストールおよび構成のOracle GoldenGate Monitor Serverの開始に関する項を参照してください。

2.1.2 Oracle Golden Monitorサーバーの停止

次の手順に従い、Oracle GoldenGate Monitorサーバーを停止します。

- 実行中のインタフェース・セッションを閉じます。

- OGGMON_DOMAIN/bin (OGGMON_DOMAIN\bin (Windows))に移動し、次のコマンドを入力して、サーバーを停止します。
Linux:

$ ./stopManagedWebLogic.sh

Windows:

C:\path\to\bin> stopManagedWebLogic.cmd

- Oracle GoldenGate Monitorをアンインストールする場合など、一部のシナリオでは、管理サーバーの停止が必要になる場合があります。管理サーバーを停止するには、「管理サーバーの停止の手順」を参照してください。

2.2 Oracle GoldenGate Monitorコンソールの起動

WebLogic Server管理サーバーおよび管理対象Oracle GoldenGate Monitorサーバーでは、どちらでもOracle GoldenGate Monitorコンソールを起動できます。これを行うには、Oracle GoldenGate Monitorサーバーのインストールおよび構成のOracle GoldenGate Monitorコンソールの起動に関する項の手順に従います。

アプリケーションにログインすると、構成済のソリューションがソリューション検出プロセスによって検出されます。

2.2.1 複数セッションの実行

Internet Explorerを使用している場合、同じコンピュータおよびブラウザから、Oracle GoldenGateMonitorのユーザー・インタフェースの複数のセッションを実行できます。Internet ExplorerとMozilla Firefoxのセッションを1つずつ同時に実行することもできますが、Mozilla Firefoxの複数のセッションを同じコンピュータ上で実行することはできません。

2.3 Oracle GoldenGate Monitorサーバーおよびリポジトリのパスワードの変更

必要に応じてMonitorサーバーおよびリポジトリのパスワードを変更できるユーティリティが提供されています。必要に応じてOracle GoldenGate Monitorを調整できるように、メモリー割当てを変更することもできます。

2.3.1 パスワードの変更

Oracle GoldenGate Monitorサーバーのパスワードは、サーバーのインストール中に入力した内容に基づいて初期設定されます。インストール・プログラムによってOracleWalletが作成され、サポートされているすべてのプラットフォーム上でパスワードが格納されます。

パスワードを変更するには、WebLogic Scripting Tool (WLST)コマンドupdateCred()を使用します。WLSTとは、WebLogic Serverドメインの作成、管理、および監視に使用するコマンドライン・スクリプト環境です。

1. ORACLE_HOME/commonのbinサブディレクトリに移動し、WLSTを起動します。
Linuxの場合

$ORACLE_HOME/common/bin>./wlst.sh

Windowsの場合:

C:\ORACLE_HOME\common\bin>./wlst.cmd

2. サーバーに接続します。

wls:/offline> connect('username','password','host:port')

3. 次に示すように、updateCred()を使用してパスワードを変更します。

- JMXパスワードを変更するには、次のように入力します。

wls:/test_domain/serverConfig>updateCred(map="OGGMONITOR",key=" WEB.JMX.PASSWORD",user="username",password="new_jmx_password",desc="JMX Password")

- キーストアのパスワードを変更するには、次のように入力します。

wls:/test_domain/serverConfig>updateCred(map="OGGMONITOR",key="MONITOR.KEYSTORE.PASSWORD",user="username",password="new_keystore_password",desc="Keystore Password")

- トラストストアのパスワードを変更するには、次のように入力します。

wls:/test_domain/serverConfig>updateCred(map="OGGMONITOR",key="MONITOR.TRUSTSTORE.PASSWORD",user="username",password="new_truststore_password",desc="Keystore Password")

- SMTPパスワードを変更するには、次のように入力します。

wls:/test_domain/serverConfig>updateCred(map="OGGMONITOR",key="MONITOR.SMTP.PASSWORD",user="username",password="new_smtp_password",desc="SMTP Password")

2.4 メモリー割当ての変更

Oracle GoldenGate Monitorサーバーに割り当てられているRAMの量は、監視可能なOracleGoldenGateインスタンスおよびプロセスの数に影響します。

注意:

メモリー要件の設定の詳細は、Oracle WebLogic ServerのパフォーマンスのチューニングのJava仮想マシン(JVM)のチューニングに関する項を参照してください。

推奨するメモリー設定は次のとおりです。

設定

サイズ

最小ヒープ(-Xms)

512MB

最大ヒープ(-Xmx)

1024MB

Permgenサイズ(-XX:PermSize)

256MB

最大Permgenサイズ(-XX:MaxPermSize)

512MB

使用するコマンド

JAVA_OPTS=-Xms512m -Xmx1024m -XX:PermSize=256m -XX:MaxPermSize=512m

注意:

Oracle GoldenGate MonitorサーバーがWindows 32ビット版で実行されている場合は、最大メモリー割当てを800MB、MaxPermSizeを340MBに減らす必要があります。メモリー割当てを減らすと、監視用にサポート可能なターゲット・システムの数が減ります。このため、これらのインストールでは、他のオペレーティング・システムでサポートされているターゲット・システムの数を監視できなくなります。

3 Oracle GoldenGate Monitorエージェントの使用

この章では、Oracle GoldenGateエージェントの使用方法について説明します。パスワードの変更方法やメモリー割当て設定の変更方法などについても説明します。

この章の内容は次のとおりです。

- 3.1項「Oracle GoldenGate Monitorエージェントのインストール」

- 3.2項「Oracle GoldenGate Monitorエージェントの開始」

- 3.3項「Oracle GoldenGate Monitorエージェントのパスワードの更新」

- 3.4項「Oracle GoldenGate Monitorエージェントのメモリー割当ての変更」

3.1 Oracle GoldenGate Monitorエージェントのインストール

Oracle GoldenGateエージェントをインストールおよび構成するには、『Oracle GoldenGate Monitor Agentのインストールおよび構成』の手順に従います。Oracle GoldenGateエージェントは、Oracle GoldenGate Monitorと同じホストにインストールする必要があります。

3.2 Oracle GoldenGate Monitorエージェントの開始

Oracle GoldenGate Monitorを開始したら、Oracle GoldenGateエージェントを開始する必要があります。これを行うには、Oracle GoldenGate Core GGSCIに移動し、start jagentコマンドを実行します。

GGSCI>START JAGENT

注意:

プロセスが追加または削除されると、Oracle GoldenGateエージェントは再起動せずにそれらを検出します。

3.3 Oracle GoldenGate Monitorエージェントのパスワードの更新

Oracle GoldenGateエージェントのパスワードは、サポートされているすべてのプラットフォーム(IBM z/OSを除く)のOracle Walletに格納され、installation_location/cfgディレクトリ内のpassword.propertiesファイルに格納されます。

サポートされているすべてのプラットフォームのエージェントのパスワードを変更するには、pw_agent_util.batおよびpw_agent_util.shユーティリティを使用します。

エージェントのパスワードを変更する手順:

1. インストール・ディレクトリに移動します。

Shell> cd ./installation_directory/

2. 適切なランタイム引数を使用して、適切なpw_agent_utilファイルを実行します。

注意:

パスワード・ユーティリティを実行できるのは、Oracle GoldenGateインスタンスをインストールしたユーザーのみです。

Windowsの場合は、コマンドラインに次のように入力します。

Shell> pw_agent_util.bat -[updateAgentJMX | updateServerJMX | updateKeystore | updateTruststore]

UNIXの場合は、次のコマンドを入力します。

Shell>./pw_agent_util.sh -[updateAgentJMX | updateServerJMX |  updateKeystore | updateTruststore]

pw_agent_utilオプションは次のとおりです。

- -updateAgentJMXでは、エージェントのJMXパスワードが変更されます。

- -updateServerJMXでは、Oracle GoldenGate MonitorサーバーのJMXパスワードが変更されます。

- -keystoreでは、Javaキーストアのパスワードが追加されます。

- -truststoreでは、Javaトラストストアのパスワードが追加されます。

- -updateKeystoreでは、Javaキーストアのパスワードが変更されます。

- -updateTruststoreでは、Javaトラストストアのパスワードが変更されます。

ウォレットが必要で、存在する場合は、変更されるパスワードの確認がユーティリティによって求められます。Oracle Walletが必要だが、存在しない場合は、-createオプションを付けて最初に実行する必要がある(これにより、ユーティリティが停止します)旨のメッセージがユーティリティによって返されます。ウォレットを作成するには、次のコマンド(前述と同じオプションを使用)を使用します。

Windowsの場合:

Shell> ./pw_agent_util.bat -create | -jagentonly

Linuxの場合:

Shell> ./pw_agent_util.sh -create | -jagentonly

3. 新しいパスワードを入力および確認し、変更を実装します。リクエストを取り消すには、データを入力せずに[Enter]を押します。

4. 変更をアクティブにするには、Oracle GoldenGateのインストール場所に移動し、GGSCIを起動します。次に、Oracle GoldenGateのリリースに応じて、次のいずれかを実行します。

- Oracle GoldenGateリリース11.1.1.1の場合は、Oracle GoldenGate Managerを一度停止してから再び開始します。

GGSCI> STOP MANAGER
GGSCI> START MANAGER

- Oracle GoldenGateリリース11.2.1の場合は、Oracle GoldenGateエージェントを一度停止してから再び開始します。

GGSCI> STOP JAGENT
GGSCI> START JAGENT

3.4 Oracle GoldenGate Monitorエージェントのメモリー割当ての変更

Oracle GoldenGateリリース11.2.1以降のスタンドアロン・エージェントのメモリー割当てを変更するには、次の手順に従います。

1. Oracle GoldenGateのインストール場所に移動します。

2. GGSCIを起動し、エージェント・パラメータ・ファイルを編集します。

Shell> GGSCI
GGSCI> EDIT PARAMS JAGENT

3. デフォルトのメモリー割当てである-Xmsと最大メモリー割当てである-Xmxの設定は、エージェントの起動文字列に含まれます。次の例では、デフォルトを64MBに設定し、最大を512MBに設定します。

java -jar -Xms64m -Xmx512m dirjar/jagent.jar

4. 必要に応じて割当て数を変更し、パラメータ・ファイルを保存し、エディタを終了します。

5. エージェントを一度停止してから再び開始して、変更を実装します。

GGSCI> STOP JAGENT
GGSCI> START JAGENT

4 アラートの構成および使用

この章では、特定の状態が存在する場合に通知するアラートの作成方法について説明します。オプションで、これらのアラートを電子メール、コマンドライン・インタフェースまたはSimple Network Management Protocol (SNMP)で配信できます。

この章の内容は次のとおりです。

- 4.1項「概要」

- 4.2項「電子メール・アラートの構成」

- 4.3項「CLIアラートの構成」

- 4.4項「SNMPアラートの構成」

- 4.5項「アラートの有効化および無効化」

4.1 概要

Oracle GoldenGate Monitorアラートは、指定した状態がOracle GoldenGateコンポーネントに存在する場合に通知します。たとえば、プロセスが停止した場合、または指定したラグのしきい値に達した場合に通知されるようにリクエストできます。メッセージに含まれる情報はユーザーが選択します。アラートを定義するには、ユーザー・インタフェースで「Alert Definitions」に移動し、オンライン・ヘルプの指示に従います。

Oracle GoldenGate Monitorによって生成されるアラート・タイプは、各ユーザーが指定します。あるユーザー用のアラートを有効にするには、Oracle GoldenGate Monitorのユーザー・インタフェースの「User Profile」に移動し、オンライン・ヘルプの指示に従います。

4.2 電子メール・アラートの構成

Oracle GoldenGate Monitorアラートが電子メール・アカウントに配信されるように構成できます。

この機能を使用するには、次の手順を実行する必要があります。

1. インストール中に「SMTP (Simple Mail Transfer Protocol) alerts」ボックスを選択するか、次の項で説明するように、monitor.propertiesファイル内の電子メール・アラート・プロパティを後で設定して、電子メール・アラートを有効にします。

2. Oracle GoldenGate Monitorのユーザー・インタフェースの「User Management」タブに、ユーザーの電子メール・アドレスを入力します。

3. Oracle GoldenGate Monitorのユーザー・インタフェースの「User Profile」に移動し、適切なセキュリティ・レベルの通知タイプとして電子メールを選択します。

4.2.1 電子メール・アラートのプロパティの設定

インストール中に電子メール・アラートを設定しなかった場合は、monitor.propertiesファイルで次のプロパティを設定して電子メール・アラートを設定できます。

- 次のプロパティをtrueに設定して、電子メール・アラートを有効にします。

monitor.smtp.alerts.enabled=true

- 電子メール・サーバーから生成されるOracle GoldenGate Monitor通信用の送信者名を指定します。

monitor.smtp.from=sender_name

- 電子メール・サーバーのホスト名を指定します。

monitor.smtp.host=email_host_name

- 電子メール・サーバーによって使用されるポートを指定します。

monitor.smtp.port=port_number

- 電子メール・サーバーがセキュア・モードであるかどうかを指定します。

monitor.smtp.secure={true | false}

- 電子メール・サーバーがセキュア・モードである場合、ログインが許可されているユーザーを指定します。

monitor.smtp.user=user_name

4.2.2 セキュア・モード用のパスワードの設定

電子メール・サーバーがセキュア・モードで実行されている場合、パスワードを変更するには、WebLogic Scripting Tool (WLST)にログインし、次の例のようにcreateCred()コマンドを使用する必要があります。

wls:/test_domain/serverConfig>createCred(map="OGGMONITOR",key="WEB.SMTP.EMAIL.PASSWORD",user="<email user id>",password="<email password>",desc="SMTP EMAIL Password")

WLSTの使用の詳細は、「WebLogic Scripting Toolの理解」を参照してください。

4.3 CLIアラートの構成

Oracle GoldenGate MonitorのCommand-Line Integration (CLI)を使用すると、アラートがトリガーされたときに、Oracle GoldenGate Monitorサーバー上でスクリプトまたはオブジェクト・ファイルを実行できます。

この機能を使用するには、インストール中に「CLI alerts」ボックスを選択するか、後でmonitor.propertiesファイルのmonitor.cli.alerts.enabledプロパティをtrueに設定して、CLIアラートを有効にする必要があります。

4.3.1 コマンドライン・ハンドラの設定

Oracle GoldenGate Monitorのインストールでは、CLIインタフェースの構成に役立つファイルが提供されます。これらは、インストール場所のcfgサブディレクトリに格納されます。

- CommandLineHandlers.xml
CLIインタフェースは、CommandLineHandlers.xmlファイルで構成されます。

インストールには、UNIX用とWindows用の2つのサンプルCommandLineHandlers.xmlファイルが含まれています。それぞれに、CLIインタフェース構成用のサンプル構文が含まれています。適切なバージョンをコピーし、引数を追加および変更して、独自のCLIインタフェースを構成するCommandLineHandlers.xmlを作成します。

注意:

CommandLineHandlers.xmlファイルは、システムをインストールしたOracleGoldenGate Monitorサーバーのホスト管理者が、Oracle GoldenGate Monitorのユーザー・インタフェース外で設定する必要があります。

- CommandLineHandlers.xsd
このファイルには、CommandLineHandlers.xmlファイルの定義が含まれます。XSDからサンプルのXMLを作成する商用またはオープン・ソースのXML生成ツールを使用して、CommandLineHandlers.xmlを生成する際に使用できます。

変更を有効にするには、CommandLineHandlers.xmlの構成後、Oracle GoldenGate Monitorサーバーを一度停止してから再び開始します。この方法は、「Oracle GoldenGate Monitorサーバーの開始および停止」を参照してください。

4.3.1.1 コマンドライン・ハンドラの引数

次のUNIX構成例は、XML構成ファイルの構造および引数を示すものです。ヘッダー値は変更できません。これらの値で、XML.のバージョンおよびコーディングが指定されます。

引数は、例に示すように等号(=)の後に値を引用符で囲んで入力します。この例では、ネームスペースおよびスキーマの情報は省略記号(. . .)で示され、省略されています。

<?xml version="1.0" encoding="UTF-8"?>
<CommandLineHandlers . . .>
<CommandLineHandler dateTimeFormat="MMddyyyyHHmmssSSS"
executeIn="/home/user" name="CMDLINE">
<externalCommand>touch</externalCommand>
<arguments>
<argument argText="filename" name="hostname"
presentIfEmpty="true" quoted="false"/>
</arguments>
<alertMappings>
<alertMapping alertField="host" name="hostname"/>
</alertMappings>
</CommandLineHandler>
</CommandLineHandlers>s

CommandLineHandlerは、CLIアラート・ハンドラの親タグです。これは、CommandLineHandlersタグ内で指定されます。

<CommandLineHandler dateTimeFormat="MMddyyyyHHmmssSSS"
executeIn="/home/user" name="CMDLINE">

CommandLineHandlerタグには、次の引数が含まれます。

- dateTimeFormat
これは、Javaドキュメントで説明されている標準のJavaフォーマットの引数です。

- executeIn
executeIn引数によって、外部スクリプトまたはオブジェクト・ファイルが実行される前に、指定されたディレクトリへの移動処理がトリガーされます。デフォルトでは、スクリプトまたはコマンドが起動されたディレクトリである、仮想マシン(VM)の現在の実行ディレクトリが使用されます。

RunTimeExceptionは、指定されたディレクトリが存在しない場合、またはexecuteIn属性が空であるか存在しない場合に、アラートのトリガー時に生成されます。

- 名前
これは、常にCMDLINEです。

次の例には、CommandLineHandlerタグ内でネスト可能なタグが示されています。

<externalCommand>touch</externalCommand>
<arguments>
<argument argText="filename" name="hostname"
presentIfEmpty="true" quoted="false"/>
</arguments>
<alertMappings>
<alertMapping alertField="host" name="hostname"/>
</alertMappings>

- externalCommand
externalCommandの値では、スクリプトまたはオブジェクト・ファイルへの絶対パスを指定します。システムのPATH環境変数が、実行されるファイルのディレクトリを指している場合は、スクリプトまたはオブジェクト・ファイル名をパスなしで指定できます。

- arguments
argumentsタグでは、externalCommandタグで指定されるディレクトリ値に追加される1つ以上の値を指定します。

各引数に次の属性を指定できます。

argText - externalCommandタグを使用して送信されるリテラル・テキスト引数を指定します。

name - 名前を指定するか、次に説明するように、alertMappingsを使用して検索した名前を使用できます。

presentIfEmpty - alertMappingsタグと連携し、アラート定義に関連付けられている選択された情報をexternalCommandタグに追加します。詳細は、次の「alertMappings」を参照してください。

quoted - 引用符を追加する必要があるかどうかを指定します。

- alertMappings
alertMappingsタグは、アラート定義情報から抽出された値をexternalCommandタグで指定されている値に追加します。

<alertMappings>
<alertMapping alertField="host" name="hostname"/>
</alertMappings>

alertFieldには、アラート定義に関連付けられている次のいずれかの値が指定されます。

alertName - アラート定義の名前。

host - 監視ポイントでアラートをトリガーするOracle GoldenGateオブジェクトのホスト。

alertObjectName - EXACCTという名前のExtractプロセスなど、監視ポイントでアラートをトリガーするオブジェクトに関連付けられている名前。

alertTime - アラートがトリガーされた時間。

alertSeverity - アラートに定義されたセキュリティ・レベル(WarningまたはErrorのいずれか)。

alertMessage - アラートによって生成されたメッセージ。これは、アラートに定義された状態、監視ポイントの値およびリテラル・テキストの組合せです。

changedValue - アラートをトリガーした新しい監視ポイント値。たとえば、ラグが5秒を超える場合にトリガーされるアラートを作成します。ラグは4秒で、その後7秒になります。これによりアラートがトリガーされ、changedValueは7になります。

次の例では、argumentおよびalertMappingタグのname属性は、alertField属性から値を抽出するために一致しています。argument name "hostname"は、alertMapping name "hostname"と一致し、"host"であるalertFieldの値が検索されます。これにより、アラートをトリガーしたOracle GoldenGateオブジェクトのホストを、externalCommandタグで指定されている値に追加するようシステムが設定されます。

<arguments>
<argument argText="text" name="hostname" presentIfEmpty="true"
quoted="false"/>
</arguments>
<alertMappings>
<alertMapping alertField="host" name="hostname"/>
</alertMappings>

presentIfEmpty属性では、alertFieldが有効でない場合、またはname属性が一致しない場合の処理がalertMappingsタグを使用して決定されます。

- presentIfEmpty="true"
argText属性の値は、外部コマンドで使用されます。

- presentIfEmpty="false"
引数全体が省略されます。

4.3.2 サンプルのコマンドライン・ハンドラ

これらの例では、Oracle GoldenGate Monitorサーバー上でバッチ・スクリプトが実行されています。

4.3.2.1 Windowsサーバー上での実行

次の例では、Oracle GoldenGate MonitorサーバーをホストしているWindowsサーバー上で、バッチ・スクリプトsample_cli.batが実行されています。アラートをトリガーしたOracle GoldenGateインスタンスのサーバー("host")が、externalCommandで指定されているバッチ・スクリプトの名前に追加されています。

<?xml version="1.0" encoding="UTF-8"?>
<CommandLineHandlers
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.yourlocation/monitor/commandlinehandlers/CommandLineHandlers.xsd">
<CommandLineHandler dateTimeFormat="MMddyyyyHHmmssSSS"
executeIn="C:\" name="CMDLINE">
<externalCommand>c:\sample_cli.bat</externalCommand>
<arguments>
<argument argText="" name="hostname" presentIfEmpty="true" quoted="false"/>
</arguments>
<alertMappings>
<alertMapping alertField="host" name="hostname"/>
</alertMappings>
</CommandLineHandler>
</CommandLineHandlers>

4.3.2.2 UNIXホスト上での実行

次の例では、Oracle GoldenGate MonitorサーバーをホストしているUNIXサーバー上で、sample_cli.shスクリプトが実行されています。アラートをトリガーしたOracle GoldenGateインスタンスのサーバー("host")が、externalCommandで指定されているバッチ・スクリプトの名前に追加されています。

<?xml version="1.0" encoding="UTF-8"?>
<CommandLineHandlers
xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.yourlocation/monitor/commandlinehandlers/CommandLineHandlers.xsd">
<CommandLineHandler dateTimeFormat="MMddyyyyHHmmssSSS"    executeIn="/home/user" name="CMDLINE">
<externalCommand>bash</externalCommand>
<arguments>
<argument argText="/home/user/sample_cli.sh" name="hostname"  presentIfEmpty="true" quoted="true"/>
</arguments>
<alertMappings>
<alertMapping alertField="host" name="hostname"/>
</alertMappings>
</CommandLineHandler>
</CommandLineHandlers>

4.4 SNMPアラートの構成

Oracle GoldenGate Monitor Simple Network Management Protocol (SNMP)インタフェースでは、アラートはデータグラムの形式で送信されます。これらは、指定されたポート上でリスニングしているSNMPトラップの受信者によって取得されます。

この機能を使用するには、インストール中にSNMPアラートを有効にするか、後でmonitor.propertiesファイルのmonitor.snmp.alerts.enabledプロパティをtrueに設定する必要があります。

4.4.1 MIBファイルのインポート

GoldenGate-Monitor-mib.mibファイルは、Oracle GoldenGate Monitorのインストール中にcfgサブディレクトリに格納されます。これには、ターゲットによってアラートの解釈に使用される管理情報ベース(MIB)定義が含まれます。トラップで受信される情報を解釈する必要がある場合、このファイルをターゲット・ツールにインポートします。

4.4.2 SNMPアラートの構成

SNMPアラートは、Oracle GoldenGateのインストール中にcfgサブディレクトリ内に格納されるSNMPJMXMapping.xmlファイルで構成されます。

SNMPJMXMapping.xmlファイルへの変更はすべて、Oracle GoldenGate Monitorサーバー・ソフトウェアをインストールしたホスト管理者が、Oracle GoldenGate Monitorのユーザー・インタフェース外で行う必要があります。

SNMPJMXMapping.xmlファイル内では、SNMPバージョンを設定するセクションおよびターゲットを定義するセクションのみを変更する必要があります。

.
.
.
<MIBTree>
.
.
.
<notifications type="NOTIFICATIONS">
<notification version="2" enabled="true">
<targets>
<target timeout="200" retry="0">localhost/162
</target>
</targets>
.
.
.
</notification>
<notification version="1" enabled="false">
<targets>
<target>localhost/162
</target>
</targets>
.
.
.
</notification>
</notifications>
</MIBTree>

4.4.2.1 SNMPバージョンの設定

SNMPバージョンは、入力内容に基づいてインストール中に初期設定されます。後で、notification version 1 enabled値およびnotification version 2 enabled値をリセットして変更できます。1つをtrueに、もう1つをfalseに設定します。

有効なバージョンに定義されたターゲットが使用されます。無効なバージョンのターゲットは無視されます。

4.4.2.2 SNMPターゲットの設定

<target> </target>タグ内に、ホスト名とポート番号をスラッシュで区切って入力し、ターゲットを定義します。

4.5 アラートの有効化および無効化

Oracle GoldenGate Monitor管理者は、任意のカテゴリのアラートを無効化し、これらのアラートがリモート・クライアントに配信されないようにできます。たとえば、メンテナンス・ウィンドウ中にプロセスが停止されるときなど、計画停止中はアラートを無効にする場合があります。無効化されたアラートはリモート・クライアントには送信されませんが、Oracle GoldenGate Monitorのユーザー・インタフェースには記録されます。

アラートを無効にする手順:

1. Oracle GoldenGate Monitorサーバーのmonitor.propertiesファイルの適切なプロパティをfalseに設定します。

- SMTP配信を無効化するには、monitor.smtp.alerts.enabled=falseを設定します。

- CLI配信を無効化するには、monitor.cli.alerts.enabled=falseを設定します。

- SNMP配信を無効化するには、monitor.snmp.alerts.enabaled=falseを設定します。

2. Oracle GoldenGate Monitorサーバーを一度停止してから再び開始します。この方法は、「Oracle GoldenGate Monitorサーバーの開始および停止」を参照してください。

3. アラートを再び有効化するには、プロパティをtrueに戻し、Oracle GoldenGate Monitorサーバーを一度停止してから再び開始します。

5 SSL通信の使用

この章では、Oracle GoldenGateインスタンスを監視する場合に、Oracle GoldenGate MonitorサーバーとOracle GoldenGateエージェント間のJava Management Extensions (JMX)通信にSecure Sockets Layer (SSL)を使用する方法について説明します。

この章の内容は次のとおりです。

- 5.1項「Secure Sockets Layer (SSL)の使用」

- 5.2項「SSLの有効化」

- 5.3項「自己署名証明書の作成」

- 5.4項「認証局(CA)ドキュメントの使用」

5.1 Secure Sockets Layer (SSL)の使用

Oracle GoldenGate Monitor通信は、Oracle GoldenGate MonitorサーバーとOracle GoldenGateインスタンスのエージェント間の双方向で行われます。Oracle GoldenGate Monitorでは、SSLおよびセキュアJMX通信のいずれもサポートしますが、両方は同時にサポートしません。

5.1.1 SSL使用の考慮事項

通常は、Oracle GoldenGate Monitorサーバーおよびエージェントは、それらの間で送信されるデータを暗号化します。SSLを使用すると、次のセキュリティが追加されます。

- Oracle GoldenGate MonitorサーバーとOracle GoldenGateエージェント間のSSL通信は、証明書の形式の資格証明で検証する必要があります。

- SSLを使用して、ネットワーク上でOracle GoldenGate MonitorサーバーとOracle GoldenGateエージェント間で渡される情報は、送信中のデータが第三者によって変更されないように暗号化されます。

SSLを使用するかどうかを選択できますが、両方を同時に選択することはできません。Oracle GoldenGate MonitorサーバーがSSLを使用する場合は、それと通信するすべてのエージェントもSSLを使用する必要があります。Oracle GoldenGateインスタンスを監視するためにSSL通信を使用するオプションは、次に従います。

- デフォルトはSSLを使用しない設定ですが、使用するにはSSLを有効にする必要があります。

- サポートされているOracle GoldenGateプラットフォーム(監視がサポートされていないHP NonStopおよびIBM AS/400を除く)でOracle GoldenGateインスタンスを監視するために、SSLを使用できます。

- SSLを使用する場合、SSLが使用するリポジトリ(キーストア)はパスワードで保護されます。このパスワードは、サポートされているすべてのプラットフォーム(IBM z/OSを除く)のOracle Walletに格納されます。z/OSの場合、すべてのパスワードは、インストール・ディレクトリのcfgサブディレクトリにあるpassword.proptertiesファイルに格納されます。

- Oracle GoldenGate Monitorでは、双方向SSL認証をサポートしており、Oracle GoldenGate MonitorサーバーおよびOracle GoldenGateエージェントは双方向通信を使用します。Oracle GoldenGate Monitorサーバーおよびエージェントは、それぞれサーバー(リクエストを受信)として機能したり、クライアント(リクエストを送信)として機能します。

- SSLの設定には、Java Keytoolを使用したキーストアおよび証明書の作成が含まれます。この章では、SSLの鍵および証明書の生成手順について説明しますが、前提となるのは、Java Keytoolおよびキーストアの知識があること、Java Keytoolのドキュメントを読んでいること、推奨するセキュリティの考慮事項を認識していることです。

5.1.2 用語

次の用語は、この章で使用するJava用語です。詳細な定義および関連する用語の定義は、Java Keytoolのドキュメントを参照してください。

キーストア

キーストアとは、SSL認証に使用されるデータベースです。キーストアには、秘密鍵と証明書、クライアントまたはサーバーの識別に使用される対応する公開鍵が少なくとも格納されます。ただし、他のパーティから証明書を追加して、キーストアにマージするようにトラストストアを構成できます。

証明書

証明書とは、エンティティからのデジタル署名された文です(署名を検証して信頼性をチェックできるため、参照される公開鍵が有効であることが記載されています)。

トラストストア

トラストストアには、他のエンティティの証明書の署名(発行)について信頼済のサード・パーティの認証局(CA)と(から)通信する、他のパーティからの公開鍵と証明書が格納されます。トラストストアは、キーストアにマージするように構成できるため、すべての鍵と証明書の場所が1つになります。

Keytool

Keytoolとは、鍵および証明書を生成および管理するためのJavaユーティリティです。

5.2 SSLの有効化

Oracle GoldenGate MonitorサーバーおよびOracle GoldenGate Monitorエージェントは、デフォルトでSSLが有効になっていません。SSLを使用する場合は、サーバーおよびエージェントのプロパティを有効にする必要があります。キーストアを作成し、指定した場所に各キーストアを配置する必要もあります。

5.2.1 SSLプロパティの設定

SSLを有効にするには、サーバーおよびエージェントの両方のプロパティ設定を変更する必要があります。

Oracle GoldenGate Monitorサーバーの場合:

1. Oracle GoldenGate Monitorサーバーのインストール・ディレクトリに移動します。

2. monitor.propertiesファイルを編集しmonitor.sslプロパティをtrueに設定します。

3. Oracle GoldenGate Monitorサーバーを一度停止してから再び開始し、新しい設定を有効化します。

各Oracle GoldenGate Monitorエージェントの場合:

1. Oracle GoldenGate Monitorインスタンスのインストール・ディレクトリに移動します。

2. エージェントのConfig.propertiesファイルを編集し、jagent.sslプロパティをtrueに設定します。

注意:

Oracle GoldenGate MonitorサーバーでSSLを有効にする場合は、サーバーと通信するすべてのエージェントでもSSLを有効にする必要があります。

5.2.2 キーストアの作成

SSLでは、証明書および鍵ペアを格納するためのキーストアを作成する必要があります。これらを作成するには、Java Secure Sockets Extension (JSSE)のKeytoolを使用します。Solaris/UNIXまたはWindowsのKeytoolドキュメントにアクセスするには、「JDKツールとユーティリティ」(http://docs.oracle.com/javase/6/docs/technotes/tools)を参照してください。

キーストアの場所

Oracle GoldenGate Monitorのキーストアは、サーバーおよびエージェントのインストールの場所の次のディレクトリに格納する必要があります。

- エージェントの証明書を含むキーストアは、Oracle GoldenGateインスタンスのインストールディレクトリのdircrtサブディレクトリに格納する必要があります。デフォルト名はjagentKeyStoreです。

- Monitorサーバーのキーストアおよび証明書は、Oracle GoldenGate Monitorサーバーのインストール・ディレクトリのcertサブディレクトリに格納する必要があります。デフォルト名はmonitorKeyStoreです。

デフォルトでは、キーストアは、Keytoolが実行されるディレクトリに作成されます。指定した場所からKeytoolを実行するか、キーストアの作成後にキーストアを移動します。

jagent.keystore.file、jagent truststore.file、monitor.keystore.fileまたはmonitor.truststore.fileプロパティを設定することで、キーストアのデフォルト名を変更できます。キーストアとトラストストアのファイルが同じ名前に設定されている場合は、そのファイルが使用され、証明書と他のエンティティからの信頼済の証明書の両方が格納されます。

キーストアのパスワード

キーストアは、Oracle GoldenGate Monitorサーバーまたはエージェントを識別する証明書を作成したときに作成されるパスワードで保護されます。このパスワードは、Oracle Wallet(IBM z/OSの場合はpassword.propertiesファイル)にも追加する必要があります。

注意:

Oracle GoldenGate Monitorパスワードは、サポートされているすべてのプラットフォーム(IBM z/OSを除く)のOracle Walletに格納されます。z/OSの場合は、Oracle GoldenGate Monitorサーバーまたはエージェントのインストール場所のcfgサブディレクトリにある、password.proptertiesファイルに格納されます。

Oracle GoldenGate Monitorサーバーの場合:

- WebLogic Scripting ToolコマンドのupdateCred()(2.3.1項「パスワードの作成」を参照)を使用して、キーストアのパスワードを追加します。

- 個別のトラストストアを使用している場合は、updateCred()を使用して、そのパスワードも追加します。

各Oracle GoldenGateエージェントの場合:

- Oracle GoldenGateエージェントのパスワードを追加します(3.3項「Oracle GoldenGate Monitorエージェントのパスワードの更新」を参照)。

- 個別のトラストストアを使用している場合は、ユーティリティの-truststoreオプションを使用して、トラストストアのパスワードも追加します。

5.3 自己署名証明書の作成

Java Keytoolを使用して、Oracle GoldenGate MonitorサーバーおよびOracle GoldenGateエージェントの検証に必要な証明書を作成できます。Keytoolでは、これらの証明書をキーストアに格納します。

5.3.1 Monitorサーバーの自己署名証明書の確立

最初に、Oracle GoldenGate Monitorサーバーを識別する自己署名証明書を作成し、Oracle GoldenGate Monitorエージェント・トラストストアにエクスポートします。

Monitorサーバーを検証するための証明書の作成

次の手順に従い、証明書を作成します。コマンドおよびオプションの詳細は、Java用のKeytoolのドキュメントを参照してください。

1. Oracle GoldenGate Monitorサーバーのインストール・ディレクトリに移動し、certサブディレクトリに移動します。これは、Monitorサーバー・キーストアの場所です。

2. Monitorで使用される証明書を作成し、自身を検証して通信を暗号化します。
例:

keytool -genkeypair -keystore monitorkeystore -keyalg rsa -alias monalias -storepass keystorepw -keypass serverpw

オプション-keystoreは、キーストア・リポジトリの名前を識別します。monitorkeystoreデフォルト名を使用しない場合は、選択した名前でmonitor.propertiesファイルを更新する必要があります。

-keyalgは、暗号化アルゴリズムを指定します(rsaにする必要があります)。

-aliasは、作成される新しいキーストア・エントリの識別子を指定します(この例ではmonalias)。

-storepassは、キーストアを保護するパスワードを指定します。-keypassは、Monitorサーバーを識別する生成済の鍵ペアの秘密鍵を保護するパスワードを指定します。これらにパスワードを指定しないと、入力するように求められます。

注意:

選択したキーストアのパスワードを記録し、Oracle GoldenGate Monitorサーバーまたはエージェントに追加できるようにします(5.2.2項「キーストアの作成」を参照)。

次の質問に答えるように求められます。

What is your first and last name?
What is the name of your organizational unit?
What is the name of your organization?
What is the name of your City or Locality?
What is the name of your State or Province?
What is the two-letter country code for this unit?

答えを入力すると、答えが表示され、それらが正しいかの確認が求められます。この情報は、証明書の一部になります。

3. (オプション)次のコマンドを使用して、作成されたエントリをリストし、証明書の作成を検証します。

keytool -list -alias monalias -keystore monitorkeystore

4. Oracle GoldenGate Monitorサーバー証明書をmonitorkeystoreキーストアからファイルにエクスポートします。例:

keytool -exportcert -alias monalias -file moncert.crt -keystore monitorkeystore storepass keystorepw

オプション-fileは、エクスポート後にmonalias証明書を保持するファイルを指定します。-keystoreは、エクスポートされるaliasを格納するリポジトリを指定します。

オプションで、-certreqオプションを付けて証明書署名リクエスト(CSR)を生成し、サード・パーティのCAに送信して署名できます。

5. (オプション)証明書情報を出力します。例:

keytool -printcert -file moncert.crt

6. Keytool exportcertコマンド(この例ではmoncert.crt)で作成したOracle GoldenGate Monitorサーバー証明書ファイルを、Oracle GoldenGateエージェントのinstallation location/dircrtディレクトリにコピーします。

エージェント・キーストアへのサーバー証明書のインポート

次の手順を実行し、Oracle GoldenGate Monitorサーバー証明書をエージェント・トラストストアにインポートします。

1. Oracle GoldenGateエージェント・キーストアの場所(installation location/dircrt)に移動します。

2. 証明書をOracle GoldenGateエージェント・キーストアにインポートします。例:

keytool -importcert -alias agentalias -file moncert.crt -keystore jagentkeystore storepass agentkeystorepw

これは、moncert.crtファイルから証明書を読み取り、jagentkeystoreに格納します。

オプションで、-trustcertsオプションを使用して、信頼チェーンの追加の証明書をCA証明書のシステム全体のキーストアからインポートできます。たとえば、次のコマンドは、Keytoolをトリガーして、moncert.crtから自己署名証明書までの信頼パスの確立を試みます。

keytool -importcert -trustcacerts -alias agentalias -file moncert.crt -keystore jagentkeystore -storepass agentkeystorepw

3. (オプション)キーストアに作成された証明書をリストし、インポートを検証します。例:

keytool -list -keystore jagentkeystore storepass agentkeystorepw

5.3.2 エージェントの自己署名証明書の確立

自己署名証明書を作成してOracle GoldenGate Monitorエージェントを検証し、証明書をOracle GoldenGate Monitorサーバーにインポートする必要があります。

5.3.2.1 エージェントを検証するための証明書の作成

次の手順に従い、エージェントの証明書を作成します。コマンドおよびオプションの詳細は、Keytoolのドキュメントを参照してください。

1. Oracle GoldenGateエージェント・キーストアの場所(installation location/dircrt)に移動します。

2. 次のように、Keytoolコマンドを使用してエージェント証明書を生成します。

keytool -genkeypair -alias agentalias -keystore jagentkeystore

この例では、同じキーストアjagentkeystoreを使用しており、これはOracle GoldenGate Monitorサーバーからの信頼済証明書に使用しています。

キーストアのパスワードは入力していないため、入力するようにKeytoolから求められます。

3. (オプション)キーストアの証明書をリストし、作成を検証します。例:

keytool -list -keystore jagentkeystore -storepass agentkeystorepw

4. エージェントを検証する証明書をファイルにエクスポートします。例:

keytool -exportcert -alias agentalias -file agentclient.crt -keystore jagentkeystore -storepass agentkeystorepw

5. (オプション)証明書情報を出力します。

keytool -printcert -file agentclient.crt

6. 証明書ファイル(この例ではagentclient.crt)をOracle GoldenGate Monitorサーバーのinstallation location/certディレクトリにコピーします。

5.3.2.2 Monitorサーバーへのエージェント証明書のインポート

次の手順に従い、証明書をOracle GoldenGate Monitorサーバー・トラストストアにインポートします。

1. Oracle GoldenGate Monitorサーバー・キーストアの場所(installation location/dircrt)に移動します。

2. エージェント証明書をOracle GoldenGate Monitorサーバー・キーストアにインポートします。例:

keytool -importcert -alias agentalias -file agentclient.crt -keystore monitorkeystore -storepass keystorepw

3. (オプション)証明書情報をリストし、インポートを検証します。

keytool -list -keystore monitorkeystore -storepass keystorepw

5.4 認証局(CA)ドキュメントの使用

Java Keytoolを使用して、信頼できるサード・パーティによって証明書を署名するようにリクエストできます。認証局(CA)が証明書を署名すると、キーストアまたはトラストストアにインポートして、識別と検証を実行できます。

5.4.1 証明書署名リクエストの生成

次の手順に従い、証明書署名リクエスト(CSR)を生成します。この例では、Oracle GoldenGate Monitorサーバー側またはエージェント側のいずれかに例を制限するのを回避するために、異なる名前をキーストアに使用しています。

1. 次のように、Keytoolコマンドを使用してCSRを生成します。

keytool -certreq -v -alias certalias -file cert.csr -keypass keypassword -storepass keystorepw -keystore keystore.jks

このコマンドでは、-fileオプションで指定した、cert.csrという名前のファイルを作成します。-vオプションでは、冗長モードを署名し、詳細情報を出力します。

2. CSR cert.csrを、証明書を署名するサード・パーティに送信します。

5.4.2 証明書のインポート

サード・パーティのCAから署名済証明書が戻されたら、署名済証明書および署名したCAの証明書をキーストアにインポートします。

1. CA証明書および署名済証明書をPEM形式に変換し、キーストアのディレクトリに格納します。チェーン内の証明書を含む、各証明書を個別に格納する必要があります。

2. 次のコマンドを使用して、チェーン内の最上位(ルート)証明書(CAの自己署名証明書にする必要があります)をインポートします。

keytool -importcert -v -noprompt -trustcacerts -alias rootCA -file rootCA.pem -keystore keystore.jks -storepass keystorepw

この例では、rootCAは、証明書の別名で、rootCA.pemは、チェーン内の最上位の証明書を格納するファイルです。

インポートが成功すると、KeytoolによってメッセージCertificate was added to keystoreが表示されます。

注意:

一部のサード・パーティ認証局では、チェーン内にルート証明書と中間CA証明書の2つのCA証明書が存在する場合があります。この場合は、ルート証明書の直後に中間証明書をインポートするようにしてください。

3. チェーン内の証明書(.pemファイル)ごとに、インポートを繰り返します。それぞれ異なるaliasを作成します。

4. すべての証明書が正常にインポートされたら、次のコマンドを使用して、署名済応答証明書をインポートします。

-keytool -importcert -v-alias certalias -file cert.pem -keystore keystore.jks -keypass keypass -storepass keystorepw

証明書およびCSRの生成時に使用したのと同じaliasを使用します。

インポートが成功すると、KeytoolによってメッセージCertificate reply was installed in the keystoreが表示されます。

5. インポートされたすべてのCA証明書をリストします。

keytool -list -keystore keystore.jks -storepass keystorepw

6. 次のコマンドを使用して、公開証明書をエクスポートします(ファイルcert.cerが作成されます)。

keytool -exportcert -alias certalias -file cert.cer -keystore keystore.jks -storepass keystorepw

証明書ごとに、エクスポートを繰り返します。

7. 証明書およびそのCA証明をキーストアにインポートするには、最初にすべての証明書を.pem形式で個別のファイルに格納します。次に、最上位(ルート)証明書から開始し、それぞれに異なる別名を指定してすべての証明書をインポートします。ルート証明書をインポートする例:

keytool -importcert -v -noprompt -trustcacerts -alias IDrootCA -file IDrootCA.pem -keystore keystore.jks -storepass storepasspw

証明書ごとに、インポートを繰り返します。

6 インスタンス・レベル・セキュリティについて

この章では、Oracle GoldenGate Monitor 12c (12.1.3)のインスタンス・レベル・セキュリティの実装方法について説明します。内容は次のとおりです。

- 6.1項「概要」

- 6.2項「インスタンス・アクセス・ルール」

- 6.3項「インスタンス・アクセス動作」

- 6.4項「ユーザー・インスタンス・マトリクス」

6.1 概要

Oracle Golden Gate Monitor 12.1.3 (12c)では、異なるホスト/インスタンスへの個別のユーザー・アクセスを制限するために、現在の機能レベルのセキュリティに加えて、インスタンス・レベルのセキュリティを利用できます。

6.2 インスタンス・アクセス・ルール

次のインスタンス・アクセス・ルールが適用されます。

- スーパー管理者は、すべてのOracle GoldenGateエージェント・インスタンスに常にアクセス可能で、オペレータ/パワー・オペレータおよび管理者ロールに属するユーザーに、インスタンスを常に直接割り当てることができます。

- 管理者は、スーパーユーザーおよびその他の管理者にマップされたインスタンスを変更する権限はありません。管理者は、オペレータおよびパワー・オペレータに対してのみ、インスタンス(現在ログインしている管理者がアクセス可能なインスタンス)のマップおよびアンマップが可能です。

- 管理者およびオペレータ/パワー・オペレータは、共有インスタンス・アクセスを持つことができます(複数のユーザーがインスタンス・プールから共通の/同じインスタンスにアクセスできます(例: Pool [1,2,3,4,5] Ad1 -->[1,2,3], Ad2-->[3,4,5]))。

- スーパー管理者は、異なる管理者から付与された、オペレータ/パワー・オペレータがアクセス可能なインスタンスの完全/結合セットを常に持つことができます。スーパー管理者は、管理者によってオペレータ/パワー・オペレータに割り当てられたインスタンスをオーバーライドできます(例: ユーザーはスーパー管理者としてログインし、ユーザーOpr1をクリックします)。ユーザーAdmin2はインスタンス3、4、5にアクセスでき、3、4、5のインスタンス・アクセスをユーザーOpr1に割り当てているため、スーパー管理者には、インスタンス1、2、3、4、5のみが有効になっていることが表示されます。

- スーパー管理者によって削除されたインスタンスに管理者がアクセスできる場合、管理者は、それらのインスタンスをオペレータ/パワー・オペレータに再割当てできます。

- 管理者が削除された場合、オペレータまたはパワー・オペレータに割り当てられたインスタンスはそのまま残ります。削除された管理者が存在しない場合、オペレータまたはパワー・オペレータによって所有されるインスタンスは、スーパー管理者によって管理されます。

- ユーザーに複数のロールを割り当てることができます。Oracle GoldenGate Monitorでは、そのユーザー(Admin1など)の最高のロールを考慮し、スーパー・ユーザーおよび管理者の両方になることができます。

ロール割当ての例

次のシナリオは、ロール/インスタンスの割当て中に前述のルールがどのように適用されるかを示しています。この例で使用されるロールは次のとおりです。

- SA: スーパー管理者

- JI: Jagentインスタンス

- Ad1、Ad2: 管理者

- Opr1、Opr2: オペレータ

- PowerOpr1、PowerOpr2: パワー・オペレータ

利用可能なOracle GoldenGateエージェント・インスタンス: {1, 2, 3, 4, 5}

次の手順は、特定のインスタンスがロールにどのように割り当てられるかを示しています。:

1. SA: JI 1、2、3、4、5にアクセス

2. SA: JI 1、2、3をAd1に割当て

3. SA: JI 3、4、5をAd2に割当て

4. Ad1: JI 1、2、3をOpr1に割当て

5. Ad2: JI 3、4、5をOpr1に割当て

6. Ad1: JI 1、2、3をPowerOpr1に割当て

7. Ad2: JI 3、4、5をPowerOpr1に割当て

6.3 インスタンス・アクセス動作

ユーザーに割り当てられていないインスタンスに、そのユーザーがアクセスしようとすると、インスタンスにアクセスできない旨のメッセージが表示されます。同じ動作は、特定のインスタンスの一部であるソリューション/ビューに適用されます。

6.4 ユーザー・インスタンス・マトリクス

ログインしているユーザー

EDIT USERインスタンスが有効/無効

EDIT USERインスタンスが有効/無効

EDIT USERインスタンスが有効/無効

EDIT USERインスタンスが有効/無効

スーパー管理者としてログイン

スーパー管理者インスタンスが無効

管理者インスタンスが有効

オペレータ・インスタンスが有効

パワー・オペレータ・インスタンスが有効

管理者としてログイン

スーパー管理者インスタンスが無効

管理者インスタンスが無効

オペレータ・インスタンスが有効

パワー・オペレータ・インスタンスが有効

注意:

インスタンス・レベル・セキュリティはアラート生成で利用できません。ユーザーは、そのユーザーがアクセスできないインスタンス・オブジェクトのアラートを作成できます。

7 コマンドおよびパラメータ

この章では、監視を有効にするためにOracle GoldenGateインスタンスで設定されているパラメータ、Oracle GoldenGate Monitorのデータ・ストアを作成および変更するのに使用するコマンド、および監視データを処理するOracle GoldenGate Monitorエージェントを開始するのに使用するコマンドについて説明します。

この章の内容は次のとおりです。

- 7.1項「パラメータ」

- 7.2項「GGSCIコマンド」

7.1 パラメータ

Oracle GoldenGateパラメータは、Oracle GoldenGateプロセスの構成、実行および管理に使用されます。ここに含まれるパラメータは、Oracle GoldenGate MonitorサーバーまたはOracle Enterprise Managerによる監視に適用されます。

7.1.1 ENABLEMONITORAGENT

適用対象

GLOBALS

ENABLEMONITORAGENTパラメータでは、Oracle GoldenGate agent for Oracle GoldenGateリリース11.1.1.1を有効にします。詳細は、『Oracle GoldenGate Windows and UNIXリファレンス・ガイド』(11.1.1.1リリース)を参照してください。

注意:

ENABLEMONITORAGENTは、Oracle GoldenGateリリース11.2.1以降で非推奨です。

構文

ENABLEMONITORAGENT

7.1.2 ENABLEMONITORING

適用対象

GLOBALS

ENABLEMONITORINGパラメータでは、Oracle GoldenGateの監視を有効にします。監視は、適用対象のOracle GoldenGateのインスタンス内のExtract、ReplicatおよびManagerプロセスに対して有効になっています。

ENABLEMONITORINGは、Oracle GoldenGateプロセスに関するステータスやその他の情報をOracleGoldenGate MonitorまたはOracle Enterprise Managerに提供する監視ポイントの収集をアクティブにします。

注意:

ENABLEMONITORINGは、Oracle GoldenGateリリース11.2.1以降で有効なパラメータです。

構文

ENABLEMONITORING

7.1.3 AUTOSTART JAGENT

適用対象

Manager

AUTOSTARTパラメータのJAGENTオプションでは、Managerの起動時にOracle GoldenGateエージェントを自動的に開始します。

同じパラメータ・ファイルで複数のAUTOSTART文を使用できます。

構文

AUTOSTART {{EXTRACT | REPLICAT | ER} group_name | JAGENT}

例

AUTOSTART JAGENT

7.2 GGSCIコマンド

Oracle GoldenGateソフトウェア・コマンド・インタフェース(GGSCI)は、ユーザーとOracle GoldenGate機能コンポーネント間のコマンド・インタフェースです。Oracle GoldenGateリリース11.2.1以降では、コマンドは、Oracle GoldenGateと、Oracle GoldenGate MonitorサーバーまたはOracle Enterprise Managerによる監視との間のインタフェースの設定および制御に使用されます。

注意:

この項の一部のコマンドまたはオプションは、Oracle GoldenGate 11.2.1.0.7以降の場合にのみ有効としてマークされ、その他は、11.2.1以降で有効です。

7.2.1 CREATE DATASTORE

CREATE DATASTOREでは、Oracle GoldenGate Monitorデータ・ストアをOracle GoldenGateインストール・ディレクトリに作成します。データ・ストアには、Oracle GoldenGate Extract、ReplicatおよびManagerプロセスによって提供される監視情報が保持されます。これは、監視を使用する場合に必要な手順です。

構文

CREATE DATASTORE [ MMAP | SHM [ID number] ]

MMAPは、データ・ストアがプロセス間通信にメモリー・マップ・ファイルを使用する必要があることを示します。これは、Windowsプラットフォームのデフォルトです。MMAPオプションは、Oracle GoldenGateリリース11.2.1.0.7以降で有効です。

注意:

ネットワーク・ファイル・システム(NFS)、ASMクラスタ・ファイル・システム(ACFS)、Oracle Databaseファイル・システム(DBFS)などの共有ネットワーク・ファイル・システムを実行している場合は、MMAPを使用しないでください。

SHMは、データ・ストアがプロセス間通信にSystem V共有メモリーを使用する必要があることを示します。これは、Windows以外のプラットフォームのデフォルトです。オプションのIDは、numberをSystem V共有メモリー・キーに使用する必要があることを指定します。ID numberが入力されていない場合は、1000から開始し、割当てごとに1ずつ増分するデフォルトのキーが割り当てられます。SHMオプションは、Windowsプラットフォームでは利用不可で、Oracle GoldenGateリリース11.2.1.0.7以降でのみ有効です。

例

CREATE DATASTORE
CREATE DATASTORE MMAP
CREATE DATASTORE SHM
CREATE DATASTORE SHM ID 1000

7.2.2 ALTER DATASTORE

ALTER DATASTOREでは、Oracle GoldenGate Monitorデータ・ストアによるプロセス間通信に使用されるメモリー・モデルを変更します。このコマンドを使用する前に、すべてのOracle GoldenGateプロセス(Managerを含む)を停止します。このコマンドは、Oracle GoldenGateリリース11.2.1.0.7以降で有効です。

構文

ALTER DATASTORE [ MMAP | SHM [ID number] ]

MMAPは、データ・ストアがプロセス間通信にメモリー・マップ・ファイルを使用する必要があることを示します。

SHMは、データ・ストアがプロセス間通信にSystem V共有メモリーを使用する必要があることを示します。オプションのIDは、numberをSystem V共有メモリー・キーに使用する必要があることを指定します。ID numberが入力されていない場合、キーはGGSCIによって選択されます。このオプションは、Windowsプラットフォームでは使用できません。

例

ALTER DATASTORE MMAP
ALTER DATASTORE SHM
ALTER DATASTORE SHM ID 1000

7.2.3 DELETE DATASTORE

DELETE DATASTOREコマンドでは、Oracle GoldenGate Monitorデータ・ストアをOracle GoldenGateインストール・ディレクトリから削除します。このコマンドを使用する前に、すべてのOracle GoldenGateプロセス(Managerを含む)を停止します。このコマンドは、Oracle GoldenGateリリース11.2.1.0.7以降で有効です。

構文

DELETE DATASTORE [!]

! (感嘆符)は、データ・ストアを削除するかどうかを確認するプロンプトをバイパスします。

例

DELETE DATASTORE
DELETE DATASTORE !

7.2.4 INFO DATASTORE

INFO DATASTOREコマンドでは、Oracle GoldenGate Monitorデータ・ストアによるプロセス間通信に使用されるメモリー・モデルの情報を表示します。このコマンドは、Oracle GoldenGateリリース11.2.1.0.7以降で有効です。

構文

INFO DATASTORE

7.2.5 REPAIR DATASTORE

REPAIR DATASTOREコマンドでは、Oracle GoldenGateインストールのデータ・ストアを修復します。すべてのExtractおよびReplicatプロセスが登録されていることをチェックし、内部整合性エラーの解決を試みます。REPAIR DATASTOREでは、前のバージョンのデータ・ストアからの更新時に、必要な更新を適用します。

このコマンドを使用する前に、すべてのOracle GoldenGateプロセス(Managerを含む)を停止します。

構文

REPAIR DATASTORE

7.2.6 INFO JAGENT

INFO JAGENTでは、Jagentが実行中かどうかを表示します。

構文

INFO JAGENT

例

INFOリクエストは、Oracle GoldenGateエージェントが実行中または停止中かを返します。

INFO JAGENT

JAgent is DOWN!

7.2.7 START JAGENT

START JAGENTでは、エージェント・プロセスを開始します。開始したことを確認するには、INFO JAGENTまたはSTATUS JAGENTコマンドを使用します。

注意:

追加または削除されたプロセスを検出するために、エージェント・プロセスを再開する必要はありません。

構文

START JAGENT

例

START JAGENT

GGCMD JAGENT started.

7.2.8 INFO JAGENT

STATUS JAGENTでは、エージェントが実行中かどうかを判断します。

構文

STATUS JAGENT

例

STATUS JAGENT

JAgent is running.

7.2.9 STOP JAGENT

STOP JAGENTでは、エージェント・プロセスを停止します。停止したことを確認するには、INFO JAGENTまたはSTATUS JAGENTコマンドを使用します。

構文

STOP JAGENT [!]

説明:

!(感嘆符)は、エージェントを停止するリクエストを確認するプロンプトをバイパスします。

8 プロパティ

この章では、Oracle GoldenGate MonitorおよびOracle GoldenGateコアのインストール時にcfgサブディレクトリに格納されるプロパティ・ファイルについて説明します。これらのファイルには、監視プロセスを制御する設定が格納されます。ソフトウェアのリリースに基づいて事前設定されているプロパティ値と、ユーザーの入力内容に基づいてインストーラによって設定されるプロパティ値があります。

この章の内容は次のとおりです。

- 8.1項「Monitorサーバーのプロパティ」

- 8.2項「エージェントのプロパティ」

8.1 Monitorサーバーのプロパティ

monitor.propertiesファイルには、Oracle GoldenGate Monitorの処理に関する特性が記述されます。これには、JMXサーバーとの関係、使用されるアラート通知のタイプ、および接続の試行のタイミングを定義するプロパティが含まれます。これらのプロパティ値の多くは、ユーザーの入力内容に基づいてインストール中に初期設定されます。

注意:

プロパティ値を変更したら、Monitorサーバーを再起動してアクティブ化する必要があります。

8.1.1 制限付きプロパティ

特定のOracle GoldenGate Monitorのプロパティは、変更するとシステム障害が発生する場合があります。これらのプロパティは、制限付きと指定されています。制限付きプロパティに事前設定されている値は変更しないでください。

制限付きプロパティには、次のものがあります。

monitor.jmx.internal.mbeans.enabled
monitor.supported.agent.metadata.version
monitor.jpa.connection.driver_class
monitor.jpa.connection.url
eclipselink.target-database
eclipselink.weaving
eclipselink.ddl-generation

8.1.2 JMXサーバーのプロパティ

これらのプロパティは、JMXサーバーを有効にし、ユーザー名を識別して、JMXサーバー・ホストの名前とポートを登録します。

8.1.2.1 monitor.jmx.server.enabled

monitor.jmx.server.enabledでは、JMXサーバーを有効化または無効化します。JagentをOracle GoldenGate Monitorサーバーに登録するには、JMXサーバーが有効化されている必要があります。エージェントが登録されるよう、値はtrueに初期設定されています。

デフォルト

true

構文

monitor.jmx.server.enabled={true | false}

8.1.2.2 monitor.jmx.server.host

monitor.jmx.server.hostでは、Oracle GoldenGate Monitorインストールのコンピュータ名を指定します。これは、Oracle GoldenGate Monitorインストール用のサーバーの完全修飾のホスト名に設定します。エージェントのConfig.propertiesファイル内のmonitor.serverのエントリと一致している必要があります。この値は、ユーザーの入力内容に基づいてインストーラによって初期設定されます。

構文

monitor.jmx.server.host=host_name

8.1.2.3 monitor.jmx.server.port

monitor.jmx.server.portでは、JMXサーバーのポート番号を指定します。この値は、ユーザーの入力内容に基づいてインストーラによって初期設定されます。

構文

monitor.jmx.server.port=port_number

8.1.2.4 monitor.jmx.server.user

monitor.jmx.server.userでは、JMXサーバーと通信するときに使用するユーザー名を指定します。この値は、ユーザーの入力内容に基づいてインストーラによって初期設定されます。

構文

monitor.jmx.server.user=user_name

8.1.3 通信

通信でSecure Sockets Layer (SSL)を使用するかどうかを選択する必要があります。SSLを使用する場合は、鍵および資格証明の記憶域を指定する必要があります。

8.1.3.1 monitor.ssl

monitor.sslでは、Oracle GoldenGate Monitorからの通信でSSLを使用するかどうかを指定します。

注意:

Oracle GoldenGate Monitorサーバーのmonitor.ssl設定は、サーバーと通信するすべてのエージェントでConfiguration.propertiesファイルのagent.sslプロパティ設定に一致する必要があります。

デフォルト

false

構文

monitor.ssl=[true | false]

8.1.3.2 monitor.keystore.file

monitor.keystore.fileでは、SSL認証に使用される鍵のペアと証明書を格納するファイルを指定します。

デフォルト

monitorKeyStore

構文

monitor.keystore.file=keystore_filename

8.1.3.3 monitor. truststore.file

monitor.truststore.fileでは、クライアントまたはサーバーのIDを確認する、信頼できる認証局(CA)の証明書を格納します。

デフォルト

jagentKeyStore

構文

monitor.truststore.file=truststore_filename

8.1.4 アラート通知

これらのプロパティでは、アラートのタイプを有効または無効にし、電子メール・サーバーとの通信に必要な情報を格納します。

8.1.4.1 monitor.smtp.from

monitor.smtp.fromでは、電子メール・サーバーから生成されるOracle GoldenGate Monitorの通信用の送信者名を指定します。この値は、ユーザーの入力内容に基づいてインストーラによって初期設定されます。

構文

monitor.smtp.from=sender_name

8.1.4.2 monitor.smtp.host

monitor.smtp.hostでは、電子メール・サーバーのホスト名を指定します。この値は、ユーザーの入力内容に基づいてインストーラによって初期設定されます。

構文

monitor.smtp.host=email_host_name

8.1.4.3 monitor.smtp.port

monitor.smtp.portでは、電子メール・アラートの送信用ポートを指定します。この値は、ユーザーの入力内容に基づいてインストーラによって初期設定されます。

構文

monitor.smtp.port=port_number

8.1.4.4 monitor.smtp.secure

monitor.smtp.secureでは、SMTPサーバーをセキュア・モードにするかどうかを指定します。この値は、ユーザーの入力内容に基づいてインストーラによって初期設定されます。

構文

monitor.smtp.secure={true | false}

8.1.4.5 monitor.smtp.user

SMTPサーバーがセキュア・モードである場合、ログインが許可されているユーザーを指定します。この値は、ユーザーの入力内容に基づいてインストーラによって初期設定されます。

構文

monitor.smtp.user=user_name

8.1.4.6 monitor.smtp.alerts.enabled

monitor.smtp.alerts.enabledでは、電子メールを有効にするかどうかを指定します。この値は、ユーザーの入力内容に基づいてインストーラによって初期設定されます。

構文

monitor.smtp.alerts.enabled={true | false}

8.1.4.7 monitor.snmp.alerts.enabled

monitor.snmp.alerts.enabledでは、SNMPアラートを有効にするかどうかを指定します。この値は、ユーザーの入力内容に基づいてインストーラによって初期設定されます。

構文

monitor.snmp.alerts.enabled={true | false}

8.1.4.8 monitor.cli.alerts.enabled

monitor.cli.alerts.enabledでは、コマンドライン・インタフェース・アラートを有効にするかどうかを指定します。この値は、ユーザーの入力内容に基づいてインストーラによって初期設定されます。

構文

monitor.cli.alerts.enabled={true | false}

8.1.5 接続のプロパティ

これらのプロパティは、接続の特性を定義します。これらは変更できますが、まずOracle Supportサポートに問い合せることをお薦めします。詳細は、http://support.oracle.comにアクセスしてください。

8.1.5.1 monitor.db.connection.initial_size

monitor.db.connection.initial_sizeでは、接続プール内の初期データベース接続数を設定します。デフォルトは5です。

構文

monitor.db.connection.initial_size=5

8.1.5.2 monitor.db.connection.max_active

monitor.db.connection.max_activeでは、作成可能な最大データベース接続数を設定します。デフォルトは50です。

構文

monitor.db.connection.max_active=50

8.1.5.3 monitor.db.connection.max_idle

monitor.db.connection.max_idleでは、アイドル状態にできる最大データベース接続数を設定します。デフォルトは5です。

構文

monitor.db.connection.max_idle=5

8.1.5.4 monitor.default_agent_connection.max_attempts

monitor.default_agent_connection.max_attemptsでは、プロセスが接続の試行を停止するまでに失敗する接続数を指定します。0または負の数値を入力すると、接続の試行回数が無制限になります。この値は10に初期設定されています。

構文

monitor.default_agent_connection.max_attempts=number

8.1.5.5 monitor.default_agent_connection.interval

monitor.default_agent_connection.intervalでは、接続の試行に失敗するたびに待機する秒数を指定します。この値は30に初期設定されています。

構文

monitor.default_agent_connection.interval=seconds

8.1.5.6 monitor.default_agent_connection.reconnect_interval

monitor.default_agent_connection.reconnect_intervalでは、既存の接続が切断された後、再接続が試行されるまでに待機する秒数を指定します。この値は5に初期設定されています。

構文

monitor.default_agent_connection.reconnect_interval=seconds

8.1.6 リポジトリのプロパティ

リポジトリ・データベースは、Oracle GoldenGate Monitorのインストール中に選択されます。インストール後にリポジトリを変更する必要がある場合は、Oracle Supportに問い合せてください。サポートへの問合せの詳細は、http://support.oracle.comにアクセスしてください。

8.1.6.1 monitor.jpa.connection.user

monitor.jpa.connection.userでは、リポジトリ・データベースのユーザー名を指定します。この値は、ユーザーの入力内容に基づいてインストーラによって初期設定されます。

構文

monitor.jpa.connection.user=user_name

8.1.7 構成管理のプロパティ

これらのプロパティでは、タイムアウト値と、処理をトリガーするイベント数のしきい値を設定します。

8.1.7.1 monitor.cm.event.timeout

monitor.cm.event.timeoutでは、Oracle GoldenGate Monitorサーバーに登録された新規エージェントに対する問合せ間で、ソリューションの検出プロセスが待機する時間をミリ秒単位で指定します。新しいエージェントが検出されると、ソリューションの検出プロセスが開始されます。この値は2000ミリ秒に初期設定されています。

構文

monitor.cm.event.timeout=milliseconds

8.1.7.2 monitor.cm.event.max.size

monitor.cm.event.max.sizeでは、残りのイベントの処理までmonitor.cm.event.timeoutで指定されている秒数の間待機しないように、ソリューション検出プロセスをトリガーするイベント数のしきい値を指定します。この値は1000イベントに初期設定されています。

構文

monitor.cm.event.max.size=number_events

8.1.7.3 monitor.events.dispatcher.threads_size

monitor.events.dispatcher.threads_sizeでは、イベント・ディスパッチャ・プロセスによって使用されるスレッドの数を指定します。この値は30に初期設定されています。

構文

monitor.events.dispatcher.threads_size=number

8.2 エージェントのプロパティ

Config.propertiesファイルでは、Oracle GoldenGate MonitorサーバーまたはOracle Enterprise Manager (Oracle GoldenGateリリース11.2.1以降)と通信できるようにOracle GoldenGateエージェントが構成されます。これには、Oracle GoldenGateコア・インストールで提供される事前設定済プロパティが含まれています。ホスト・サーバー名、ポート、ユーザーなどの値を、使用しているシステムに有効な値にリセットする必要があります。

一部のプロパティには、プロパティ・ファイルにプロパティの値が定義されていない場合に使用されるデフォルト値が含まれています。デフォルト値は無効なエントリには置き換えられません。デフォルト値が使用される場合、メッセージがjagent.logおよびggserr.logに書き込まれます。

注意:

プロパティ値を変更したら、エージェントを再起動してアクティブ化する必要があります。

8.2.1 エージェントの定義

Oracle GoldenGateインスタンスの監視に使用するエージェントのタイプを設定する必要があります。

8.2.1.1 agent.type.enabled

agent.type.enabledでは、監視をOracle GoldenGate MonitorとOracle Enterprise Managerのどちらで行うかを指定します。

Oracle GoldenGateエージェントは、構成可能な間隔でManagerをポーリングして、監視ポイント・データを収集します

- agent.type.enabledをOGGMONに設定すると、Oracle GoldenGateエージェントはOracle GoldenGate Monitorサーバーにデータを送信します。

- agent.type.enabledをOEMに設定すると、Oracle GoldenGateエージェントは、Oracle Enterprise ManagerエージェントまたはODIによってポーリングされたときに監視ポイント・データを提供します。

この設定は、Oracle Data Integratorとの統合時にも必要です。GoldenGate MonitorとOracle Data Integratorを同時に使用している場合は、2つのエージェントを設定する必要があります(1つはagent.type.enabledをOracle GoldenGate Monitorに設定し、もう1つはOEMに設定)。

agent.type.enabledがOEMに設定されている場合、Oracle Enterprise ManagerエージェントはRemote Method Invocation (RMI)コネクタ経由でOracle GoldenGateエージェントに接続するため、jagent.rmi.portと入力する必要があります。

注意:

このプロパティは、Oracle GoldenGateのリリース11.2.1以降で有効です。

構文

agent.type.enabled={OGGMON | OEM}

8.2.1.2 jagent.rmi.port

jagent.rmi.portでは、RMIコネクタのポート番号を指定します。これは、Oracle GoldenGateエージェントに接続している場合に、Enterprise Managerエージェントによって使用されます。

このプロパティはagent.type.enabledがOEMに設定されている場合に必要です。

注意:

このプロパティは、Oracle GoldenGateのリリース11.2.1以降で有効です。

デフォルト

5559

構文

agent.rmi.port=port_number

8.2.2 通信

通信でSecure Sockets Layer (SSL)を使用するかどうかを選択する必要があります。SSLを使用する場合は、鍵および資格証明の記憶域を指定する必要があります。

注意:

IBM z/OS上で実行されているOracle GoldenGateエージェントは、SSLのみを使用できます。また、GoldenGate Monitorサーバーと通信しているすべてのエージェントは同じ接続プロトコルを使用する必要があります。

8.2.2.1 jagent.ssl

jagent.sslでは、エージェントからの通信でSSLを使用するかどうかを指定します。

注意:

jagent.backward.compatilityプロパティがtrueに設定されている場合、Oracle GoldenGate Monitorは、SSLが有効でないと判断し、jagent.sslの設定を無視します。

注意:

Oracle GoldenGate Monitorサーバーと通信するすべてのエージェントのjagent.ssl設定は、monitor.propertiesファイルのmonitor.sslプロパティのサーバーの設定と一致する必要があります。

デフォルト

false

構文

jagent.ssl=[true | false]

8.2.2.2 jagent.keystore.file

jgent.keystore.fileでは、SSL認証に使用される鍵のペアと証明書を格納するファイルを指定します。

デフォルト

jagentKeyStore

構文

jagent.keystore.file=keystore_filename

8.2.2.3 jagent.truststore.file

jagent.truststore.fileでは、クライアントまたはサーバーのIDを確認する、信頼できる認証局(CA)の証明書を格納します。

デフォルト

jagentKeyStore

構文

jagent.truststore.file=truststore_filename

8.2.3 ターゲットの監視

Oracle GoldenGate Managerおよびエージェントが常駐するコンピュータの名前とポートを指定する必要があります。下位互換性を設定し、エージェント資格証明を定義する必要もあります。

8.2.3.1 jagent.host

jagent.hostでは、Oracle GoldenGateエージェントが実行されているコンピュータのホスト名を指定します。これは、監視対象のOracle GoldenGateインスタンスのホスト名で、Oracle GoldenGate Monitorインスタンスに接続するリモートGoldenGate Extractプロセスによって、RMTHOSTパラメータで使用されるのと同じ名前にする必要があります。これにより、ソリューション検出が適切に動作します。

このプロパティは必須です。有効値が入力されていないと、起動中にManagerがエラーをggserr.logに書き込み、エージェントが正常に初期化されません。

構文

jagent.host=ogg_host_name

注意:

RMTTRAILを使用して、Extractパラメータ・ファイルでリモート証跡が指定されている場合、RMTHOSTパラメータに指定したホスト名は、Java jagent.hostエントリに設定されている値に一致する必要があります。Oracle GoldenGateエージェントを実行するローカルのOracle GoldenGate MonitorインスタンスにリモートExtractを接続している場合、パラメータ・ファイルに指定した完全修飾のホスト名は、jagent.hostに使用される完全修飾名と同じにする必要があります。

8.2.3.2 jagent.jmx.port

jagent.jmx.portでは、エージェントのJMXポートを指定します。

デフォルト

5555

構文

jagent.jmx.port=port_number

8.2.3.3 mgr.host

mgr.hostでは、Oracle GoldenGate Managerが実行されているコンピュータの名前またはIPアドレスを指定します。mgr.hostおよびmgr.portは、ともにOracle GoldenGateエージェントにOracle GoldenGateインスタンスを指定します。

このプロパティが入力されていないと、エージェントがOracle GoldenGateインスタンスに対してローカルであると判断され、デフォルトで値が決定されます。

注意:

エージェントはOracle GoldenGateインスタンスに対してローカルである必要があるため、このプロパティは11.2.1以前のリリースには使用されません。

構文

mgr.host=ogg_host_name

8.2.3.4 mgr.port

mgr.portでは、Oracle GoldenGate Managerのポートを指定します。このプロパティが入力されていないと、エージェントがOracle GoldenGateインスタンスに対してローカルであると判断され、デフォルトで値が決定されます。

注意:

エージェントはOracle GoldenGateインスタンスに対してローカルである必要があるため、このプロパティは11.2.1以前のリリースには使用されません。

構文

mgr.port=manager_port

8.2.3.5 monitor.host

monitor.hostでは、Oracle GoldenGate Monitorサーバー・インストールのホスト・コンピュータ名を指定します。完全修飾のホスト名を使用します。これは、monitor.propertiesファイルのmonitor.jmx.server.hostのエントリに一致する必要があります。

このプロパティは必須です。有効値が入力されていないと、起動中にManagerがエラーをggserr.logに書き込み、エージェントが正常に初期化されません。

構文

monitor.host=monitor_host_name

8.2.3.6 monitor.jmx.port

monitor.jmx.portでは、Oracle GoldenGate Monitorサーバー・インストールのJMXポートを指定します。これは、Oracle GoldenGate Monitorサーバーのインストール中に、「JMX Server Configuration」画面でポートに入力した値に初期設定されます。

デフォルト

5502

構文

monitor.jmx.port=port_number

8.2.3.7 monitor.jmx.username

monitor.jmx.usernameでは、Oracle GoldenGate MonitorサーバーのJMX接続のユーザー名を指定します。これは、Oracle GoldenGate Monitorのインストール中に、「JMX Server Configuration」画面でユーザー名に入力した値に初期設定されます。

このプロパティは必須です。有効値が入力されていないと、起動中にManagerがエラーをggserr.logに書き込み、エージェントが正常に初期化されません。

構文

monitor.jmx.username=user_name

8.2.3.8 jagent.username

jagent.usernameでは、Oracle GoldenGateエージェントへのJMX接続のエージェント・ユーザー名を指定します。エージェントが登録されると、この名前はOracle GoldenGate Monitorサーバーに渡されます。

このプロパティは必須です。有効値が入力されていないと、起動中にManagerがエラーをggserr.logに書き込み、エージェントが正常に初期化されません。

構文

jagent.username=user_name

8.2.3.9 jagent.backward.compatibility

jagent.backward.compatibilityをtrueに設定し、Oracle GoldenGate 11.1.1.1.1インスタンスの監視を可能にする下位互換性を有効にします。この値はfalseに初期設定されています。

注意:

このプロパティは、agent.type.enabled=OGGMONの場合にのみ適用されます。agent.type.enabled=OEMの場合は無視されます。

jagent.backward.compatibilityは、IBM z/OSを除く、サポートされているすべてのプラットフォームで有効です。

jagent.backward.compatibilityがtrueに設定されている場合、Oracle GoldenGate Monitorは、SSLが有効でないと判断し、jagent.sslが無視されます。

構文

jagent.backward.compatibility={true | false}

8.2.4 ポーリングのプロパティ

ポーリング間隔を設定できます。何も入力されない場合、これらのポーリング間隔プロパティは、指定されたデフォルトの秒数に設定されます。入力された秒数が負の値または2147483647よりも大きい場合には、エラー・メッセージが生成されます。

8.2.4.1 interval.regular

interval.regularでは、Regular Default Polling Groupに、監視ポイントに使用するポーリング間隔を指定します。値は秒単位です。

デフォルト

60秒

構文

interval.regular=seconds

8.2.4.2 interval.quick

interval.quickでは、Quick Default Polling Groupに、監視ポイントに使用するポーリング間隔を指定します。値は秒単位です。

デフォルト

30秒

構文

interval.quick=seconds

8.2.4.3 reg.retry.interval

reg.retry.intervalでは、例外が発生した場合に、最初のエージェント登録が再試行されるまで待機する間隔を指定

デフォルト

60秒

構文

reg.retry.interval=seconds

8.2.4.4 instance.query.initial.interval

instance.query.initial.intervalでは、Managerのみが実行中のプロセスである場合、Jagentが登録されるまで待機する間隔を指定します。この間隔の後でも他のプロセスが存在しない場合、エージェントにより登録が処理されます。

デフォルト

15秒

構文

instance.query.initial.interval=seconds

8.2.4.5 incremental.registration.quiet.interval

incremental.registration.quiet.intervalでは、エージェントが新しいプロセスの登録まで待機する間隔を指定します。

デフォルト

5秒

構文

incremental.registration.quiet.interval=seconds

8.2.4.6 maximum.message.retrieval

maximum.message.retrievalでは、Oracle GoldenGateエージェントが開始されるときに、コアのOracle GoldenGateインスタンスから取得される最大メッセージ数を指定します。

デフォルト

500メッセージ

構文

maximum.message.retrieval=number

8.2.4.7 message.polling.interval

message.polling.intervalでは、エージェントが新規メッセージのggserr.logをポーリングする間隔を設定します。

デフォルト

5秒

構文

message.polling.interval=seconds

8.2.4.8 status.polling.interval

status.polling.intervalでは、エージェントが新規および既存のプロセスのステータスをポーリングする間隔を設定します。

デフォルト

5秒

構文

status.polling.interval=seconds

8.2.4.8.1 Monitorサーバーのプロパティ

monitor.propertiesファイルには、Oracle GoldenGate Monitorの処理に関する特性が記述されます。これには、JMXサーバーとの関係、使用されるアラート通知のタイプ、および接続の試行のタイミングを定義するプロパティが含まれます。これらのプロパティ値の多くは、ユーザーの入力内容に基づいてインストール中に初期設定されます。

索引
A  C  D  E  H  I  J  M  N  O  P  Q  R  S  T  U

A

エージェント

Oracle Enterprise Manager, 8.2.1.1

Oracle GoldenGate Monitorサーバー, 8.2.1.1

開始, 7.2.7

停止, 7.2.9

エージェントのプロパティ

エージェントのホストおよびポート, 8.2.3

Config.propertiesファイル, 8.2

ポーリング, 8.2.4

alertMappings

テンプレート値の追加, 4.3.1.1

alertMessage値, 4.3.1.1 alertName値, 4.3.1.1 alertObjectName値, 4.3.1.1 アラート

コマンドライン・インタフェース, 4.3

定義, 4.1

無効化, 4.5

電子メール, 4.2

Simple Mail Transfer Protocol (SMTP), 4.2

Simple Network Management Protocol (SNMP), 4.4

ユーザーに対する指定, 4.1

alertSeverity値, 4.3.1.1 alertTime値, 4.3.1.1 アラート定義値の追加, 4.3.1.1 アーキテクチャ

Oracle GoldenGate Monitor, 1.2

argText

CLIアラート引数, 4.3.1.1

C

changedValue, 4.3.1.1

変更

エージェントのパスワード, 3.3

エージェントのサーバー・パスワード, 3.3

CLIアラート, 4.3.1.1

ディレクトリ値への追加, 4.3.1.1

引数, 4.3.1.1

値の関連付け, 4.3.1.1

コマンドの作成, 4.3.1.1

datetimeformat引数, 4.3.1.1

無効化, 4.5

有効化, 4.3, 8.1.4.8

レポート

アラート・メッセージ, 4.3.1.1

アラート名, 4.3.1.1

ホスト, 4.3.1.1

オブジェクト名, 4.3.1.1

重大度, 4.3.1.1

アラートがトリガーされた時刻, 4.3.1.1

値のトリガー, 4.3.1.1

名前の指定, 4.3.1.1 引用符の指定, 4.3.1.1 コマンドライン・インタフェース

概要, 4.3

アラート

「CLIアラート」を参照

CommandLineHandlers.xmlファイル

構成, 4.3.1

ヘッダー, 4.3.1.1

サンプル, 4.3.1

管理者による設定, 4.3.1

アラート・ヘッダーの指定, 4.3.1.1

コマンド作成のためのタグ, 4.3.1.1

xsd定義, 4.3.1

CommandLineHandlers.xsdファイル

概要, 4.3.1

xmlの定義, 4.3.1

完全なソリューション, 1.3.1 Config.propertiesファイル, 8.2 接続

間隔の指定, 8.2.4.1

最大試行回数の指定, 8.1.5.4

再接続の待機の指定, 8.1.5.6, 8.2.4.3

間隔の指定, 8.1.5.5

CREATE DATASTORE

GGSCIコマンド, 7.2.1

D

データ記憶域

作成, 7.2.1

データの修復, 7.2.5

データベース

概要, 1.2.4

ユーザー名の指定, 8.1.6.1

datetimeformat引数

CLIアラート, 4.3.1.1

アラートの無効化, 4.5

E

電子メール・アラート

構成, 4.2.1

無効化, 4.5

有効化, 4.2, 8.1.4.6

送信者名プロパティ, 8.1.4.1

電子メール・サーバー名の指定, 8.1.4.2

セキュア・モードの指定, 8.1.4.4

送信ポートの指定, 8.1.4.3

セキュア・モードでのユーザーの指定, 8.1.4.5

ENABLEMONITORAGENTパラメータ, 7.1.1 ENABLEMONITORING

パラメータ, 7.1.2

有効化, 7.1.2 executeIn引数, 4.3.1.1 externalCommand

CLIアラート, 4.3.1.1

使用, 4.3.1.1

H

ホスト名

エージェント, 8.2.3.1

Manager, 8.2.3.3

Monitorサーバー, 8.2.3.5

アラートのホスト値, 4.3.1.1

I

incremental.registration.quiet.intervalプロパティ, 8.2.4.5

INFO JAGENT

GGSCIコマンド, 7.2.6

instance.query.initial.intervalプロパティ, 8.2.4.4 interval.quickプロパティ, 8.2.4.2 interval.regularプロパティ, 8.2.4.1

J

jagent

情報の表示, 7.2.6

jagent.host

プロパティ, 8.2.3.1

jagent.jmx.portプロパティ, 8.2.3.2 jagent.rmi.port

プロパティ, 8.2.1.2

jagent.type.enabled

プロパティ, 8.2.1.1

jagent.usernameプロパティ, 8.2.3.8 JMXサーバー

有効化および無効化, 8.1.2.1

ポートの指定, 8.1.2.3

ユーザー名の指定, 8.1.2.4

JMXMapping.xmlファイル

変更, 4.4.2

M

管理情報ベース(MIB), 4.4.1

最大メッセージ数, 8.2.4.6

maximum.message.retrievalプロパティ, 8.2.4.6

message.polling.intervalプロパティ, 8.2.4.7

メッセージ

間隔の設定, 8.2.4.7

最大数の設定, 8.2.4.6

mgr.hostプロパティ, 8.2.3.3 mgr.portプロパティ, 8.2.3.4 MIB定義, 4.4.1 モニター

プロパティ・ファイル

アラート通知のプロパティ, 8.1.4

接続のプロパティ, 8.1.5

構成管理のプロパティ, 8.1.7

JMXサーバーのプロパティ, 8.1.2

リポジトリのプロパティ, 8.1.6

制限付きプロパティ, 8.1.1

monitor.cli.alerts.enabledプロパティ, 8.1.4.8 monitor.cm.event.max.sizeプロパティ, 8.1.7.2 monitor.cm.event.timeoutプロパティ, 8.1.7.1 monitor.default_agent_connection.intervalプロパティ, 8.1.5.5 monitor.default_agent_connection.max_attemptsプロパティ, 8.1.5.4 monitor.default_agent_connection.reconnect_intervalプロパティ, 8.1.5.6 monitor.events.dispatcher.threads_sizeプロパティ, 8.1.7.3 monitor.host

プロパティ, 8.2.3.5

監視, 7.1.2

有効化, 7.1.1

タイプの設定, 8.2.1.1

データの監視

修復, 7.2.5

格納, 7.2.1

monitor.jmx.portプロパティ, 8.2.3.6 monitor.jmx.server.enabledプロパティ, 8.1.2.1 monitor.jmx.server.hostプロパティ, 8.1.2.2 monitor.jmx.server.portプロパティ, 8.1.2.3 monitor.jmx.server.userプロパティ, 8.1.2.4 monitor.jmx.usernameプロパティ, 8.2.3.7 monitor.jpa.connection.userプロパティ, 8.1.6.1 monitor.propertiesファイル, 8.2.4.8.1 monitor.smtp.alerts.enabledプロパティ, 4.2.1, 8.1.4.6 monitor.smtp.fromプロパティ, 4.2.1, 8.1.4.1 monitor.smtp.hostプロパティ, 4.2.1, 8.1.4.2 monitor.smtp.portプロパティ, 4.2.1, 8.1.4.3 monitor.smtp.secureプロパティ, 4.2.1, 8.1.4.4 monitor.smtp.userプロパティ, 4.2.1, 8.1.4.5 monitor.snmp.alerts.enabledプロパティ, 8.1.4.7

N

名前

CLIアラート引数, 4.3.1.1

O

Oracle Enterprise Manager

監視のオプション, 1.1

Oracle GoldenGate

概要, 1.2.1

Oracle GoldenGateエージェント

概要, 1.2.2

Oracle GoldenGate Monitor

アーキテクチャ, 1.2

ソリューションの検出, 1.3.1

複数ユーザー・インタフェース・セッション, 2.2.1

ホスト・コンピュータの指定, 8.1.2.2

Oracle GoldenGate Monitorエージェント

パスワードの変更, 3.3

サーバー・パスワードの変更, 3.3

Oracle GoldenGate Monitorデータベース

概要, 1.2.4

Oracle GoldenGate Monitorサーバー

概要, 1.2.3

監視のオプション, 1.1

プロパティ・ファイル, 8.2.4.8.1

P

部分的なソリューション, 1.3.2

ポーリング間隔

簡易, 8.2.4.2

標準, 8.2.4.1

ポート

JMXサーバー, 8.2.3.6

presentIfEmpty

altertMappings, 4.3.1.1

CLIアラート引数, 4.3.1.1

Q

引用

CLIアラート引数, 4.3.1.1

R

登録

最初の待機間隔, 8.2.4.5

再試行間隔, 8.2.4.3

待機間隔, 8.2.4.4

reg.retry.intervalプロパティ, 8.2.4.3 REPAIR DATASTORE

GGSCIコマンド, 7.2.5

S

設定

エージェント, 8.2.4.6, 8.2.4.7, 8.2.4.8

Oracle Enterprise Manager, 8.2.1.2

ホスト, 8.2.3.1

ポーリング間隔, 8.2.4.1

ポート, 8.2.3.2

登録間隔, 8.2.4.4

再試行間隔, 8.2.4.3

ユーザー名, 8.2.3.8

Manager

ホスト, 8.2.3.3

ポート, 8.2.3.4

サーバー

ホスト, 8.1.2.2, 8.2.3.5

JMXポート, 8.2.3.6

JMXユーザー名, 8.2.3.7

ポート, 8.1.2.3

ユーザー名, 8.1.2.4

SMTPアラート

構成, 4.2.1

無効化, 4.5

有効化, 4.2, 8.1.4.6

送信者名プロパティ, 8.1.4.1

電子メール・サーバー名の指定, 8.1.4.2

セキュア・モードの指定, 8.1.4.4

送信ポートの指定, 8.1.4.3

セキュア・モードでのユーザーの指定, 8.1.4.5

SNMP

バージョンの変更, 4.4.2.1

ターゲットの設定, 4.4.2.2

SNMPアラート

構成, 4.4.2

無効化, 4.5

有効化, 4.4, 8.1.4.7

ソリューション検出

データベース比較手法, 1.3.3

タイムアウトをオーバーライドするためのイベントの数の指定, 8.1.7.2

問合せ間の待機時間の指定, 8.1.7.1

ソリューション

完全, 1.3.1

検出, 1.3.1

部分的, 1.3.2

リテラル・テキストの指定, 4.3.1.1 START JAGENT

GGSCIコマンド, 7.2.7

ステータス・ポーリング間隔, 8.2.4.8 status.polling.intervalプロパティ, 8.2.4.8 STOP JAGENT

GGSCIコマンド, 7.2.9

T

スレッド

指定, 8.1.7.3

U

updateAgentJMXパスワード変更オプション, 3.3

updateServerJMXパスワード変更オプション, 3.3

ユーザー・インタフェース

複数のセッションの実行, 2.2.1

ユーザー名

エージェント, 8.2.3.8

JMXサーバー, 8.2.3.7

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2015, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。