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

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

構成ファイル

次の項では、Oracle SNMPエージェント・インテグレータとOracle SNMPエージェントがアクセスする構成ファイルについて説明します。

 


Oracle SNMPエージェントの構成ファイル(beamgr.conf)

起動時に、Oracle SNMPエージェント・インテグレータ(snmp_integrator)およびOracle SNMPエージェント(tux_snmpd)は、BEA_SM_BEAMGR_CONF環境変数で指定された絶対パスを読み取って、ホスト・システム上のbeamgr.conf構成ファイルを特定します。Oracle SNMPエージェント・インテグレータおよびエージェントは、beamgr.confファイルの一部の構成を読み取ります。

注意: BEA_SM_BEAMGR_CONF設定は、ファイル名beamgr.confで終わります。

デフォルトの格納場所

BEA_SM_BEAMGR_CONF環境変数が設定されていない場合、Oracle SNMPエージェント・インテグレータおよびエージェントは、次のデフォルトの格納場所でbeamgr.confを探します。

ホスト・システム上にbeamgr.confファイルが見つからなかった場合、Oracle SNMPエージェント・インテグレータおよびエージェントはエラー・メッセージを表示し、起動を 中止します。beamgr.confファイルは、必須の構成ファイルです。

説明

beamgr.conf構成ファイルには、Oracle SNMPエージェント・インテグレータおよびOracle SNMPエージェントで使用される情報が格納されています。ファイルの構成エントリは、複数の空白またはタブ区切りのフィールドで構成されます。

KEYWORD parameters

エントリが長すぎる場合、行の末尾に円記号(¥)を使用すると、次の行に続けることができます。¥文字の直後は、改行文字でなければなりません。

次のキーワードには、対応するMIBオブジェクトがあります。

すべてのOracle SNMPエージェント・コンポーネントで使用するキーワード

TRAP_HOST

SNMPトラップの送信に必要なホスト名、ポート番号、コミュニティ名。

host_name trap_port trap_community

host_hame

トラップ通知の送信先となるターゲット・マシンの名前。デフォルト値はローカル・ホストです。

トラップを複数のマシンに送信する必要がある場合は、構成ファイルで複数のTRAP_HOSTを入力できます。

TRAP_HOSTエントリは、SNMPトラップ通知が生成されるときにトラップの送信先を決めるためにOracle SNMPエージェント・インテグレータおよびSNMPエージェントで使用されます。

SNMP_ENABLE_AUTH_TRAP

SNMPエージェントが認証失敗トラップを生成できるかどうかを示す値を格納します。値が1の場合、コミュニティ・プロファイルに準拠していない無効なリクエストを受信すると、SNMPエージェントは認証失敗トラップを生成します。値が1以外の場合、認証失敗トラップは生成されません。

OID_CLASS

OIDは、MIB内の各オブジェクトにオブジェクト識別子として割り当てられたユニークな数字です。各OIDは、特定のカテゴリまたはクラスに分類されます。SNMPエージェントが特定のオブジェクトにアクセスする場合、MIBファイル内のOIDツリーをたどって目的のオブジェクトを見つけます。OIDは、OIDツリーのルートから目的のオブジェクトまでのユニークなパスを指定することでオブジェクトを識別します。

Oracle SNMPエージェント・インテグレータで使用するキーワード

INTEGRATOR_TIMEOUT

Oracle SNMPエージェント・インテグレータがリクエストへのレスポンスを待機するタイムアウトを設定します。デフォルトのタイムアウトは30秒です。次のようにINTEGRATOR_TIMEOUTエントリを追加することで、Oracle SNMPエージェント・インテグレータのタイムアウトを設定できます。

BEA_PEER MAX_WAIT 30

INTEGRATOR_MAX_TIMEOUTS

SNMPピアまたはSMUXサブエージェントに対するリクエストがタイムアウトになり、以降のリクエストが無視されるまでに試行できる最大回数を設定します。デフォルトは3です。

