目 次 目 次... 2 商 標 および 著 作 権... 3 ご 注 意 概 要 ご 使 用 前 に インストール esmamsetコマンド 使 用 方 法 戻 り 値 esmsysr

Transcription

1 ESMPRO/ServerAgent for VMware ESMPRO/ServerAgent(Linux 版 ) Ver.4.4 コンフィグレーションツールガイド 第 章 概 要 第 2 章 ご 使 用 前 に 第 3 章 インストール 第 4 章 esmamsetコマンド 第 5 章 esmsysrepコマンド SA44_J-TG-L NEC Corporation 20

2 目 次 目 次... 2 商 標 および 著 作 権... 3 ご 注 意 概 要 ご 使 用 前 に インストール esmamsetコマンド 使 用 方 法 戻 り 値 esmsysrepコマンド 使 用 方 法 戻 り 値 エラーメッセージ

3 商 標 および 著 作 権 本 ソフトウェアの 著 作 権 は 日 本 電 気 株 式 会 社 が 有 しています * ESMPRO は 日 本 電 気 株 式 会 社 の 登 録 商 標 です * Linux は Linus Torvalds 氏 の 米 国 およびその 他 の 国 における 商 標 または 登 録 商 標 です * VMware VMware ロゴは VMware,Inc.の 米 国 および 各 国 での 商 標 または 登 録 商 標 です * その 他 記 載 されている 会 社 名 製 品 名 は 各 社 の 商 標 または 登 録 商 標 です サンプルアプリケーションで 使 用 している 名 称 は すべて 架 空 のものです 実 在 する 品 名 団 体 名 個 人 名 とは 一 切 関 係 ありません ご 注 意 () 本 書 の 内 容 の 一 部 または 全 部 を 無 断 転 載 することは 禁 止 されています (2) 本 書 の 内 容 に 関 しては 将 来 予 告 なしに 変 更 することがあります (3) NEC の 許 可 なく 複 製 改 変 などを 行 うことはできません (4) 本 書 の 内 容 は 万 全 を 期 して 作 成 いたしましたが 万 一 ご 不 審 な 点 誤 りおよび 記 載 もれなどお 気 づきのことがありま したら ご 連 絡 ください (5) 運 用 した 結 果 の 影 響 については (4) 項 にかかわらず 責 任 を 負 いかねますのでご 了 承 ください 3

4 . 概 要 本 コンフィグレーションツール( 以 降 本 ツールと 表 記 )では 以 下 のコマンドを 提 供 します esmamset コマンド コマンドラインインターフェースを 使 用 して ESMPRO/ServerAgent が 使 用 するラック 名 や 通 報 関 連 の 情 報 を 設 定 します esmamset コマンドでは 以 下 を 設 定 できます () ラック 名 の 設 定 (ラックマウント 機 種 のみ) (2) SNMP コミュニティ 名 の 設 定 (3) 通 報 手 段 (SNMP)の 有 効 / 無 効 設 定 (4) 通 報 手 段 (SNMP)の 通 報 先 IP アドレスの 追 加 または 削 除 (5) 通 報 手 段 (TCP_IP IN-BAND)の 有 効 / 無 効 設 定 (6) 通 報 手 段 (TCP_IP IN-BAND)の IP アドレスの 追 加 または 削 除 (7) 通 報 手 段 (TCP_IP IN-BAND)で 使 用 するポート 番 号 の 設 定 (8) ESMPRO/ServerAgent からのシステムシャットダウン 有 効 / 無 効 の 設 定 esmsysrep コマンド コマンドラインインターフェースを 使 用 して ESMPRO/ServerAgent が 監 視 する Syslog 監 視 対 象 イベントを 設 定 し ます esmsysrep コマンドでは 以 下 を 設 定 できます () Syslog 監 視 対 象 イベントの 追 加 (2) Syslog 監 視 対 象 イベントの 変 更 (3) Syslog 監 視 対 象 イベントの 削 除 4

