mserver.properties（Management Server環境設定ファイル）で，障害検知時コマンドの動作を設定します。

次のキーで，障害検知時コマンドの動作を設定します。

（凡例）

システム：システム提供の障害検知時コマンドでの設定の要否を示す。

ユーザ：ユーザ作成の障害検知時コマンドでの設定の要否を示す。

○：設定は必要。

△：デフォルトの設定を変更する場合だけ必要。

−：設定は不要。

adminagent.properties（運用管理エージェントプロパティファイル）で，障害検知時コマンドで取得する資料を設定します。

adminagent.propertiesの次のキーで，障害検知時コマンドで取得する資料の数や取得の有無，障害検知時コマンドのパスなどを設定します。なお，snapshotログの収集先を定義するためのリストファイルについては，「5.2(3)　snapshotログの収集先のカスタマイズ」を参照してください。

（凡例）

システム：システム提供の障害検知時コマンドでの設定の要否を示す。

ユーザ：ユーザ作成の障害検知時コマンドでの設定の要否を示す。

○：設定は必要。

△：デフォルトの設定を変更する場合だけ必要。

−：設定は不要。

ユーザ作成の障害検知時コマンドは，コマンドファイル（バッチファイルまたはシェルスクリプトファイル）に記述できます。このとき，次の表に示す環境変数をコマンドファイルに記述しておくことで，障害の発生した論理サーバの情報や障害に関する情報を利用してコマンドを実行できます。

表5-6　ユーザ作成の障害検知時コマンドのコマンドファイルに記述できる環境変数

なお，障害検知コマンドとして実行するコマンドから出力される標準出力，標準エラー出力は，Management Serverでは取得しません。このため，コマンドの標準出力，標準エラー出力を取得する場合は，コマンドの中でファイルに出力する必要があります。

(a)　コマンドファイルの例

J2EEサーバの障害発生時にdrwtsn32コマンドまたはkillコマンドを実行してユーザダンプまたはcoreダンプを取得する場合の例を次に示します。

• ユーザダンプの取得の例（Windowsの場合）
  

  rem 障害がプロセスダウンかハングアップかを，プロセスダウンを検知した時刻から判断する。 if defined COSMI_MNG_TIME_TERMINATED goto END rem 障害がハングアップであるため，ユーザダンプを取得する。 "C:\WINDOWS\system32\drwtsn32.exe" -p %COSMI_MNG_LSPID% :END

• coreダンプの取得の例（UNIXの場合）
  

  #!/bin/sh # 障害がプロセスダウンかハングアップかを，プロセスダウンを検知した時刻から判断する。 if [ "$COSMI_MNG_TIME_TERMINATED" = "" ] ; then # 障害がハングアップであるため，coreダンプを取得する。 /bin/kill -6 $COSMI_MNG_LSPID fi

(b)　ユーザ作成の障害検知時コマンドの動作

論理CTMでは，グローバルCORBAネーミングサービスとCTMデーモンの二つのプロセスが起動，停止，監視されます。そのため，論理CTM内のグローバルCORBAネーミングサービスの障害を検知した場合とCTMデーモンの障害を検知した場合とでは，実行するコマンドが異なります。

• グローバルCORBAネーミングサービスの障害を検出した場合
  adminagent.naming.usr_cmd.abnormal_endキーで指定したコマンドが実行されます。
  
• CTMデーモンの障害を検出した場合
  adminagent.ctm.usr_cmd.abnormal_endキーで指定したコマンドが実行されます。
  

また，論理CTM内の二つのプロセス（CTMデーモン，グローバルCORBAネーミングサービス）のどちらのプロセスで障害を検知しても，Management Serverのログには，論理サーバ（CTM）の障害検知時コマンドの開始を通知するログが出力されます。