NON_SMUX_PEER

Oracle SNMPエージェント・インテグレータのピアとして実行されているSNMPエージェントが利用可能なOIDを指定します。詳細は、「NON_SMUX_PEERエントリ」を参照してください。

RULE_ACTION

Oracle SNMPエージェント・インテグレータのポーリング規則を指定します。この値を指定すると、ネットワーク管理システムのしきい値チェックの負荷を、管理対象ノードの各分散インテグレータ・エージェントに分散できます。詳細は、「RULE_ACTIONエントリ」を参照してください。

Oracle SNMPエージェントで使用するキーワード

TMAGENT

エージェントのモニター対象となるOracle Tuxedoドメインを定義します。管理対象ノード上のTuxedo SNMPエージェントごとに1つのTMAGENTエントリが必要です。このエントリの形式は次のとおりです。

TMAGENT logical_agent_name tuxdir tuxconfig_path

複数のドメインをモニターするには、モニター対象ドメインごとに個別のTuxedoエージェントを実行します。このエージェントは、Oracle SNMPエージェント・インテグレータの下でSMUXサブエージェントとして実行する必要があります。

管理対象ノード上でSMUXサブエージェントとして実行されているTuxedo SNMPエージェントが複数ある場合、SetまたはGetリクエストでコミュニティを変更するには、論理エージェント名を使用する必要があります。コミュニティの形式は次のとおりです。

community@logical_agent_name

例:

public@payrollagent

管理対象ノードで実行されているTuxedo SNMPエージェントが1つしかない場合、コミュニティを論理エージェント名で修飾する必要はありません。

TMEVENT_FILTER

Oracle Tuxedoイベント通知のどの部分をSNMPトラップ通知として転送するかを定義します。フィルタを指定していない場合、デフォルトでは、すべてのTuxedoイベントがSNMPトラップとして転送されます。エントリの形式は次のとおりです。

TMEVENT_FILTER filter_id logical_agent_name tux_evt_expr
tux_evt_filter status

各パラメータの文字列の間には空白文字がないことに注意してください。

filter_id

このIDには、Oracle SNMPエージェントの構成ファイルで指定したすべてのTMEVENT_FILTERエントリに対してユニークな文字列を指定する必要があります。文字列の最大値は16文字です。

logical_agent_name

そのノードの特定のエージェントにイベント・フィルタをマップします。論理エージェント名の長さは最大で32文字です。論理エージェント名は、エージェントを起動したWindowsサービスに付けられた名前(Windowsシステムの場合)、またはコマンドラインでエージェントを起動するときに-lオプションで指定した名前(UNIXシステムの場合)です。

tux_evt_expr

Tuxedoイベント名表現。この文字列には255文字以内の文字を使用できます。イベント名表現(正規表現)の詳細は、『Oracle Tuxedo ATMI C関数リファレンス』のリファレンス・ページ「tpsubscribe(3c)」を参照してください。

この名前は、SNMPトラップとして転送されるイベントのTuxedoイベント名と一致する必要があります。イベント名のリストについては、『ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のリファレンス・ページ「EVENTS(5)」を参照してください。

デフォルトはall(すべてのイベント)です。NONEを指定した場合、イベントは転送されず、TMEVENT_FILTERエントリの他のパラメータも無視される可能性があります。NONEを指定すると、同じ論理エージェント名の他のイベント・フィルタがすべてオーバーライドされます。例:

次のエントリ:

¥.Sys.*

は、すべてのイベントに一致します。

次のエントリ:

¥.SysServer.*

は、サーバーに関連するすべてのシステム・イベントに一致します。

tux_evt_filter

