機能説明
本コマンドは、オブジェクトDBで管理しているネットワーク構成情報について、追加・修正・削除されたノードおよびその日時を出力します。
記述形式
mpchgnodeinf | [-t ADD|MOD|DEL] [-b AUTO_S|AUTO_N|AUTO_I|MAN] [-s 起点日時] [-e 終点日時] [-o filename] [-d domainname] [-h 接続先運用管理サーバのホスト名] |
オプション
追加されたノード情報だけを出力する場合は「ADD」、変更されたノード情報だけを出力する場合は「MOD」、削除されたノード情報だけを出力する場合は「DEL」を指定します。省略した場合、追加・変更・削除すべてのノード情報を出力します。
システム監視機能による追加・変更・削除だけを出力する場合は「AUTO_S」、ノード検出機能による追加・変更・削除だけを出力する場合は「AUTO_N」、インベントリ収集機能による追加・変更・削除だけを出力する場合は「AUTO_I」、手動追加・変更・削除だけを出力する場合は「MAN」を指定します。省略した場合、すべての情報を出力します。
出力の起点となる時刻を指定します。省略した場合、オブジェクトDBに格納されている最古のイベントの受信時刻を起点とします(指定された時刻がDB内に格納されている最古のイベントの受信時刻よりも古かった場合は、その旨と最古に格納されているイベントの受信時刻を表示します)。
時刻の指定は、年(下2桁)、月、日、時、分、秒を入力します。例えば、2010年4月2日午前13時51分00秒の場合、「100402135100」と入力します。
出力の終点となる時刻を指定します。省略した場合、または指定された時刻がDB内に格納されている最新のイベントの受信時刻よりも新しかった場合、その時点までの情報を出力します (指定された時刻が、コマンドの発行された時刻よりも新しい場合でも表示形式に変更はありません)。
時刻の指定は、年(下2桁)、月、日、時、分、秒を入力します。例えば、2010年4月2日午前13時51分00秒の場合、「100402135100」と入力します。
変更ノード情報を出力するファイル名をフルパスまたは相対パスで指定します。出力はCSV形式です。省略した場合、情報を標準出力します。
従来との互換のために残されているオプションです。指定する必要はありません。
本コマンドの接続対象となる運用管理サーバのホスト名を指定します。
本オプションは運用管理クライアントで実行する場合のみ指定可能です。省略した場合は、[Systemwalkerセットアップ]画面の1つ目に定義されている運用管理サーバに接続します。
復帰値
正常終了
異常終了
コマンド格納場所
Windows | Systemwalkerインストールディレクトリ\Mpwalker.dm\bin |
Solaris | /opt/systemwalker/bin |
実行に必要な権限/実行環境
【Windows】
運用管理サーバでは、Administrator権限/DmAdmin権限/DmOperation権限/DmReference権限が必要です。
運用管理クライアントでは、一般ユーザの権限が必要です。
運用管理サーバ/運用管理クライアントで実行可能です。
【Solaris/Linux】
運用管理サーバでは、システム管理者(スーパーユーザ)権限が必要です。
運用管理クライアントでは、一般ユーザの権限が必要です。
運用管理サーバ/運用管理クライアントで実行可能です。
注意事項
本コマンドはオブジェクトログ・データベース上に蓄積される変更ノード情報を取得しています。オブジェクトログ・データベースはサイクリックに利用されているため、古いデータが上書きされることで変更ノード情報が残っていない場合、すべての履歴が表示されませんのでご注意ください。
使用例
2010年1月1日午前0時から2010年2月1日午前0時までの変更ノード情報を出力します。
【Windows】
mpchgnodeinf -s 100101000000 -e 110201000000 -o D:\tmp\Mpchgnodeinf.csv
【Solaris/Linux】
mpchgnodeinf -s 100101000000 -e 100201000000 -o /var/tmp/Mpchgnodeinf.csv
実行結果/出力形式
追加されたノード情報としては、ホスト名およびIPアドレスを出力します。ただし、IPアドレスが設定されてない場合、IPアドレスは出力されません。
変更されたノード情報としては、変更された情報だけを出力します。変更後の情報が左、変更前の情報が右(標準出力の場合は括弧内に表記)に出力します。ホスト名だけが変更された場合、IPアドレスは出力されません。IPアドレスだけが変更された場合ホスト名は出力されません。
削除されたノード情報としては、ホスト名およびIPアドレスを出力します。
ホスト名は16文字を超える場合、標準出力時には16文字ごとに折り返して出力します。CSV 出力時には折り返しません。
CSV出力では、各列に以下の情報が出力されます。
1列目 | 2列目 | 3列目 | 4列目 | 5列目 | 6列目 | 7列目 | 8列目 |
|---|---|---|---|---|---|---|---|
日付 | 時刻 | 操作名 | 操作手段 | IPアドレス(後) | ホスト名(後) | IPアドレス(前) | ホスト名(前) |
追加されたノードのホスト名は6列目、IPアドレスは5列目に出力されます(IPアドレスが設定されていない場合、5列目は出力されません)。変更されたノードのホスト名は、変更後が6列目、変更前が8列目に出力され(ホスト名が変更されていない場合、6,8列目は出力されません)、IPアドレスは変更後が5列目、変更前が7列目に出力されます(IPアドレスが変更されてない場合、5,7列目は出力されません)。削除されたノードのホスト名は6列目、IPアドレスは5列目に出力されます。
操作手段(4列目)にはノードの追加・変更・削除の手段が以下のように出力されます。
CSVに出力される情報 | ノードの追加・変更・削除を行った機能 |
|---|---|
AUTO_SystemMonitoring | システム監視機能 |
AUTO_NodeDiscovery | ノード検出機能 |
AUTO_Inventory | インベントリ収集機能 |
MANUAL | 手動 |
起点時刻の指定が DB 内で最古のイベントよりも古かった場合 (標準出力)
[WARNING] Directed Starting date and time is older than oldest information in the Database. ================================================================================================================= DATE TIME OPERATION METHOD IP_ADDRESS HOSTNAME IP_ADDRESS(PRE) HOSTNAME(PRE) ================================================================================================================= 2009 09 24 09:57:17 ADD MANUAL 10.10.10.19 saki 2009 09 24 12:03:15 ADD AUTO_SystemMonitoring 10.10.11.50 hedgehog 2009 09 25 08:43:00 ADD AUTO_SystemMonitoring 10.34.10.158 ms-06f 2009 10 06 15:54:11 ADD AUTO_NodeDiscovery 10.34.10.112 kawakawa
その他の場合 (標準出力)
================================================================================================================= DATE TIME OPERATION METHOD IP_ADDRESS HOSTNAME IP_ADDRESS(PRE) HOSTNAME(PRE) ================================================================================================================= 2009 09 24 09:57:17 ADD MANUAL 10.10.10.19 saki 2009 09 24 12:03:15 ADD AUTO_SystemMonitoring 10.10.11.50 hedgehog 2009 09 25 08:43:00 ADD AUTO_SystemMonitoring 10.10.10.158 ms-06f 2009 10 06 15:54:11 ADD AUTO_NodeDiscovery 10.10.10.112 kawakawa
起点時刻の指定が DB 内で最古のイベントよりも古かった場合 (CSV 出力)
[WARNING] Directed Starting date and time is older than oldest information in the Database. "2009/09/24","09:58:06","MODIFY","AUTO_SystemMonitoring","","saki.air.yk.fujitsu.co.jp","","saki" "2009/09/24","09:57:17","ADD","MANUAL","10.10.10.19","saki","","" "2009/09/24","12:03:15","ADD","AUTO_SystemMonitoring","10.10.11.50","hedgehog","","" "2009/09/25","08:43:00","ADD","AUTO_SystemMonitoring","10.10.10.158","ms-06f","","" "2009/09/30","19:31:40","MODIFY","MANUAL","","saki","","saki.air.yk.fujitsu.co.jp" "2009/10/06","15:54:11","ADD","AUTO_NodeDiscovery","10.10.10.112","kawakawa","",""
その他の場合 (CSV 出力)
"2009/09/24","09:58:06","MODIFY","AUTO_SystemMonitoring","","saki.air.yk.fujitsu.co.jp","","saki" "2009/09/24","09:57:17","ADD","MANUAL","10.10.10.19","saki","","" "2009/09/24","12:03:15","ADD","AUTO_SystemMonitoring","10.10.11.50","hedgehog","",""
メッセージ
Usage、無効なオプション（-t, -b, -s, -e, -o 以外）の指定
Usage: mpchgnodeinf [-t ADD|MOD|DEL] [-b AUTO_S|AUTO_N|AUTO_I|MAN] [-s sss] [-e eee] [-o filename] [-d domainname]
Options:
-t ADD|MOD|DEL Operation to output
-b AUTO_S|AUTO_N|AUTO_I|MAN Operation method to output
-s starttime time (date) of start insearch. [Form: YYMMDDhhmmss]
-e endtime time (date) of end insearch. [Form:YYMMDDhhmmss]
-o filename output target file name.
-d domainname target domain name.入力値違反 (追加・変更・削除指定)
mpchgnodeinf: ERROR: Invalid direction. Direct ADD|MOD|DEL.
入力値違反 (自動・手動)
mpchgnodeinf : ERROR: Invalid direction. Direct AUTO_S|AUTO_N|AUTO_I|MAN.
入力値違反 (起点日時)
mpchgnodeinf: ERROR: Invalid start date and time.
入力値違反 (終点日時)
mpchgnodeinf : ERROR: Invalid end date and time.
入力値違反 (起点時刻と終点時刻の逆転)
mpchgnodeinf : ERROR: Invalid order of start and end.
内部エラー (通信エラー)
mpchgnodeinf : ERROR: Communication was failed. [*1] [*2]
*1, *2 : CORBA 通信詳細コード
内部エラー (DB 検索失敗)
mpchgnodeinf : ERROR: DB Query was failed.
内部エラー (出力ファイル書き込み失敗)
mpchgnodeinf: ERROR: File open was failed.
内部エラー (内部処理失敗)
mpchgnodeinf : ERROR: Internal execution was failed. [*3] [*4]
*3, *4 : 内部エラー詳細コード