Hitachi

JP1 Version 12 JP1/Integrated Management 2 - Manager コマンド・定義ファイル・APIリファレンス


jim_log.sh(UNIX限定)

〈このページの構成〉

機能

JP1/IM - Managerで障害が発生したときに資料を採取するためのツールです。JP1/IM - ManagerおよびJP1/Baseの保守資料,OSのシステム情報,統合トレースログなどを採取します。

このツールは,シェルスクリプトです。ユーザーによるカスタマイズはできません。

このツールを実行すると,資料を採取する対象ディレクトリまたはファイルを一次資料および二次資料に区分けし,指定した資料格納ディレクトリの直下でtarコマンドによってアーカイブしたあと,compressコマンドで圧縮したファイルを作成します。

一次資料は,障害時の切り分けや,軽度の障害の調査を目的に採取する資料です。必要最低限のログおよび設定ファイルを採取します。二次資料は,一次資料ではわからなかった障害をさらに調査するための詳細資料です。core解析情報,JP1/BaseのイベントDBなどを採取します。

systemd-coredumpのcoreファイル出力が有効になっている環境では,このツールの実行時にシステムに保持されているcoreファイル一覧の中から,JP1/IM - Managerのプロセスが出力したcoreファイルについて,採取対象のログファイルディレクトリにcoreファイルを取得します。

また,JP1/IM - Manager(セントラルコンソール)のコアダンプやスレッドダンプがある状態でjim_log.shコマンドを実行すると,メッセージKAVB8941-IまたはKAVB8942-Iを表示してコアダンプまたはスレッドダンプを削除するかどうかユーザーに問い合わせます。「y」または「yes」を入力した場合,コアダンプまたはスレッドダンプを削除します。

なお,このツールを使って採取できる資料の詳細については,マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「11.3 トラブル発生時に採取が必要な資料」を参照してください。

採取した資料を圧縮したファイルを次に示します。

表1‒43 採取した資料を圧縮したファイル

ファイル名

内容

jp1_default_imm_1st.tar.Z

物理ホストの一次資料を格納します。

jp1_default_imm_2nd.tar.Z

物理ホストの二次資料を格納します。

論理ホスト名_imm_1st.tar.Z

論理ホストの一次資料を格納します。

論理ホスト名_imm_2nd.tar.Z

論理ホストの二次資料を格納します。

注※ -hオプションで論理ホストを指定した場合にだけ作成されます。

圧縮されたファイルは,資料格納ディレクトリに格納されます。圧縮された各ファイルの内部ディレクトリ構成を次に示します。

表1‒44 物理ホストの一次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名

格納された資料

./etc/opt/jp1base

JP1/Baseの自動起動および自動終了スクリプト

./etc/opt/jp1base/conf

JP1/Baseの設定および定義ファイル

./etc/opt/jp1base/default

JP1/Baseの共通定義情報

./etc/opt/jp1cons

JP1/IM - Manager(セントラルコンソール)の自動起動および自動終了スクリプト

./etc/opt/jp1cons/conf

JP1/IM - Manager(セントラルコンソール)の設定および定義ファイル

./etc/opt/jp1cons/default

JP1/IM - Manager(セントラルコンソール)の共通定義情報

./etc/opt/jp1imm/conf/tools

JP1/IM - Managerの設定および定義ファイル

./etc/opt/jp1imm/conf/imcf

IM構成管理の設定および定義ファイル

./etc/opt/jp1imm/conf/imdb

IMデータベースの設定および定義ファイル

./etc/opt/jp1imm/conf/imdd

JP1/IM - Manager(インテリジェント統合管理基盤)の設定および定義ファイル

./etc/opt/jp1imm/plugin

JP1/IM - Manager(インテリジェント統合管理基盤)のプラグイン

./var/opt/jp1imm/log/suggestion

JP1/IM - Manager(インテリジェント統合管理基盤)の対処アクション実行履歴ファイル

./etc/opt/jp1imm/default/imcf

IM構成管理の共通定義情報

./etc/opt/jp1scope/conf

JP1/IM - Manager(セントラルスコープ)の設定および定義ファイル

./etc/opt/jp1scope/default

JP1/IM - Manager(セントラルスコープ)の共通定義情報

./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(セントラルコンソール)のログファイル

./var/opt/jp1imm/database/imdb

IMデータベースのログの詳細情報

./var/opt/jp1imm/log/imcf

IM構成管理のログファイル