イベント・フィルタ表現。この文字列には255文字以内の文字を使用できます。各Tuxedoイベントには、イベントの関連情報を格納するFMLバッファが付いています。フィルタがある場合、バッファは、このフィルタに関連して評価されます。イベントは、バッファの内容がTRUEと評価された場合に転送されます。そうでない場合には転送されません。Oracle SNMPエージェントは、このフィルタをtpsubscribe()を呼び出す場合の引数として使用します。詳細は、『Oracle Tuxedo ATMI C関数リファレンス』のリファレンス・ページ「tpsubscribe(3c)」を参照してください。

status

activeまたはinactiveのどちらかになります。ステータスがactiveの場合、フィルタは使用中です。そうでない場合、フィルタは使用されていません。

Oracle SNMPエージェントの構成ファイルで指定したTMEVENT_FILTERエントリに対応するMIB表があります。これらのエントリは、SNMP Setリクエストで動的に更新できます。詳細は、『Oracle Tuxedo SNMPエージェントMIBリファレンス』「コアMIB」で説明されているbeaEvtFilterTableオブジェクトを参照してください。

NON_SMUX_PEERエントリ

ピアSNMPエージェント(非SMUXマスター・エージェントまたは非SMUXピア・エージェントなど)を介してMIBオブジェクトにアクセスするようにOracle SNMPエージェント・インテグレータを構成するには、次の形式でbeamgr.confファイルにNON_SMUX_PEERエントリを追加します。

NON_SMUX_PEER port community|*
OID_Node[,ro|rw][,
priority][,timeout] ...

NON_SMUX_PEER

エントリのキーワード。

port

SNMPエージェントがリスニングしているUDPポート番号を指定します。この値は、次のいずれかの形式で指定できます。

ip_address.port
hostname.port

この値は、SNMPエージェントがリモート環境でOracle SNMPエージェント・インテグレータに接続する場合に指定します。ip_addressまたはhostnameを指定していない場合、Oracle SNMPエージェント・インテグレータは、ピアSNMPエージェントがOracle SNMPエージェント・インテグレータと同じ管理対象ノードにあるものとみなします。

community

SNMPエージェントがポーリングされるときにOracle SNMPエージェント・インテグレータが使用するコミュニティを指定します。Oracle SNMPエージェント・インテグレータがSNMPマネージャによって提供されるコミュニティを使用するように指定する場合は、特殊な値*が使われます。

OID_Node

このSNMPエージェントでサポートされるMIBツリーのルートのOIDを指定します。

ro|rw

このOIDツリーを読取り専用でエクスポートするか、読取り/書込みでエクスポートするかを指定します。デフォルトはrwです。

priority

OIDツリーをエクスポートする際の優先度を示す正数。番号が小さいほど、優先度は高くなります。複数のエージェントまたはサブエージェントが同じMIBツリーをサポートしている場合、優先度の最も高いサブエージェントに問合せが行われます。複数のSNMPエージェントとSMUXサブエージェントは同じサブツリーを登録できます。ただし、別のプロパティで登録する必要があります。

SNMPエージェントが、すでに設定されている優先度でサブツリーを登録しようとする場合、Oracle SNMPエージェント・インテグレータは、未使用の優先度が見つかるまで整数値を繰返しインクリメントし(優先度を下げ)ます。特殊な優先度-1を使用すると、空いている優先度の中で最も高いものが選択されます。優先度-1で登録するようにリクエストされた場合、使用可能な20未満の数字の中で最も高い値で登録されます。優先度フィールドが見つからない場合、MIBツリーは、優先度-1でエクスポートされます。

timeout

Oracle SNMPエージェント・インテグレータが、特定のMIBグループを探すために、このSNMPエージェントからの応答を待つ間隔(秒)を指定します。デフォルト値は3秒です。デフォルト値を変更するには、BEA_PEER_MAX_WAIT環境変数を別の値に設定します。

アクセス(roまたはrw)、priorityおよびtimeoutフィールドは省略可能です。ただし、timeoutを指定する場合は、アクセスおよびpriorityを指定する必要があり、MIBツリーのpriorityを指定する場合は、アクセスを指定する必要があります。

