EDMGetRas(サーバ側の障害情報の取得)
機能
DocumentBrokerで障害が発生した場合に,障害調査に必要な情報を取得します。なお,このコマンドで取得できるのは,サーバ側の情報です。
このコマンドを実行して取得できる情報(ファイル)は,次のとおりです。
- $DOCBROKERDIR/spool下の全ファイル
- $DOCBROKERDIR/etc下の全ファイル
- $DOCBROKERDIR/tmp下の全ファイル
- $_HIEDMS_TRACE_DIR下の全ファイル
- 詳細エラーログファイル
- OS情報
- 環境情報
- TPBrokerのトレース($VBROKER_ADM/../log下の全ファイル)
- getrascustom.iniの[Path]セクションで指定されたファイル
- DocumentBroker Serverのバージョン情報
それぞれの情報の詳細については,「6.4.8 サーバ側で発生した障害情報の取得」を参照してください。
形式
EDMGetRas -d 出力先ディレクトリ名
〔-l 収集種別 〕
〔-s 開始時刻 〕
オプション
- -d 出力先ディレクトリ名
- 障害情報の出力先ディレクトリ名をフルパスで指定します。このコマンドで収集した障害情報を,指定したディレクトリに出力します。
- 出力先ディレクトリの名称は任意です。このコマンドを実行するユーザが,作成するディレクトリに対して読み取り,書き込み,および検索を実行できるように権限を設定してください。
- 出力先ディレクトリとして,収集対象となるディレクトリの下位のディレクトリを指定しないでください。
- -l 収集種別
- 収集する障害情報の種別を1~3で指定します。指定が省略された場合には,収集種別1で動作します。
- 収集種別ごとに取得できる情報の種類について,次の表に示します。なお,それぞれの情報の詳細については,「6.4.8 サーバ側で発生した障害情報の取得」を参照してください。
表7-7 EDMGetRasコマンドで収集種別ごとに取得できる情報の種類
収集種別 | 取得できる情報 |
---|
1 | $DOCBROKERDIR/spool下の全ファイル $DOCBROKERDIR/etc下の全ファイル $DOCBROKERDIR/tmp下の全ファイル $_HIEDMS_TRACE_DIR下の全ファイル※1 詳細エラーログファイル※1 OS情報 環境情報 TPBrokerのトレース($VBROKER_ADM/../log下の全ファイル)※1 getrascustom.ini※2の[Path]セクションで指定されたファイル DocumentBroker Serverのバージョン情報 |
2 | $DOCBROKERDIR/spool下の全ファイル $_HIEDMS_TRACE_DIR下の全ファイル※1 詳細エラーログファイル※1 TPBrokerのトレース($VBROKER_ADM/../log下の全ファイル)※1 getrascustom.ini※2の[Path]セクションで指定されたファイル DocumentBroker Serverのバージョン情報 |
3 | $DOCBROKERDIR/spool下の全ファイル $_HIEDMS_TRACE_DIR下の全ファイル※1 詳細エラーログファイル※1 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」に指定してください。
- このコマンドは,DocumentBrokerサーバの停止中または起動中どちらでも実行できます。
- 収集対象となるディレクトリ($DOCBROKERDIR/spoolなど)が存在しなかったり,アクセス権(コマンド実行者に対する,読み出し,実行権限)がなかった場合には,その処理はスキップされ,以降の処理が続行されます。getrascustom.iniの[Path]セクションに指定した場合も同様です。