WebLogic Server コマンド リファレンス

WebLogic SNMP エージェント コマンドライン リファレンス

WebLogic Server では Simple Network Management Protocol (SNMP) を使用して、企業全体の管理システムとの通信を実現できます。WebLogic の管理データを収集して SNMP の通信モジュール (トラップ通知) に変換し、サードパーティ SNMP 管理システムにトラップ通知を転送する WebLogic Server サブシステムを、WebLogic SNMP エージェントと呼びます。WebLogic SNMP エージェントは管理サーバ上で動作し、ドメイン内のすべての管理対象サーバから情報を収集します。

WebLogic SNMP エージェントには、次のことを実行できるコマンドライン インタフェースが用意されています。

• WebLogic Server 管理情報ベース (Management Information Base : MIB) 内で管理対象オブジェクトとして公開される WebLogic Server 属性の値を取得する。
• WebLogic Server トラップを生成および受信する。

以下の節では、コマンドライン インタフェースから WebLogic SNMP エージェントを操作する方法について説明します。

• SNMP コマンドライン インタフェースの環境要件と構文
• WebLogic Server 属性値を取得するためのコマンド
• トラップをテストするためのコマンド

WebLogic Server での SNMP の使い方については、『WebLogic SNMP 管理ガイド』を参照してください。

 

---

SNMP コマンドライン インタフェースの環境要件と構文

WebLogic SNMP エージェントのコマンドライン インタフェースを使用する前に、以下の節で示すように、環境を設定してコマンドの構文に関する情報に目を通しておいてください。

環境

WebLogic SNMP エージェントのコマンドライン インタフェース用に環境を設定するには、次の手順に従います。

インストール ガイドの説明に従って、WebLogic Server ソフトウェアをインストールおよびコンフィグレーションします。
Administration Console オンライン ヘルプの「SNMP と WebLogic Server のコンフィグレーション」で説明されているとおりに、WebLogic SNMP エージェントを有効にします。

注意 : snmpv1trap および snmptrapd コマンドでは、SNMP エージェントを有効にする必要はありません。

コマンド プロンプト (シェル) を開いて、次のスクリプトを呼び出します。

WL_HOME\server\bin\setWLSEnv.sh (Windows では setWLSEnv.cmd)

WL_HOME は、WebLogic Server のインストール先ディレクトリです。

スクリプトでは、サポートされる JDK をシェルの PATH 環境変数に追加し、WebLogic Server クラスを CLASSPATH 変数に追加します。

共通の引数

すべての WebLogic SNMP エージェント コマンドは次の形式を取ります。

java command-name arguments

表 6-1 では、ほとんどの WebLogic SNMP エージェント コマンドに共通する引数について説明します。

表 6-1 共通のコマンドライン引数

引数	定義
-d	コマンド出力にデバッグ情報とパケット ダンプを含める。
-v {v1 | v2}	SNMP エージェントとの通信に SNMPv1 と SNMPv2 のどちらを使用するのかを指定する。 SNMP エージェントをコンフィグレーションするときに [トラップ バージョン] フィールドで設定したものと同じ SNMP バージョンを指定しなければならない (Administration Console オンライン ヘルプの「WebLogic SNMP エージェントの有効化およびコンフィグレーション」を参照)。 値を指定しない場合、コマンドは -v v1 であると仮定する。
-c snmpCommunity [@server_name | @domain_name ]	WebLogic SNMP エージェントが SNMP データを保護するために使用するコミュニティ名、および対話するオブジェクトをホストするサーバ インスタンスを指定する。 管理サーバ上のオブジェクトの値を要求するには、次のように指定する。 snmpCommunity snmpCommunity は、SNMP エージェントをコンフィグレーションするときに [コミュニティ プレフィックス] フィールドで設定した SNMP コミュニティ名 (Administration Console オンライン ヘルプの「WebLogic SNMP エージェントの有効化およびコンフィグレーション」を参照)。 管理対象サーバ上のオブジェクトの値を要求するには、次のように指定する。 snmpCommunity@server_name server_name は、管理対象サーバの名前。 ドメイン内のすべてのサーバ インスタンスのオブジェクトの値を要求するには、次の形式でコミュニティ文字列を指定する。 snmpCommunity@domain_name 値を指定しない場合、コマンドは -c public であると仮定して、管理サーバ上の値を取得しようとする。
-p snmpPort	WebLogic SNMP エージェントがリクエストをリスンするポート番号を指定する。 値を指定しない場合、コマンドは -p 161 であると仮定する。
-t timeout	コマンドが SNMP エージェントに正常に接続するのを待機するミリ秒数を指定する。 値を指定しない場合、コマンドは -t 5000 であると仮定する。
-r retries	SNMP エージェントへの接続の試行が失敗した場合に、コマンドが再試行する回数を指定する。 値を指定しない場合、コマンドは最初に試行が失敗した時点で終了する。
host	WebLogic SNMP エージェントが動作している WebLogic Server の管理サーバをホストするコンピュータの DNS 名と IP アドレスを指定する。

 

 

---

WebLogic Server 属性値を取得するためのコマンド

表 6-2 は、WebLogic Server MIB 内で公開される WebLogic Server MBean 属性の値を取得するコマンドの概要です。

表 6-2 WebLogic Server 属性値を取得するためのコマンドの概要

コマンド	説明
snmpwalk	MIB ツリー内の指定されたノード以下にあるすべての管理対象オブジェクトの再帰的なリストを返す。 「snmpwalk」を参照。
snmpgetnext	指定する OID の直後にある管理対象オブジェクトの説明を返す。 「snmpgetnext」を参照。
snmpget	1 つまたは複数のオブジェクト インスタンス OID に対応する管理対象オブジェクトの説明を返す。 「snmpget」を参照。