Oracle Enterprise Manager Oracle GoldenGate System Monitoring Plug-Inインストレーション・ガイド

リリース12.1.0.1.1

B69446-02(原本部品番号:E27804-04)

Oracle Enterprise Manager

Oracle GoldenGate System Monitoring Plug-Inインストレーション・ガイド

リリース12.1.0.1.1

B69446-02(原本部品番号:E27804-04)

2012年11月

このドキュメントでは、Oracle System Monitoring Plug-in for Oracle GoldenGateの簡単な説明、プラグインでサポートされるリリースの詳細、プラグインのインストールの前提条件、およびOracle GoldenGateをプラグイン用に構成する方法の詳細な手順を示します。

Oracle GoldenGateの説明と機能

System Monitoring Plug-in for Oracle GoldenGateは、Oracle Enterprise Manager Cloud Controlを拡張して、Oracle GoldenGateインスタンスの管理のサポートを追加します。このプラグインをCloud Control環境にデプロイすることで、次の管理機能を使用できるようになります。

- Oracle GoldenGateインスタンスの監視。

- 構成データの収集およびOracle GoldenGateインスタンスの構成変更の追跡。

- 監視ターゲットおよび構成データに設定されたしきい値に基づくアラートおよび違反の表示。

- リモート・エージェントによる監視のサポート。ローカル・エージェントは、Oracle GoldenGateインスタンスと同じホスト上で実行されるエージェントです。リモート・エージェントは、Oracle GoldenGateインスタンスが実行されているホストとは異なるホストで実行されるエージェントです。

サポートされるプラットフォーム

Oracle GoldenGateプラグインは、HP NonStop、IBM iSeriesおよびIBM z/OSを除き、Oracle GoldenGate 11.2インスタンスを実行できるすべてのプラットフォームの監視をサポートします。

サポートされるバージョン

Oracle GoldenGateプラグインでは、次の製品バージョンがサポートされます。

- Enterprise Manager Cloud Control 12c Bundle Patch 1 (12.1.0.1)以降

- Oracle GoldenGate 11gリリース2 (11.2.1.0.1)以降

前提条件

Oracle GoldenGateプラグインを使用する前に、次の前提条件を満たす必要があります。

JDKを指すように環境変数を設定

次の手順を実行して、使用環境で監視を行う準備ができていることを確認します。

注意:
次の指示に従って、Oracle GoldenGate 11.1.1のインスタンスを監視できるようLD_LIBRARY_PATHを設定した場合、11.2.1以降のインスタンスを監視する際には設定を削除する必要があります。

- Windowsの場合:

1. JAVA_HOME変数を、JDKがインストールされている場所に設定します。

2. PATH変数を、JDKがインストールされている場所の\jre\binに設定します。

. . .;%JAVA_HOME%\jre\bin

3. PATH変数を、jvm.dllの場所(JDKがインストールされている場所の\jre\bin\serverディレクトリ)に設定します。

. . .;%JAVA_HOME%\jre\bin\server

- Oracle SolarisまたはLinuxの場合、LD_LIBRARY_PATHをlibjvm.soファイルの場所に設定します。

注意:
64ビットのSolaris SPARCサーバーでは、LD_LIBRARY_PATH設定が64ビットのライブラリの場所を指していることを確認します。

$JAVA_HOME/jre/lib/sparcv9/server

- AIXの場合、LIBPATHを共有ライブラリppc64およびj9vmの場所に設定します。たとえば、JAVA_HOMEをJDKのインストール・ディレクトリに設定する場合は、次のようになります。

export LIBPATH
=$JAVA_HOME/jre/lib/ppc64:$JAVA_HOME/jre/lib/ppc64/j9vm:$LIBPATH

- HPUXの場合:

1. SHLIB_PATHをlibjvm.slの場所(HPUX PA-RISC)とlibjvm.so (HPUX Itanium)に設定します。

2. Oracle GoldenGate Managerを起動する前に、LD_PRELOADをlibjvm.sl (HPUX PA-RISC)とlibjvm.so (HPUX Itanium)に設定します。

注意:
LD_PRELOAD設定は、システム上で実行している他のアプリケーションに影響が及ばないように、GoldenGate Managerを起動した後、削除してください。