./var/opt/jp1imm/log/imdb

IMデータベースのログファイル

./var/opt/jp1imm/log/imdd

JP1/IM - Manager(インテリジェント統合管理基盤)のログファイル

./var/opt/jp1imm/log/_jp1_default/oslog

OSのログ情報

./var/opt/jp1imm/log/_jp1_default/operationlog

JP1/IM - Managerの操作ログ

./var/opt/jp1scope/log

JP1/IM - Manager(セントラルスコープ)のログファイル

表1‒45 物理ホストの二次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名

格納された資料

./var/opt/jp1base/log/COMMAND

JP1/Baseのコマンド実行履歴ファイル

./var/opt/jp1base/sys/event/servers/default

JP1/BaseのイベントDB

./var/opt/jp1cons/operation/evgen

JP1/IM - Manager(セントラルコンソール)の相関イベント発行履歴ファイル

./var/opt/jp1cons/operation/comexclude

JP1/IM - Manager(セントラルコンソール)の共通除外履歴ファイルおよび共通除外条件定義履歴ファイル

./var/opt/jp1imm/log/_jp1_default/oslog

OSのログ情報

./var/opt/jp1imm/log/_jp1_default/core

コアファイル

./var/opt/jp1scope/database

JP1/IM - Manager(セントラルスコープ)のDB情報

./var/opt/jp1imm/data/imcf

IM構成管理のデータファイル

./var/opt/jp1imm/database/imdb/imdbbackup.dat

IMデータベースのバックアップファイル

./var/opt/jp1imm/data/imdd

JP1/IM - Manager(インテリジェント統合管理基盤)のデータファイル

./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_ses

JP1/SES互換用ログ

表1‒46 論理ホストの一次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名

格納された資料

./共有ディスク/jp1base/../event

JP1/Baseの論理ホストのイベントサーバ設定

./共有ディスク/jp1base/conf

JP1/Baseの論理ホストの設定および定義ファイル

./共有ディスク/jp1base/log

JP1/Baseの論理ホストのログファイル

./共有ディスク/jp1cons/conf

JP1/IM - Manager(セントラルコンソール)の論理ホストの設定および定義ファイル

./共有ディスク/jp1cons/log

JP1/IM - Manager(セントラルコンソール)の論理ホストのログファイル

./共有ディスク/jp1scope/conf

JP1/IM - Manager(セントラルスコープ)の論理ホストの設定および定義ファイル

./共有ディスク/jp1scope/log

JP1/IM - Manager(セントラルスコープ)の論理ホストのログファイル

./var/opt/jp1imm/log/_論理ホスト名/oslog

OSのログ情報

./var/opt/jp1imm/log/_論理ホスト名/operationlog

JP1/IM - Managerの操作ログ

./共有ディスク/jp1imm/conf/imcf

IM構成管理の設定および定義ファイル

./共有ディスク/jp1imm/conf/imdd

JP1/IM - Manager(インテリジェント統合管理基盤)の設定および定義ファイル

./var/opt/jp1imm/database/imdb

IMデータベースのログの詳細情報

./共有ディスク/jp1imm/log/imcf

IM構成管理のログファイル

./共有ディスク/jp1imm/log/imdd

JP1/IM - Manager(インテリジェント統合管理基盤)のログファイル

./共有ディスク/jp1imm/log/suggestion

JP1/IM - Manager(インテリジェント統合管理基盤)の対処アクション実行履歴ファイル

./var/opt/jp1imm/log/imdb

IMデータベースのログファイル

表1‒47 論理ホストの二次資料の内部ディレクトリ構成

ディレクトリ名・ファイル名

格納された資料

./共有ディスク/event

JP1/Baseの論理ホストのイベントDB

./共有ディスク/jp1base/log/COMMAND

JP1/Baseの論理ホストのコマンド実行履歴ファイル

./共有ディスク/jp1cons/operation/evgen

JP1/IM - Manager(セントラルコンソール)の論理ホストの相関イベント発行履歴ファイル

./共有ディスク/jp1cons/operation/comexclude

JP1/IM - Manager(セントラルコンソール)の論理ホストの共通除外履歴ファイルおよび共通除外条件定義履歴ファイル

./共有ディスク/jp1scope/database

JP1/IM - Manager(セントラルスコープ)の論理ホストのDB情報

./var/opt/jp1imm/log/_論理ホスト名/oslog

OSのログ情報

