3.3 ソース・エージェントとターゲット・エージェントのインストールおよび構成

エージェント・ディレクトリから、ソース・エージェントとターゲット・エージェントをインストールおよび構成します。

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

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

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

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

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

VERIDATA_HOME

これは、Oracle GoldenGate Veridataがインストールされているホーム・ディレクトリです。たとえば、このドキュメントのVERIDATA_HOME/scratch/vdt23cです。

VERIDATA_AGENT_HOME

VERIDATA_HOME/agent。これは、Oracle GoldenGate Veridataエージェントがインストールされる場所です。

AGENT_DEPLOY_LOCATION

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

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

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

構文:

export JAVA_HOME=/usr/java/jdk17
cd /scratch/vdt23c/agent
./agent_config.sh /scratch/agent1
./agent_config.sh /scratch/agent2
cd /scratch/agent1
cp sample_properties/agent.properties.oracle agent.properties
(EDIT agent.properties per documentation)
./agent.sh start agent.properties

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

ノート:

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

3.3.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= <Port Number>

      たとえば、<Port Number> = 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=<JDBC Driver>

      たとえば、<JDBC Driver>= ojdbc11-23.2.0.0.jarです。

  4. Oracle、MySQL、PostgreSQL、SQL Server、DB2およびSybaseドライバは、VERIDATA_HOME/agent/driversにあります。使用する他のドライバについては、ドライバをVERIDATA_HOME/agent/driversにコピーします。詳細は、「エージェント・パラメータ - 接続」を参照してください。

Oracle GoldenGate Veridataエージェントをインストールしたら、双方向SSLを構成する必要があります。Oracle GoldenGate Veridata 23cでの双方向SSLのワークフローの構成を参照してください。

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

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

$ ./agent.sh start agent.properties

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

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

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

構文:

<VERIDATA_AGENT_HOME>/agent_config.sh AGENT_DEPLOY_LOCATION true

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

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

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

  1. コマンド・プロンプトを開き、エージェントがインストールされているディレクトリに移動します。
  2. <AGENT_DEPLOY_LOCATION>に移動し、次のコマンドを実行します:
    ./agent.sh reloadLog
    エージェント・プロパティがagent.properties以外のカスタム・ファイルに格納されている場合は、次のコマンドを実行します:
    ./agent.sh reloadLog <AGENT_PROPERTIES_FILENAME>