プライマリ・コンテンツへ移動
Oracle® GoldenGate Oracle GoldenGate Monitor Agentのインストール、構成およびアップグレード
12c (12.2.1)
E70092-01
  ドキュメント・ライブラリへ移動
ライブラリ
製品リストへ移動
製品
目次へ移動
目次

前
 
次
 

3 z/OS用Oracle GoldenGate Monitorエージェントのインストールおよび構成

この章では、z/OSプラットフォーム用にOracle GoldenGate Monitorエージェントをインストールし、構成するプロセスについて順を追って説明します(z/OS以外のプラットフォームでOracle GoldenGate Monitorエージェントをインストールする場合、第2章「Oracle GoldenGate Monitorエージェントのインストールおよび構成」を参照してください)。

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

3.1 z/OS用Oracle GoldenGate Monitorエージェントのインストール

Oracle GoldenGate Monitorエージェント製品ディストリビューションには、ファイルogg_agent-zos.tarが含まれており、これを使用してz/OSプラットフォームでOracle GoldenGate Monitorエージェントをインストールします。次の手順に従ってください。

  1. Oracle GoldenGate Monitorエージェント・バイナリをインストールするフォルダを作成します。この例では、そのフォルダを/apps/products/ogg-agent-zos-home/と呼びます。

  2. /apps/products/ogg-agent-zos-homeに移動し、ogg_agent-zos.tarを解凍します。

    $./tar xvzf ogg_agent-zos.tar
    

    /apps/products/ogg-agent-zos-home/に新規フォルダogg_agent-zosが作成されます。このogg_agent-zosフォルダには、すべてのOracle GoldenGate Monitorエージェントのバイナリとその構成およびスクリプト・ファイルが含まれます。z/OSプラットフォームではこのフォルダ(/apps/products/ogg-agent-zos-home/ogg_agent-zos)がOGG_AGENT_INST_HOMEディレクトリです。

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

  1. My Oracle SupportのリンクをWebブラウザに入力します。

    http://support.oracle.com

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


    注意:

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

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

  3. 「Patches & Updates」タブをクリックします。

  4. 使用するオペレーティング・システムのManagement Pack for Oracle GoldenGateを検索します。

  5. 少なくともパッチ19916072をダウンロードします。

  6. ダウンロードしたファイルを解凍します。

  7. パッチZIPファイル内のREADME.txtファイルの指示に従い、パッチがシステムに必要であること、およびパッチのインストール方法を確認します。

3.3 z/OS用Oracle GoldenGate Monitorエージェントのインスタンスの作成および構成

この項では、z/OS以外のプラットフォーム用にOracle GoldenGate Monitorエージェントのインスタンスを作成および構成する手順について説明します。このプロセスは、次の6つの手順で構成されます。

  1. インスタンスの作成

  2. 構成プロパティの更新

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

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

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

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

3.3.1 インスタンスの作成

  1. Oracle GoldenGate Monitorエージェントの作成スクリプト(createMonitorAgentInstance.sh)を含むディレクトリに移動します。次に例を示します。

    cd /u01/app/oracle/product/wls/oggmon/ogg_agent
    
  2. スクリプトを実行します。

    ./createMonitorAgentInstance.sh 
    

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

    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ホーム・ディレクトリと異なるディレクトリにしてください。

    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 MonitorエージェントとOracle GoldenGateインスタンスの構成および通信。

3.3.2 構成プロパティの更新

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

  1. 前述の項の手順を完了したら、oggmon.propertiesファイルをOGG_MONITORSERVER_DOMAIN/config/monitorserver/cfgディレクトリからすべてのOracle GoldenGate Monitorエージェント・インスタンスのOGG_AGENT_INST_HOME/cfgディレクトリにコピーします。

  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エージェントのインストール時に指定したホスト名に設定します。

    monitor.jmx.port=

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

    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サーバーのインストールおよび構成のMonitorプロパティの編集に関する項を参照してください。

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

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

3.3.3.1 Oracle GoldenGate Monitorパスワード・ファイルの作成

  1. 既存のdirwltディレクトリを削除します。

  2. oggmon.propertiesファイルがcfgディレクトリにコピーされていることを確認します。

  3. ウォレット資格証明の作成を開始します。

  4. ./pw_agent_util.sh  -create
    
  5. jagent.usernameプロパティのユーザー・パスワードを入力して確認します。

    Please create a password for Java Agent: 
    Please confirm password for Java Agent: 
    
  6. monitor.jmx.usernameプロパティのユーザー・パスワードを入力して確認します。

    Please enter Monitor Server JMX password: 
    
  7. Please confirm Monitor Server JMX password: 
    

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

    Password is stored successfully
    

    これにより、OGG_AGENT_INST_HOMEディレクトリにPassword.propertiesファイルが作成されます。

3.3.3.2 Oracle GoldenGate Enterprise Management Plug-Inウォレットの作成

  1. ウォレット資格証明の作成を開始します。

  2. ./pw_agent_util.sh  -jagentonly
    
  3. 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に作成されます。

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


注意:

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

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

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

  1. pw_agent_util.sh (Windowsでは.bat)ユーティリティを使用して、Oracle GoldenGate Monitorの管理のOracle GoldenGate Monitorエージェントのパスワードの更新に関する項に説明されているように、キーストアおよびトラストストア・パスワードでウォレットを更新します。

  2. config.propertiesファイル内のjagent.keystoreおよびjagent.truststore値を次のように更新します。

    jagent.keystore.file=jagentKeyStore
    jagent.truststore.file=jagentKeyStore
    

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

  1. GLOBALSという名前のファイルをOracle GoldenGateホーム・ディレクトリに作成します(このファイルがない場合)。

  2. GLOBALSファイルを編集します。

  3. 新しい行にENABLEMONITORINGを追加します。

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

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

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

GGSCI> start jagent

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

前述の手順を完了し、Oracle GoldenGate Monitorエージェントが稼働すると、Oracle GoldenGate Monitorエージェントのログ詳細がOGG_AGENT_INST_HOME/logsogg_agent.logファイルに書き込まれます。