SNMPエージェント管理ガイド

     前  次    新規ウィンドウで目次を開く  新規ウィンドウで索引を開く  PDFとして表示 - 新規ウィンドウ  Adobe Readerを取得 - 新規ウィンドウ
コンテンツはここから始まります

Oracle SNMPエージェント・インテグレータのコマンド

以下の項では、Oracle SNMPエージェント・インテグレータ用のコマンドとユーティリティについて説明します。

 


コマンド

reinit_agent

構文

reinit_agent all | logical_agent_name [logical_agent_name]

説明

指定したエージェントが構成ファイルを再び読み取ります。このユーティリティは、ルート権限で実行する必要があります。all引数を使用すると、すべてのSNMPエージェントが再初期化されます。tux_snmpd以外のSNMPエージェントの場合は、logical_agent_nameが実行可能ファイルの名前になります。

次にコマンドrexの使用例を示します。

reinit_agent snmp_integrator

これにより、Oracle SNMPエージェント・インテグレータが構成ファイルを再び読み取ります。

snmp_integrator

構文

snmp_integrator [-d] [-n] [-p port | -r smux_port]
[-b
ipaddr_list | hostname_list ]

引数

-d

SNMP/SMUXパケットを送信または受信するたびにプログラムでメッセージを表示します。

-n

プログラムは、デーモンとして実行されません(UNIXのみ)。

-p port

Oracle SNMPエージェント・インテグレータがSNMPリクエストをリスニングするUDPポートを指定します(デフォルトは161/udp)。

-r smux_port

SMUXサブエージェントとの通信に使用するTCPポートを指定します(デフォルトは199/tcp)。

-b ipaddr_list | hostname_list

Oracle SNMPエージェント・インテグレータが動作しているマシンに複数のIPアドレスがある場合、Oracle SNMPエージェント・インテグレータはデフォルトですべてのIPアドレスをリスニングします。-bオプションを使用すると、受信したSNMPリクエストをモニターするためのIPアドレスのサブセットを指定できます。
ipaddr_list 単独のIPアドレスまたは複数のIPアドレスを空白で区切ったリストを指定できます。 hostname_list 単独のホスト名または複数のホスト名を空白で区切ったリストを指定できます。 たとえば、Oracle SNMPエージェント・インテグレータが動作しているマシンに複数のIPアドレスがある場合は、次のように指定します。 130.86.34.3
130.86.33.13
130.86.23.1
次のコマンドで開始すると、サービスリクエスト専用のアドレスを130.86.23.1にするようにOracle SNMPエージェント・インテグレータを構成できます。 snmp_integrator -b 130.86.23.1

説明

snmp_integratorファイルは、SNMP Oracle SNMPエージェント・インテグレータの実行可能ファイルです。 このファイルを使用すると、任意のベンダーの複数のSNMPエージェントおよびSMUXサブエージェントが同じノードに共存し、任意のSNMPマネージャへの単一のSNMPエージェントとして表示できるようになります。

Oracle SNMPエージェント・インテグレータでは、以下の項目を同時に利用できます。

また、Oracle SNMPエージェント・インテグレータは、他のどのSNMPエージェントとも標準SNMPポート(161/udp)で共存できます。MIB-II system(1)およびsnmp(3)グループに加えてSMUX MIB (RFC 1227)を直接サポートします。

プログラムは、SNMPエージェントとして実行されている場合、beamgr.confファイルのTRAP_HOSTエントリで指定したホストに対して、起動時にcoldStartトラップを生成します。TRAP_HOSTエントリがない場合、トラップは、publicとして定義されているコミュニティとともに、ユーティリティが実行されているホストのUDPポート162に送信されます。

Oracle SNMPエージェント・インテグレータでサポートされている書きおよび読取り専用コミュニティは、beamgr_snmpd.confファイルで指定できます。デフォルトでは、読取り専用コミュニティはpublicで読取り/書込みコミュニティはiviewです。

beamgr_snmpd.confファイルを使用すると、登録対象のSMUXサブエージェントからパスワードを受け取るようにOracle SNMPエージェント・インテグレータを構成できます。

Windowsシステムの場合

-d引数で表示されたメッセージは、イベント・ログに送信されます。

-n引数は無効です。

UNIXシステムの場合

