uCosminexus DocumentBroker Version 3 システム導入・運用ガイド
![[目次]](figure/content.gif)
![[用語]](figure/gloss.gif)
![[索引]](figure/index.gif)
![[前へ]](figure/front.gif)
EDMGetRas(サーバ側の障害情報の取得)
機能
DocumentBrokerで障害が発生した場合に,障害調査に必要な情報を取得します。なお,このコマンドで取得できるのは,サーバ側の情報です。
このコマンドを実行して取得できる情報(ファイル)は,次のとおりです。
- 環境変数「DOCBROKERDIR」で指定したディレクトリ\spool下の全ファイル
- 環境変数「DOCBROKERDIR」で指定したディレクトリ\etc下の全ファイル
- 環境変数「DOCBROKERDIR」で指定したディレクトリ\tmp下の全ファイル
- 環境変数「_HIEDMS_TRACE_DIR」で指定したディレクトリ下の全ファイル
- 詳細エラーログファイル
- OS情報
- 環境情報
- イベントログ(Application.log,System.log)
- TPBrokerのトレース(環境変数「VBROKER_ADM」で指定したディレクトリ\..\log下の全ファイル)
- getrascustom.iniの[Path]セクションで指定されたファイル
- DocumentBroker Serverのバージョン情報
それぞれの情報の詳細については,「6.4.8 サーバ側で発生した障害情報の取得」を参照してください。
形式
EDMGetRas -d 出力先ディレクトリ名
〔-l 収集種別 〕
〔-s 開始時刻 〕
オプション
- -d 出力先ディレクトリ名
- 障害情報の出力先ディレクトリ名をフルパスで指定します。このコマンドで収集した障害情報を,指定したディレクトリに出力します。
- 出力先ディレクトリの名称は任意です。また,このコマンドを実行するユーザに対して,出力先ディレクトリにフルコントロールの権限を設定してください。
- 出力先ディレクトリとして,収集対象となるディレクトリの下位のディレクトリ(例えば,環境変数「DOCBROKERDIR」で指定したディレクトリ\spool\mytmp)を指定しないでください。
- -l 収集種別
- 収集する障害情報の種別を1〜3で指定します。指定が省略された場合には,収集種別1で動作します。
- 収集種別ごとに取得できる情報の種類について,次の表に示します。なお,それぞれの情報の詳細については,「6.4.8 サーバ側で発生した障害情報の取得」を参照してください。
表7-11 EDMGetRasコマンドで収集種別ごとに取得できる情報の種類
| 収集種別 |
取得できる情報 |
| 1 |
環境変数「DOCBROKERDIR」で指定したディレクトリ\spool下の全ファイル
環境変数「DOCBROKERDIR」で指定したディレクトリ\etc下の全ファイル
環境変数「DOCBROKERDIR」で指定したディレクトリ\tmp下の全ファイル
環境変数「_HIEDMS_TRACE_DIR」で指定したディレクトリ下の全ファイル※1
詳細エラーログファイル※1
OS情報
環境情報
イベントログ(Application.log,System.log)
TPBrokerのトレース(環境変数「VBROKER_ADM」で指定したディレクトリ\..\log下の全ファイル)※1
getrascustom.ini※2の[Path]セクションで指定されたファイル
DocumentBroker Serverのバージョン情報 |
| 2 |
環境変数「DOCBROKERDIR」で指定したディレクトリ\spool下の全ファイル
環境変数「_HIEDMS_TRACE_DIR」で指定したディレクトリ下の全ファイル※1
詳細エラーログファイル※1
イベントログ(Application.log,System.log)
TPBrokerのトレース(環境変数「VBROKER_ADM」で指定したディレクトリ\..\log下の全ファイル)※1
getrascustom.ini※2の[Path]セクションで指定されたファイル
DocumentBroker Serverのバージョン情報 |
| 3 |
環境変数「DOCBROKERDIR」で指定したディレクトリ\spool下の全ファイル
環境変数「_HIEDMS_TRACE_DIR」で指定したディレクトリ下の全ファイル※1
詳細エラーログファイル※1
イベントログ(Application.log,System.log)
getrascustom.ini※2の[Path]セクションで指定されたファイル
DocumentBroker Serverのバージョン情報 |
- 注※1
- 環境変数の設定によっては取得できません。詳細については,「6.4.8 サーバ側で発生した障害情報の取得」を参照してください。
- 注※2
- 詳細については,「6.4.8 サーバ側で発生した障害情報の取得」を参照してください。
- -s 開始時刻
- トレースファイルを収集する場合に,指定した時刻からコマンドを実行した時刻までに更新されたファイルだけを収集するときに指定します。
- このオプションが有効になるのは,取得する障害情報のうち,次のファイルです。
- 環境変数「DOCBROKERDIR」で指定したディレクトリ\spool下の全ファイル
- 環境変数「_HIEDMS_TRACE_DIR」で指定したディレクトリ下の全ファイル
- TPBrokerのトレース(環境変数「VBROKER_ADM」で指定したディレクトリ\..\log下の全ファイル)
- 詳細エラーログファイル
- 指定が省略された場合,更新時刻に関係なく,すべてのファイルが収集対象になります。
- 開始時刻は,次の書式で指定してください。
- 開始時刻の書式
"YYYY/MM/DD[△hh:mm]"
- 開始時刻は「"」(引用符)で囲んで指定してください。
- △には,半角の空白を指定します。
- YYYYには,西暦年号を指定します。0001〜9999の範囲の数字を指定してください。
- MMには,月を指定します。01〜12の範囲の数字を指定してください。
- DDには,日を指定します。01〜31の範囲の数字を指定してください。
- hhには,時を指定します。00〜23の範囲の数字を指定してください。
- mmには,分を指定します。00〜59の範囲の数字を指定してください。
- 開始時刻の指定例
- 指定例を次に示します。
例1(省略なし):-s "2000/12/24 10:30"
2000年12月24日10:30AMからコマンドを実行した時刻までに更新されたファイルが対象になります。
例2([△hh:mm]を省略):-s "2000/12/24"
2000年12月24日00:00AMからコマンドを実行した時刻までに更新されたファイルが対象になります。
注意事項
- このコマンドは,DocumentBrokerサーバの停止中または起動中どちらでも実行できます。
- 収集対象となるディレクトリ(環境変数「DOCBROKERDIR」で指定したディレクトリ\spoolなど)が存在しなかったり,アクセス権(コマンド実行者に対する,読み出し,実行権限)がなかった場合には,その処理はスキップされ,以降の処理が続行されます。getrascustom.iniの[Path]セクションに指定した場合も同様です。
All Rights Reserved. Copyright (C) 2006, Hitachi, Ltd.
All Rights Reserved. Copyright (C) 2006, 2013, Hitachi Solutions, Ltd.