この章では、SNMPマネージャと同じ機能の多くを提供するSNMPコマンドライン・ユーティリティについて説明します。このユーティリティは、WebLogic Serverドメイン内のSNMPエージェントの構成に対するテストとトラブルシューティングに使用できます。
この章の内容は以下のとおりです。
WebLogic Server SNMPコマンドライン・ユーティリティ用に環境を設定するには:
インストレーション・ガイドの説明に従って、WebLogic Serverソフトウェアをインストールおよび構成します。
SNMPエージェントと、トラップ宛先をWebLogic Serverドメイン内に作成します。Oracle WebLogic Server管理コンソール・オンライン・ヘルプのSNMPを使用したWebLogic Serverの監視に関する項を参照してください。
コマンド・プロンプト(シェル)を開いて、次のスクリプトを呼び出します。
WL_HOME
\server\bin\setWLSEnv.sh
(WindowsではsetWLSEnv.cmd
)
ここで、WL_HOME
は、WebLogic Serverのインストール先ディレクトリです。
このスクリプトを実行すると、シェルのPATH
環境変数にはサポートされるJDKが追加され、CLASSPATH
変数にはWebLogic Serverクラスが追加されます。
次の構文を使用して、SNMPコマンドライン・ユーティリティを呼び出します。
java weblogic.diagnostics.snmp.cmdline.Manager command [-?]
前述の構文のcommand
は、表5-1に記載されているコマンドのいずれかを示します。オプションの引数-?
を使用して、指定したコマンドの使用情報を取得します。
表5-1 SNMPコマンド
コマンド | 説明 |
---|---|
|
指定したパターンでSnmpGetNextを繰返し呼び出すことにより、MIBオブジェクト コマンド・ラインで指定した最初のOIDから開始して、オブジェクトの下にあるすべてのMIB変数を取得するのに必要な回数、 コマンド・ラインで指定したOIDをインクリメントして、前述のパターンを繰り返します。 オプションとして |
|
INFORM通知を構築し、SNMPマネージャまたはトラップ・モニターに配信します。 |
|
1つまたは複数のMIB変数の値を取得します。このコマンドでは、管理対象オブジェクトのOIDは使用できません。 指定した変数の値が繰返し取得されるように、必要に応じて間隔を指定することができます。 |
|
指定した表の列を確認して、出力内の各行に対する列値をグループ化します。指定された列はすべて、同じ表のものであることが必要です。 |
|
指定したパターンで
|
|
管理対象オブジェクトまたはMIB変数を返します。表形式のオブジェクトを指定した場合、最初の子管理対象オブジェクトが返されます。スカラー・オブジェクトを指定した場合、オブジェクトの最初の変数が返されます。
|
|
TRAP通知を構築し、SNMPマネージャまたはトラップ・モニターに配信します。 |
|
通知をリスニングするプロセスを開始します。受信した各通知を、ログ・ファイルに書き込みます。 |
|
通知をリスニングするプロセスを開始します。受信した各通知を、標準出力へ出力します。 |
|
MIB内の指定されたノード以下に、または指定された範囲内にあるすべての管理対象オブジェクトまたは変数を返します。 表形式のオブジェクトOIDを指定すると、コマンドはそのすべてのオブジェクト変数と、関連するすべての子オブジェクトおよび変数を返します。 |
この節のサンプルでは、管理サーバー上にSNMPエージェントを作成済みであり、エージェントのデフォルト変数を変更していないということが前提となっています(たとえば、エージェントはUDPポート161をリスニングし、コミュニティ名としてpublic
を使用します)。
これらの例では、MIBモジュールのロードに次のオプションが使用され、これにより、管理対象オブジェクトをOIDではなく、その表示名で参照できるようになります。
-m
は、WebLogic Server MIBモジュールBEA-WEBLOGIC-MIB
を指定します。
-M
は、コンパイルしたMIBのディレクトリ、またはリソース・クラスパースを指定します。これらの例では、リソース・クラスパースが使用されています。
すべてのWebLogic Server管理対象オブジェクトの表示名を確認するには、「WebLogic Server用のMIBモジュール」を参照してください。
次の例では、SnmpWalk
コマンドの使用情報を表示します。
java weblogic.diagnostics.snmp.cmdline.Manager SnmpWalk -?
次の例では、ドメインにデプロイされているすべてのアプリケーションの名前を取得します。
java weblogic.diagnostics.snmp.cmdline.Manager SnmpWalk -m BEA-WEBLOGIC-MIB -M /weblogic/diagnostics/snmp/mib applicationRuntimeObjectName
以下のコマンドでは、ドメイン内のすべてのアプリケーションのすべての変数バインドを取得します。ネットワーク通信の効率を上げるため、各リクエスト内で3つのSnmpGetBulk
コマンドをグループ化しています。
java weblogic.diagnostics.snmp.cmdline.Manager SnmpBulkWalk -v2 -Bm 3 -m BEA-WEBLOGIC-MIB -M /weblogic/diagnostics/snmp/mib applicationRuntimeTable
以下のコマンドでは、ドメイン内で最初にデプロイされたアプリケーションの名前を取得します。その後、ドメイン内の最初の2つのJMSサーバーの名前と保留中のバイト数を取得します。
java weblogic.diagnostics.snmp.cmdline.Manager SnmpGetBulk -v2 -Bn 1 -Bm 2 applicationRuntimeObjectName jmsServerRuntimeObjectName jmsServerRuntimeBytesPendingCount