-d引数は通常、プログラムがコマンドラインで実行されるときにデバッグ目的で使用されます。表示されたメッセージは、プログラムの標準出力に送信されます。プログラムがinit(1M)で開始された場合、これらのメッセージの宛先は、UNIXプラットフォームとバージョンによって決まります。これらのメッセージは、非常に頻繁にコンソールに送信されるものです。

-n引数は通常、respawnオプションとともにinit(1M)でプログラムが起動されたときに使用されます。

stop_agent

構文

stop_agent logical_agent_name | all [logical_agent_name]

引数

all

すべてのSNMPエージェントを停止します。

logical_agent_name

tux_snmpd以外のSNMPエージェントの場合は、論理エージェント名が常に実行可能ファイルの名前になります。

show_agent

構文

show_agent all | logical_agent_name [logical_agent_name]

説明

実行中の全エージェントとリクエストされたエージェントの名前とPIDを表示します。

 


Oracle SNMPエージェントのユーティリティ

Oracle SNMPエージェント・ソフトウェアでは、以下のユーティリティを使用して、エージェントまたはサブエージェントをインストールおよびテストできます。

instsrv
エージェントをWindowsサービスとしてインストールします。
snmpget
スカラによって管理されるオブジェクトの情報を報告します。
snmpgetnext
MIB内で連続する次のオブジェクトを返します。
snmptest
任意のMIBオブジェクトに対してGet、GetNext、およびSet操作を選択して実行します。
snmptrap
ホストにSNMPトラップ・メッセージを送信します。
snmptrapd
snmp-trapポートに送信されたSNMPトラップ・メッセージをローカル・マシンで受信してログに記録します。
snmpwalk
SNMP GetNextリクエストを使用してOIDツリーを検索することにより、管理対象オブジェクトに問い合せます。

instsrv

目的

指定した名前でWindowsサービスとして作成したモジュールをインストールするために使用します。 たとえば、マルチバージョン環境でいずれかのバージョンをアンインストールした後でOracle SNMPエージェント・インテグレータを再インストールするために使用します。 Windowsシステムでのみ有効です。UNIXシステムでは使用できません。

形式

instsrv service_name [executable_file | remove]
サービスを作成するにはexecutable_fileを入力します。サービスを削除するにはremoveを入力します。たとえば、 instrsrv snmp_integrator c:\tux81\bin\snmp_integrator.exeのようになります。

引数

service_name

サービス名。

executable_file

実行可能ファイルの絶対パス。

snmpget

目的

スカラによって管理されるオブジェクトの情報を報告します。

形式

snmpget [-d] [-p port] host community variable_name
[variable_name...]

引数

-d

パケットごとにプログラムでメッセージを表示します。

-p port

SNMPエージェントとの通信に使用するUDPポートを指定します(デフォルトは161)。

host

問合せ対象のSNMPエージェントを実行するノードのインターネット・アドレスまたはホスト名。

community

トランザクションのコミュニティ名。

variable_name

少なくとも1つのユニークなオブジェクト識別子(OID)。

説明

snmpgetユーティリティは、SNMP Getリクエストを使用して、管理対象オブジェクトに関する情報を取得します。コマンドラインには、1つ以上のオブジェクト識別子を引数として入力できます。この名前は、絶対パスで指定しても、ツリーのルートから始めても、.iso.org.dod.internetを基にした相対パスで指定してもかまいません。

環境変数

BEA_SM_SNMP_MIBFILE
mib.txtへのパスを指定するように設定する必要があります。このファイルには、プライベートMIBの内容がASCIIテキストで記述されています。

次のコマンドは、認可用のコミュニティにpublicを使用して、topazというホストで実行されているSNMPエージェントに問合せを送信します。エージェントは、OracleプライベートMIBにある管理対象オブジェクトbeaSysHasDiskの値を取得します。この例では、相対OID (private.enterprises.bea.beaSystem)が指定されていることに注意してください。.iso.org.dod.internet.が追加されて、絶対パスになります。
snmpget topaz public private.enterprises.bea.beaSystem
.beaSysHasDisk.0
このコマンドは、オブジェクトに関する次の情報を戻します。Name: private.enterprises.bea.beaSystem.beaSysHasDisk.0
INTEGER: yes(2)
次のコマンドは、認可用のコミュニティにpublicを使用して、rubyというホストで動作しているSNMPエージェントに問合せを送信します。エージェントは、MIBにある管理対象オブジェクトsysDescrおよびsysUptimeの値を取得します。snmpget ruby public mgmt.mib.system.sysDescr.0
mgmt.mib.system.sysUpTime.0
このコマンドは、次の情報を戻します。Name: mgmt.mib.system.sysDescr.0
OCTET STRING- (ascii): Kinetics FastPath2
Name: mgmt.mib.system.sysUpTime.0
Timeticks: (2270351) 6:18:23

