ページの先頭行へ戻る
ETERNUS SF Storage Cruiser 16.2 運用ガイド
FUJITSU Storage

A.5 SNMPトラップXML定義ファイル説明

SNMPトラップXML定義ファイルを用いて、障害監視方法をカスタマイズできます。このファイルは、マネージャー側とエージェント側で定義します。

マネージャー側のSNMPトラップXML定義ファイル

障害管理する各装置(サーバノードを含む)からSNMPトラップを受信した時のイベントログのメッセージ、Systemwalker Centric Manager連携、Shell/Bat連携、外部スクリプト連携の動作を定義できます。ストレージシステムの運用環境に応じて、マネージャー側でのこれらの処理をデフォルトから変更したい場合にカスタマイズしてください。

このファイルを作成することで、サポートレベルIの装置も、サポートレベルAおよびBと同等の障害監視を実現できます。

エージェント側のSNMPトラップXML定義ファイル

エージェントのサーバノードに対する障害監視方法を定義します。エージェントの障害監視方法をデフォルトから変更したい場合にカスタマイズしてください。

設定ファイルの反映方法

マネージャー側の設定ファイルは動的に本製品に読み込まれるため、特別な反映方法はありません。

エージェント側の設定ファイルは静的に本製品に読み込まれるため、反映するにはエージェントの再起動が必要です。

カスタマイズ

注意

  • XML定義ファイルに誤りがある場合は、イベントログに下記の形式でメッセージが出力されます。このとき、障害レベルはInformationレベルで通知されます。また、Systemwalker Centric Manager連携・Shell/Bat連携も動作しません。

    メッセージ形式:"XML parse error (detected trap: (SNMPトラップデータ文字列))"
  • Systemwalker Centric Managerに通知されるときのswsagコードは、一部の装置を除き、すべて4821となります。

  • SNMPトラップ処理をカスタマイズする場合は、カスタマイズディレクトリ内の定義ファイルを編集するようにし、インストールディレクトリ内の定義ファイルを編集しないでください。

マネージャーでのファイル名と格納場所

SNMPトラップXML定義ファイルは、装置ごとに作成され、マネージャーのインストール時、アップグレード時に以下のディレクトリに格納されます。

マネージャーのOS種別

絶対パス名

Windows

$INS_DIR\ESC\Manager\opt\FJSVssmgr\lib\snmpth
($INS_DIRは、マネージャーをインストールした時の「プログラムディレクトリ」です。)

Solaris OS、
Linux

/opt/FJSVssmgr/lib/snmpth

カスタマイズする際は、上記ディレクトリのSNMPトラップXML定義ファイルを以下のカスタマイズ用ディレクトリにコピーし、コピーしたファイルを編集してください。

マネージャーのOS種別

絶対パス名(カスタマイズ用)

Windows

$ENV_DIR\ESC\Manager\etc\opt\FJSVssmgr\current\snmpth
($ENV_DIRは、マネージャーをインストールした時の「環境設定ディレクトリ」です。)

Solaris OS、
Linux

/etc/opt/FJSVssmgr/current/snmpth

マネージャーの動作は、以下のようになります。

  • カスタマイズ用ディレクトリにSNMPトラップXML定義ファイルがある場合

    カスタマイズ用ディレクトリのファイル内容に従います。

  • カスタマイズ用ディレクトリにSNMPトラップXML定義ファイルがない場合

    インストールディレクトリ内のファイル内容(デフォルト)に従います。

ファイル名は、装置のトラップに含まれるエンタープライズコードの"."を"_"に置き換えたものです。

表A.1 マネージャー導入時に存在するSNMPトラップXML定義ファイル

装置種

ファイル名

SN200、Brocade、
PRIMERGY ファイバーチャネルスイッチブレード、
Brocade VDX series、
PRIMERGY コンバージドスイッチブレード

1_3_6_1_4_1_1588_2_1_1_1.xml

