sysvariable Utility--Retrieve a System Value

コマンドラインユーティリティ › SNMP コマンドラインユーティリティ › sysvariable ユーティリティ -- システム値の取得

sysvariable ユーティリティ -- システム値の取得

sysvariable ユーティリティは、SNMP を使用して特定のシステム値の値を取得します。このユーティリティは、特定の OID を持つ snmpget です。 sysvariable は、数値の OID 名を知らなくてもシステム値を取得する方法です。

このユーティリティは以下の形式になっています。

sysvariable
    [-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]
    [-V]
    [-o Variable]

-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）のユーザ名を指定します。

デフォルト： なし

-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

-V

詳細で冗長な情報を生成します。

変数

表示するシステム値を指定します。この値は、以下のいずれかになります。

sysuptime: システムの稼働時間を表示します。
sysnumusers: ユーザの数を表示します。
sysprocess: プロセスの数を表示します。
nodename: ホスト名を表示します。
memory: メモリをキロバイト単位で表示します。
agentversion: SystemEDGE エージェントバージョンを表示します。
systype: システムリリースを表示します。
osversion: システムバージョンを表示します。
numcpu: CPU の数を表示します。
virtualmemory: 仮想メモリをキロバイト単位で表示します。
totalswap: スワップ領域の合計をキロバイト単位で表示します。
avg1: 1 分間の負荷平均に 100 を掛けた値を表示します。
avg5: 5 分間の負荷平均に 100 を掛けた値を表示します。
avg15: 15 分間の負荷平均に 100 を掛けた値を表示します。
openfiles: オープンしているファイル数を表示します。
swapcap: スワップ容量を表示します。
memcap: メモリ容量を表示します。
meminusecap: memoryInUse 容量を表示します。
numneti: ネットワークインターフェースの数を表示します。
sysedgemode: SystemEDGE モードを表示します。

注：変数は sysvariable の最後の引数にする必要があります。1 つの sysvariable コールで複数の変数をクエリすることはできません。

例

sysvariable -o sysprocess

sysvariable -h box1.domain.com -o agentversion

sysvariable -p 2009 -c admin -v 1 -o openfiles

sysvariable -c admin -v 2c -h Ea2f:fe90:abcd:0000:230:a2f:200:ad01 -o numcpu

snmpget -p 2009 -u user3v3 -v 3 -s 1 -o memcap

snmpget -h box1.domain.com -p 2009 -u user1v3 -A SHA -a osa -v 3 -s 2 -m 2 -o numneti

snmpget -h 130.10.100.101 -p 2009 -u user2v3 -A SHA -a osa -X AES -x osp -v 3 -s 3 -t 30 -o sysuptime

このトピックについて CA Technologies に電子メールを送信する