1. Oracle GoldenGate Monitor Agentのインストールおよび構成
  2. Oracle GoldenGate Monitor Agentのインストールおよび構成

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

IBM以外のすべてのプラットフォーム用のOracle GoldenGate Monitorエージェントをインストールし構成するには、このガイド内のステップ・バイ・ステップの説明に従ってください。

z/OSプラットフォームにOracle GoldenGate Monitorエージェントをインストールする場合、「z/OS用Oracle GoldenGate Monitorエージェントのインストール」を参照してください。

この章は次の項で構成されています:

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

z/OS以外のすべてのプラットフォームでは、Oracle Universal Installer (OUI)を使用してOracle GoldenGate Monitorエージェントをインストールします。次のステップを実行します。

  1. インストーラの起動
  2. 製品のインストール
  3. 使用可能なパッチのインストール

2.1.1 インストーラの起動

インストール・プログラムを起動する手順:

  1. システムにログインします。
  2. インストール・プログラムをダウンロードしたディレクトリに移動します。
  3. 次の表に示すように、システムのJDKディレクトリからjava -jarを起動し、インストール・プログラムを起動します。
    対象のオペレーティング・システム 使用するコマンド

    UNIX

    		 
    $ java -jar -Xmx1024m /path/to/jar/file/fmw_12.2.1.2.0_ogg.jar

    Windows

    		 
    C:\ java -jar -Xmx1024m  fmw_12.2.1.2.0_ogg.jar

ここで、fmw_12.2.1.2.0_ogg.jarは、ご使用のオペレーティング・システム用にダウンロードしたファイルの名前です。

インストール・プログラムが表示されたら、インストールを開始できます。各インストール・プログラムの画面の詳細は、「製品のインストール」を参照してください。

ノート:

Oracle GoldenGate Monitorインストーラは、共有ディスクでは動作しません。

2.1.2 製品のインストール

製品をインストールするには、次の表に説明されている必要な情報を指定して、インストーラ画面を進みます。この表には、表示される順に画面をリストし、必要なフィールドを完成させるための手順を示します。画面の詳細が必要な場合、左側の列でその名前をクリックします。

画面 説明

Welcome

この画面は、製品インストーラの概要を示します。

「Next」をクリックします。

Installation Location

この画面を使用して、Oracleホーム・ディレクトリの場所を指定します。

  1. Oracleホームの場所(WebLogic ServerとJRFおよびCoherenceをインストールしたパス)を入力するか、参照して選択します。

  2. 「View」をクリックして、選択したOracleホームにインストールされている製品を表示します。

  3. 「Next」をクリックします。

Installation Type

この画面を使用して、インストール・タイプを選択します。

  1. 「Oracle Golden Gate Monitor Agent」を選択します。

  2. 「Next」をクリックします。

Prerequisite Checks

この画面では、システムが最小必要要件を満たしていることを確認します。

警告またはエラー・メッセージが表示された場合は、Oracle Fusion Middlewareのインストールのプランニングの動作保証、システム要件および相互運用性の確認に関する項の参照ドキュメントのいずれかを参照できます。

「Next」をクリックします。

Installation Summary

この画面を使用して、選択したインストール・オプションを確認します。

ノート: 個々のコンポーネントのおおよそのインストール・サイズを表示するには、その名前をクリックします。

「Install」をクリックします。

Installation Progress

この画面には、インストールの進行状況が表示されます。進行状況バーが100%に達したら、インストールは完了です。一部のシステムでは、ライブラリの生成プロセスが全インストール時間の70%を占める場合があることに注意してください。

インストールの進行状況が100%になったら、「Next」をクリックします。

Installation Complete

この画面は、インストールの最後に表示され、インストールされた製品および機能のサマリーが表示されます。

「Finish」をクリックします。

このステップでOUIは、OUI固有のファイル・セットとともにOracle GoldenGate Monitorエージェントのバイナリと構成ファイルをORACLE_HOME/oggmon/ogg_agentディレクトリにインストールします。これ以降、このディレクトリはOGG_AGENT_INST_HOMEと呼ばれます。