CFX2000 series、
PRIMERGY コンバージドファブリックスイッチブレード(10Gbps 18/8+2)

1_3_6_1_4_1_211_1_127_118_2.xml

ETERNUS DX60/DX80/DX90

1_3_6_1_4_1_211_4_1_1_126_1_60.xml

ETERNUS DX80 S2/DX90 S2

1_3_6_1_4_1_211_4_1_1_126_1_100.xml

ETERNUS DX60 S3/DX100 S3/DX200 S3
ETERNUS DX200F

1_3_6_1_4_1_211_4_1_1_126_1_150.xml

ETERNUS DX60 S2

1_3_6_1_4_1_211_4_1_1_126_1_101.xml

ETERNUS DX400 series
ETERNUS DX8000 series

1_3_6_1_4_1_211_4_1_1_126_1_50.xml

ETERNUS DX400 S2 series

1_3_6_1_4_1_211_4_1_1_126_1_100.xml

ETERNUS DX500 S3/DX600 S3

1_3_6_1_4_1_211_4_1_1_126_1_150.xml

ETERNUS DX8000 S2 series

1_3_6_1_4_1_211_4_1_1_126_1_102.xml

ETERNUS DX8000 S3 series

1_3_6_1_4_1_211_4_1_1_126_1_152.xml

ETERNUS LT20(SCSI)

1_3_6_1_4_1_11_2_36_1.xml

ETERNUS LT200

1_3_6_1_4_1_119_1_83_1_21.xml

ETERNUS LT210/LT220/LT230

1_3_6_1_4_1_119_1_83_1_1.xml
1_3_6_1_4_1_119_1_83_1_2.xml

ETERNUS LT250

1_3_6_1_4_1_211_4_1_1_126_3_5.xml

ETERNUS LT260

1_3_6_1_4_1_20884_3.xml

ETERNUS LT270

1_3_6_1_4_1_211_4_1_1_126_3_2.xml

ETERNUS LT270 S2

1_3_6_1_4_1_211_4_1_1_126_3_6.xml

テープ暗号化装置

1_3_6_1_4_1_2021_250_10.xml

Fibre Alliance MIBサポート装置

1_3_6_1_3_94.xml

ETERNUS NR1000 series

1_3_6_1_4_1_789.xml

ETERNUS VS850

1_3_6_1_4_1_2_6_190.xml

ETERNUS LT20/LT20 S2/LT40/LT40 S2/LT60/LT60 S2 (SAS/FC)

1_3_6_1_4_1_20884_10893_2_101_3.xml

ETERNUS CS2000

1_3_6_1_4_1_231_2_48_2_0.xml

ETERNUS VX700 series

1_3_6_1_4_1_211_1_21_4_1_50.xml

性能管理からのイベント

1_3_6_1_4_1_211_4_1_3_21_3.xml

Solaris OS版またはWindows版エージェントからのイベントでマルチパス関係

1_3_6_1_4_1_211_4_1_3_21_2.xml (注1)

Solaris OS版エージェントからのSafe/PRIMECLUSTER GDS、GFSシリーズのイベント

1_3_6_1_4_1_211_4_1_3_21_2_2.xml (注1)(注2)

Solaris OS版エージェントからのマルチパス関係のイベント

1_3_6_1_4_1_211_4_1_3_21_2_21.xml (注1)(注2)

Windows版エージェントからのマルチパス関係のイベント

1_3_6_1_4_1_211_4_1_3_21_2_5.xml (注1)(注2)

Windows版エージェントからのMPIOのイベント

1_3_6_1_4_1_211_4_1_3_21_2_51.xml (注1)(注2)

Linux版エージェントからのETERNUS Multipath Driverのイベント

1_3_6_1_4_1_211_4_1_3_21_2_3.xml (注1)(注2)

Linux版エージェントからのPRIMECLUSTER GDS、GFSシリーズのイベント