複数のOIDノードをリスト表示できます。

サブツリー登録によって、サブツリー内の他のSNMPエージェント/サブエージェントによる登録オブジェクトが非表示になります。したがって、エージェントAがサブツリー.1.3.6.1.4.1.140を登録し、別のエージェント/サブエージェントBがサブツリー.1.3.6.1.4.1.140.1を登録する場合、.1.3.6.1.4.1.140.1サブツリーの下のすべてのオブジェクトについて、エージェント/サブエージェントAが問合せを受けることになります。

また、Oracle SNMPエージェント・インテグレータがこのエントリを読み取るときに、SNMPエージェントは、指定したポートで実行されている必要があります。指定したポートでSNMPエージェントが実行されていない場合、Oracle SNMPエージェント・インテグレータはこのエントリを無視します。さらに、このSNMPエージェントに対して3回続いたリクエストがタイムアウトした場合は、このエントリで指定したSNMPエージェントはアクティブではなくなり、このエントリは無視されます。

構成ファイルの再読取りをOracle SNMPエージェント・インテグレータに強制するには、reinit_agent snmp_integratorコマンドを任意の時点で呼び出すことができます。

Oracle SNMPエージェント・インテグレータは、MIBのSNMP (mib2.snmp)およびSMUXサブツリーの上、下、またはサブツリーでの登録を拒否/無視します。

NON_SMUX_PEERの例

次に、NON_SMUX_PEERエントリの使用例を示します。

OID_CLASSエントリ

このエントリは、SMUXサブエージェントによって使用されます。通常、SMUXサブエージェントは、SMUXマスター・エージェントによって認識したすべてのMIBグループを登録します。ただし、SMUXサブエージェントによってエクスポートされるMIBグループを制限できます。それには、beamgr.confに次の形式でOID_CLASSエントリを追加する必要があります。

OID_CLASS agent_name OID_Node[,ro|rw] [,priority] ..

OID_CLASS

エントリのキーワード。

agent_name

このエントリを適用可能なSMUXサブエージェントの名前を指定します。

OID_Node

このSMUXサブエージェントでサポートされるツリーのOIDを指定します。

ro|rw

このOIDツリーを読取り専用でエクスポートするか、読取り/書込みでエクスポートするかを指定します。デフォルトはrwです。

priority

OIDツリーをエクスポートする順序を示す正数。番号が小さいほど、優先度は高くなります。複数のサブエージェントが同じMIBツリーをサポートしている場合、優先度の最も高いサブエージェントに問合せが行われます。優先度フィールドがない場合、MIBツリーには、空いている優先度の中で最も高いものが適用されてエクスポートされます。このエントリは主に、Oracle SNMPエージェント・インテグレータのSMUXサブエージェントによってエクスポートされるOIDサブツリーを制限するために使用します。このエントリがない場合、SMUXサブエージェントは、認識できたMIBグループをすべてエクスポートします。

複数のOIDノードをリスト表示できます。

RULE_ACTIONエントリ

Oracle SNMPエージェント・インテグレータは、管理対象ノードでローカルに管理し、SNMPマネージャで生成されるポーリング・トラフィックを軽減するために、選択的にSNMPマネージャに通知するよう構成できます。C言語と同様のIF構文を使用すると、ローカルで使用可能なMIBオブジェクトに関する規則を定義し、それに従ってSNMPトラップを送信したり、コマンドをローカルで実行したり(またはその両方を行ったり)することが可能です。MIBオブジェクトは、Oracle SNMPエージェント・インテグレータ自体でサポートされているものでも、そのSNMPエージェントまたはSMUXサブエージェントのいずれかでサポートされているものでもかまいません。RULE_ACTIONエントリの詳細および例については、「Oracle SNMPエージェント・インテグレータを使用したポーリング」を参照してください。

構成は、beamgr.confファイルで行います。エントリの構文は次のようになります。