snmpgetnext

目的

表の次のエントリまたはMIB内で連続する次のオブジェクトを返します。

形式

snmpgetnext [-d] [-p port] host community variable_name
[variable_name ...]

引数

-d

パケットごとにプログラムでメッセージを表示します。

-p port

SNMPエージェントとの通信に使用するUDPポートを指定します(デフォルトは161)。

host

問合せ対象のSNMPエージェントを実行するノードのインターネット・アドレスまたはホスト名。

community

トランザクションのコミュニティ名。

variable_name

少なくとも1つのユニークなオブジェクト識別子(OID)。

説明

コマンドラインには、1つ以上のオブジェクト識別子を引数として入力できます。この名前は、絶対パスで指定しても、ツリーのルートから始めても、.iso.org.dod.internetを基にした相対パスで指定してもかまいません。

環境変数

BEA_SM_SNMP_MIBFILE
mib.txtへのパスを指定するように設定する必要があります。このファイルには、プライベートMIBがASCIIテキストで記述されています。

この例では、コミュニティ名publicを使用してblueberryというホストに問合せを実行し、mgmt.mib.interfaces.ifTable.ifEntry.ifOutOctets.0の直後のインスタンスの値をMIBから取得します。
snmpgetnext blueberry public mgmt.mib.interfaces.ifTable.ifEntry
.ifOutOctets.0
オブジェクトの値を参照するために、インスタンスの索引.0をOIDの末尾に追加する必要があります。 先ほどのコマンドの出力は次のようになります。 Name: mgmt.mib.interfaces.ifTable.ifEntry.ifOutOctets.1
COUNTER: 85655250
続けて、次の変数に関する情報を取得するコマンドを入力できます。 snmpgetnext blueberry public mgmt.mib.interfaces.ifTable.ifEntry
.ifOutOctets.1

snmptest

目的

任意のMIBオブジェクトに対してGet、GetNext、およびSet操作を選択して実行します。

形式

snmptest [-d] [-p port] host community

引数

-d

パケットごとにプログラムでメッセージを表示します。

-p port

SNMPエージェントとの通信に使用するUDPポートを指定します(デフォルトは161)。

host

問合せ対象のSNMPエージェントを実行するノードのインターネット・アドレスまたはホスト名。

community

トランザクションのコミュニティ名。

説明

このプログラムが実行されると、OIDを入力するように要求されます。snmptestユーティリティは、オブジェクトの名前およびタイプとともに、リクエスト・パケットおよび応答パケットに関する情報を戻します。
デフォルトでは、プログラムはGetリクエスト・パケットを送信します。以下の表の値をプロンプトで入力すると、この設定を変更できます。

コマンド
リクエスト・タイプ
$G
Get
$N
GetNext
$S
Set

Setリクエスト・モードを選択した場合、以下のリストの変数の型を指定するように要求されます。

変数の型
説明
a
IPアドレス
d
10進数のバイトを空白文字で区切ったOctet文字列(105 118 105 101 119)
i
Integer
n
Null値
o
オブジェクト識別子
s
ASCIIで指定したOctet文字列(bea)
t
タイム・チック
x
16進数のバイトを空白文字で区切ったOctet文字列(69 76 69 65 77など)

リクエスト・タイプを指定すると、指定したタイプの値を入力するように要求されます。このプロンプトで、整数(10進数)または文字列を入力して、Enterキーを押します。リクエスト・パケットを送信するには、プロンプトでもう一度Enterキーを押します。 プログラムを終了するには、以下のコマンドを入力します。 $Q

環境変数

BEA_SM_SNMP_MIBFILE
mib.txtへのパスを指定するように設定する必要があります。このファイルには、プライベートMIBがASCIIテキストで記述されています。