ソフトウェア要件

- 次のものをインストールおよび実行する必要があります。

- Oracle GoldenGate release 11.2.1.0.1以降

- Oracle Enterprise Manager Cloud Control 12c Bundle Patch 1 (12.1.0.1)以降(Oracle Management ServiceおよびOracle Management Agent)

- 監視するOracle GoldenGateインスタンスをホストしている各システムにOracle Management Agentをインストールする必要があります。

- Oracle GoldenGateがインストールされている各システムに、任意のリリースのJava 1.6 Java Development Kit (JDK)をインストールします。

- これは、Java Runtime Environment (JRE)ではなくJDKである必要があります。

- Windows x64プラットフォームの場合、x64版のJDKを使用する必要があります。そうしないと、Enterprise ManagerはJavaエージェントをロードできません。

JDKのバージョンを確認するには、Oracle GoldenGateインストール・ディレクトリに移動し、次のコマンドを実行します。

Shell> java -version

これによって1.6バージョンのJavaが返されない場合は、PATH環境変数にjava.exeとjavaが含まれていることを確認します。

- ソフトウェア・ライブラリを構成するには、『Oracle Enterprise Manager Cloud Control管理者ガイド』の「ソフトウェア・ライブラリの構成」を参照してください。

http://docs.oracle.com/cd/E24628_01/doc.121/e24473/softwarelib.htm#BABHFAIH

各Oracle GoldenGateインスタンスの構成

- 各Oracle GoldenGateインスタンスに対して、次の操作を行います。

- Oracle GoldenGateインストール・ディレクトリに移動し、GLOBALSパラメータ・ファイルを編集することで、監視を有効にします。

Shell> GGSCI
GGSCI> EDIT PARAMS ./GLOBALS

ENABLEMONITORINGパラメータをGLOBALSパラメータに追加し、ファイルを保存します。Oracle GoldenGateインスタンスの構成後にマネージャを起動すると、パラメータがアクティブになります。

- 「Oracle Walletの作成」の手順に従って、パスワードを保存するOracle Walletを作成します。

- 「Oracle Enterprise Managerで実行するためのOracle GoldenGateの構成」の手順に従って、Oracle Enterprise Managerによる監視用にOracle GoldenGateインスタンスを構成します。

- 「Oracle GoldenGateインスタンスの開始」の手順に従って、次の操作を行います。

- 監視データの格納に使用されるデータベースを作成します。

- Oracle Management Agentに渡す監視データを収集するOracle GoldenGate Agentを起動します。

Oracle Walletの作成

次の手順を実行して、Oracle Walletを作成し、Oracle Management AgentがOracle GoldenGate Agentに接続してメトリック値を受信するために使用するパスワードを追加します。

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

2. Javaエージェントのみ使用する(Oracle GoldenGate Monitor Serverは使用しない)ことを指定するランタイム引数を使用して、適切なpw_agent_utilスクリプトを実行します。

- Windowsでは、コマンド・ラインに移動し、次のように入力します。

Shell> pw_agent_util.bat -jagentonly

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

Shell>./pw_agent_util.sh -jagentonly

ウォレットが存在しない場合は、作成されます。

3. 次に、Oracle Enterprise Managerエージェント・パスワードの入力を求められます。

Please create a password for Java Agent:

次に、パスワードの確認を求められます。

Please confirm password for Java Agent:

ウォレットがdirwltディレクトリにすでに存在する場合は、メッセージが返され、ユーティリティが停止します。この状況が発生した場合は、次のいずれかを入力して、ユーティリティを実行してJagentパスワードを作成します。

- Windowsでは、コマンド・ラインに移動し、次のように入力します。

Shell> pw_agent_util.bat -updateAgentJMX

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

Shell> ./pw_agent_util.sh -updateAgentJMX

Oracle Enterprise Managerで実行するためのOracle GoldenGateの構成

Oracle Enterprise Managerで動作するようにOracle GoldenGateインスタンスを構成するには、ホスト、ポートおよび監視タイプのプロパティ値を設定します。

次の手順に従って、Oracle Enterprise Managerの監視を構成します。

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

2. \cfg\Config.propertiesファイルを編集します。