5 2. ご 使 用 前 に () 本 ツールを 使 用 するには ESMPRO/ServerAgent Ver4.4 以 降 が 動 作 している 必 要 があります 必 ず ESMPRO/ServerAgent Ver4.4 以 降 をインストールして 動 作 させてください (2) 本 ツールを 使 用 するには root 権 限 が 必 要 です 必 ず root 権 限 のあるユーザーでログインしてください (3) 本 ツールは 複 数 同 時 に 使 用 することはできません また ESMPRO/ServerAgent のコントロールパネル(ESMagntconf, ESMamsadm)も 起 動 しないでください (4) 本 ツールの 設 定 を ESMPRO/ServerAgent に 反 映 するため 以 下 のどちらかを 実 行 してください 以 下 のコマンドを 実 行 して ESMPRO/ServerAgent 関 連 サービスを 再 起 動 します # /opt/nec/esmpro_sa/bin/esmrestart 以 下 のコマンドを 実 行 して システムを 再 起 動 します # reboot 5

6 3. インストール () ダウンロードした esmpro_cfg_lnx.tgz を 設 定 するサーバの 任 意 のディレクトリに 格 納 します (2) esmpro_cfg_lnx.tgz を 格 納 したディレクトリに 移 動 し 展 開 します # cd ( 格 納 したディレクトリ) # tar -xzvf esmpro_cfg_lnx.tgz 以 下 のファイルが 展 開 されます MD5 チェックサム ファイル 名 備 考 6c4a08f3cdb9b6f6407e028cd2f674a x86/esmamset 32bit 用 77a88095e82630daf7450acdb5d6c73e x86/esmsysrep 32bit 用 b6980cea0e5b967063d7e6caaaf89 x86_64/esmamset 64bit 用 c075c9879c7a5a7e d25ecccf x86_64/esmsysrep 64bit 用 (3) サーバのアーキテクチャにあわせて x86 または x86_64 ディレクトリ 配 下 のコマンドを 使 用 してください 本 ツールが 不 要 となったときは ダウンロードしたファイル および 展 開 したファイルは 削 除 してください 6

7 4. esmamsetコマンド 4.. 使 用 方 法 esmamset コマンドの 使 用 方 法 は 以 下 のとおりです #./esmamset [OPTION] Usage: esmamset [-r <rackname>] [-c <community>] [-s ON OFF] [-d <delip ALLIP >] [-a <addip >] [-t ON OFF] [-i <ip>] [-p <port>] [-o ON OFF] [-f <filename>] [-h] [OPTION] 指 定 [OPTION] には 以 下 のオプションを 指 定 します 複 数 のオプションを 同 時 に 指 定 することもできます オプション -r <rackname> ラック 名 を 設 定 します -c <community> コミュニティ 名 を 設 定 します snmpd.conf に 設 定 されていないコミュニティ 名 を 指 定 したときは 設 定 は 変 更 され ませんので 先 に snmpd.conf を 修 正 してください -s ON OFF 通 報 手 段 (SNMP)の 有 効 / 無 効 を 設 定 します ON OFF : 有 効 : 無 効 -d <delip...> 通 報 手 段 (SNMP)に 指 定 されている 通 報 先 IP アドレスを 削 除 します 半 角 スペースを 空 けて 2 つ 以 上 の IP アドレスを 同 時 に 削 除 することもできます -d <ALLIP> 通 報 手 段 (SNMP)に 指 定 されている 通 報 先 IP アドレスを 全 て 削 除 します -a <addip...> 通 報 手 段 (SNMP)に 指 定 されている 通 報 先 IP アドレスを 追 加 します 半 角 スペースを 空 けて 2 つ 以 上 の IP アドレスを 同 時 に 追 加 することもできます -t ON OFF 通 報 手 段 (TCP_IP IN-BAND)の 有 効 / 無 効 を 設 定 します ON OFF : 有 効 : 無 効 -i <ip> 通 報 手 段 (TCP_IP IN-BAND)の 通 報 先 IP アドレスを 指 定 します -p <port> 通 報 手 段 (TCP_IP IN-BAND)で 使 用 するポート 番 号 を 指 定 します -o ON OFF ESMPRO/ServerAgent からのシステムシャットダウンの 有 効 / 無 効 を 設 定 します 7