2.1.3 使用可能なパッチのインストール

  1. My Oracle SupportのリンクをWebブラウザに入力します。
  2. 「Sign In...」をクリックします。

    ノート:

    まだログインしていない場合、「Oracle Single Sign-On」ページが表示されます。OracleユーザーIDとパスワードを入力し、「Sign In」をクリックします。

    「Dashboard」ページが表示されます。

  3. 「Patches & Updates」タブをクリックします。
  4. 使用するオペレーティング・システムのManagement Pack for Oracle GoldenGateを検索します。
  5. ダウンロードしたファイルを解凍します。
  6. パッチZIPファイル内のREADME.txtファイルの指示に従い、パッチがシステムに必要であること、およびパッチのインストール方法を確認します。

2.2 Oracle GoldenGate Monitorエージェントのインスタンスの作成および構成

このトピックでは、Oracle GoldenGate Monitorエージェントのインスタンスを作成および構成する手順について説明します。このプロセスには、次の6つのステップが必要です。

  1. Oracle GoldenGate Monitorエージェントのインスタンスの作成
  2. 構成プロパティの更新
  3. ウォレット資格証明の作成
  4. SSL証明書ファイルのコピー
  5. Oracle GoldenGate Monitorエージェントの起動
  6. Oracle GoldenGate Monitorエージェント・インスタンス・ログ・ファイルの確認

2.2.1 Oracle GoldenGate Monitorエージェントのインスタンスの作成

  1. Oracle GoldenGate Monitorエージェントの作成スクリプト(createMonitorAgentInstance.sh)を含むディレクトリに移動します。例:
    cd OGG_AGENT_BASE_HOME
  2. 次のスクリプトを実行します。
    対象のオペレーティング・システム 使用するコマンド

    UNIX

    		 
    $ ./createMonitorAgentInstance.sh

    Windows

    		 
    C:\ createMonitorAgentInstance.bat

    システムは次のように応答します。

    Please enter absolute path of Oracle GoldenGate home directory :
  3. Oracle GoldenGateホーム・ディレクトリの絶対パスを入力します。例: /u01/ogg/replication/oggcore1。

    システムは次のように応答します。

    Please enter absolute path of OGG Agent instance :
  4. Oracle GoldenGate Monitorエージェント・インスタンスを含むディレクトリ(既存のディレクトリでかまいません)を入力します。例: /u01/ogg/agents/oggmon/agent1。このディレクトリは、次にOracle GoldenGateをインストールおよびパッチ適用するときに、Oracle GoldenGate MonitorエージェントJARおよび構成ファイルを上書きしないように、Oracle GoldenGateホーム・ディレクトリと異なるディレクトリにしてください。このディレクトリは、パッチ適用をサポートするためにOGG_AGENT_BASE_HOMEディレクトリの外部にある必要もあります。次の各項では、このディレクトリはOGG_AGENT_INST_HOMEと呼ばれます。

    ノート:

    Windowsの場合は、JDK8ディレクトリの絶対パスを必ず明示的に指定する必要があり、そうしないと、MonitorエージェントはMonitorサーバーに接続できません。このディレクトリ・パスはjagent.prmファイルで定義することもできます。

    Oracle GoldenGate Monitorエージェント・インスタンスのディレクトリは、既存のディレクトリの場所でかまいません。この場合は、指定するように求められます。 

    OGG Agent instance directory already exists, do you want to overwrite the contents (yes | no)".

    「yes」を選択した場合、スクリプトの実行が続けられ、その場所にあるOracle GoldenGate Monitorエージェントに関連する内容はすべて上書きされます。「no」を選択した場合、スクリプトの実行が停止します。

    システムは次のように応答します。

    Please enter unique name to replace timestamp in startMonitorAgent script.
  5. startMonitorAgent.shスクリプト・ファイルのタイムスタンプを置換する一意の名前を入力します。

一意のディレクトリに作成する必要がありますが、これと同じプロセスを使用して追加のインスタンスを作成できます。たとえば、新しいMonitorエージェント・インスタンスは、別のOracle GoldenGate Monitorエージェント・インスタンスと同じOracle GoldenGateインスタンス・ディレクトリ(例: /u01/ogg/replication/oggcore1)を参照できますが、Oracle GoldenGate Monitorエージェント・インスタンスのディレクトリは常に新しいディレクトリ(例: /u01/ogg/agents/oggmon/agent2)にする必要があります。Oracle GoldenGate Monitorエージェントは、その構成方法に基づいて、Oracle GoldenGateのモニタリング統計をOracle GoldenGate Monitorサーバーに報告します。

ノート:

Oracle GoldenGate 12.3.xの場合、最低限必要なJAgentバージョンは12.2.1.2.171115です。