3. 監視タイプを決定するプロパティをOracle Enterprise Managerに設定します。

agent.type.enabled=OEM

4. Oracle Enterprise Managerエージェントの適切なRemote Method Invocation (RMI)ポートを設定します。デフォルト値は5559です。

jagent.rmi.port=[port_number]

5. Jagentのホストを識別するプロパティを設定します。これは、Oracle GoldenGateインスタンスのホストである必要があります。値には名前またはIPアドレスを指定できます。

jagent.host=[Oracle_GoldenGate_host_name]

6. Jagentのポートを設定します。このプロパティのデフォルト値は5555です。

jagent.jmx.port=[port_number]

7. Jagentへの接続のユーザー名を設定します。

jagent.username=[user_name]

Oracle GoldenGateインスタンスの開始

次の手順を使用して、Oracle GoldenGateとOracle GoldenGate Agentを起動します。この項で使用するGGSCIコマンドの詳細は、『Oracle GoldenGate Monitor管理者ガイド』を参照してください。

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

2. GGSCIセッションを開始します。

Shell> GGSCI

3. 監視を有効にしてから今回初めてOracle GoldenGateを起動する場合は、監視データを永続化するデータベースを作成します。

GGSCI> CREATE DATASTORE

4. GLOBALSパラメータを追加して監視を有効にしただけの場合は、実行中のOracle GoldenGate Managerプロセスを停止して再起動し、新しい設定をアクティブにする必要があります。

GGSCI> STOP MANAGER

5. Oracle GoldenGate Managerプロセスを開始します。

GGSCI> START MANAGER

6. Oracle GoldenGate Agentを起動します。

GGSCI> START JAGENT

注意:
エージェントを起動する前に、Oracle Walletが正常に作成され、パスワードが入力されている必要があります。

プラグインをデプロイするための管理エージェントの構成

次の手順に従って、Oracle GoldenGateプラグインをデプロイするすべてのエージェントで優先資格証明を設定します。

1. Enterprise Manager Cloud Controlで、「設定」、「セキュリティ」、「優先資格証明」の順にクリックします。

2. 「優先資格証明」ページで、「ホスト」ターゲット・タイプを選択して「優先資格証明の管理」をクリックします。

3. 「ホスト優先資格証明」ページの「ターゲットの資格証明」セクションで、プラグインをデプロイする必要のある管理エージェントを実行しているホストについて、ユーザー名とパスワードを指定します。

4. 資格証明を設定したら、同じページで「テスト」をクリックします。テストが正常に実行される場合は、資格証明が正しく設定されています。

5. プラグインのデプロイ先の管理エージェントに対してOSコマンド・ジョブを実行します。

- Enterprise Manager Cloud Controlにログインします。

- 「エンタープライズ」、「ジョブ」、「アクティビティ」の順にクリックします。

- 「ジョブ・アクティビティ」ページで「OSコマンド」を選択し、「実行」をクリックします。

- 次のページで必要な詳細を入力し、「発行」をクリックしてジョブを実行します。ジョブが正常に実行される場合は、資格証明が正しく設定されています。

プラグインのデプロイ

プラグインをデプロイする手順は、『Oracle Enterprise Manager Cloud Control管理者ガイド』の「プラグイン・マネージャ」を参照してください。

http://docs.oracle.com/cd/E24628_01/doc.121/e24473/plugin_mngr.htm

プラグイン・アーカイブの手動インポート

プラグインを手動でダウンロードした場合、Oracle Enterprise Manager Cloud Controlにプラグインをインポートする必要があります。

1. ダウンロード・ページからOracle GoldenGateプラグインをダウンロードします。

http://www.oracle.com/technetwork/middleware/goldengate/downloads/

プラグインは「Management Pack for Oracle GoldenGate」セクションにあります。

2. Enterprise Managerコマンドライン(EM CLI)ユーティリティを設定します。「設定」メニューの「コマンドライン・インタフェース」をクリックします。Enterprise Managerコマンドライン・インタフェースのダウンロード・ページに説明されている手順に従います。

3. プラグイン・アーカイブをインポートします。

emcli login -username=<your user ID> -password=<password>
emcli sync
emcli import_update -file=<path to *.opar file you downloaded>

