11 トラブルシューティング

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

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

トピック:

親トピック: トラブルシューティング

11.1.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配信の再起動」を参照してください。

親トピック: Javaアダプタのトラブルシューティング

11.1.2 問題のレポート

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

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

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

    $ java -version

  • 構成ファイル:

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

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

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

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

  • ログ・ファイル:

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

親トピック: Javaアダプタのトラブルシューティング