jp1ssolog.bat(Windows限定)
形式
jp1ssolog.bat [-col] [-d 出力先ディレクトリ名] [<agent> ...]
機能
SSOの障害発生時に障害調査用資料を採取します。このコマンドは,Windows限定のコマンドです。
デフォルトまたは-dオプションで指定したディレクトリ配下にJP1SSOディレクトリを作成し,その配下に採取する資料を出力します。JP1SSOディレクトリがすでにある場合は,削除してから新たにJP1SSOディレクトリを作成します。
採取する資料のデフォルトの出力先は,%TEMP%\jp1logです。デフォルトの出力先は,このコマンド(バッチファイル)を編集することで変更できます。
オプション
-col
障害調査用資料として$SSO_DB\Coll配下も採取します。
-d 出力先ディレクトリ名
採取する資料の出力先を,相対パスまたは絶対パスで指定します。
<agent> ...
指定した監視サーバに対するpingコマンドの実行結果も,障害調査用資料として採取します。<agent>にはIPアドレスまたはホスト名を指定します。なお,指定したIPアドレスまたはホスト名が正しくない場合や,監視サーバが停止している場合,コマンドの戻り値は1になります。
カスタマイズ
このコマンドはバッチファイルです。必要に応じて次に示す項目をカスタマイズできます。
デフォルトの出力先を変更する場合
次に示す行の出力先を編集します。
set OUTPUTDIR=%TEMP%\jp1log
使用例
-
監視サーバ「agt1」および「agt2」で障害が発生した場合
jp1ssolog.bat agt1 agt2
採取資料一覧
採取する障害調査用の資料の一覧,および資料を採取する方法の詳細については,「9.2.3(17) 上記以外のエラー」を参照してください。
戻り値
0 |
資料採取が成功した |
1 |
一部の資料採取に失敗したが問題なし |
4 |
資料採取が失敗した(出力先ディレクトリ不正) |
注意事項
-
このコマンドを実行する場合のオプションについては,「9.2.3 運用時の障害の対処方法」を参照してください。
-
このコマンドは,可能な限り障害が発生した直後に実行してください。デーモンプロセスが異常終了した場合でも,そのデーモンプロセスの再起動やSSOの再起動などをする前に実行してください。
-
採取資料の保存中にディスクの空き容量が不足した場合,正しく資料を保存できません。このコマンドを実行する場合は,出力先のディスクに十分な空き容量があることを確認してから実行してください。必要となる容量の目安は,-colオプションを指定しない場合は{ログの容量 + 100メガバイト}で,-colオプションを指定する場合は{ログの容量 + 100メガバイト + $SSO_DBの容量}です。
-
出力先ディレクトリに未接続のネットワーク上の共有ディスクのディレクトリを指定しないでください。もし指定した場合は,資料採取に失敗するおそれがあります。