RULE_ACTION rule_name frequency_in_secs
if (VAL(
oid) rel_operator value) logical_op ( cond_2 ) ...
{ TRAPID_ERR=
enterprise_specific_trapid
TRAPID_OK=
enterprise_specific_trapid
COMMAND_ERR=
executable COMMAND_OK=executable }

注意: エントリは1行で記述する必要があります。複数行に分けて記述する場合は、継続文字としてバックスラッシュ(\)を使用する必要があります。\を継続文字として使用している場合、その直後には改行文字のみが来るようにする必要があります。

RULE_ACTION

このエントリを識別するためのキーワード。

rule_name

規則でアクションとして指定したコマンドにコマンドラインの引数として渡される各RULE_ACTIONエントリのユニークな識別子。この識別子には8文字以内の文字を使用できます。

frequency

snmp_integratorが条件をチェックするポーリングの頻度(秒)。

VAL

条件の左側に、このキーワードを指定する必要があり、この後に、MIBオブジェクトのオブジェクト識別子をカッコで囲んで指定します。各規則には、10個以内のVALキーワードを指定できます。

oid

オブジェクト識別子(OID)。OIDは、必ず数値で指定します。次のいずれかの形式を使用できます。

注意: 複雑な規則で複数のOIDを指定する場合、特定のインスタンスを指定するOIDと、同じ規則でワイルドカードを使用するOIDを混在させないでください。また、ワイルドカードを使用したOIDを1つの規則で複数使用する場合、すべてのOIDは、同じ表のオブジェクトのみを指定する必要があります。

rel_operator

有効な関係演算子のリストについては、「条件を定義するための関係」を参照してください。

value

条件内のRHSは、すでに説明したように、数字、文字列、IPアドレス(number1.number2.number3.number4)、OIDのいずれかの形式で指定できます。

RHSがOIDの場合は、一重引用符で囲まなければなりません。また、RHSの値のタイプは、条件のLHS内のOIDのVALUEのタイプに対応している必要があります。

logical_op

有効な論理演算子のリストについては、「条件に論理演算子を使用する」を参照してください。

処理を指定する

規則の状態がtrue (ERR)からfalse (OK)およびfalse (OK)からtrue (ERR)に遷移した場合には、コマンドの実行およびSNMPトラップの生成という2つの対応策があります。汎用OID (アスタリスクで列オブジェクトの全インスタンスを指定したOID)を使用して規則を定義している場合、表の任意の行でしきい値がtrueと評価されると、規則の状態はOKからERRに遷移します。また、MIB表のすべての行でしきい値がfalseと評価されると、規則の状態はERRからOKに遷移します。最初に、Oracle SNMPエージェント・インテグレータが起動する(またはreinit_agentコマンドで再初期化される)と、すべての規則の状態はOKに設定されます。次のキーワードで処理を指定します。

TRAPID_ERR = number

これは、規則の状態がfalse (OK)からtrue (ERR)に遷移したときに、numberのtrapidを持つエンタープライズ固有のSNMPトラップが生成されることを示します。

TRAPID_OK = number

これは、規則の状態がtrue (ERR)からfalse (OK)に遷移したときに、numberのtrapidを持つエンタープライズ固有のSNMPトラップが生成されることを示します。

COMMAND_ERR = command

これは、規則の状態がfalse (OK)からtrue (ERR)に遷移したときに、commandが実行されることを示します。

COMMAND_OK = command

これは、規則の状態がtrue (ERR)からfalse (OK)に遷移したときに、commandが実行されることを示します。

複数のドメインのRULE_ACTIONを設定する

