Oracle® GoldenGate

Oracle GoldenGate Monitorの管理

12c (12.2.1)

E70096-01(原本部品番号:E60968-01)

2015年10月

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

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

E70096-01

Copyright © 2011, 2015, Oracle and/or its affiliatesAll rights reserved.

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

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

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

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 Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

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

はじめに

- 対象読者

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

- 関連ドキュメント

- 表記規則

1 Oracle GoldenGate監視の概要

- 1.1 概要

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

- 1.2.1 Oracle GoldenGate

- 1.2.2 Oracle GoldenGate Monitor Javaエージェント

- 1.2.3 Oracle GoldenGate Monitorサーバー

- 1.2.4 Oracle GoldenGate Monitorリポジトリ

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

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

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

- 1.3.3 データベースの検出

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 Javaエージェントの使用

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

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

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

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

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

- 4.1 概要

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

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

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

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

- 5.1 パラメータ

- 5.1.1 ENABLEMONITORAGENT

- 5.1.2 ENABLEMONITORING

- 5.1.3 AUTOSTART JAGENT

- 5.2 GGSCIコマンド

- 5.2.1 CREATE DATASTORE

- 5.2.2 ALTER DATASTORE

- 5.2.3 DELETE DATASTORE

- 5.2.4 INFO DATASTORE

- 5.2.5 REPAIR DATASTORE

- 5.2.6 INFO JAGENT

- 5.2.7 START JAGENT

- 5.2.8 INFO JAGENT

- 5.2.9 STOP JAGENT

6 プロパティ

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

- 6.1.1 制限付きプロパティ

- 6.1.2 SSO Webパラメータ

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

- 6.1.4 通信

- 6.1.5 接続のプロパティ

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

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

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

- 6.2.1 エージェントの定義

- 6.2.2 通信

- 6.2.3 ターゲットの監視

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

はじめに

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

対象読者

このドキュメントは、Oracle GoldenGate Monitorを構成および実行するシステム管理者またはアプリケーション開発者を対象としています。Web技術とJava技術に精通しており、Linux、UNIXおよびWindowsプラットフォームに関する全般的な理解があることを前提としています。また、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]のように、パイプ記号で区切ります。

1 Oracle GoldenGate監視の概要

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

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

- 1.1項「概要」

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

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

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.2.1)をサポートしています。
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 Monitor Javaエージェントと関連付けられています。

1.2.2 Oracle GoldenGate Monitor Javaエージェント

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

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

1.2.3 Oracle GoldenGate Monitorサーバー

Oracle GoldenGate Monitorサーバーは、複数のOracle GoldenGateインスタンスの監視を調整します。Oracle GoldenGate Monitorサーバーは、1) Oracle GoldenGate Monitor Javaエージェントからの情報を処理して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によって登録されている場合、同じホスト上にある同じデータベース・インスタンスは、別のデータベースとして分類されます。

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またはUNIXの場合:

$ ./stopManagedWebLogic.sh

Windowsの場合:

C:\ 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 GoldenGate Monitorのユーザー・インタフェースの複数のセッションを実行できます。Internet ExplorerとMozilla Firefoxのセッションを1つずつ同時に実行することもできますが、Mozilla Firefoxの複数のセッションを同じコンピュータ上で実行することはできません。

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

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

2.3.1 パスワードの変更

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

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

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

$ 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の量は、監視可能なOracle GoldenGateインスタンスおよびプロセスの数に影響します。

注意:
メモリー要件の設定の詳細は、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 Javaエージェントの使用

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

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

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

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

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

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

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

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

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

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

GGSCI>START JAGENT

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

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

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

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

Oracle GoldenGate Monitor Javaエージェントのパスワードを更新する手順:

1. インストール・ディレクトリに移動します。
LinuxまたはUNIXの場合:

$ cd ./installation_directory/

Windowsの場合:

C:\ cd installation_directory

2. 適切なランタイム引数を使用して、適切なpw_agent_utilユーティリティを実行します。

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

LinuxまたはUNIXの場合:

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

Windowsの場合:

