Oracle® Fusion Middleware Oracle WebLogic Serverコマンド・リファレンス 11g リリース1(10.3.5) B61640-03 |
|
![]() 前 |
注意: このドキュメントで説明するコマンド・ライン・ユーティリティは、WebLogic Server 10.0で非推奨になりました。かわりに、『Oracle WebLogic Server SNMP管理ガイド』のWebLogic SNMPコマンド・ライン・ユーティリティに関する項で説明されているコマンド・ライン・ユーティリティを使用してください。 |
WebLogic ServerではSimple Network Management Protocol (SNMP)を使用して、企業全体の管理システムとの通信を実現できます。WebLogic管理データ(管理対象オブジェクト)を収集し、このデータをSNMP通信モジュール(トラップ通知)に変換し、このトラップ通知をサード・パーティのSNMP管理システムに転送するWebLogic Serverサブシステムを、WebLogic SNMPエージェントと呼びます。WebLogic SNMPエージェントは管理サーバー上で動作し、ドメイン内のすべての管理対象サーバーから管理対象オブジェクトを収集します。
WebLogic SNMPエージェントには、次のことを実行できるコマンド・ライン・インタフェースが用意されています。
WebLogic Server管理対象オブジェクトを検索する
テスト目的のためにWebLogic Serverトラップを生成および受信する
以下の節では、コマンド・ライン・インタフェースからWebLogic SNMPエージェントを操作する方法について説明します。
WebLogic ServerでSNMPを使用する方法については、次を参照してください:
『Oracle WebLogic Server SNMP管理ガイド』
WebLogic SNMPエージェントのコマンド・ライン・インタフェース用に環境を設定するには、次の手順に従います。
『Oracle WebLogic Serverインストレーション・ガイド』の説明に従って、WebLogic Serverソフトウェアをインストールおよび構成します。
WebLogic Server管理対象オブジェクトを検索する場合、Oracle WebLogic Server管理コンソール・ヘルプのSNMPを使用したWebLogic Serverのモニターに関する項の説明に従ってWebLogic SNMPエージェントを有効にします。
コマンド・プロンプト(シェル)を開いて、次のスクリプトを呼び出します。
WL_HOME
\server\bin\setWLSEnv.sh
(WindowsではsetWLSEnv.cmd
)
ここで、WL_HOME
は、WebLogic Serverのインストール先ディレクトリです。
このスクリプトを実行すると、シェルのPATH
環境変数にはサポートされるJDKが追加され、CLASSPATH
変数にはWebLogic Serverクラスが追加されます。
すべてのWebLogic SNMPエージェント・コマンドは次の形式を取ります。
java command-name arguments
表4-1では、ほとんどのWebLogic SNMPエージェント・コマンドに共通する引数について説明します。
表4-1 共通のコマンド・ライン引数
引数 | 定義 |
---|---|
-d |
コマンド出力にデバッグ情報とパケット・ダンプを含めます。 |
-v {v1 | v2} |
SNMPエージェントとの通信にSNMPv1とSNMPv2のどちらを使用するのかを指定します。 SNMPエージェントを構成するときに「トラップ・バージョン」フィールドで設定したものと同じSNMPバージョンを指定する必要があります(Oracle WebLogic Server管理コンソール・ヘルプのSNMPエージェントの作成に関する項を参照)。 値を指定しない場合、コマンドは |
-c snmpCommunity [@server_name | @domain_name |
WebLogic SNMPエージェント用に設定するコミュニティ名、および必要であれば対話するオブジェクトをホストするサーバー・インスタンスを指定します。 管理サーバー上の管理対象オブジェクトをリクエストするには、次のように指定します。
snmpCommunity
ここで、 1つの管理対象サーバー上の管理対象オブジェクトをリクエストするには、次のように指定します。
snmpCommunity@server_name
ここで、 ドメイン内のすべてのサーバー・インスタンスの管理対象オブジェクトをリクエストするには、次の形式でコミュニティ文字列を指定します。
snmpCommunity@domain_name
ここで、 この引数の値を指定しない場合、値は |
-p snmpPort
|
WebLogic SNMPエージェントがリクエストをリスニングするポート番号です。 値を指定しない場合、コマンドは |
-t timeout
|
コマンドがSNMPエージェントに正常に接続するのを待機するミリ秒数。 値を指定しない場合、コマンドは |
-r retries
|
SNMPエージェントへの接続の試行が失敗した場合に、コマンドが再試行する回数。 値を指定しない場合、コマンドは最初に試行が失敗した時点で終了します。 |
host
|
WebLogic SNMPエージェントが動作しているWebLogic Serverの管理サーバーをホストするコンピュータのDNS名またはIPアドレス。 |
表4-2に、WebLogic Server管理対象オブジェクトとオブジェクト・インスタンスを検索するコマンドの概要を示します。
表4-2 WebLogic Server管理対象オブジェクトからデータを取得するためのコマンドの概要
コマンド | 説明 |
---|---|
snmpwalk |
MIB内の指定されたノード以下にあるすべての管理対象オブジェクトとインスタンスを返します。 「snmpwalk」を参照してください。 |
snmpgetnext |
指定するOIDの直後にある管理対象オブジェクトまたはインスタンスを返します。 「snmpgetnext」を参照してください。 |
snmpget |
1つまたは複数のOIDに対応する管理対象オブジェクトを返します。 「snmpget」を参照してください。 |
MIB内の指定されたノード以下にあるすべての管理対象オブジェクトまたはインスタンスを返します。
表形式のオブジェクトOIDを指定すると、コマンドはそのすべてのオブジェクト・インスタンスと、関連するすべての子オブジェクトおよびインスタンスを返します。
java snmpwalk [-d] [-v (v1,v2)] [-c snmpCommunity] [-p snmpPort] [-t timeout] [-r retries] host OID
表4-3に、snmpwalk
に渡されるOID
の引数を示します。
以下の例では、管理サーバーにデプロイされているすべてのアプリケーションの名前を取得します。アプリケーション名の管理対象オブジェクトは、applicationRuntimeTable
オブジェクトの子であるapplicationRuntimeName
です。(http://download.oracle.com/docs/cd/E15523_01/apirefs.1111/e14145/BEA-WEBLOGIC-MIB.asn1.zip
を参照してください。)
java snmpwalk localhost .1.3.6.1.4.1.140.625.105.1.15
サンプルのMedRecServerを実行するコンピュータからこのコマンドを呼び出す場合、コマンドは以下の抜粋のような出力を返します。出力には、applicationRuntimeName
オブジェクトのインスタンスごとに完全なOIDが含まれています。
Object ID: .1.3.6.1.4.1.140.625.105.1.15.32.49.102.98.97.100.97.102.99.57.48.50. 102.48.98.53.54.100.100.49.54.50.54.99.54.99.49.97.97.98.53.100.97 STRING: MedRecServer_uddiexplorer Object ID: .1.3.6.1.4.1.140.625.105.1.15.32.54.98.49.101.57.56.54.98.98.50.57.10 0.54.55.48.100.56.98.101.101.97.55.48.53.57.99.49.51.56.98.97.99 STRING: MedRecServer_StartupEAR Object ID: .1.3.6.1.4.1.140.625.105.1.15.32.56.48.97.53.50.52.99.101.53.54.57.54 .52.52.99.54.48.55.54.100.102.49.54.97.98.52.48.53.98.100.100.49 STRING: MedRecServer_wl_management_internal2 ...
以下の例では、medrec
ドメインのすべてのサーバーにデプロイされている、すべてのアプリケーションの名前を取得します。
java snmpwalk -c public@medrec localhost .1.3.6.1.4.1.140.625.105.1.15
以下の例では、管理対象サーバーMS1
にデプロイされているすべてのアプリケーションの名前を取得します。
java snmpwalk -c public@MS1 localhost .1.3.6.1.4.1.140.625.105.1.15
指定する1つまたは複数のOIDの直後にある管理対象オブジェクトまたはオブジェクト・インスタンスの説明を返します。表形式のオブジェクトを指定した場合、最初の子管理対象オブジェクトが返されます。スカラー・オブジェクトを指定した場合、オブジェクトの最初のインスタンスが返されます。
snmpwalk
コマンドが提供する再帰的なリストとは異なり、このコマンドでは、OIDの順序が次となる管理対象オブジェクトまたはインスタンス1つのみに関する説明を返します。一連のsnmpgetnext
コマンドを並べて指定すると、snmpwalk
コマンドと同じ結果が得られます。
java snmpgetnext [-d] [-v (v1,v2)] [-c snmpCommunity] [-p snmpPort] [-t timeout] [-r retries] host OID [OID]...
表4-4に、snmpgetnext
コマンドに渡されるOIDの引数を示します。
以下の例では、管理サーバーにデプロイされているアプリケーションの名前を取得します。アプリケーション名の管理対象オブジェクトは、applicationRuntimeName
です。これはスカラー・オブジェクトであり、applicationRuntimeTable
オブジェクトの子です。(http://download.oracle.com/docs/cd/E15523_01/apirefs.1111/e14145/BEA-WEBLOGIC-MIB.asn1.zip
を参照してください。)
java snmpgetnext localhost .1.3.6.1.4.1.140.625.105.1.15
サンプルのMedRecServerを実行するコンピュータからこのコマンドを呼び出す場合、コマンドは以下のような出力を返します。
Response PDU received from /127.0.0.1, community: public Object ID: .1.3.6.1.4.1.140.625.105.1.15.32.49.102.98.97.100.97.102.99.57.48.50. 102.48.98.53.54.100.100.49.54.50.54.99.54.99.49.97.97.98.53.100.97 STRING: MedRecServer_uddiexplorer
管理サーバーにデプロイされている他のアプリケーションがあるかどうかを調べるには、snmpgetnext
コマンドの出力を追加のsnmpgetnext
コマンドの入力として使用できます。
java snmpgetnext localhost .1.3.6.1.4.1.140.625.105.1.15.32.49.102.98.97.100.97.102.99.57.48.50.102. 48.98.53.54.100.100.49.54.50.54.99.54.99.49.97.97.98.53.100.97
コマンドは以下のような出力を返します。
Response PDU received from /127.0.0.1, community: public Object ID: .1.3.6.1.4.1.140.625.105.1.15.32.54.98.49.101.57.56.54.98.98.50.57.10 0.54.55.48.100.56.98.101.101.97.55.48.53.57.99.49.51.56.98.97.99 STRING: MedRecServer_StartupEAR
以下の例では、2つのOIDを指定して、管理サーバーにデプロイされているアプリケーションの名前、および JDBC接続プールの名前を取得します。コマンド例のOIDは、アプリケーション名のapplicationRuntimeName
オブジェクトとJDBC接続プール名のjdbcConnectionPoolRuntimeName
です。
java snmpgetnext localhost .1.3.6.1.4.1.140.625.105.1.15.1.3.6.1.4.1.140.625.190.1.15
サンプルのMedRecServerを実行するコンピュータからこのコマンドを呼び出す場合、コマンドは以下のような出力を返します。
Response PDU received from /127.0.0.1, community: public Object ID: .1.3.6.1.4.1.140.625.105.1.15.32.49.102.98.97.100.97.102.99.57.48.50. 102.48.98.53.54.100.100.49.54.50.54.99.54.99.49.97.97.98.53.100.97 STRING: MedRecServer_uddiexplorer Object ID: .1.3.6.1.4.1.140.625.190.1.15.32.53.53.49.48.50.55.52.57.57.49.99.102 .55.48.98.53.50.54.100.48.100.53.53.52.56.49.57.49.49.99.99.99 STRING: MedRecPool-PointBase
1つまたは複数のオブジェクト・インスタンスの値を取得します。このコマンドでは、管理対象オブジェクトのOIDは使用できません。
java snmpget [-d] [-v (v1,v2)] [-c snmpCommunity] [-p snmpPort] [-t timeout] [-r retries] host object-instance-OID [object-instance-OID]...
表4-5に、snmpget
コマンドに渡されるobject-instance-OID
引数を示します。
以下の例では、管理サーバーのserverRuntimeState
およびserverRuntimeListenPort
管理対象オブジェクト・インスタンスを取得します。これらのオブジェクトは、どちらもserverRuntimeTable
オブジェクトの子です(http://download.oracle.com/docs/cd/E15523_01/apirefs.1111/e14145/BEA-WEBLOGIC-MIB.asn1.zip
を参照してください。)
java snmpget localhost .1.3.6.1.4.1.140.625.360.1.60.32.102.100.48.98.101.102.100.99.102.52.98. 97.48.48.49.102.57.53.51.50.100.102.53.55.97.101.52.56.99.99.97.99 .1.3.6.1.4.1.140.625.360.1.35.32.102.100.48.98.101.102.100.99.102.52. 98.97.48.48.49.102.57.53.51.50.100.102.53.55.97.101.52.56.99.99.97.99
サンプルのMedRecServerを実行するコンピュータからこのコマンドを呼び出す場合、コマンドは以下のような出力を返します。
Response PDU received from /127.0.0.1, community: public Object ID: .1.3.6.1.4.1.140.625.360.1.60.32.102.100.48.98.101.102.100.99.102.52. 98.97.48.48.49.102.57.53.51.50.100.102.53.55.97.101.52.56.99.99.97.99 STRING: RUNNING Object ID: .1.3.6.1.4.1.140.625.360.1.35.32.102.100.48.98.101.102.100.99.102.52. 98.97.48.48.49.102.57.53.51.50.100.102.53.55.97.101.52.56.99.99.97.99 INTEGER: 7001
表4-6は、テスト目的でトラップを生成および受信するコマンドの概要です。
表4-6 WebLogic Serverに関する情報を取得するためのコマンドの概要
コマンド | 説明 |
---|---|
snmptrapd |
トラップを受信してトラップについての情報を出力するデーモンを起動します。 「snmptrapd」を参照してください。 |
snmpv1trap |
SNMPv1トラップを作成して、指定したホスト上で動作し、指定したポート番号でリスニングするSNMPマネージャまたはトラップ・デーモンに、そのトラップを配信します。 「snmpv1trap」を参照してください。 |
トラップを受信してトラップについての情報を出力するデーモンを起動します。
SNMPv1トラップを作成して、指定したホスト上で動作し、指定したポート番号でリスニングするSNMPマネージャまたはトラップ・デーモンに、そのトラップを配信します。
このコマンドの呼出しの一部として、送信するトラップ・パケット内のフィールドの値を指定します。指定する値は、WebLogic Server MIBで定義されているトラップに解決される必要があります。WebLogic Serverトラップとトラップ・パケットに必要なフィールドの詳細は、『Oracle WebLogic Server SNMP管理ガイド』のWebLogic Server通知のOIDに関する項を参照してください。
java snmpv1trap [-d] [-c snmpCommunity] [-p TrapDestinationPort] TrapDestinationHost .1.3.6.1.4.140.625 agent-addr generic-trap specific-trap timestamp [OID {INTEGER | STRING | GAUGE | TIMETICKS | OPAQUE | IPADDRESS | COUNTER} value] ...
表4-8に、snmpv1trap
コマンドに渡される引数を示します。
表4-8 snmpv1trapの引数
引数 | 定義 |
---|---|
-c snmpCommunity
|
トラップのコミュニティ名。SNMPマネージャ(またはトラップ・デーモン)は、このコミュニティ名を使用するように構成されている場合にのみトラップにアクセスできます。 値を指定しない場合、コマンドは |
-p TrapDestinationPort
|
SNMPマネージャまたはトラップ・デーモンがリスニングするポート番号。 値を指定しない場合、コマンドは |
TrapDestinationHost
|
SNMPマネージャまたはトラップ・デーモンをホストするコンピュータのDNS名またはIPアドレス。 |
.1.3.6.1.4.140.625 |
トラップの |
agent-addr
|
トラップの このフィールドは、トラップが生成されたコンピュータを示します。
|
generic-trap
|
トラップの 有効な値のリストについては、『Oracle WebLogic Server SNMP管理ガイド』のWebLogic Server通知のOIDに関する項を参照してください。 |
specific-trap
|
トラップの 有効な値のリストについては、『Oracle WebLogic Server SNMP管理ガイド』のWebLogic Server通知のOIDに関する項を参照してください。 |
timestamp
|
トラップの このフィールドは、SNMPエージェントが最後に再初期化した時からトラップが発行された時までの時間を示します。
|
OID {INTEGER | STRING |
GAUGE | TIMETICKS | OPAQUE |
IPADDRESS | COUNTER} value
|
(オプション)トラップの「 名前と値の組合せごとに、OID、値のタイプ、値を指定します。 たとえば、ログ・メッセージ・トラップには、トラップが生成される時刻を示すために .1.3.6.1.4.1.140.625.100.5 STRING "2:00 pm" |
以下の例では、trapTime
およびtrapServerName
変数バインドを含むログ・メッセージ・トラップを生成します。ポート165からトラップをブロードキャストします。例:
java snmpv1trap -p 165 localhost .1.3.6.1.4.140.625 localhost 6 60 1000 .1.3.6.1.4.1.140.625.100.5 STRING "2:00 pm" .1.3.6.1.4.1.140.625.100.10 STRING localhost
上記の例で注目すべき点は以下のとおりです。
6
は「他のWebLogic Serverトラップ」を指定するgeneric trap値。
60
はWebLogic Serverがログ・メッセージ・トラップの識別に使用するspecific trap値。
.1.3.6.1.4.1.140.625.100.5
はtrapTime
変数バインドのOID。.1.3.6.1.4.1.140.625.100.10
は、trapServerName
変数バインドのOID。
ポート番号165
でリスニングするSNMPマネージャ(またはトラップ・デーモン)がトラップを受信します。トラップ・デーモンが165
でリスニングしている場合は、次のように返します。
Trap received from: /127.0.0.1, community: public Enterprise: .1.3.6.1.4.140.625 Agent: /127.0.0.1 TRAP_TYPE: 6 SPECIFIC NUMBER: 60 Time: 1000 VARBINDS: Object ID: .1.3.6.1.4.1.140.625.100.5 STRING: 2:00 pm Object ID: .1.3.6.1.4.1.140.625.100.10 STRING: localhost
snmpv1trap
コマンドを使用してWebLogic Serverトラップを生成し、トラップ・デーモンを介してそれらを受信するには、次の手順に従います。
コマンド・プロンプト(シェル)を開いて、次のスクリプトを呼び出します。
WL_HOME
\server\bin\setWLSEnv.sh
(WindowsではsetWLSEnv.cmd
)
ここで、WL_HOME
は、WebLogic Serverのインストール先ディレクトリです。
トラップ・デーモンを起動するには、次のコマンドを入力します。
java snmptrapd
別のシェルを開いて、次のスクリプトを呼び出します。
WL_HOME
\server\bin\setWLSEnv.sh
(WindowsではsetWLSEnv.cmd
)
トラップを生成するには、次のコマンドを入力します。
java snmpv1trap localhost .1.3.6.1.4.140.625 localhost 6 60 1000
snmpv1trap
コマンドはserverStart
トラップを生成して、ポート162からブロードキャストします。
トラップ・デーモンが動作するシェルでは、デーモンが次のように出力します。
Trap received from: /127.0.0.1, community: public Enterprise: .1.3.6.1.4.140.625 Agent: /127.0.0.1 TRAP_TYPE: 6 SPECIFIC NUMBER: 60 Time: 1000 VARBINDS:
WebLogic SNMPエージェントを使用してWebLogic Serverトラップを生成し、トラップ・デーモンを介してそれらを受信するには、次の手順に従います。
ドメインの管理サーバーを起動し、SNMPエージェントを有効にします。
Oracle WebLogic Server管理コンソール・ヘルプのSNMPエージェントの作成に関する項を参照してください。
トラップ・デーモンを表すトラップ宛先を作成します。トラップ宛先がポート165
を使用するように構成します。管理コンソールのその他のデフォルト値はそのままにしておきます。
Oracle WebLogic Server管理コンソール・ヘルプのトラップ宛先の作成に関する項を参照してください。
コマンド・プロンプト(シェル)を開いて、次のスクリプトを呼び出します。
WL_HOME
\server\bin\setWLSEnv.sh
(WindowsではsetWLSEnv.cmd
)
ここで、WL_HOME
は、WebLogic Serverのインストール先ディレクトリです。
トラップ・デーモンを起動するには、次のコマンドを入力します。
java snmptrapd -p 165
管理サーバーを再起動します。
管理サーバーが起動すると、SNMPエージェントはserverStart
トラップを生成して、ポート165からそれをブロードキャストします。
トラップ・デーモンが動作するシェルでは、デーモンが次のように出力します。
Trap received from: /127.0.0.1, community: public Enterprise: .1.3.6.1.4.140.625 Agent: /127.0.0.1 TRAP_TYPE: 6 SPECIFIC NUMBER: 65 Time: 1000 VARBINDS: