12 Javaアダプタのトラブルシューティング

この章の内容は次のとおりです。

トピック:

• エラーの確認
  
• 問題のレポート
  

12.1 エラーの確認

Java用Oracle GoldenGateの操作時発生する可能性のあるエラーには2つのタイプがあります。

• 実行しているReplicatプロセス、またはVAMが起動しないか異常終了します。

• プロセスは正常に稼働しますが、データが正しくないか、存在しません。

ReplicatまたはExtractプロセスが起動しないか異常終了する場合、処理の最初から最後まで順にエラー・メッセージを確認します。

1. Oracle GoldenGateイベント・ログでエラーを確認し、Extractレポート・ファイルを表示します。

   GGSCI> VIEW GGSEVT
   GGSCI> VIEW REPORT {replicat/extract name}
   

2. 該当するログ・ファイルを確認します。

   ネイティブ・ログ・ファイルの場合:

   • ネイティブ・ライブラリのログ・ファイルにレポートされている最後のメッセージを確認します。ファイル名は、プロパティ・ファイルで設定されたログ・ファイル接頭辞(log.logname)と現在の日付です。

     shell> more {log.logname}_{yyyymmdd}.log
     

     注意:

     これは、Javaアプリケーションのログ・ファイルではなく、共有ライブラリのみのログ・ファイルです。

3. ReplicatまたはVAMがJavaランタイムを起動できなかった場合、log4jログ・ファイルが存在します。

   ログ・ファイルの名前はlog4j.propertiesファイルに定義されています。デフォルトでは、ログ・ファイル名はggjava-version-log4j.logで、versionは使用されるJARファイルのバージョン番号です。次に例を示します。

   shell> more ggjava-*log4j.log
   

   Javaアプリケーションのロギングの詳細レベルを設定するには、次のいずれかを行います。

   • より詳細なレベルで記録するよう現在のlog4jプロパティ・ファイルを編集します。

   • プロパティ・ファイルを編集して既存のlog4j構成の1つを再利用します。

     jvm.bootoptions=-Djava.class.path=ggjava/ggjava.jar
     -Dlog4j.configuration=debug-log4j.properties –Xmx512m
     

   あらかじめ構成されたこれらのlog4jプロパティ・ファイルはクラスパスで検出され、次の場所にインストールされています。

   ./ggjava/resources/classes/*log4j.properties
   

4. これらのログ・ファイルのいずれかで問題の原因が明らかにならない場合、ネイティブ・プロセスをシェルから直接(GGSCI外で)実行し、stderrおよびstdoutをより簡単に監視でき、環境変数を確認できるようにします。次に例を示します。

   shell> REPLICAT PARAMFILE dirprm/javaue.prm
   

プロセスは正常に実行されるが、データが正しくないか存在しない場合、記述したカスタム・フィルタ、フォーマッタまたはハンドラにエラーがないか確認します。

Replicatを証跡の最初から再開する場合は、「Java配信の再起動」を参照してください。

12.2 問題のレポート

Oracle GoldenGateのサポート・アカウントがある場合、次の情報を含めてサポート・チケットを発行してください。

• オペレーティング・システムとJavaのバージョン

  Java Runtime Environmentのバージョンは、次のようにすると表示できます。

  $ java -version
  

• 構成ファイル:

  • Replicatのパラメータ・ファイル

  • JMSまたはJNDIプロパティ・ファイルを含む、使用されるすべてのプロパティ・ファイル

  • フォーマット目的のためのVelocityテンプレート

  • 可能であれば、ターゲット固有の構成ファイルも含めてください

• ログ・ファイル:

  Oracle GoldenGateのインストール・ディレクトリ内のすべての.logファイル(Java log4jログ・ファイル、およびネイティブ・モジュールまたはVAMのログ・ファイル)。