6 Oracle GoldenGate Veridataエージェントのデプロイおよび構成

Oracle WebLogic ServerドメインのOracle GoldenGate Veridataエージェントをデプロイおよび構成する方法を学習します。エージェントの起動および停止方法、ロギング・プロパティのリロード方法、およびデバッグ・モードでのエージェントの使用方法について説明します。

6.1 Oracle GoldenGate Veridataエージェントのデプロイメント・スクリプトについて

Oracle Universal Installerを使用してOracle GoldenGate Veridataエージェントをインストールしたら、比較ジョブを実行する前に、インストールに付属のデプロイメント・スクリプトを使用して、Oracleホーム以外の場所にエージェントをデプロイして構成する必要があります。

次の表では、この項のディレクトリの参照時に使用されるディレクトリおよび変数について説明します。

表6-1 Oracle GoldenGate Veridataインストールのディレクトリ

ディレクトリ変数 ディレクトリ・パス

ORACLE_HOME

/install_location/Oracle_HomeOracle Fusion Middleware製品のホーム・ディレクトリです。

VERIDATA_PRODUCT_HOME

/ORACLE_HOME/veridata

AGENT_ORACLE_HOME

/VERIDATA_PRODUCT_HOME/agent

AGENT_DEPLOY_LOCATION

これは、Oracle GoldenGate Veridataエージェントがデプロイされる場所です。

この場所は、ORACLE_HOME.の外部にする必要があります。

AGENT_ORACLE_HOMEディレクトリにあるagent_config.sh|.batスクリプトは、Veridataエージェントのデプロイに使用されます。

構文:

agent_config.sh|.bat AGENT_DEPLOY_LOCATION

AGENT_DEPLOY_LOCATIONは、スクリプトを実行する場所の絶対パスまたは相対パスになります。

ノート:

Oracle GoldenGate Veridataエージェントは、ORACLE_HOME外部のディレクトリにデプロイする必要があります。

6.2 Oracle GoldenGate Veridataエージェントの構成

Oracle GoldenGate Veridataエージェントでデータベースを使用するように構成する必要があります。

  1. エージェントがデプロイされている場所AGENT_DEPLOY_LOCATIONに移動します。

    このディレクトリにあるagent.properties.sampleファイルには、JDBC URLやドライバなどのデータベース関連プロパティが含まれています。

  2. agent.properties.sampleファイルをコピーし、名前をagent.propertiesに変更します。

  3. このファイルに定義されているほとんどのプロパティにデフォルト値があります。ただし、次のプロパティは更新する必要があります。

    1. server.portプロパティは、Oracle GoldenGate Veridataエージェントが接続リクエストをリスニングするポートです。

      server.port=server.port
      

      たとえば、server.port=7862

    2. database.urlでは、データベースのJDBC接続URLを指定します。すべてのサポート対象データベースのサンプルがファイルに記載されています。

      database.url=database.url

      たとえば、database.url=jdbc:oracle:thin:@localhost:1521:orcl

    3. server.jdbcDriverプロパティでは、JDBCドライバのJARファイルのリストを指定します。サポート対象データベースのサンプル・リストがファイルに記載されています。

      前のステップのdatabase.urlの対応するドライバを使用します。

      server.jdbcDriver=<server.jdbcDriver>

      たとえば、server.jdbcDriver=ojdbc8.jarです。

  4. AGENT_DEPLOY_LOCATION/driversにあるドライバをドライバの場所にコピーします。

6.3 Oracle GoldenGate Veridataエージェントの開始

エージェントのデプロイメント場所AGENT_DEPLOY_LOCATION に移動して、次のコマンドを実行します。

$ ./agent.sh start agent.properties

agent.propertiesは、データベース・プロパティが含まれているプロパティ・ファイルです。

6.4 デバッグ・モードでのOracle GoldenGate Veridataエージェントのデプロイメント・スクリプトの使用

Veridataエージェントのデプロイメントでデバッグの問題が発生した場合は、次のように、追加のコマンドライン引数を指定して、agent_configスクリプトを実行します。

構文:

agent_config.sh|.bat AGENT_DEPLOY_LOCATION true

このオプションがtrueの場合、デバッグ・ログが画面に出力されます。

6.5 Veridataエージェントのロギング・プロパティのリロード

ロギング情報は、reloadLogオプションを使用して、AGENT_ORACLE_HOME/config/odl.xml構成ファイルから実行中のエージェントにリロードできます。odl.xmlファイルの変更はエージェントで有効になります。このコマンドを機能させるには、エージェントを実行中である必要があります。

  1. コマンド・プロンプトを開き、エージェントがインストールされているディレクトリに移動します。
  2. 次のコマンドを実行して、AGENT_ORACLE_HOME/config/odl.xml構成ファイルをロードします。
    agent.sh|bat reloadLog