履歴の収集 › 履歴制御テーブルの設定 › emphistory ユーティリティ -- 履歴制御テーブルでのエントリの管理

emphistory ユーティリティ -- 履歴制御テーブルでのエントリの管理

履歴制御テーブルでエントリのステータスを追加、削除、設定したり、エントリをリストするには、コマンド ラインから emphistory ユーティリティを使用します。 さらに、このユーティリティを（ダンプ操作と共に）使用して、履歴テーブルから格納されたデータ サンプルを取得することもできます。

emphistory ユーティリティは、以下のように使用できます。

emphistory [-h hostname | ip _addr] [-p port] [-c community]
    [-v 1 | 2c | 3] [-u secName] [-s secLevel] [-n contextName]
    [-a authPassword] [-A MD5 | SHA]
    [-x privPassword] [-X DES | AES | 3DES]
    [-m FIPS_mode]
    [-r retries]
    [-t timeout] [-d logLevel] [-f logFile]
    [-o] [command]

-h hostname | ipaddr

エージェントが実行されているシステムのホスト名または IP アドレスを指定します。 IPv4 アドレスおよび IPv6 アドレスを指定できます。

デフォルト： localhost

-p port

エージェントが実行されている UDP ポート（たとえば 1691）を指定します。

デフォルト： 161

-c community

エージェントが使用するコミュニティ文字列を指定します。 SNMPv1 および SNMPv2c の場合のみ有効です。

注： snmpset に使用する読み取り/書き込みコミュニティ文字列を指定します。

デフォルト： public

-v {1 | 2c | 3}

エージェントが実行している SNMP のバージョン。 SNMPv1 の場合は 1 を、SNMPv2c の場合は 2c を、SNMPv3 の場合は 3 をそれぞれ指定します。

デフォルト： 1

-u secName

SNMPv3 セキュリティに使用される User-based Security Model （USM）のユーザ名を指定します。

デフォルト： なし

-s secLevel

以下に示した SNMPv3 通信用セキュリティ レベルのいずれかを指定します。

• 1 - noAuthNoPriv
• 2 - AuthNoPriv

  3 - AuthPriv （SNMPv3 のみ）

-n contextName

MIBMuxed エージェントのインスタンス名を指定します。

デフォルト： なし

-a authPassword

エージェントが secLevel 2（AuthNoPriv）または 3（AuthPriv）の SNMPv3 に設定されている場合に、認証パスワードを指定します。

注： SNMPv3 通信では、このオプションの指定は不要です。

デフォルト： なし

-A {MD5 | SHA}

エージェントが secLevel 2 （AuthNoPriv）または 3 （AuthPriv）の SNMPv3 に設定されている場合に使用する認証プロトコルを指定します。 現在、MD5 （Message Digest Algorithm）および SHA （Secure Hash Algorithm）のみを使用できます。

デフォルト： MD5

-x privPassword

エージェントが secLevel 3（AuthPriv）の SNMPv3 に設定されている場合に、プライバシー（暗号化）パスワードを指定します。

デフォルト： なし

-X {DES | AES | 3DES}

SNMPv3 ユーザが secLevel 3 （AuthPriv）で設定されている場合に、プライバシー プロトコルを指定します。 データ暗号化標準の場合は DES、128 ビットの暗号化キーを使用した高度暗号化標準（AES128）の場合は AES、トリプル データ暗号化標準の場合は 3DES と指定します。

デフォルト： なし

-m FIPS_mode

操作の FIPS モードを制御します。 許可される値は 0、1、および 2 です。

0

非 FIPS モード

1

FIPS 共存モード

2

FIPS のみのモード

デフォルト： 1

-r retries

再試行の回数を指定します。

デフォルト： 10

-t timeout

SNMP レシーバが要求をタイムアウトしたと判断するまでの期間を指定します。

デフォルト： 10 秒

-d logLevel

SNMP メッセージのログ レベルを指定します。 許可される値は 0 ～ 5 です。

0

致命的なメッセージをログ記録します。

1

重大なメッセージをログ記録します。

2

警告メッセージをログ記録します。

3

情報メッセージをログ記録します。

4

すべてのメッセージをログ記録します。

5

デバッグ メッセージを含むすべてのメッセージをログ記録します。

デフォルト： 0

-f logfile

エラーとデバッグ情報が含まれるログ ファイルの名前を指定します。

デフォルト： sysedge_utility.log

command

コマンドおよび関連する引数を指定します。 サポートされるコマンドは以下のとおりです。

• add
• setstatus
• delete
• dump
• list

  注：上記のコマンドの詳細については、「履歴制御テーブルのエントリを管理するための emphistory コマンド」を参照してください。

重要： emphistory ユーティリティを以下の方法で使用することはできなくなる予定です。 以下の形式が今後サポートされなくなるため、上記の引数形式の使用が強く推奨されます。

emphistory add ipaddr[:port] commstr ctrlIndex objid interval buckets ['description']
emphistory delete ipaddr[:port] commstr ctrlIndex
emphistory list ipaddr[:port] commstr
emphistory setstatus ipaddr[:port] commstr ctrlIndex status
emphistory dump ipaddr[:port] commstr ctrlIndex