JP1/Integrated Management - Manager コマンド・定義ファイルリファレンス
機能
JP1/IM - Managerで障害が発生したときに資料を採取するためのツールです。JP1/IM - ManagerおよびJP1/Baseの保守資料,OSのシステム情報,統合トレースログなどを採取します。
このツールは,シェルスクリプトです。ユーザーによるカスタマイズはできません。
このツールを実行すると,資料を採取する対象ディレクトリまたはファイルを一次資料および二次資料に区分けし,指定した資料格納ディレクトリの直下でtarコマンドによってアーカイブしたあと,compressコマンドで圧縮したファイルを作成します。
一次資料は,障害時の切り分けや,軽度の障害の調査を目的に採取する資料です。必要最低限のログおよび設定ファイルを採取します。二次資料は,一次資料ではわからなかった障害をさらに調査するための詳細資料です。core解析情報,JP1/BaseのイベントDBなどを採取します。
また,JP1/IM - Manager(JP1/IM - Central Console)のコアダンプやスレッドダンプがある状態でjim_log.shコマンドを実行すると,メッセージKAVB8941-IまたはKAVB8942-Iを表示してコアダンプまたはスレッドダンプを削除するかどうかユーザーに問い合わせます。「y」または「yes」を入力した場合,コアダンプまたはスレッドダンプを削除します。
なお,このツールを使って採取できる資料の詳細については,マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「10.3 トラブル発生時に採取が必要な資料」を参照してください。
採取した資料を圧縮したファイルを次に示します。
表1-34 採取した資料を圧縮したファイル
ファイル名 内容 jp1_default_imm_1st.tar.Z 物理ホストの一次資料を格納します。 jp1_default_imm_2nd.tar.Z 物理ホストの二次資料を格納します。 論理ホスト名_imm_1st.tar.Z※ 論理ホストの一次資料を格納します。 論理ホスト名_imm_2nd.tar.Z※ 論理ホストの二次資料を格納します。 注※ -hオプションで論理ホストを指定した場合にだけ作成されます。
圧縮されたファイルは,資料格納ディレクトリに格納されます。圧縮された各ファイルの内部ディレクトリ構成を次に示します。
表1-35 物理ホストの一次資料の内部ディレクトリ構成
ディレクトリ名・ファイル名 格納された資料 ./etc/opt/jp1base JP1/Baseの自動起動および自動終了スクリプト ./etc/opt/jp1base/conf JP1/Baseの設定および定義ファイル ./etc/opt/jp1base/default JP1/Baseの共通定義情報 ./etc/opt/jp1cons JP1/IM - Manager(JP1/IM - Central Console)の自動起動および自動終了スクリプト ./etc/opt/jp1cons/conf JP1/IM - Manager(JP1/IM - Central Console)の設定および定義ファイル ./etc/opt/jp1cons/default JP1/IM - Manager(JP1/IM - Central Console)の共通定義情報 ./etc/opt/jp1imm/conf/tools JP1/IM - Managerの設定および定義ファイル ./etc/opt/jp1imm/conf/imcf IM構成管理の設定および定義ファイル ./etc/opt/jp1imm/conf/imdb IMデータベースの設定および定義ファイル ./etc/opt/jp1imm/default/imcf IM構成管理の共通定義情報 ./etc/opt/jp1scope/conf JP1/IM - Manager(JP1/IM - Central Scope)の設定および定義ファイル ./etc/opt/jp1scope/default JP1/IM - Manager(JP1/IM - Central Scope)の共通定義情報 ./opt/jp1/hcclibcnf 共通定義情報 ./opt/jp1base JP1/Baseのパッチ適用履歴およびパッチログ情報 ./opt/jp1base/conf JP1/Baseのプラグインサービスの設定ファイル ./opt/jp1imm JP1/IM - Managerのパッチ適用履歴およびパッチログ情報 ./var/opt/jp1base/log JP1/Baseのログファイル ./var/opt/jp1base/sys/tmp JP1/Baseのログおよびテンポラリファイル ./var/opt/hitachi/HNTRLib2/spool 統合トレースログ ./var/opt/jp1cons/log JP1/IM - Manager(JP1/IM - Central Console)のログファイル ./var/opt/jp1imm/database/imdb IMデータベースのログの詳細情報 ./var/opt/jp1imm/log/imcf IM構成管理のログファイル ./var/opt/jp1imm/log/imdb IMデータベースのログファイル ./var/opt/jp1imm/log/_jp1_default/oslog OSのログ情報 ./var/opt/jp1scope/log JP1/IM - Manager(JP1/IM - Central Scope)のログファイル
表1-36 物理ホストの二次資料の内部ディレクトリ構成
ディレクトリ名・ファイル名 格納された資料 ./var/opt/jp1base/log/COMMAND JP1/Baseのコマンド実行履歴ファイル ./var/opt/jp1base/sys/event/servers/default JP1/BaseのイベントDB ./var/opt/jp1cons/operation/discrim JP1/IM - Manager(JP1/IM - Central Console)のインシデント登録履歴ファイル ./var/opt/jp1cons/operation/evgen JP1/IM - Manager(JP1/IM - Central Console)の相関イベント発行履歴ファイル ./var/opt/jp1imm/log/_jp1_default/oslog OSのログ情報 ./var/opt/jp1imm/log/_jp1_default/core コアファイル ./var/opt/jp1scope/database JP1/IM - Manager(JP1/IM - Central Scope)のDB情報 ./var/opt/jp1imm/data/imcf IM構成管理のデータファイル ./var/opt/jp1imm/database/imdb/imdbbackup.dat IMデータベースのバックアップファイル ./tmp/.JP1_SES*
./usr/tmp/jp1_ses
./usr/lib/jp1_ses/log
./usr/lib/jp1_ses/sys
./usr/bin/jp1_ses/jp*
./var/opt/jp1_sesJP1/SES互換用ログ
表1-37 論理ホストの一次資料の内部ディレクトリ構成
ディレクトリ名・ファイル名 格納された資料 ./共有ディスク/jp1base/../event JP1/Baseの論理ホストのイベントサーバ設定 ./共有ディスク/jp1base/conf JP1/Baseの論理ホストの設定および定義ファイル ./共有ディスク/jp1base/log JP1/Baseの論理ホストのログファイル ./共有ディスク/jp1cons/conf JP1/IM - Manager(JP1/IM - Central Console)の論理ホストの設定および定義ファイル ./共有ディスク/jp1cons/log JP1/IM - Manager(JP1/IM - Central Console)の論理ホストのログファイル ./共有ディスク/jp1scope/conf JP1/IM - Manager(JP1/IM - Central Scope)の論理ホストの設定および定義ファイル ./共有ディスク/jp1scope/log JP1/IM - Manager(JP1/IM - Central Scope)の論理ホストのログファイル ./var/opt/jp1imm/log/_論理ホスト名/oslog OSのログ情報 ./共有ディスク/jp1imm/conf/imcf IM構成管理の設定および定義ファイル ./var/opt/jp1imm/database/imdb IMデータベースのログの詳細情報 ./共有ディスク/jp1imm/log/imcf IM構成管理のログファイル ./var/opt/jp1imm/log/imdb IMデータベースのログファイル
表1-38 論理ホストの二次資料の内部ディレクトリ構成
ディレクトリ名・ファイル名 格納された資料 ./共有ディスク/event JP1/BaseのイベントDB ./共有ディスク/jp1base/log/COMMAND JP1/Baseのコマンド実行履歴ファイル ./共有ディスク/jp1cons/operation/discrim JP1/IM - Manager(JP1/IM - Central Console)のインシデント登録履歴ファイル ./共有ディスク/jp1cons/operation/evgen JP1/IM - Manager(JP1/IM - Central Console)の相関イベント発行履歴ファイル ./共有ディスク/jp1scope/database JP1/IM - Manager(JP1/IM - Central Scope)のDB情報 ./var/opt/jp1imm/log/_論理ホスト名/oslog OSのログ情報 ./var/opt/jp1imm/log/_論理ホスト名/core コアファイル ./共有ディスク/jp1imm/data/imcf IM構成管理のデータファイル ./共有ディスク/jp1imm/database/imdb/imdbbackup.dat IMデータベースのバックアップファイル
形式
jim_log.sh -f 資料格納ディレクトリ [-h 論理ホスト名] [-t] [-u] [-n] [-p] [-r] [-e] [-g] [-a] [-s] [-c] [-d] [-x] [-q] [ディレクトリ名またはファイル名...]-aオプションは,BJEXと連携した場合に使用するオプションです。-aオプションの詳細については,マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「9.6.3 jim_log.sh(UNIX限定)」を参照してください。
実行権限
スーパーユーザー権限
格納先ディレクトリ
/opt/jp1imm/tools/
引数
-f 資料格納ディレクトリ
採取した資料を出力するディレクトリ名またはデバイス名をフルパスまたはルートディレクトリからの相対パス形式で指定します。ディレクトリ名を指定した場合,その下に採取した各資料を格納したファイルが作成されます。パスに空白を含む場合は,「"」で囲んで指定します。このオプションは省略できません。
存在しないディレクトリを指定した場合は,その名称でディレクトリが新規作成されます。すでに存在するディレクトリを指定した場合は,いったんそのディレクトリを削除してから,指定したディレクトリが作成されます。
デバイス名を指定した場合,作成したファイルの数だけデバイスに対して書き込みが発生します。また,テープなどのデバイスファイル名を指定した場合,採取した資料は圧縮されずにデバイスに格納されます。
デバイス名を指定し,かつ-qオプションを指定した場合,ユーザー確認に対しては「yes」を選択したものとして動作するので,あらかじめコマンドを実行する前にデバイスをセットしておく必要があります。
-h 論理ホスト名
クラスタシステムで運用している場合に,論理ホスト名を指定します。このオプションを指定した場合,物理ホストと論理ホストの両方の資料を採取します。このオプションを省略した場合,物理ホストの資料だけ採取します。クラスタシステムを使用していない場合には指定は不要です。
なお,このコマンドでは環境変数JP1_HOSTNAMEの論理ホスト名は使用しません。このため,クラスタシステムで使用する場合には論理ホスト名を必ずこのオプションで指定してください。
-t
hosts,services,およびpasswdファイルを採取しない場合に指定します。
-u
core解析情報を採取しない場合に指定します。core解析情報とは,coreダンプファイルをSeraphツールのcarコマンドで解析して取得したファイルです。
-n
JP1/Baseの保守資料を採取しない場合に指定します。
-p
JP1/BaseのイベントDBを取得しない場合に指定します。
-r
JP1/Baseのコマンド実行履歴ファイルを採取しない場合に指定します。
-e
インシデント登録履歴ファイルを採取しない場合に指定します。
-g
相関イベント発行履歴ファイルを採取しない場合に指定します。
-a
応答待ちイベント滞留ファイルを採取しない場合に指定します。
-s
JP1/IM - Manager(JP1/IM - Central Scope)の保守資料を採取しない場合に指定します。
-c
IM構成管理の保守資料を採取しない場合に指定します。
-d
IMデータベースの保守資料を採取しない場合に指定します。
-x
IMデータベースのバックアップファイルを採取する場合に指定します。
IMデータベースのバックアップファイルは,デフォルトで採取するIMデータベースの保守資料には含まれていません。IMデータベースサービスが起動していない場合は,保守資料を採取しません。IMデータベースサービスを起動したあと,資料採取コマンドを再実行してください。なお,資料採取時にJP1/IM-Managerが起動していても採取できます。
-q
ユーザー確認を省略してコマンドを実行する場合に指定します。
ディレクトリ名またはファイル名
資料採取ツールで任意のファイルまたはディレクトリを採取したいときに指定します。フルパス名で指定してください。複数指定する場合は,スペースで区切ってください。
なお,このオプションは,指定したいほかのオプションをすべて指定したあとに指定してください。採取した資料は物理ホストの一次資料に格納されます。
注意事項
- このツールによって採取できる資料の総容量は膨大になるため,このツールを実行する前に必要容量を見積もり,ご使用のマシンの空き容量を確認する必要があります。詳細については,マニュアル「JP1/Integrated Management - Manager 運用ガイド」の「10.4 資料の採取方法」を参照してください。
- このツールを複数同時に実行しないでください。資料が上書きされたり,採取できなかったりする場合があります。
戻り値
0 正常終了 8 異常終了
使用例1
/tmp/jp1logに物理ホストの資料と論理ホストhostAの資料を採取する場合
jim_log.sh -f /tmp/jp1log -h hostA出力結果は次のようになります。
KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_jp1_default). The directory will be created. KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_hostA). The directory will be created. KAVB8926-I Data acquisition processing will start. KAVB8921-I The physical host's first material will be acquired. KAVB8922-I The physical host's first material has been acquired. KAVB8921-I The physical host's second material will be acquired. KAVB8922-I The physical host's second material has been acquired. KAVB8921-I The logical host(hostA)'s first material will be acquired. KAVB8922-I The logical host(hostA)'s first material has been acquired. KAVB8921-I The logical host(hostA)'s second material will be acquired. KAVB8922-I The logical host(hostA)'s second material has been acquired. KAVB8918-I The data was successfully acquired.
使用例2
存在しない/tmp/jp1log/に物理ホストの資料を採取するが,存在する論理ホストhostAを指定しなかった場合
jim_log.sh -f /tmp/jp1log出力結果は次のようになります。
KAVB8925-I The directory does not exist. (/tmp/jp1log). The directory will be created. KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_jp1_default). The directory will be created. KAVB8926-I Data acquisition processing will start. KAVB8921-I The physical host's first material will be acquired. KAVB8922-I The physical host's first material has been acquired. KAVB8921-I The physical host's second material will be acquired. KAVB8922-I The physical host's second material has been acquired. KAVB8918-I The data was successfully acquired. KAVB8935-I The following logical host(s) exist on this machine: hostA To acquire information about a logical host, execute "jim_log.sh -f output-directory-name -h logical-hostname".
使用例3
jp1_default_imm_1st.tar.Zおよびjp1_default_imm_2nd.tar.Zファイルが存在する/tmp/jp1log/に物理ホストの資料を採取するが,存在する論理ホストhostAを指定しなかった場合
jim_log.sh -f /tmp/jp1log出力結果は次のようになります(すべて「y」と入力した場合)。
KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_jp1_default). The directory will be created. KAVB8926-I Data acquisition processing will start. KAVB8921-I The physical host's first material will be acquired. KAVB8922-I The physical host's first material has been acquired. KAVB8921-I The physical host's second material will be acquired. KAVB8944-I (/tmp/jp1log/jp1_default_imm_2nd.tar.Z) already exists. Do you want to overwrite it? [yes/no]y KAVB8922-I The physical host's second material has been acquired. KAVB8918-I The data was successfully acquired. KAVB8944-I (/tmp/jp1log/jp1_default_imm_1st.tar.Z) already exists. Do you want to overwrite it? [yes/no]y KAVB8935-I The following logical host(s) exist on this machine: hostA To acquire information about a logical host, execute "jim_log.sh -f output-directory-name -h logical-hostname".
All Rights Reserved. Copyright (C) 2009, 2011, Hitachi, Ltd.