TL1 AlarmMap
内容
casp1032jp
内容
TL1 ゲートウェイ AlarmMap は、
CA Spectrum
アラートへの TL1 イベントおよびアラームの内部マッピングです。AlarmMap は、TL1 デーモンによって、受信 TL1 イベントまたはアラームを破棄するか、またはアラート コードに変換して、CA Spectrum
に転送するかを判断するために使われます。したがって、AlarmMap は、不要な TL1 イベントまたはアラームを破棄するフィルタとして機能します。AlarmMap をサポートするためには、別のマッピング ファイルも必要です。TL1 AlarmMap に指定されているアラート コードは、
SpectroSERVER
上の対応する AlertMap ファイルによって処理します。AlertMap ファイルが見つからない場合、TL1 アラートがイベントに正しくマップされません。詳細については、「TL1 の AlertMap」を参照してください。AlarmMap には通常、特定のマッピングがない TL1 イベントまたはアラームに使われるデフォルトのエントリが含まれます。つまり、マップされていない TL1 イベント/アラームはすべて、デフォルトのエントリに指定されている同じ
CA Spectrum
アラートになります。TL1 アラームを以下のイメージに示します。

アラームごとの TL1 の詳細を以下のイメージに示します。

AlarmMap の形式
AlarmMap は、それぞれ以下の 5 つのカンマ区切りフィールドを構成するレコードのシーケンスです。
<type>,<condition>,<alert-code>,<clr-alert-code>,<process>
- <type>「ALM」(アラーム)または「EVT」(イベント)のいずれかとしてエントリを指定するテキスト文字列。
- <condition>Telcordia 標準ドキュメント GR-833-CORE に指定された TL1 条件タイプ(TL1 アラーム)を識別するテキスト文字列。この文字列が空白または空の場合、レコードは AlarmMap のデフォルトのエントリとして機能します。文字列がハイフンで終わる(OGCCS- など)場合、その文字列で始まるすべての条件がこのエントリによってマップされます。「ワイルドカード」に類似しています。
- <alert-code>CA Spectrumが、この TL1 イベント/アラームに使用するアラート コードを指定する「0x」が先頭に付いた 16 進リテラル。
- <clr-alert-code>CA Spectrumが、TL1 イベント/アラームをクリアするために使用するコードを指定する「0x」が先頭に付いた 16 進リテラル。
- <process>イベント/アラームを処理するかどうかを指定するブール値(TRUE または FALSE)です。TRUE の場合、CA Spectrumに対してアラートが生成されます。FALSE の場合、受信 TL1 イベント/アラームは廃棄され、CA Spectrumに何も転送されません。AlarmMap の例を以下に示します。ALM, ,0x3d50001 ,0x3d50002 ,TRUE <------ DEFAULTALM,LINETERM ,0x3d500f3 ,0x3d500f4 ,TRUEALM,ECOI ,0x3d501b9 ,0x3d501ba ,TRUEALM,SLOR ,0x3d501c9 ,0x3d501ca ,TRUEEVT,NTYDGSP ,0x3d5009d ,0x3d5009e ,TRUEカンマはスペースで囲むことができます。<process> フィールド以降とスペースは、読みやすくするためのコメントとして扱われます。
AlarmMap の内容は、TL1 ゲートウェイのパフォーマンスに重要です。興味のある TL1 アラームのみが処理されるように、AlarmMap を設定します。つまり、
CA Spectrum
アラートを生成させたくないすべての TL1 アラームに対して、<process> 値が FALSE に設定されていることを確認します。マップにデフォルトのエントリがあることを前提として、「不要な」 TL1 イベント/アラームは、マップに表示されなくても、デフォルトのマッピングによって処理されます。この追加処理を防ぐには、以下の手順のいずれかを実行できます。
- <process> 値を FALSE に設定して、すべての不要な TL1 イベント/アラームをマップに含めます。
- デフォルトのエントリを削除します。
tl1map ユーティリティ
TL1 ゲートウェイには、AlarmMap を調査し、以下の 2 つの操作のいずれかを実行できる tl1map と呼ばれるコマンドライン ツールが含まれています。
- TL1 デバイス モデルまたは TL1 デバイス モデル タイプ(Gen_TL1_Dev)のいずれかから、AlarmMap を抽出します。
- TL1 デバイス モデルまたは Gen_TL1_Dev モデル タイプに、テキスト ファイルの形式で、AlarmMap をインポートします。
tl1map ツールは、
CA Spectrum
の最上位ディレクトリの TL1Apps サブディレクトリにあります。tl1map は、シェル コマンド ラインまたはスクリプト内(より複雑な AlarmMap の操作を実行する必要がある場合)のいずれかから実行できます。いずれにしても、tl1map は SpectroSERVER クライアントであるため、SpectroSERVER が稼働中である必要があります。注:
tl1map ユーティリティは、Gen_TL1_Dev 階層のモデル/モデル タイプ専用です。その他のモデル/モデル タイプで使用することを意図しておらず、正しく使用しないと、データの破損が発生する可能性があります。構文
.tl1map {load | dump} -f mfile {-t | -m} handle [host]
- dump内部 AlarmMap をテキスト形式で抽出し、-f オプションで指定されたファイルにテキスト形式で保存します。
- ロード-f オプションで指定された入力ファイルを処理し、AlarmMap を対応する属性に書き込みます。
- -f mfile次のエントリが特定のマップ ファイル(mfile)の名前を提供することを示します。ロード モードでは、提供される入力ファイルが AlarmMap 構文を使用していることが期待され、内部 TL1 AlarmMap オブジェクトに変換されます。ダンプ モードでは、すでに存在する内部 AlarmMap の内容が抽出され、フォーマットされて、指定された mfile に書き込まれます。このファイルは、テキスト エディタによる目視検査と処理に適しているため、変更して、ロード オプションを使用して再インポートできます。
- -t指定したハンドルが TL1 デバイス モデル タイプのモデル タイプ ハンドルであることを指定します。
- -m指定したハンドルが TL1 デバイス モデルのモデル ハンドルになることを指定します。
- handleTL1 デバイス モデル タイプ(-t フラグを使用した場合)または TL1 デバイス モデル(-m フラグを使用した場合)のいずれかのハンドルを指定します。制限:16 進形式
- hostCA Spectrumホストの名前。これは、リモート ホストにアクセスする場合、または「本当の」ホスト名が小文字形式でアドバタイズされているが、Unix hostname コマンドで大文字と小文字が混在する名前が報告された場合にのみ必要です。どの場合でも、tl1map はローカル ホスト上で実行する必要があります。
注:
-f、-t、および -m-f オプションは任意の順序で指定できます。AlarmMap の抽出
tl1map が dump オプションで呼び出された場合、モデル(-m オプション)またはモデルタイプ(-t オプション)のいずれかから現在の AlarmMap 属性値を読み取り、人間が理解できる形式に変換し、-f オプションで指定されたファイルに書き込みます。そのファイルには、モデル名、モデル タイプ名、モデル ハンドル、モデル タイプ ハンドル、ホスト名、現在のタイムスタンプ(ユーティリティが呼び出されたマシンに基づく)などの情報ヘッダも含まれます。ヘッダはコメントとしてフォーマットされるため、このマシンで生成されたファイルを使用した後続のすべてのインポート操作に影響しません。
一般に、テキスト エディタでこの AlarmMap ファイルを調べて、必要な変更を加えてから、load オプションで tl1map を呼び出すことによって、ファイルを再度インポートします。
注:
出力ファイル内のエントリは順不同です。2 つの異なる AlarmMaps を比較する場合は、以下の手順を実行する必要があります。- コメント ヘッダを削除します。
- ファイルをソートします。
- 実際の比較を実行します。
AlarmMap のインポート
以下のいずれかのシナリオで、AlarmMap をインポートするには、load オプションで tl1map ユーティリティを使用します。
- TL1 デバイス ベンダーのドキュメントまたは TL1 標準ドキュメントに基づいて、初期 AlarmMap を作成する。
- 以前に保存された AlarmMap を抽出し、いくつかの変更を適用して、変更されたバージョンを再度インポートする。
- 1 つのモデル/モデル タイプから AlarmMap を抽出し、別のモデル/モデル タイプ(別のホスト上など)にインポートする。
ファイルから初期の AlarmMap をインポートする場合、ファイルが AlarmMap ファイルの形式の仕様に準拠していることを確認する必要があります。
tl1map ユーティリティは、AlarmMap ファイルに不正なエントリを検出した場合、制限付き診断メッセージを表示します。何らかのエラーがあった場合、モデル/モデル タイプ属性にデータは書き込まれません。
tl1map の使用例
以下の例では、さまざまな特定のタスクを実行するために、tl1map ユーティリティを使用する方法を示しています。例では、/dev/stdin および /dev/stdout を使用していることに注意してください。これらは NT では使用できないため、Unix 式のパイプの代わりに中間ファイルを使用します。
AlarmMap をモデル 0x146007 にインポートする方法
tl1map load -f custom.amap -m 0x146007
AlarmMap をファイルにエクスポートする方法
AlarmMap をファイルにエクスポートすると、変更できるようになります。変更したファイルは、再ロード/インポートできます。
tl1map dump -f exp.amap -t 0x4010000
次に、exp.amap を編集した後に保存します。
tl1map load -f exp.amap -t 0x4010000
モデル間で AlarmMap をコピーする方法
tl1map dump -m0x1503fcc -f/dev/stdout | tl1map load -m0x1504003 -f/dev/stdin
AlarmMap から「LINETERM」エントリを削除する方法
tl1map dump -m0x1504003 -f/dev/stdout | sed '/LINETERM/d' | tl1map load -m0x1504003 -f/dev/stdin
あるホストのモデルベースのマップを別のホストのモデル タイプベースのマップにコピーする方法
tl1map dump -m0x1504003 -f/dev/stdout hosta | tl1map load -t0x25040cc -f/dev/stdin hostb
以下の例では、簡単な AlarmMap エディタを実装するために使用できるシェル スクリプトを示しています。
#! /bin/ksh # # A simple AlarmMap editor # # Syntax: tl1edit { -m | -f } handle [ host ] # # Your favorite text editor if [[ -z $EDITOR ]] ; then EDITOR=vi fi # Generate a unique, temp file name MF=`date '+%Y%m%d%H%M%S.almap'` # Dump the AlarmMap to that temp file tl1map dump -f $MF $* # Make a backup copy cp $MF $MF.orig # Invoke your favorite editor on that file $EDITOR $MF # If there are no changes, remove temp mapfiles & exit diff $MF $MF.orig > /dev/null && rm -rf $MF $MF.orig && exit # If there were changes, load them into the attribute tl1map load -f $MF $*
TL1 の AlertMap
TL1 AlarmMap は TL1 自律メッセージを、
CA Spectrum
によって処理されるアラート(イベントではなく)に変換します。CA Spectrum
は SNMP トラップと同様にこれらのアラートを処理します。TL1 アラーム マップに指定されているアラート コードで、AlertMap を設定します。注:
AlertMap に指定されるアラート コードは、SNMP トラップ OID ではなく、10 進数です。TL1 ゲートウェイからの各アラートは、以下の標準の変更不可能な変数バインドを提供します。
- Varbind 1: AID
- Varbind 2: 重大度
- Varbind 3: 条件
- Varbind 4: アラーム メッセージ
- Varbind 5: アラート コード(TL1 AlarmMap に指定された)
AlertMap は、これらのアラート変数をイベント変数に 1 対 1 でマップする必要があります。
AlertMap でサポートされているエントリは、以下の構文のようになります。
64352257 0x3d5f001 1(1,0) 2(2,0) 3(3,0) 4(4,0) 5(5,0)
上記のエントリは、アラート コード 64352257 (10 進数で 0x3d5f001)をイベント コード 0x3d5f001 にマップし、5 つのアラート変数をそれぞれイベントにコピーします。
AlertMap、EventDisp、CsEvFormat、CsPCause ファイルの詳細については、「」を参照してください。