プログラムを起動するには、以下のコマンドを入力します。
snmptest topaz public プログラムが起動すると、以下のメッセージが表示されます。 Please enter the variable name: 変数名を入力してEnterキーを押します。 private.enterprises.bea.beaEm.beaEmMonitorTimer.0 もう一度、変数名がリクエストされます。 Please enter the variable name: 別の変数名を入力するか、Enterキーを押して、結果を表示します。Enterキーを押すと、テストの結果が表示されます。 Received GET RESPONSE from 192.84.232.47
requestid 0x775efba0 errstat 0x0 errindex 0x0
Name: private.enterprises.bea.beaEm.beaEmMonitorTimer.0
INTEGER: 5000
結果が表示された後で、別の変数名を入力することも、$Qを入力してプログラムを終了することもできます。 Please enter the variable name: $Q 「$Q」を入力すると、終了メッセージが表示されます。 Quitting, Good-bye

snmptrap

目的

ホストにSNMPトラップ・メッセージを送信します。

形式

snmptrap [-a agent_addr] [-d] [-p port] host community
trap_type specific_trap
variable_binding_value

引数

-a agent_addr

発信元のアドレスが、snmptrapを実行しているホストと異なる場合は、そのアドレスを指定します。この引数を使用すると、別のホストのかわりにトラップを送信できます。

-d

パケットごとにプログラムでメッセージを表示します。

-p port

SNMPトラップの送信先となるターゲット・ホストのUDPポートを指定します(デフォルトは162)。

host

SNMPトラップの送信先となるホストのインターネット・アドレスまたは名前。

community

トランザクションのコミュニティ名。

trap_type

送信するトラップの汎用タイプを指定する整数値(0 - 6)。

specific_trap

trap_typeが汎用トラップ・タイプ6に設定された場合に発生するエンタープライズ固有のトラップを識別する整数値。

variable_binding_value

トラップ・パケット内で伝送される情報。 プログラムは、トラップを送信する際に、変数バインディング・リストの値としてこのデータを使用します。

説明

次の表では、有効な(汎用)トラップ・タイプを定義します。

トラップ・タイプ
の名前
汎用トラップ番号
説明
coldStart
0
送信側のエージェントが、通常は再起動によって再初期化されます。
warmStart
1
送信側のエージェントが、通常は標準的な再起動によって再初期化されます。
linkDown
2
エージェント・ノードの通信リンクのいずれか1つが失敗しました。 変数バインディングの最初の要素には、失敗したインタフェースのifIndexインスタンスの名前と値が含まれます。
linkUp
3
エージェント・ノードの通信リンクのいずれか1つが成功しました。 変数バインディングの最初の要素には、関連インタフェースのifIndexインスタンスの名前と値が含まれます。
authenticationFailure
4
受信したリクエストで指定されているコミュニティが無効か不十分な権限のために、リクエストを完了できないことをエージェントが報告しています。
egpNeighborLoss
5
External Gateway Protocol (EGP)内のピア同士の関係が存在していないことをエージェントが報告しています。
enterpriseSpecific
6
エンタープライズ固有のイベントが発生したことを送信側のエージェントが報告しています。specific-trapフィールドの値はイベントの性質を示します。

このツールによって生成されたトラップには、オブジェクトと値のペアを1つだけ格納した固定変数バインディング・リストが含まれています。 以下に、そのオブジェクトを示します。 .iso.org.dod.internet.private.enterprises.bea.beaSystem.
beaTrapDescr.0
このオブジェクトの値は、variable-binding-value引数で指定できます。 SNMPトラップのPDUヘッダーの一部であるエンタープライズ・フィールドは、常に次のようになります。 .1.3.6.1.4.1.140.1.1 上記のメッセージは下のメッセージと同じです。 .iso.org.dod.internet.private.enterprises.bea.beaSystem.
sysDescr

次のコマンドは、topazというホストにcoldStartトラップを送信します。認可用のコミュニティには、publicを使用します。specific-trap引数の値は、trap-type引数の値が6以外(enterpriseSpecific)の場合は無視されますが、必ず指定してください。
snmptrap topaz public 0 1 “host xyz is booting”

snmptrapd

目的

snmp-trapポートに送信されたSNMPトラップ・メッセージを受信してログに記録します。

形式

snmptrapd [-d] [ -l port ] [-p]

引数

-d

パケットごとにプログラムでデバッグ・メッセージを表示します。

-l port

受信トラップ・パケットをリスニングする際に使用するUDPポートを指定します(デフォルトは162)。

-p

トラップ情報を標準出力に出力します。

環境変数