1_3_6_1_4_1_211_4_1_3_21_2_31.xml (注1)(注2)

HP-UX版エージェントからのLVM(PV-Links)のイベント

1_3_6_1_4_1_211_4_1_3_21_2_4.xml (注1)(注2)

HP-UX版エージェントからのHBAドライバのイベント

1_3_6_1_4_1_211_4_1_3_21_2_41.xml (注1)(注2)

AIX版エージェントからのイベントでマルチパス関係

1_3_6_1_4_1_211_4_1_3_21_2_6.xml (注1)(注2)

注1: このファイルは「定義ファイルの形式」の「定義内容」のうち、動作定義(flag属性)のSystemwalker Centric Manager連携(ただし、Shell/Bat連携の制御だけでSystemwalker Centric Manager連携はできません)、および外部スクリプト連携1、外部スクリプト連携2のon/off設定だけ変更可能です。障害レベルおよびメッセージは変更できません。

注2: このファイルを更新する場合は、エージェントの同名ファイルと同じ内容に更新する必要があります。

上記以外の装置に対しても、装置のエンタープライズコードを基にXMLファイルを作成することにより、装置に対するSNMPトラップ 処理が可能です。

エージェントでのファイル名と格納場所

SNMPトラップXML定義ファイルの格納場所は、以下のとおりです。

エージェントのOS種別

絶対パス名

Windows

$ENV_DIR\ESC\Agent\etc\snmpth
($ENV_DIRは、エージェントをインストールした時の「環境設定ディレクトリ」です。)

Solaris OS、
Linux、
HP-UX、
AIX

/etc/opt/FJSVssage/snmpth

エージェントは、起動時にこのファイルを読み込んで動作します。このため、変更した内容をエージェントに反映するには、エージェントの再起動が必要です。

ファイル名は、エージェントがマネージャーに発行するトラップのエンタープライズコードの"."を"_"に置き換えたものです。

表A.2 エージェント導入時に存在するSNMPトラップXML定義ファイル

サーバノード

ファイル名(注)

監視対象

Solaris OS

1_3_6_1_4_1_211_4_1_3_21_2_2.xml

Safe/PRIMECLUSTER GDS、GFSシリーズ

1_3_6_1_4_1_211_4_1_3_21_2_21.xml

ETERNUS Multipath Driver

1_3_6_1_4_1_211_4_1_3_21_2_22.xml

EMC PowerPath

1_3_6_1_4_1_211_4_1_3_21_2_23.xml

HITACHI JP1/HiCommand Dynamic Link Manager

1_3_6_1_4_1_211_4_1_3_21_2_24.xml

Sun MPxIO

Windows

1_3_6_1_4_1_211_4_1_3_21_2_5.xml

ETERNUS Multipath Driver

Linux

1_3_6_1_4_1_211_4_1_3_21_2_3.xml

ETERNUS Multipath Driver

1_3_6_1_4_1_211_4_1_3_21_2_31.xml

PRIMECLUSTER GDS、GFSシリーズ

HP-UX

1_3_6_1_4_1_211_4_1_3_21_2_4.xml

PV-LINK(LVMの機能)

1_3_6_1_4_1_211_4_1_3_21_2_41.xml

HBAドライバ

AIX

1_3_6_1_4_1_211_4_1_3_21_2_6.xml

MPIO

注: このファイルを更新する場合は、マネージャーの同名ファイルと同じ内容に更新する必要があります。

定義ファイルの形式
定義内容

定義ファイルには、トラップのSpecific Trap Typeごとに、以下の項目について動作を定義します。

項目

内容

動作定義

画面に状態変化の通知を表示する/しない

イベントログを出力する/しない

Systemwalker Centric Manager連携、Shell/Bat連携を行う/行わない

外部スクリプト連携1を行う/行わない

外部スクリプト連携2を行う/行わない

障害レベル

