3.3 ソース・エージェントとターゲット・エージェントのインストールおよび構成
エージェント・ディレクトリから、ソース・エージェントとターゲット・エージェントをインストールおよび構成します。
- Oracle GoldenGate Veridataエージェントのデプロイメント・スクリプトについて
- Oracle GoldenGate Veridataエージェントの構成
- Oracle GoldenGate Veridataエージェントの開始
- デバッグ・モードでのOracle GoldenGate Veridataエージェントのデプロイメント・スクリプトの使用
- Veridataエージェントのロギング・プロパティのリロード
親トピック: インストール
3.3.1 Oracle GoldenGate Veridataエージェントのデプロイメント・スクリプトについて
Oracle Universal Installerを使用してOracle GoldenGate Veridataエージェントをインストールしたら、比較ジョブを実行する前に、インストールに付属のデプロイメント・スクリプトを使用して、Oracleホーム以外の場所にエージェントをデプロイして構成する必要があります。
次の表では、この項のディレクトリの参照時に使用されるディレクトリおよび変数について説明します。
表3-1 Oracle GoldenGate Veridataインストールのディレクトリ
ディレクトリ変数 | ディレクトリ・パス |
---|---|
|
これは、Oracle GoldenGate Veridataがインストールされているホーム・ディレクトリです。たとえば、このドキュメントのVERIDATA_HOME は/scratch/vdt23c です。
|
|
|
|
これは、Oracle GoldenGate Veridataエージェントがデプロイされる場所です。 この場所は、 |
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エージェントでデータベースを使用するように構成する必要があります。
- エージェントがデプロイされている場所
AGENT_DEPLOY_LOCATION
に移動します。このディレクトリにある
agent.properties.sample
ファイルには、JDBC URLやドライバなどのデータベース関連プロパティが含まれています。 agent.properties.sample
ファイルをコピーし、名前をagent.properties
に変更します。- このファイルに定義されているほとんどのプロパティにデフォルト値があります。ただし、次のプロパティは更新する必要があります。
server.port
プロパティは、Oracle GoldenGate Veridataエージェントが接続リクエストをリスニングするポートです。server.port= <Port Number>
たとえば、
<Port Number>
=7862
ですdatabase.url
では、データベースのJDBC接続URLを指定します。すべてのサポート対象データベースのサンプルがファイルに記載されています。database.url=<Database URL>
たとえば、
<Database URL>
=jdbc:oracle:thin:@localhost:1521:orcl
です。server.jdbcDriver
プロパティは、JDBCドライバJARファイルのリストを指定します。サポート対象データベースのサンプル・リストがファイルに記載されています。前のステップの
database.url
の対応するドライバを使用します。server.jdbcDriver=<JDBC Driver>
たとえば、
<JDBC Driver>
=ojdbc11-23.2.0.0.jar
です。
- 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
の場合、デバッグ・ログが画面に出力されます。