2.2.2 構成プロパティの更新

Oracle GoldenGate Monitorエージェントは、2つのモード(Oracle GoldenGate Monitor ServerまたはOracle GoldenGate Enterprise Management Plug-In)のいずれかで動作します。次のステップを使用して、動作するモードにあわせて構成プロパティを設定します。

  1. (Oracle GoldenGate Enterprise Management Plug-Inではなく) Oracle GoldenGate Monitor Serverを使用する場合、oggmon.propertiesファイルをOGG_MONITORSERVER_DOMAIN/config/monitorserver/cfgディレクトリからすべてのOracle GoldenGate Monitorエージェント・インスタンスのOGG_AGENT_INST_HOME/cfgディレクトリにコピーします(OGG_AGENT_INST_HOMEはOracle GoldenGate Monitorエージェント・インスタンスへの絶対パス)。
  2. OGG_AGENT_INST_HOME/cfg/Config.propertiesファイルを編集します。
  3. 次のいずれかのモードのプロパティを確認して設定します。

    Oracle GoldenGate Monitor (OGGMON):

    jagent.host=

    デフォルトを使用するか、Oracle GoldenGate Monitorエージェント (jagent)が稼働しているマシンの完全なホスト名またはIPに変更します。

    jagent.jmx.port=

    デフォルトを使用するか、優先ポートに変更します。

    monitor.host=

    Oracle GoldenGate Monitor Serverのインストール時にmonitor.propertiesに設定したホスト名に設定します。

    monitor.jmx.port=

    Oracle GoldenGate Monitor Serverのインストール時にmonitor.propertiesに設定したポートに設定します。

    monitor.jmx.username=

    Oracle GoldenGate Monitorエージェントのインストール時に指定したユーザー名に設定します

    jagent.username=

    jagentユーザー名を設定します。

    agent.type.enabled=

    OGGMONに設定されていることを確認します。

    jagent.backward.compatibility=

    falseに設定されていることを確認します。

    jagent.ssl=

    falseに設定されていることを確認します。

    または

    Oracle GoldenGate Enterprise Management Plug-In (OEM):

    jagent.host=

    デフォルトを使用するか、Oracle GoldenGate Monitorエージェント (jagent)が稼働しているマシンの完全なホスト名またはIPに変更します。

    jagent.username=

    jagentユーザー名を設定します。

    jagent.rmi.port=

    デフォルトを使用するか、特定のポートに変更します。

    agent.type.enabled=

    OEMに設定します。

    jagent.backward.compatibility=

    falseに設定されていることを確認します。

    jagent.ssl=

    falseに設定されていることを確認します。

  4. ファイルを閉じて保存します。

ウォレットを作成するには、oggmon.propertiesファイルが必要です。

ノート:

Oracle GoldenGate Monitor UIを使用して構成ファイルを変更する場合、「Edit」ボタンをクリックしてファイルを再度開く必要があります。タブのタイトルはアスタリスク記号(*)付きの接頭辞に変更されます(これは、テキスト・エリアが編集モードであることを意味します)。値を変更して保存せずに別のセクションに移動すると、変更の保存を促す確認ダイアログが表示されます。保存しないと、変更された値は保持されず、メッセージが表示されません。

2.2.3 ウォレット資格証明の作成

OGG_AGENT_INST_HOME/binディレクトリに移動し、次のいずれかの項を使用して、現在の動作モード(Oracle GoldenGate MonitorまたはOracle GoldenGate Enterprise Management Plug-In)に対応したOracleウォレットを作成します。

2.2.3.1 Oracle GoldenGate Monitorウォレットの作成
  1. 既存のdirwltディレクトリを削除します。
  2. oggmon.propertiesファイルがcfgディレクトリにコピーされていることを確認します。
  3. ウォレット資格証明の作成を開始します。
    対象のオペレーティング・システム 使用するコマンド

    UNIX

    		 
    $ ./pw_agent_util.sh  -create

    Windows

    		 
    C:\ pw_agent_util.bat  -create
  4. jagent.usernameプロパティのユーザー・パスワードを入力して確認します。 
    Please create a password for Java Agent: 