各イベント、Systemwalker Centric Manager連携通知のレベル

(Information/Warning/Error)

メッセージ

イベントおよびSystemwalker Centric Manager連携に出力するメッセージ

ノード階層

タグのノード階層は以下のようになります。

タグと属性の種類
SNMPTrapControlタグ

属性名

内容

name

装置名

ver

この定義ファイルのVersion

ExternalScript1タグ、ExternalScript2タグ(オプション)

外部スクリプト連携を利用するときにスクリプト名を定義します。ExternalScript1タグが外部スクリプト連携1、ExternalScript2タグが外部スクリプト連携2になります。

ここで定義したスクリプトは、TrapTypeタグやConvertタグのflag属性で該当する連携bitをonにすることで実行されます。

ExternalScript1タグ、ExternalScript2タグは、TrapTypeタグ定義よりも前行に定義する必要があります。

属性名

内容

name

実行するスクリプト名(フルパス指定)

TrapTypeタグ

Specific Trap Type単位にそのトラップの解析動作を定義します。このタグで定義しないTypeのトラップは、解析処理を行わず破棄されます。

属性名

内容

type

"ST" + Specific Trap Type番号(10進数)

flag

イベント、Systemwalker Centric Manager連携、スクリプト連携、およびメール通知の動作を、2進数7bitで定義します。

0はoff、1はonと解釈されます。

bit6 … Informationイベントのメール通知 (注1)
bit5 … 外部スクリプト連携2
bit4 … 外部スクリプト連携1
bit3 … Systemwalker Centric Manager連携、Shell/Bat連携 (注2)
bit2 … イベントログ出力
bit1 … (変更不可)
bit0 … 状態変化の通知

例えば、Systemwalker Centric Manager連携だけをonにするには、flag="0001000"と記述します。

なお、4bit分しか記述していない場合、bit4、bit5、およびbit6は0と解釈されます。
例えば、flag="1111"は、flag="0001111"と同じ意味になります。

level

イベントおよびSystemwalker Centric Managerへの通知レベルを定義します。

I … Information
W … Warning
E … Error

msg

イベント、Systemwalker Centric Manager連携および外部スクリプト連携で表示するメッセージを定義します。メッセージには、以下のパラメーターを含めることができます。

%d … 10進数
%x … 16進数
%s … 文字列

パラメーターを含めた分、ARGタグを定義する必要があります。

%に続く文字がd、x、s以外の場合、その%はそのまま表示されます。

注1: Informationイベントのメール通知を有効にする場合、または、WarningイベントおよびErrorイベントのメール通知を無効にする場合に、onに設定します。

注2: エージェントのイベントはSystemwalker Centric Managerに通知されないため、エージェントの定義ファイルではShell/Bat連携の制御だけとなります。

ARGタグ

ARGタグは、TrapTypeタグのmsg属性内で指定したパラメーターとトラップデータ内のVariable Bindingのインデックスの対応を定義します。このARGタグは、msg属性内で指定したパラメーターと同じ数分定義する必要があります。

属性名

内容

index

TrapTypeタグのmsg属性値に含まれるパラメーターのインデックス番号(0~)

VBIndex

トラップデータ内のVariable Bindingのインデックス番号(0~)

Convertタグ (オプション)

Convertタグは、トラップのINTEGERタイプのデータ値に対する文字列表現を定義します。このタグの定義は必須ではありません。例えば、トラップデータ値0がステータスOKを示す場合、<Convert val="0" name="OK"/>と定義することで、イベントメッセージに"0"ではなく"OK"という文字列を表示できます。

また、flag属性、level属性(オプション)の指定によって、TrapTypeタグのlevel属性で指定した障害レベルを変更して通知できます(msg属性に複数のARGがあり、それぞれのConvertタグにflag属性またはlevel属性がある場合は、最後のARGのConvertタグの指定が採用されます)。

属性名

内容

val

