3.3.6　J2EEサーバのログ取得の設定

(1)　ログの出力先の変更

J2EEサーバのログの出力先を変更する場合は，簡易構築定義ファイルでログの出力先ディレクトリを指定します。

ログの出力先の変更

デフォルトのログ出力先を次に示します。

• Windowsの場合

  <作業ディレクトリ>\ejb\<サーバ名>\logs

• UNIXの場合

  <作業ディレクトリ>/ejb/<サーバ名>/logs

なお，作業ディレクトリのデフォルトは，<製品のインストールディレクトリ>\CC\server\public（Windowsの場合），または/opt/Cosminexus/CC/server/public（UNIXの場合）です。

作業ディレクトリおよびJ2EEサーバのログの出力先は，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，次のパラメタを指定すると変更できます。

• ejb.public.directory

  J2EEサーバの作業ディレクトリのパスを指定します。

• ejb.server.log.directory

  J2EEサーバのログの出力先ディレクトリを指定します。

設定例（物理ティアの定義の場合）

• Windowsの場合

  <configuration>
    <logical-server-type>j2ee-server</logical-server-type>
    <param>
      <param-name>ejb.server.log.directory</param-name>
      <param-value>C:\CClogs\server\MyServer</param-value>
    </param>
    ：
  </configuration>

• UNIXの場合

  <configuration>
    <logical-server-type>j2ee-server</logical-server-type>
    <param>
      <param-name>ejb.server.log.directory</param-name>
      <param-value>/CClogs/server/MyServer</param-value>
    </param>
    ：
  </configuration>

カレントディレクトリ

ログ出力先を相対パスで指定する場合のカレントディレクトリを次に示します。

• Windowsの場合

  <作業ディレクトリ>\ejb\<サーバ名称>

• UNIXの場合

  <作業ディレクトリ>/ejb/<サーバ名称>

注意事項

• ログの出力先を変更した場合は，J2EEサーバを起動する前に，変更後のログの出力先ディレクトリを作成しておいてください。

  変更後のログの出力先ディレクトリがない場合は，J2EEサーバの起動時にKDJE40024-Eのメッセージが出力されて異常終了します。また，サーバ管理コマンドの実行時にKDJE37209-E，KDJE37210-E，KDJE37211-Eのメッセージが出力されて異常終了します。

• 同一ホスト内で複数のJ2EEサーバを起動させている場合は，ログ出力先が同じディレクトリにならないように，ディレクトリにサーバ名称を含めるなど，サーバごとにユニークなディレクトリ名になるようにしてください。なお，パラメタの値に同じディレクトリを指定した場合は，動作の保証はしません。

• ログの出力先を変更して作業ディレクトリ以外にログを出力する場合，ログファイルはサーバのアンセットアップ時に削除されません。ログファイルを削除したい場合には，手動で削除してください。

• 簡易構築定義ファイルでログの出力先を設定していても，JavaVM起動パラメタでJavaVMの保守情報およびGCのログ出力先が設定されていると，JavaVM起動パラメタの設定が優先されますので，注意してください。

  JavaVM起動パラメタは，簡易構築定義ファイルの論理J2EEサーバ（j2ee-server）の<configuration>タグ内に定義します。JavaVM起動パラメタの指定内容を次に示します。

<param-name>タグ

add.jvm.arg

<param-value>タグ

XX:HitachiJavaLog:<JavaVMの保守情報およびGCのログ出力先>

JavaVM起動パラメタを指定している場合は，JavaVMの保守情報およびGCのログ出力先に設定したディレクトリに，JavaVMの保守情報およびGCのログファイルが出力されます。

• ログ出力先には，UNC名を含むパスは指定できません。

ページの先頭へ

(2)　ログサイズの変更

J2EEサーバのログサイズを変更する場合は，簡易構築定義ファイルで，ログファイルの面数，およびログファイル1面当たりの最大サイズを設定します。

ログファイル面数の変更

J2EEサーバのログファイルの面数は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.channels.define.<チャネル名>.filenumパラメタで指定します。

設定例（物理ティアの定義の場合）

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.logger.channels.define.MessageLogFile.filenum</param-name>
    <param-value>3</param-value>
  </param>
  ：
</configuration>

ログファイル1面当たりの最大サイズの変更

J2EEサーバのログファイル1面当たりの最大サイズ（単位：バイト）は，論理J2EEサーバ（j2ee-server）の<configuration>タグ内に，ejbserver.logger.channels.define.<チャネル名>.filesizeパラメタで指定します。

設定例（物理ティアの定義の場合）

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.logger.channels.define.MessageLogFile.filesize</param-name>
    <param-value>2097152</param-value>
  </param>
  ：
</configuration>

ページの先頭へ

(3)　ログレベルの変更

J2EEサーバのログレベルは，ログの重要度を表します。ログレベルには，「Error」，「Warning」，「Information」，「Debug」の四つがあります。ログレベルを設定すると，設定したレベルのログが出力されます。デフォルトでは，Errorレベルのログだけが取得されます。通常はデフォルトのまま利用してください。

ログレベルは，簡易構築定義ファイルの論理J2EEサーバの<configuration>タグ内に，ejbserver.logger.enabled.*パラメタで設定します。ejbserver.logger.enabled.*の<param-value>タグにはレベル名を，「Error」，「Warning」，「Information」，「Debug」の文字列で一つ，または複数設定します。複数設定する場合には，レベル名の文字列の間をコンマ（,）で区切ります。

設定例（物理ティアの定義の場合）

1.

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.logger.enabled.*</param-name>
    <param-value>Error</param-value>
  </param>
  ：
</configuration>

2.

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.logger.enabled.*</param-name>
    <param-value>Error,Warning</param-value>
  </param>
  ：
</configuration>

3.

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.logger.enabled.*</param-name>
    <param-value>Error,Warning,Information</param-value>
  </param>
  ：
</configuration>

4.

<configuration>
  <logical-server-type>j2ee-server</logical-server-type>
  <param>
    <param-name>ejbserver.logger.enabled.*</param-name>
    <param-value>Error,Warning,Information,Debug</param-value>
  </param>
  ：
</configuration>

注意事項

• 記述例の1.，2.，3.，4.の順に，取得できるログの件数が増加していきます。複数のログレベルを設定してログを取得すると，性能が劣化し，ログファイルの面の切り替えが頻繁に起こるようになります。

• レベル名に「Error」，「Warning」，「Information」，「Debug」以外の文字列，または空の値を設定した場合は，KDJE90009-Wのメッセージが出力されます。Errorレベルのログは取得されます。

ログレベルの推奨設定

ログレベルの推奨設定を次に示します。

• 通常運用時

  レベル名に「Error」を指定します。

• 通常運用時（verbose）

  通常運用時よりも詳細な情報を取得する場合には，レベル名に「Error,Warning」を指定します。

• テスト時

  レベル名に「Error,Warning,Information」を指定します。

• 障害調査時

  レベル名に「Error,Warning,Information,Debug」を指定します。

ページの先頭へ