6.4.9 クライアント側で発生した障害情報の取得

DocumentBrokerの運用中に障害が発生した場合,障害の種類を切り分けたり障害の原因を究明したりするために,トレースなどのトラブルシュート情報を取得する必要があります。

クライアント側で発生した障害に関する障害情報を取得するには,クライアント側の障害情報取得コマンド(EDMGetRasCL)を使用できます。このコマンドを使用すると,必要なトラブルシュート情報を指定したディレクトリに退避できます。

ここでは,クライアント側の障害情報取得コマンド(EDMGetRasCL)を実行して取得できる障害情報の種類,構成および取得情報のカスタマイズ方法について説明します。

Java クラスライブラリが出力するトレースファイルは取得の対象ではありません。

<この項の構成>
(1) 取得できる障害情報の種類
(2) 障害情報が出力されるファイル
(3) 取得する障害情報のカスタマイズ(getrascustom.ini)

(1) 取得できる障害情報の種類

クライアント側の障害情報取得コマンド(EDMGetRasCL)で取得できる障害情報について,次に示します。

なお,これらの情報のうち,どの情報を取得するかは,クライアント側の障害情報取得コマンド(EDMGetRasCL)実行時にオプションとして指定する収集種別によって指定できます。

(2) 障害情報が出力されるファイル

障害情報は,コマンド実行時にオプションとして指定した出力先ディレクトリ下に作成される,次のファイルに出力されます。

ファイル名の文字列の意味は次のとおりです。

<ホスト名>
コマンドを実行したホスト名(最大64バイト)を表す文字列です。
<YYYYMMDDhhmmss>
コマンドを実行した時刻を表す文字列です。
YYYY:西暦年号(4けた),MM:月(2けた),DD:日(2けた),hh:時(2けた),mm:分(2けた),ss:秒(2けた)で構成されます。

(3) 取得する障害情報のカスタマイズ(getrascustom.ini

取得する障害情報の種類をカスタマイズする場合は,クライアントの障害情報取得カスタマイズファイル(getrascustom.ini)を編集します。このファイルは,次のディレクトリに格納されています。

getrascustom.iniの格納ディレクトリ(クライアント側)

/opt/HiEDMS/client/etc

このファイルの記述内容については,サーバ側の障害情報の取得コマンドで使用するgetrascustom.iniと同じです。詳細については,「6.4.8(3) 取得する障害情報のカスタマイズ(getrascustom.ini)」を参照してください。

なお,クライアント側の障害情報の取得コマンド(EDMGetRasCL)で参照されるgetrascustom.iniを編集する場合,次の手順で編集してください。

  1. getrascustom.iniをローカルディレクトリにコピーします。
  2. コピーしたgetrascustom.iniを編集して保存します。
  3. 編集が完了したgetrascustom.iniを格納したディレクトリのフルパスを,環境変数「_HIEDMS_GETRAS_INI」として設定します。
    文書空間で使用する文字コード種別がUTF-8の場合は,印刷可能なASCIIコードで値を設定してください。