./var/opt/jp1imm/log/_論理ホスト名/core

コアファイル

./共有ディスク/jp1imm/data/imcf

IM構成管理のデータファイル

./共有ディスク/jp1imm/database/imdb/imdbbackup.dat

IMデータベースのバックアップファイル

./共有ディスク/jp1imm/data/imdd

JP1/IM - Manager(インテリジェント統合管理基盤)のデータファイル

形式

jim_log.sh -f 資料格納ディレクトリ
           [-h 論理ホスト名]
           [-t]
           [-u]
           [-n]
           [-p]
           [-r]
           [-g]
           [-a]
           [-s]
           [-c]
           [-d]
           [-x]
           [-q]
           [-b]
           [ディレクトリ名またはファイル名...]

-aオプションは,BJEXまたはJP1/ASと連携した場合に使用するオプションです。-aオプションの詳細については,マニュアル「JP1/Integrated Management 2 - Manager 運用ガイド」の「10.5.3 jim_log.sh(UNIX限定)」を参照してください。

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1imm/tools/

引数

-f 資料格納ディレクトリ

採取した資料を出力するディレクトリ名またはデバイス名をフルパスまたはルートディレクトリからの相対パス形式で指定します。ディレクトリ名を指定した場合,その下に採取した各資料を格納したファイルが作成されます。パスに空白を含む場合は,「"」で囲んで指定します。このオプションは省略できません。

存在しないディレクトリを指定した場合は,その名称でディレクトリが新規作成されます。すでに存在するディレクトリを指定した場合は,いったんそのディレクトリを削除してから,指定したディレクトリが作成されます。

デバイス名を指定した場合,作成したファイルの数だけデバイスに対して書き込みが発生します。また,テープなどのデバイスファイル名を指定した場合,採取した資料は圧縮されずにデバイスに格納されます。

デバイス名を指定し,かつ-qオプションを指定した場合,ユーザー確認に対しては「yes」を選択したものとして動作するので,あらかじめコマンドを実行する前にデバイスをセットしておく必要があります。

-h 論理ホスト名

クラスタシステムで運用している場合に,論理ホスト名を指定します。このオプションを指定した場合,物理ホストと論理ホストの両方の資料を採取します。このオプションを省略した場合,物理ホストの資料だけ採取します。クラスタシステムを使用していない場合には指定は不要です。

なお,このコマンドでは環境変数JP1_HOSTNAMEの論理ホスト名は使用しません。このため,クラスタシステムで使用する場合には論理ホスト名を必ずこのオプションで指定してください。

-t

hostsservices,およびpasswdファイルを採取しない場合に指定します。

-u

core解析情報を採取しない場合に指定します。core解析情報とは,coreダンプファイルをSeraphツールのcarコマンドで解析して取得したファイルです。

-n

JP1/Baseの保守資料を採取しない場合に指定します。

-p

JP1/BaseのイベントDBを取得しない場合に指定します。

-r

JP1/Baseのコマンド実行履歴ファイルを採取しない場合に指定します。

-g

相関イベント発行履歴ファイルを採取しない場合に指定します。

-a

応答待ちイベント滞留ファイルを採取しない場合に指定します。

-s

JP1/IM - Manager(セントラルスコープ)の保守資料を採取しない場合に指定します。

-c

IM構成管理の保守資料を採取しない場合に指定します。

-d

IMデータベースの保守資料を採取しない場合に指定します。

-xオプションと同時に指定できません。

-x

IMデータベースのバックアップファイルを採取する場合に指定します。

-dオプションと同時に指定できません。

IMデータベースのバックアップファイルは,デフォルトで採取するIMデータベースの保守資料には含まれていません。IMデータベースサービスが起動していない場合は,保守資料を採取しません。IMデータベースサービスを起動したあと,資料採取コマンドを再実行してください。なお,資料採取時にJP1/IM-Managerが起動していても採取できます。

-q

ユーザー確認を省略してコマンドを実行する場合に指定します。

-b

インテリジェント統合管理基盤の保守資料を採取しない場合に指定します。

ディレクトリ名またはファイル名

資料採取ツールで任意のファイルまたはディレクトリを採取したいときに指定します。フルパス名で指定してください。複数指定する場合は,スペースで区切ってください。

なお,このオプションは,指定したいほかのオプションをすべて指定したあとに指定してください。採取した資料は物理ホストの一次資料に格納されます。

注意事項

戻り値

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".