構成ファイルには、複数のTMAGENTで定義した複数のドメインを格納できます。RULE_ACTIONを設定する手順は次のとおりです。

  1. TMAGENTエントリで、エージェントのモニター対象となるOracle Tuxedoドメインを定義します。単一の管理対象ノード上のTuxedo SNMPエージェントに対して1つのTMAGENTエントリが必要です。
  2. TMAGENT logical_agent_name TUXDIR TUXCONFIG

  3. Oracle SNMPエージェント・インテグレータが取捨選択して収集した情報をSNMPマネージャに通知するために、RULE_ACTIONエントリを使用します。
  4. RULE_ACTION rule_name frequency_in_secs

  5. 複数のTuxedo SNMPエージェントが同じノード上で実行されており、規則がTuxedo MIBオブジェクトを使用している場合、省略可能なrule_nameコンポーネントlogical _agent_namerule_nameに追加する必要があります。
  6. RULE_ACTION rule_name@logical_agent_name frequency_in_seconds
    if (...

    例:

    RULE_ACTION rule1@tux_snmpd10...

 


Oracle SNMPエージェントのパスワード・ファイル(beamgr_snmpd.conf)

必須のbeamgr.conf構成ファイルとは異なり、beamgr_snmpd.confパスワード・ファイルは省略可能の構成ファイルです。ホスト・システム上にbeamgr_snmpd.confファイルが見つからなかった場合でも、beamgr.confファイルがあれば、Oracle SNMPエージェント・インテグレータおよびエージェントは実行可能です。

デフォルトの格納場所

Oracle SNMPエージェント・インテグレータおよびエージェントは、次のデフォルトの格納場所でbeamgr_snmpd.confを探します。

説明

beamgr_snmpd.confパスワード・ファイルには、エージェントとマネージャの間の通信のパスワードとして使用するSNMPコミュニティ文字列が格納されます。UNIXシステムでは、beamgr_snmpd.confパスワード・ファイルはrootのみのアクセス権限でインストールされます。パスワードのセキュリティを確保するために、beamgr_snmpd.confファイルの読取り/書込み権限は、rootによるアクセスのみを許可するように設定します。

beamgr_snmpd.confファイルの構成エントリは、複数の空白またはタブ区切りのフィールドで構成されます。

KEYWORD parameters

KEYWORDの有効な値は次のとおりです。

COMMUNITY_RW

このキーワードに続く文字列で、エージェントに対して読取り/書込みコミュニティを指定します。このキーワードが構成ファイルにない場合、SNMPエージェントは、読取り/書込みコミュニティとしてiviewを使用します。このキーワードが指定されているエントリは、複数の読取り/書込みコミュニティを指定するために複数回繰り返すことができます。

COMMUNITY_RO

このキーワードに続く文字列で、エージェントに対して読取り専用コミュニティを指定します。このキーワードが構成ファイルにない場合、SNMPエージェントは、読取り専用コミュニティとしてpublicを使用します。このキーワードが指定されているエントリは、複数の読取り/書込みコミュニティを指定するために複数回繰り返すことができます。

SMUX_PASSWD

このキーワードに続く文字列で、SMUXパスワードを指定します。Oracle SNMPエージェント・インテグレータに登録する必要があるSMUXエージェントは、このパスワードを指定する必要があります。このキーワードがない場合、Oracle SNMPエージェント・インテグレータは、SMUXサブエージェントからの接続リクエストを認証しません。

SMUXサブエージェントは、起動時にBEA_SMUX_PASSWD環境変数で指定された値を読み取ってパスワードを取得します。この変数が設定されていない場合、SMUXサブエージェントは登録時にパスワードを指定しません。

DISABLE_SET

このキーワードに指定できる値はYESまたはNOです(デフォルトはNO)。YESに設定した場合、すべてのSNMPエージェントのSetアクセスは無効になります。

ホスト・システム上にbeamgr_snmpd.confファイルが見つからなかった場合、Oracle SNMPエージェント・インテグレータおよびエージェントは、COMMUNITY_RWCOMMUNITY_ROSMUX_PASSWD、およびDISABLE_SETに対してそれぞれのデフォルト値を使用します。


  先頭に戻る       前  次