トラップ内のINTEGERタイプのデータ数値(10進数)

flag (オプション)

イベント、Systemwalker Centric Manager連携、スクリプト連携、メール通知制御(2進数7bit)

値は「TrapTypeタグ」を参照

level (オプション)

障害レベル'I' or 'W' or 'E'

TrapTypeタグよりも優先される

name

valに対応する文字列

定義に存在しない値を受信した場合は、そのまま数値表現で表示されます。

MSGタグ

MSGタグは、サーバノードエージェントが監視する監視キーワードを定義します。このMSGタグは、サーバノードエージェントだけに有効です。

Windows版エージェントの場合: id属性、src属性、type属性で監視します(key属性は無視されます)。

Windows版以外のエージェントの場合: key属性で監視します(id属性、src属性、type属性は無視されます)。

属性名

内容

key

監視する監視キーワード(Windows版以外のエージェントの場合必須)

id

監視するイベントのイベントID(Windows版エージェントの場合必須)

src

監視するイベントのソース名(Windows版エージェントの場合必須)

line

VALタグを使用(監視イベントの部分文字列を通知情報に追加)する場合、監視イベントの行数をline属性に指定する。1行の場合またはWindowsの場合は、line属性を省略できる。

type

監視するイベントログの種類を指定する。(Windows版エージェントの場合だけ有効)

  • System: システムログを監視する(省略値)

  • Application: アプリケーションログを監視する

監視キーワードを変更したい場合は、このキーワードを変更します。

監視キーワードには、正規表現を指定することもできます。

新たに監視する監視キーワードを追加したい場合は、TrapTypeタグ以降を追加します。この時、Specific Trap Type番号が重複しないように指定してください。

VALタグ (オプション)

VALタグは、監視イベントから文字列を抽出して通知情報に追加する方法を定義します。このVALタグは、サーバノードエージェントだけに有効です。

属性名

内容

ref

通知する情報に追加する値を( )で指定する。()内は正規表現で指定。

DTDによるID属性指定

SNMPトラップ制御ではTrapTypeタグのtype属性をID属性として検索するため、XML定義ファイルに以下のDTDの記述が必要です。

<!DOCTYPE SNMPTrapControl[
<!ATTLIST TrapType type ID #REQUIRED>
]>
定義ファイルサンプル
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE SNMPTrapControl
<!ATTLIST TrapType type ID #REQUIRED>
]>
<SNMPTrapControl name="SW3800" ver=1.0">
  <TrapType type="ST1" flag="111111" level="E" msg="Faulty reason: %d">
    <ARG index="0" VBIndex="0">
      <Convert val="0" flag="000110" level="I" name="sw-ok"/>
      <Convert val="1" name="sw-faulty"/>
    </ARG>
  </TrapType>
  <TrapType type="ST2" flag="000111" level="E" msg="%s: is currently in state %d">
    <ARG index="0" VBIndex="4"/>
    <ARG index="1" VBIndex="0">
      <Convert val="1" name="unknown"/>
      <Convert val="2" name="faulty"/>
      <Convert val="3" name="below-min"/>
      <Convert val="4" flag="000110" level="I" name="nominal"/>
      <Convert val="5" name="above-max"/>
      <Convert val="6" name="absent"/>
    </ARG>
  </TrapType>
</SNMPTrapControl>

ETERNUS SN200 series、Brocade seriesのFCポートOnline/Offlineトラップの抑止方法

ETERNUS SN200 series、Brocade seriesのFCポートOnline/Offlineトラップを抑止したい場合は、該当XML定義ファイルについて下記の箇所を変更してください。

type属性が"ST3"の<ARG index="1" VBIndex="0">内の Convertタグの val="1"およびval="2"について、flag属性を"000000"に変更。

<Convert val="1" flag="000000" level="I" swsag="4203" name="Online"/>
<Convert val="2" flag="000000" level="I" swsag="4203" name="Offline"/>