C:\ pw_agent_util.bat -[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オプションを付けて最初に実行する必要がある(これにより、ユーティリティが停止します)旨のメッセージがユーティリティによって返されます。ウォレットを作成するには、次のコマンド(この手順で説明している同じオプションを使用)を使用します。

LinuxまたはUNIXの場合:

$ ./pw_agent_util.sh -create | -jagentonly

Windowsの場合:

C:\ pw_agent_util.bat -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 Monitor Javaエージェントを一度停止してから再び開始します。

GGSCI> STOP JAGENT
GGSCI> START JAGENT

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

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

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

2. 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 インスタンス・レベル・セキュリティについて

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

- 4.1項「概要」

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

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

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

4.1 概要

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

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

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

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

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

- 管理者およびオペレータ/パワー・オペレータは、共有インスタンス・アクセスを持つことができます(複数のユーザーがインスタンス・プールから共通の/同じインスタンスにアクセスできます(例: 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 Monitor Javaエージェント・インスタンス: {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に割当て

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

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

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

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

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

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

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

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

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

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

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

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

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

管理者としてログイン

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

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

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

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

注意:
ユーザーは、そのユーザーがアクセスできないインスタンス・オブジェクトのアラートを作成できます。

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

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

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

- 5.1項「パラメータ」

- 5.2項「GGSCIコマンド」

5.1 パラメータ

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

5.1.1 ENABLEMONITORAGENT

適用対象

GLOBALS

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

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

構文

ENABLEMONITORAGENT

5.1.2 ENABLEMONITORING

適用対象

GLOBALS

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

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

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

構文

ENABLEMONITORING

5.1.3 AUTOSTART JAGENT

適用対象

Manager

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

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

構文

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

例

AUTOSTART JAGENT

5.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以降で有効です。

5.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

5.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

5.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 !

5.2.4 INFO DATASTORE

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

構文

INFO DATASTORE

5.2.5 REPAIR DATASTORE

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

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

構文

REPAIR DATASTORE

5.2.6 INFO JAGENT

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

構文

INFO JAGENT

例

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

INFO JAGENT

JAgent is DOWN!

5.2.7 START JAGENT

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

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

構文

START JAGENT

例

START JAGENT

GGCMD JAGENT started.

5.2.8 INFO JAGENT

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

構文

STATUS JAGENT

例

STATUS JAGENT

JAgent is running

5.2.9 STOP JAGENT

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

構文

STOP JAGENT [!]

説明:

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

6 プロパティ

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

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

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

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

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

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

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

6.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

6.1.2 SSO Webパラメータ

SSO WebパラメータではSSO (シングル・サインオン)ログアウトURLを指定します。Oracle GoldenGate MonitorにSSO環境でアクセスする場合は、monitor.ssoLogOutUrlを使用してアプリケーションのログアウトURLを設定します。OAM (Oracle Access Manager)の後続のバージョンでログアウトURLの形式が変更された場合は、このプロパティを適切に変更する必要があります。ただし、その場合にサーバーの再起動は必要ありません。

構文は次のとおりです。

monitor.ssoLogOutUrl=/oamsso/logout.html?end_url=/monitor

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

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

6.1.3.1 monitor.jmx.server.enabled

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

デフォルト

true

構文

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

6.1.3.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

6.1.3.3 monitor.jmx.server.port

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

構文

monitor.jmx.server.port=port_number

6.1.3.4 monitor.jmx.server.user

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

構文

monitor.jmx.server.user=user_name

6.1.4 通信

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

6.1.4.1 monitor.ssl

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

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

デフォルト

false

構文

monitor.ssl=[true | false]

6.1.4.2 monitor.keystore.file

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

デフォルト

monitorKeyStore

構文

monitor.keystore.file=keystore_filename

6.1.4.3 monitor.truststore.file

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

デフォルト

jagentKeyStore

構文

monitor.truststore.file=truststore_filename

6.1.4.4 jagent.restful.ws.timeout

jagent.restful.ws.timeoutでは、Jagent RESTful Webサービスのタイムアウトをミリ秒単位で設定します。

デフォルト

15000

構文

jagent.restful.ws.timeout=number

6.1.4.5 jagent.ggsci.timeout

jagent.ggsci.timeoutでは、Jagent GGSCIのタイムアウトを秒単位で設定します。

デフォルト

30

構文

jagent.ggsci.timeout=number

6.1.5 接続のプロパティ

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

6.1.5.1 monitor.db.connection.initial_size

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

構文

monitor.db.connection.initial_size=5

6.1.5.2 monitor.db.connection.max_active

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

構文

monitor.db.connection.max_active=50

6.1.5.3 monitor.db.connection.max_idle

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

構文

monitor.db.connection.max_idle=5

6.1.5.4 monitor.default_agent_connection.max_attempts

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

構文

monitor.default_agent_connection.max_attempts=number

6.1.5.5 monitor.default_agent_connection.interval

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

構文

monitor.default_agent_connection.interval=seconds

6.1.5.6 monitor.default_agent_connection.reconnect_interval

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

構文

monitor.default_agent_connection.reconnect_interval=seconds

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

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

6.1.6.1 monitor.jpa.connection.user

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

構文

monitor.jpa.connection.user=user_name

6.1.7 構成管理のプロパティ

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

6.1.7.1 monitor.cm.event.timeout

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

構文

monitor.cm.event.timeout=milliseconds

6.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

6.1.7.3 monitor.events.dispatcher.threads_size

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

構文

monitor.events.dispatcher.threads_size=number

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

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

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

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

6.2.1 エージェントの定義

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

6.2.1.1 agent.type.enabled

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

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

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

- agent.type.enabledをOEMに設定すると、Oracle GoldenGate Monitor Javaエージェントは、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 Monitor Javaエージェントに接続するため、jagent.rmi.portと入力する必要があります。

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

構文

agent.type.enabled={OGGMON | OEM}

6.2.1.2 jagent.rmi.port

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

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

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

デフォルト

5559

構文

agent.rmi.port=port_number

6.2.2 通信

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

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

6.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]

6.2.2.2 jagent.keystore.file

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

デフォルト

jagentKeyStore

構文

jagent.keystore.file=keystore_filename

6.2.2.3 jagent.truststore.file

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

デフォルト

jagentKeyStore

構文

jagent.truststore.file=truststore_filename

6.2.3 ターゲットの監視

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

6.2.3.1 jagent.host

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

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

構文

jagent.host=ogg_host_name

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

6.2.3.2 jagent.jmx.port

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

デフォルト

5555

構文

jagent.jmx.port=port_number

6.2.3.3 mgr.host

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

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

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

構文

mgr.host=ogg_host_name

6.2.3.4 mgr.port

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

このプロパティを変更するときは必ずjagent.jmx.portプロパティも変更してMonitorサーバーに登録し、正確な結果が表示されるようにする必要があります。

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

構文

mgr.port=manager_port

6.2.3.5 monitor.host

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

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

構文

monitor.host=monitor_host_name

6.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

6.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

6.2.3.8 jagent.username

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

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

構文

jagent.username=user_name

6.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}

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

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

6.2.4.1 interval.regular

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

デフォルト

60秒

構文

interval.regular=seconds

6.2.4.2 interval.quick

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

デフォルト

30秒

構文

interval.quick=seconds

6.2.4.3 reg.retry.interval

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

デフォルト

60秒

構文

reg.retry.interval=seconds

6.2.4.4 instance.query.initial.interval

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

デフォルト

15秒

構文

instance.query.initial.interval=seconds

6.2.4.5 incremental.registration.quiet.interval

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

デフォルト

5秒

構文

incremental.registration.quiet.interval=seconds

6.2.4.6 maximum.message.retrieval

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

デフォルト

500メッセージ

構文

maximum.message.retrieval=number

6.2.4.7 message.polling.interval

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

デフォルト

5秒

構文

message.polling.interval=seconds

6.2.4.8 status.polling.interval

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

デフォルト

5秒

構文

status.polling.interval=seconds

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

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

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

コピーライトについて

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

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

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

保証免責

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

制限付権利について

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

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)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

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

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

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

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

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

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

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

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

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のベータ・トライアル契約のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle PartnerNetwork Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

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

オラクルのアクセシビリティについての詳細情報は、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を参照してください。