Please confirm password for Java Agent:
  5. monitor.jmx.usernameプロパティのユーザー・パスワードを入力して確認します。 
    Please enter Monitor Server JMX password:

  6. MonitorサーバーのJMXパスワードを確認してください。
    システムの応答: Jan 06, 2014 5:17:22 PM oracle.security.jps.JpsStartup start INFO: Jps initializing.Jan 06, 2014 5:17:24 PM oracle.security.jps.JpsStartup start INFO: Jps started.ウォレットが正常に作成されます。

    これにより、ウォレットのcwallet.ssoおよびcwallet.sso.lckファイルがOGG_AGENT_INST_HOME/cfgディレクトリのdirwltに作成されます。

2.2.3.2 Oracle GoldenGate Enterprise Management Plug-Inウォレットの作成
  1. ウォレット資格証明の作成を開始します。
    対象のオペレーティング・システム 使用するコマンド

    UNIX

    		 
    $ ./pw_agent_util.sh  -jagentonly

    Windows

    		 
    C:\ pw_agent_util.bat  -jagentonly
  2. jagent.usernameプロパティのユーザー・パスワードを入力して確認します。 
    Please create a password for Java Agent: 
Please confirm password for Java Agent:

    システムは次のように応答します。

    Jan 06, 2014 5:17:22 PM oracle.security.jps.JpsStartup start
INFO: Jps initializing.
Wallet is created successfully.

    これにより、ウォレットのcwallet.ssoおよびcwallet.sso.lckファイルがOGG_AGENT_INST_HOMEディレクトリのdirwltに作成されます。

2.2.4 SSL証明書ファイルのコピー

ノート:

このステップは、Oracle GoldenGate MonitorエージェントがSSLモードで実行される場合にのみ必要です。

OGG_AGENT_INST_HOME/dircrtに移動し、キーストアおよびトラストストア・ファイルをコピーします。

キーストアおよびトラストストア・ファイルのコピー後、次のようにします。

  1. pw_agent_util.sh (Windowsでは.bat)ユーティリティを使用して、Oracle GoldenGate Monitorエージェントのパスワードの更新に関する項に説明されているように、キーストアおよびトラストストア・パスワードでウォレットを更新します。
  2. config.propertiesファイル内のjagent.keystoreおよびjagent.truststore値を次のように更新します。
    jagent.keystore.file=jagentKeyStore
jagent.truststore.file=jagentTrustStore

ノート:

自己署名証明書を使用する場合、キーストア・ファイルとトラストストアの両方に同じファイルを使用できます。第三者署名証明書を使用する場合、適切なキーストアおよびトラストストア・ファイルでプロパティ・ファイルを更新する必要があります。

2.2.5 Oracle GoldenGate Monitorエージェント・インスタンスのモニタリングの準備

  1. GLOBALSという名前のファイルをOGG_HOMEディレクトリに作成します(このファイルがない場合)。
  2. GLOBALSファイルを編集します。
  3. 新しい行にENABLEMONITORINGを追加します。
  4. ファイルを閉じて保存します。

    ノート:

    Oracle GoldenGate 12.3.x以降では、データストアは内部的に管理されます。したがって、Oracle GoldenGate 12.3.x以上ではステップ5をスキップできます。
  5. GoldenGate 12.2.x以前のバージョンの場合は、SHM IDを指定してCREATE DATASTOREコマンドを使用することでデータストアを作成します。データストアを作成する前にすべてのプロセスを停止する必要があります。

    GGSCI> CREATE DATASTORE SHM ID <一意の正の整数>

    ノート:

    GoldenGate 12.3.x以降のバージョンの場合は、データストアを手動で作成する必要はありません。これは、PMSRVR (パフォーマンス・メトリック・サーバー)を起動すると自動的に作成されます。

2.2.6 Oracle GoldenGate Monitorエージェントの起動

  1. Oracle GoldenGate GGSCIコンソールに移動し、次のコマンドを実行してOracle GoldenGate Monitorエージェントを起動します。

    GoldenGate 12.2.x以前のバージョンの場合: 

    start manager 
start * 
start jagent

    GoldenGate 12.3.x以降のバージョンの場合: 

    start pmsrvr
start manager
start * 
start jagent

    mgr.prmファイルにautostart jagentを追加することもできます。この場合は、start jagentコマンドをスキップできます。

  2. 新しいエージェント・ログ・ファイルの$AGENT_HOME/logs/ogg_agent.logを監視し、問題がある場合は解決します。

    Oracle GoldenGate Enterprise Manager Plug-Inを使用している場合は、jAgentが正しく起動した後に、Oracle Enterprise Manager (OEM)エージェントを再起動し、OEM 12cコンソールにログインして、Oracle GoldenGateの登録済ターゲットの非同期ステータスの問題が解決されていることを確認します。

  3. BDBの破損およびエラーが原因でWebサービスが応答しなくなった場合は、データストアを再作成しすべてのサービスを再起動します。