BEA_SM_SNMP_MIBFILE
mib.txtへのパスを指定する場合に使用します。このファイルには、プライベートMIBがASCIIテキストで記述されています。

説明

このユーティリティは、-l引数で指定したUDPポートでSNMPトラップを受信します。ポートを指定しなかった場合は、ポート番号162が使用されます。このユーティリティは、snmp-trapポートを開けるようにする必要があり、ポートを開くには、通常root権限が必要です。
UNIXプラットフォームでは、-p引数を指定しなかった場合、snmptrapdは、UNIX syslogユーティリティを使用して、WARNINGステータスのメッセージをログに記録します。LOG_LOCAL0機能が使用可能な場合は、syslogまたはsnmptrapdのかわりに、この機能が使用されます。Windowsシステムでは、-p引数を指定しなかった場合、イベント・ログを使用してWARNINGメッセージを記録します。

以下のコマンドは、別のホストから送られてきたSNMPトラップを収集し、それを標準出力に出力します。
snmptrapd -p ホストがトラップを受信すると、以下の情報が表示されます。 192.84.232.47: Cold Start Trap (0) Uptime: 0:00:00
Name: private.enterprises.bea. beaSystem.beaTrapDescr.0
OCTET STRING- (ascii): host xyz is booting

snmpwalk

目的

SNMP GetNextリクエストを使用してOIDツリーを検索することにより、管理対象オブジェクトに問い合せます。

形式

snmpwalk [-d] [-p port] host community [variable_name...]

引数

-d

パケットごとにプログラムでメッセージを表示します。

-p port

SNMPエージェントとの通信に使用するUDPポートを指定します(デフォルトは161)。

host

SNMPリクエストを送信する先のホストの名前またはインターネット・アドレスをピリオドで区切って指定します。

community

SNMPリクエストで使用するコミュニティ名。

variable_name

シンボリック名、10進数、またはその2つを組み合せた一意のオブジェクト識別子。変数名が指定されていない場合、snmpwalkはMIB全体を検索します。

説明

このユーティリティは、コマンドラインで指定したオブジェクトからOIDツリーをたどります。コマンドラインには、1つ以上のオブジェクト識別子を引数として入力できます。この名前は、絶対パスで指定しても、ツリーのルートから始めても、.iso.org.dod.internetを基にした相対パスで指定してもかまいません。オブジェクトを指定しなかった場合、snmpwalkは、SNMPエージェントでサポートされているMIBツリー全体を検索します。

環境変数

BEA_SM_SNMP_MIBFILE
mib.txtへのパスを指定する場合に使用します。このファイルには、プライベートMIBオブジェクトがASCIIテキストで記述されています。

診断

ツリー検索でMIBの最後を超えて検索する場合は、以下のメッセージが表示されます。
End of MIB

次に、snmpwalkコマンドの例を示します。
snmpwalk blueberry public private.enterprises.bea.beaSystem このコマンドによって、以下の部分を含む出力が生成されます。 Name: private.enterprises.bea.beaSystem.beaSysSysname.0
OCTET STRING- (ascii): SunOS
Name: private.enterprises.bea.beaSystem.beaSysNodename.0
OCTET STRING- (ascii): blueberry

 


SNMPリクエストの形式

Oracle SNMPエージェント・ユーティリティは、SNMPリクエストを使用して、管理対象オブジェクトに関する情報をSNMPエージェントに問い合せます。SNMPリクエストの形式については、RFC 1157 (SNMP)を参照してください。このRFCはインターネットでも公開されています。詳細は、「SNMPに関する情報」を参照してください。

 


MIB変数定義ファイル

MIB変数をOracle SNMPエージェント・ユーティリティで使用する場合、ユーティリティは、この変数を数値OIDに変換するために検索を実行します。検索順序は、現在のディレクトリにあるmib.txtファイル、環境変数BEA_SM_SNMP_MIBFILEで指定したファイル、tux_prod_dir\udataobj\snmp\etc\mib.txtファイル(Windowsシステムの場合)またはtux_prod_dir/udataobj/snmp/etc/mib.txtファイル(UNIXシステムの場合)です。 これらのファイルには、RFC 1155 (管理情報の構造)で定義されているASN.1表記およびOBJECT TYPEマクロを使用する必要があります。

mib.txtファイルには、RFC 1213 (MIB-II)およびOracleプライベートMIBオブジェクトが記述されています。


  先頭に戻る       前  次