hdsinfoget（反映側障害情報の取得）

〈このページの構成〉

機能

反映側Datareplicatorで障害が発生した場合，障害の原因を調査するために定義情報，及び障害情報を取得します。

UNIX版Datareplicatorだけで使用できるコマンドです。Windows版Datareplicatorでは使用できません。

このコマンドはDatareplicator管理者が実行してください。

hdsinfoget　〔 -n　反映側Datareplicator識別子 〕
　　　　　　　 -e　初期情報出力先ディレクトリ

-n 反映側Datareplicator識別子

取得対象とする反映側Datareplicator識別子を指定します。

このオプションを省略した場合，サーバマシン上のすべての反映側Datareplicator識別子が取得対象となります。

-e 初期情報出力先ディレクトリ

初期情報ファイル（障害原因の切り分けに必要な情報をまとめたファイル）を出力する既存のディレクトリ名を絶対パスで指定します。

指定したディレクトリが存在しない，又は書き込み権限がない場合は，エラーメッセージを出力して処理を打ち切ります。

初期情報出力先ディレクトリには，初期情報ファイルと取得処理結果ログが出力されます。初期情報ファイルはアーカイブファイルであり，複数のファイルが格納されています。それぞれのファイル名を次に示します。

出力ファイル	ファイル名
初期情報ファイル	hdsinfoget_<ホスト名^※1>_init_<年月日時分秒^※2>.tar.gz
取得処理結果ログ	hdsinfoget_comlog_<ホスト名^※1>_<年月日時分秒^※2>

初期情報ファイルに取得される情報を次に示します。

分類		取得する情報	取得の有無
定義情報	Datareplicator定義ファイル	反映システム運用ディレクトリパス情報	○
		反映システム定義ファイル	○
		反映環境定義ファイル	○
		反映定義ファイル	○
		更新情報定義ファイル	×
		二重化定義ファイル	○
		反映抑止対象リストファイル	○
障害情報	Datareplicator運用ファイル	反映情報キューファイル	×
		反映ステータスファイル	△
		反映マスタステータスファイル	△
		未反映情報ファイル	○
		反映エラー情報ファイル	○
		反映トレースファイル	○
		コマンドログファイル	○^※
		SAMファイル	×
		抽出対象外データ格納ファイル	×
		二重化制御ファイル	○
		UXPLログファイル	×
	Datareplicator運用情報	Datareplicatorバージョン情報	○
		hdsstate実行結果	○
		hdsfstate実行結果	○
		hdsfstatfsコマンド実行結果	○
		データ連動対象の表，インデックス定義	×
	OS情報	反映側Datareplicator運用ディレクトリ下のファイルリスト	○
		Datareplicatorインストールディレクトリ下のファイルリスト	○
		プロセスリスト	○
		ipcs -aコマンド実行結果	○
		netstat -nコマンド実行結果	○
		hostsファイル	○
		servicesファイル	○
		inetd情報	○
		syslogファイル	○

（凡例）

○：この情報を取得します。

△：UNIXのキャラクタ型スペシャルファイルである場合は，取得しません。レギュラーファイルの場合だけ取得します。

×：この情報を取得しません。

注※

環境変数hds_command_log_fileの指定によって任意のファイル名が付与されている場合は，この情報を取得しません。

反映側Datareplicator起動時のファイル格納場所を基に情報を取得します。そのため，反映側Datareplicatorが正常に起動していない環境では，このコマンドで情報を取得できません。なお，このコマンド実行時に反映側Datareplicatorが起動している必要はありません。
コマンドを実行するユーザにアクセス権限がないファイルは取得できません。KFRB09275-Wメッセージを出力して，取得はスキップされます。

コマンドの結果は，コマンド実行時のリターンコード，又は取得処理結果ログ中のメッセージで確認できます。リターンコードの意味と対処方法を次に示します。

リターンコード	終了状態	意味と対処方法
0	正常終了	コマンドは正常に終了しました。コンソールや取得処理結果ログに警告メッセージが出力されている場合，一部の情報が取得できていないおそれがあります。メッセージを参照して，個別に取得してください。
8	異常終了	コマンドは異常終了しました。コンソールや取得処理結果ログに出力されたエラーメッセージを参照して，エラーの原因を取り除いてから，コマンドを再度実行するか，個別に取得してください。
12	割り込み（シグナル発生）による終了	割り込み（シグナル発生）によって処理を打ち切りました。

リターンコード

終了状態

意味と対処方法

正常終了

コマンドは正常に終了しました。

コンソールや取得処理結果ログに警告メッセージが出力されている場合，一部の情報が取得できていないおそれがあります。メッセージを参照して，個別に取得してください。

異常終了

コマンドは異常終了しました。

コンソールや取得処理結果ログに出力されたエラーメッセージを参照して，エラーの原因を取り除いてから，コマンドを再度実行するか，個別に取得してください。

割り込み（シグナル発生）による終了

割り込み（シグナル発生）によって処理を打ち切りました。