GoldenGate 12.2.x以前のバージョンの場合: 
stop jagent
stop *
stop manager
delete datastore
create datastore
start manager 
start * 
start jagent
GoldenGate 12.3.x以降のバージョンの場合:
stop jagent
stop *
stop manager
stop pmsrvr
start pmsrvr -initds
start manager 
start * 
start jagent

2.2.7 Oracle GoldenGate Monitorエージェント・インスタンス・ログ・ファイルの確認

前述のステップを完了し、Oracle GoldenGate Monitorエージェントが稼働すると、Oracle GoldenGate Monitorエージェントのログ詳細がOGG_AGENT_INST_HOME/logs内のogg_agent.logに書き込まれます。

12.2.1.2.0リリース以降、Oracle GoldenGate Agentログ・ファイルにはエラーおよび警告のみが示されます。OGG_AGENT_INST_HOME/cfg/logging-config.xmlファイルを編集してログ・レベルをカスタマイズできます。

2.3 複数のOracle GoldenGate Monitorインスタンスの起動

Oracle GoldenGate MonitorおよびOracle GoldenGate Enterprise Manager Plug-inを通じてOracle GoldenGate Coreインスタンスを監視するために、複数のOracle GoldenGate Monitorインスタンスをインストールできます。

複数のOracle GoldenGate Monitorエージェントのインスタンスを1つのOracle GoldenGate Coreインスタンスのインストールから実行する方法は次のとおりです。

  1. Oracle GoldenGateコア製品のインストール。

  2. スタンドアロンのOracle GoldenGate Monitorエージェントのインスタンス1をインストールし、Oracle GoldenGate Coreインスタンスを指し示すようにします。mode=OEMに設定できます。

  3. OGG_AGENT_HOME1/cfgディレクトリにあるOGGPLG 12.1.0.2.0に必要なOracle GoldenGate Agentプロパティ(Config.properties)を構成します。

    • Oracle GoldenGateホーム・ディレクトリの絶対パス: OGG_CORE_HOME

    • 最初のOGG Agentインスタンス・ディレクトリの絶対パス: OGG_AGENT_HOME1

  4. mgr.hostをマネージャが動作しているマシンのホスト名に変更し、mgr.portをOGGCOREインスタンスのmgrポートに変更します。

  5. JAVAコマンドのコピーを、OGG_CORE_HOME/dirprm/jagent.prmファイルにあるOGGコア・インスタンスから作成します。

  6. スタンドアロンのOracle GoldenGate Monitorエージェントのインスタンス2を作成し、同じOracle GoldenGate Coreインスタンスを指し示すようにします。mode =OGGMONに設定できます。

    • Oracle GoldenGateホーム・ディレクトリの絶対パス: OGG_CORE_HOME

    • 2番目のOGG Agentインスタンス・ディレクトリの絶対パス: OGG_AGENT_HOME2

    ノート:

    OGG_CORE_HOME/dirprm/の下にjagent.prmがすでに存在する場合、jagent.prmファイルが最新のjagent.prmファイルで置き換えられます。

  7. OGG_AGENT_HOME2/cfgディレクトリにあるMonitor 12.1.3に必要なOracle GoldenGate Agentプロパティ(Config.properties)を構成します。

  8. GGSCIからOracle GoldenGate Monitorエージェント・インスタンス2を起動します。

  9. Monitorエージェント・インスタンス1を起動するために、ステップ3で作成したOGG_AGENT_HOME1フォルダからMonitorエージェント・インスタンス1用にステップ5でコピーされたJavaコマンドを実行するか、OGG_AGENT_HOME2/binにあるスクリプトstartMonitorAgentInstance_*.shをOGG_CORE_HOMEの場所から実行します。

    例: OGG_AGENT_HOME2/bin/startMonitorAgentInstance_*.sh

    ノート:

    JAgentは、内部的にはusr.dir (Javaが実行されたディレクトリ)に基づき、OGGC COREの場所の設定からシステム・プロパティが使用されるため、常にOGG_CORE_HOMEの場所から起動する必要があります。