8 オプション ON OFF : 有 効 : 無 効 -f <filename> 配 置 ファイルを 指 定 して 読 み 込 み ファイルに 記 載 の 内 容 に 従 って 各 種 設 定 をしま す 配 置 ファイルについては 後 述 します 配 置 ファイルを 読 み 込 めた 時 点 で 成 功 と 判 断 するため 配 置 ファイル 内 で 指 定 され たオプションが 不 正 であっても 戻 り 値 は 0 ( 成 功 )を 返 却 します -h ヘルプ (Usage:)を 表 示 します 配 置 ファイル [OPTION]で 指 定 する 内 容 が 記 載 されたテキストファイルのことを 指 します 配 置 ファイルを -f オプションで 指 定 し て 読 み 込 むことで [OPTION]を 指 定 したときと 同 じことができます 配 置 ファイルは keyname "value" の 形 式 で 記 載 します keyname と ダブルクォート(")の 間 には 空 白 (スペースかタブ)を 入 れてください また 改 行 コードが Linux 改 行 コード(LF)となるように 注 意 してください Windows 改 行 コード(CR+LF)で 保 存 され たテキストファイルのときは 配 置 ファイルの 内 容 を 正 しく 読 み 込 むことができません keyname の については 下 表 を 参 照 してください keyname( 大 文 字 ) RACKNAME COMMUNITY SNMP DELIP ADDIP IN-BAND IN-BANDIP IN-BANDPORT SHUTDOWN -r オプションで 指 定 する 内 容 と 同 じです -c オプションで 指 定 する 内 容 と 同 じです -s オプションで 指 定 する 内 容 と 同 じです -d オプションで 指 定 する 内 容 と 同 じです -a オプションで 指 定 する 内 容 と 同 じです -t オプションで 指 定 する 内 容 と 同 じです -i オプションで 指 定 する 内 容 と 同 じです -p オプションで 指 定 する 内 容 と 同 じです -o オプションで 指 定 する 内 容 と 同 じです 4.2. 戻 り 値 esmamset コマンドの 戻 り 値 は 以 下 のとおりです エラーメッセージはコンソールに 表 示 しません 戻 り 値 0 設 定 に 成 功 しました 設 定 に 失 敗 しました 指 定 されているオプションの 内 容 を 確 認 してください 2 設 定 に 失 敗 しました ESMPRO/ServerAgent をインストールしてください 4 設 定 に 失 敗 しました ログインしているユーザーにコマンドの 実 行 権 限 がありません 8

9 5. esmsysrepコマンド 5.. 使 用 方 法 esmsysrep コマンドの 使 用 方 法 は 以 下 のとおりです #./esmsysrep [ACTION] [SOURCE] [EVENT] [OPTION] Usage: esmsysrep --add -S <sourcename> -E <eventid> -K <keyword> [OPTION]... esmsysrep --mod -S <sourcename> -E <eventid> [-K <keyword>] [OPTION]... esmsysrep --del -S <sourcename> -E <eventid> esmsysrep --help Action-selection option and specification: --help --add --mod --del Show this help message Add an event id Change the configuration of event id Delete an event id Common option and specification: -S <sourcename> Specify the source name -E <eventid> Specify the event id -K,- <keyword> Specify the first keyword, and the argument of -K will be used if - and -K are both specified. It can t be omitted when --add is specified. Other options(defaults in [ ] will be used if the options are not specified in --add): -2 <keyword2> Specify the second keyword. [ ] -3 <keyword3> Specify the third keyword. [ ] -s <ON OFF> Set ON/OFF of the SNMP report method. [ ON ] -i <ON OFF> Set ON/OFF of the TCP/IP IN-BAND report method. [ OFF] -o <ON OFF> Set ON/OFF of the TCP/IP OUT-OF-BAND report method. [ OFF] -t <trapname> Set the trap name. [ ] -d <dealmethod> Set the deal method. [ ] -w <watchtime> Set the watch time. [ 0-24 ] -c <reportcount> Set the report count. [ ] -r <NONE SHUTDOWN REBOOT> Set the action after a report. [ NONE ] 9

10 コマンド 使 用 例 #./esmsysrep --add -S TESTSOURCE -E K test234 -t "テスト 通 報 " 上 記 の 例 では ソース 名 "TESTSOURCE"に " "のイベント ID を 新 規 追 加 します ESMPRO/ServerAgent 関 連 サービスまたは システムの 再 起 動 後 syslog(/var/log/messages)に 文 字 列 "test234"が 記 録 されると Syslog 監 視 機 能 にて 検 出 し イベント ID: を SNMP で 通 報 します アラートビューアで 表 示 するトラップ 名 は"テスト 通 報 "となります [ACTION] 指 定 [ACTION] には 以 下 のオプションを 指 定 します 省 略 することはできません また 複 数 のオプションを 同 時 に 指 定 することはできません オプション --add --mod --del --help Syslog 監 視 イベントを 追 加 します 既 存 の Syslog 監 視 イベントを 変 更 します Syslog 監 視 イベントを 削 除 します ヘルプ (Usage:)を 表 示 します [SOURCE] 指 定 [SOURCE] には 以 下 のオプションを 指 定 します 省 略 することはできません オプション -S <sourcename> [ACTION]の 対 象 となるソース 名 を 半 角 英 数 字 の 大 文 字 で 指 定 します [EVENT] 指 定 [EVENT] には 以 下 のオプションを 指 定 します 省 略 することはできません オプション -E <eventid> [ACTION]の 対 象 となるイベント ID を 6 進 数 (0~F)の 8 桁 で 指 定 します イベント ID の 上 4 桁 は 状 態 を 表 しますので 任 意 に 指 定 できるのは 下 4 桁 です C000nnnn 異 常 通 報 ( 赤 色 ) 8000nnnn 警 告 通 報 ( 黄 色 ) 4000nnnn 正 常 通 報 ( 緑 色 ) [OPTION] 指 定 [OPTION] には 以 下 のオプションを 指 定 します 複 数 のオプションを 同 時 に 指 定 することもできます オプション -K <keyword> - <keyword> keyword を 設 定 します 256 バイト 以 内 の バイト 文 字 を 使 用 します -K と- を 同 時 に 指 定 したときは -K の 内 容 が 設 定 されます [ACTION]が--add のときは 省 略 することができません 0

11 オプション -2 <keyword2> keyword2 を 設 定 します 256 バイト 以 内 の バイト 文 字 を 使 用 します [ACTION]が--add のときの 既 定 値 は ""( 空 白 )です -3 <keyword3> keyword3 を 設 定 します 256 バイト 以 内 の バイト 文 字 を 使 用 します [ACTION]が--add のときの 既 定 値 は ""( 空 白 )です -s ON OFF 通 報 手 段 (SNMP)の 有 効 または 無 効 を 設 定 します ON OFF : 有 効 : 無 効 [ACTION]が--add のときの 既 定 値 は "ON"です -i ON OFF 通 報 手 段 (TCP_IP IN-BAND)の 有 効 または 無 効 を 設 定 します ON OFF : 有 効 : 無 効 [ACTION]が--add のときの 既 定 値 は "OFF"です -o ON OFF 通 報 手 段 (TCP_IP OUT-OF-BAND)の 有 効 または 無 効 を 設 定 します ON OFF : 有 効 : 無 効 [ACTION]が--add のときの 既 定 値 は "OFF"です -t <trapname> アラートビューアで 表 示 するトラップ 名 を 設 定 します 79 バイト 以 内 の 文 字 列 で バイトまたは 2 バイト 文 字 が 使 用 できます 日 本 語 も 使 用 することができます [ACTION]が--add のときの 既 定 値 は ""( 空 白 )です -d <dealmethod> アラートビューアで 表 示 する 対 処 を 設 定 します 507 バイト 以 内 の 文 字 列 で バイ トまたは 2 バイト 文 字 が 使 用 できます 日 本 語 も 使 用 することができます [ACTION]が--add のときの 既 定 値 は ""( 空 白 )です -w <watchtime> 監 視 時 間 帯 を 設 定 します 複 数 の 時 間 帯 を 指 定 するときは カンマ(,) 区 切 りで 設 定 し ます [ACTION]が--add のときの 既 定 値 は "0-24"です -c <reportcount> 監 視 時 間 帯 における 通 報 に 必 要 な 該 当 イベントの 発 生 回 数 を ~65535 の 数 字 で 設 定 します [ACTION]が--add のときの 既 定 値 は ""です -r <NONE SHUTDOWN 通 報 後 の 動 作 を 設 定 します <action>は 以 下 のいずれかを 設 定 します NONE : 何 もしない REBOOT> SHUTDOWN : シャットダウン REBOOT : 再 起 動 [ACTION]が--add のときの 既 定 値 は "NONE"です

12 5.2. 戻 り 値 esmsysrep コマンドの 戻 り 値 は 以 下 のとおりです 戻 り 値 が 0 以 外 のときは コンソールにエラーメッセージを 表 示 します 戻 り 値 0 設 定 に 成 功 しました 0 以 外 設 定 に 失 敗 しました 詳 細 はエラーメッセージ( 次 章 )を 参 照 してください 5.3. エラーメッセージ エラーメッセージは 以 下 のとおりです メッセージ 戻 り 値 Only root can execute the tool. プログラム 名 : error while loading shared libraries: ライブラリのパス: cannot open shared object file: No such file or directory parameter error : "オプション 名 " is not specified. parameter error : argument of "オプション 名 " is too long. parameter error : argument of "オプション 名 " is too short. parameter error : argument of "オプション 名 " is invalid. parameter error : option "オプション 名 " requires an argument. parameter error : invalid option "オプション 名 ". parameter error : "オプション 名 ". Can't make all of the keywords empty. Can't access "<sourcename>", which isn't the object source of this tool. ログインしているユーザーに 実 行 権 限 がありま せん ESMPRO/ServerAgent がインストールされてい ません 省 略 不 可 の"オプション 名 "が 指 定 されていませ ん "オプション 名 "に 指 定 したパラメータの 文 字 列 長 が 長 すぎます "オプション 名 "に 指 定 したパラメータの 文 字 列 長 が 短 すぎます "オプション 名 "に 指 定 したパラメータは 無 効 で す "オプション 名 "にパラメータが 指 定 されていま せん "オプション 名 "に 指 定 したオプションは 無 効 で す "オプション 名 "に 指 定 したオプションが 不 正 で す --mod の 設 定 を 反 映 すると キーワード(~3) が すべて""( 空 白 )となります 本 コマンドで 設 定 できないイベント ID が 指 定 さ れました 27 ESMntserver service is not started. ESMntserver が 起 動 していません Other program is accessing the syslog events 他 のプログラム(ESMamsadm など)が syslog 設 2

13 メッセージ 戻 り 値 setting. 定 にアクセスしているため アクセスできませ "<sourcename>/<eventid>" already exists. "<sourcename>/<eventid>" doesn t exist. ん --add で 指 定 したソース 名 /イベント ID は すで に 存 在 しています --mod または -del で 指 定 したソース 名 /イベン ト ID は 存 在 しません Access the "<sourcename>/<eventid>" failed. [ACTION]に 失 敗 しました 3