4. プラグイン・アーカイブをインポートしたら、Enterprise Manager Cloud Controlにログインし、デプロイを完了します。

1. 「設定」(右上隅)、「拡張性」、「プラグイン」の順にクリックします。

2. 「プラグイン」ページで、「ミドルウェア」フォルダを展開します。

3. 「Oracle GoldenGate」を選択します。「デプロイ先」をクリックし、「Management Server」を選択してデプロイ・プロセスを開始します。

4. リポジトリSYSパスワードを入力して、「続行」をクリックします。
一連の前提条件システム・チェックが開始されます。各システム・チェックが完了するたびに、「次」をクリックして次のチェックに進みます。

5. 前提チェックが完了したら、「次」、「デプロイ」の順にクリックします。

注意:
通常、デプロイが完了するまで10分程度かかります。その間、接続ユーザーはすべてEnterprise Managerから切断されます。確認ページが表示されますが、プラグインのデプロイの進行中は「ステータスの表示」をクリックすると「このWebページは使用できません」と表示されます。

6. プラグインのデプロイのステータスを確認します。10分後、emcliコマンドを使用してステータスを確認できます。

emcli login -username=<your user ID> -password=<password>
emcli sync
emcli get_plugin_deployment_status -plugin_id=oracle.fmw.gg

プラグインがデプロイされると、Enterprise Manager Cloud Controlの「ターゲット」の下に「Oracle GoldenGate」項目が表示されます。

監視するインスタンスの追加

プラグインを正常にデプロイできたら、次の手順に従って、集中監視および管理のためにプラグイン・ターゲットをEnterprise Manager Cloud Controlに追加します。

1. 「設定」メニューから、「ターゲットの追加」、「自動検出の構成」の順に選択します。

2. GoldenGate Discoveryモジュールをクリックして、「ターゲット・タイプのターゲットの検出の構成」画面を表示します。

3. 「エージェント・ホスト名」をハイライト表示し、「パラメータの編集」をクリックして、Oracle GoldenGate Agentへの接続に必要な情報を入力します。

- JAgentユーザー名 - 接続に対して有効なユーザー名。この名前はconfig.propertiesファイルで指定します。

- JAgentパスワード - Oracle Walletの作成時に設定されたユーザーのパスワード。

- RMIポート - 接続に使用するRemote Method Invocationポート。

4. 「OK」をクリックします。

プラグインの検査および検証

プラグインの検査および検証を行う前に、自動検出中に見つかったGoldenGateターゲットを昇格する必要があります。『Oracle Enterprise Manager Cloud Control管理者ガイド』の検出されたターゲットの確認および昇格に関する項を参照してください。

http://docs.oracle.com/cd/E24628_01/doc.121/e24473/discovery.htm#CBAFHEHC

プラグインがデータの収集を開始するまで数分間待機したら、次の手順を実行して、プラグインがEnterprise Managerで適切に監視されているかどうかを確認および検証します。

1. 「すべてのターゲット」ページから、「Oracle GoldenGate」ターゲット・リンクをクリックします。Oracle GoldenGateのホーム・ページが表示されます。

2. 「ターゲット」メニューから「監視」、「メトリック収集エラー」の順にクリックして、メトリック収集エラーがレポートされていないことを確認します。

3. 「ターゲット」メニューの「情報パブリッシャ・レポート」をクリックし、Oracle GoldenGateターゲット・タイプのレポートを表示することで、レポートが表示され、エラーがレポートされないことを確認します。

4. 「ターゲット」メニューで「構成」、「最新収集」の順にクリックして、構成データが表示されていることを確認します。構成データがすぐに表示されない場合は、「最新の構成」ページで「リフレッシュ」をクリックします。

プラグインのアンデプロイ

プラグインをアンデプロイする手順は、『Oracle Enterprise Manager Cloud Control管理者ガイド』の「プラグイン・マネージャ」を参照してください。

http://docs.oracle.com/cd/E24628_01/doc.121/e24473/plugin_mngr.htm

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

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

Oracleサポートへのアクセス

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 System Monitoring Plug-Inインストレーション・ガイド リリース12.1.0.1.1

B69446-02

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

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

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

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

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はOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

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

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