2.2.25 共有ディスクファイル監視定義ファイル

Systemwalker Centric Manager リファレンスマニュアル - UNIX共通 -

目次索引

第2章ファイルの形式 2.2 定義情報

^[EE/GEE]
2.2.25 共有ディスクファイル監視定義ファイル

■ファイル名

opashrfmon

■使用用途

共有ディスク上のログファイル監視を行う場合に、監視するログファイル名、通知するメッセージの形式、監視方法などを定義します。本定義は、監視を行うクラスタシステムの各ノードでそれぞれ定義する必要があります。

■格納場所

Solaris OE
HP-UX
AIX
Linux

/etc/opt/FJSVsagt

■ファイル形式

# monitor-file  label  errclass  work-file  mount-point
"/share1/log/app1log" "UX:app1" ERROR ""
"/share2/log/app2log" "UX:app2" INFO "/share2/tmp/ap2_workfile" "/mnt"
"/share1/log/app3log" "" NOHEAD ""

先頭が#で始まる行はコメント行として扱われます。
監視対象となるログファイルは20個まで定義可能です。
以下に定義する項目を順に説明します。

項目名	最大長(byte)	値の形式	備考
monitor-file監視対象ファイル名	511	""で囲んだフルパス	空文字""不可省略不可
labelメッセージに付加するラベル	256	""で囲んだフルパス	空文字""一部可※ 省略不可
errclassメッセージに付加するエラー種別	－	INFO WARNING ERROR HALT 情報警告エラー停止 NOHEAD のどれか	""で囲まない省略不可
work-file監視作業ファイル名	511	""で囲んだフルパス	空文字""可省略不可
mount-pointマウントポイント	511	""で囲んだフルパス	空文字""可省略可

■パラメタ

monitor-file:

監視対象とするファイル名のフルパスを""で囲んで指定します。

ファイル名の最後が".+@"となっているファイルは監視ファイル名格納ファイルとして扱います。

label:

メッセージに付加するラベルを""で囲んで指定します。

※errclassにNOHEADを指定した場合のみ空文字""を指定してください。

errclass:

メッセージに付加するエラー種別を指定します。以下のどれかを指定してください。""では囲みません。

INFO	WARNING	ERROR	HALT	NOHEAD
情報	警告	エラー	停止

NOHEAD：: ラベル、エラー種別を付加しない（ログファイルに書かれた文字列をイベントとしたい）場合に指定してください。; また、labelには空文字""を指定してください。それ以外を指定した場合はエラーとなります。

work-file:

運用時に作成される、監視のための作業ファイル名のフルパスを""で囲んで指定します。空文字""を指定した場合は監視対象ファイルと同じディレクトリに以下のファイル名で監視作業ファイルが作成されます。

『“@”＋監視対象ファイル名＋“.fmon”』

例：監視対象ファイル名が/xx/yy.txtの場合、/xx/@yy.txt.fmon

指定するファイルは、監視対象ファイルと同じ共有ディスク上にする必要があります。

mount-point:: 監視対象とするファイルがある共有ディスクのマウントポイント名のフルパスを""で囲んで指定します。共有ディスクファイル監視を行う場合は必ず指定してください。ただし、PRIMECLUSTERにおいて共有ディスクファイル監視を行う場合は、空文字""または指定無しで指定しても監視を行うことができます。

■参照

opasfmon(共有ディスクファイル監視コマンド)
opashrfmonext(共有ディスクファイル監視拡張コマンド)
監視ファイル名格納ファイル

■注意事項

本定義によって行う共有ディスクファイル監視は、EE 部門サーバおよびEE 業務サーバで使用することができます。
本ファイルに定義した内容は、システム監視エージェントサービスの起動時に有効となります。
本定義ファイルに定義したログファイルをクラスタ運用に合わせて監視する際、複数ノードから同時に参照できる共有ディスク上のログファイルの場合は、opasfmonコマンドをフェールオーバ/フェールバック時に実行されるプログラムとして登録しておく必要があります。
本定義ファイルに定義する内容は、ポリシー配付の対象にはなりません。システムごとに定義する必要があります。
本定義ファイルに定義する監視作業ファイルが、監視対象ファイルと同じ共有ディスク上のファイルでない場合、正しく監視できません。また、運用中に監視作業ファイルを削除してはいけません。監視作業ファイルに対する監視対象ファイルの監視を中止した場合は削除しても問題ありません。

共有ディスクファイル監視を行う場合は、本定義ファイルで共有ディスクのマウントポイントを定義し、Systemwalkerを起動する前にopasfmonコマンドで監視モードをコマンドモードにする必要があります。ただし、PRIMECLUSTER においては、マウントポイントを省略し監視モードが自動モードでも問題ありません。本定義ファイルで共有ディスクのマウントポイントを定義した場合、Systemwalkerを起動する前にopasfmonコマンドで監視モードをコマンドモードにする必要があります。またopasfmonコマンドで監視開始を指示する必要があります。

■使用例1

“/share1/log/app1log”を監視対象ファイルとして監視します。

# monitor-file  label  errclass  work-file  mount-point
"/share1/log/app1log"  "UX:app1"  ERROR ""

監視対象ファイルに“message”というテキストが書き込まれると、以下のメッセージがSystemwalkerに通知されます。

UX:app1: ERROR: message

監視作業ファイル名は空文字""が指定されていますので、自動的に“/share1/log/@app1log.fmon” という名前が割り当てられ、作成されます。

■使用例2

“/share2/log/app2log” を監視対象ファイルとして監視します。監視作業ファイルは“/share2/tmp/ap2_workfile”という名前で作成します。

# monitor-file  label  errclass  work-file  mount-point
"/share2/log/app2log" "UX:app2" INFO "/share2/tmp/ap2_workfile"

監視対象ファイルに”message”というテキストが書き込まれると、以下のメッセージがSystemwalkerに通知されます。

UX:app2: INFO: message

■使用例3

“/share3/log/app3log” を監視対象ファイルとして監視します。ラベル、エラー種別は付加しないものをイベントとして通知します。

# monitor-file  label  errclass  work-file  mount-point
"/share3/log/app3log" "" NOHEAD ""