<book_title> を検索 ...

Cluster Server 7.3.1 エージェント開発者ガイド - AIX、Linux、Solaris、Windows

Last Published: 2018-01-17

Product(s): InfoScale & Storage Foundation (7.3.1)

オンラインおよびオフライン状態監視用にリソース登録を行う AMF プラグインで必要な XML ファイルの作成

オンラインおよびオフライン状態の監視に対して AMF にプロセスベースのリソース登録を行うために、imf_register エントリポイントで使用されている amfregister.xml ファイルを作成します。 imf_register エントリポイントはオンラインおよびオフライン状態の監視に対してリソースを登録するために異なるエージェントによって使用される汎用のスクリプトであるため、amfregister.xml を用いて特定のタイプのリソースに対して登録すべき内容を指定する必要があります。 amfregister.xml で使われるタグについて詳しくは、次の表の説明を参照してください。

表: amfregister.xml ファイルの共通タグ

タグ名	説明
RegType	このタグを使って、登録のタイプを指定します。このタグは、PRON と PROFF に特有のタグ間で共通です。プロセスオフライン監視に対して、AMF にリソース登録を行うために PROFF に設定します。プロセスオンライン監視で、AMF にリソース登録を行うために PRON に設定します。
ReaperName	エージェントの reaper 名（型名）を格納します。エージェントは、IMF 通知のモジュールにこの名前で登録されます。

タグ名

説明

RegType

このタグを使って、登録のタイプを指定します。このタグは、PRON と PROFF に特有のタグ間で共通です。

プロセスオフライン監視に対して、AMF にリソース登録を行うために PROFF に設定します。

プロセスオンライン監視で、AMF にリソース登録を行うために PRON に設定します。

ReaperName

エージェントの reaper 名（型名）を格納します。エージェントは、IMF 通知のモジュールにこの名前で登録されます。

表: PRON 固有のタグ

タグ名	説明
ProcPattern	プロセスベースのリソースがプロセステーブルにどのように表示されるかを指定します。指定された ProcPattern がプロセステーブルで検索され、対応する pid がオンラインの監視に対して AMF に登録されます。
PronOptions	ProcPattern 照合に対して追加のオプションを指定します。 IGNORE_ARGS に設定されている場合、ProcPattern に指定されている値はプロセスパスとして見なされます。プロセステーブルエントリに対して照合されている間は、プロセスパスだけが ProcPattern に対して照合されます。照合プロセスの pid が AMF に登録されます。 PronOptions が IGNORE_PATH に設定されている場合、ProcPattern に記述されている値はプロセス args が後に続くプロセス名として見なされます。プロセステーブルエントリに対して照合されている間は、プロセスパスのベース名とプロセス args だけが ProcPattern に対して照合されます。照合プロセスの pid が AMF に登録されます。 PronOptions が IGNORE_ARGS IGNORE_PATH に設定されている場合、ProcPattern に記述されている値は単にプロセス名として見なされます。プロセステーブルエントリに対して照合されている間は、プロセスパスのベース名だけが ProcPattern に記述されているプロセス名に対して照合されます。プロセスの引数は、考慮されてません。照合プロセスの pid が AMF に登録されます。

タグ名

説明

ProcPattern

プロセスベースのリソースがプロセステーブルにどのように表示されるかを指定します。指定された ProcPattern がプロセステーブルで検索され、対応する pid がオンラインの監視に対して AMF に登録されます。

PronOptions

ProcPattern 照合に対して追加のオプションを指定します。 IGNORE_ARGS に設定されている場合、ProcPattern に指定されている値はプロセスパスとして見なされます。プロセステーブルエントリに対して照合されている間は、プロセスパスだけが ProcPattern に対して照合されます。照合プロセスの pid が AMF に登録されます。

PronOptions が IGNORE_PATH に設定されている場合、ProcPattern に記述されている値はプロセス args が後に続くプロセス名として見なされます。プロセステーブルエントリに対して照合されている間は、プロセスパスのベース名とプロセス args だけが ProcPattern に対して照合されます。照合プロセスの pid が AMF に登録されます。

PronOptions が IGNORE_ARGS IGNORE_PATH に設定されている場合、ProcPattern に記述されている値は単にプロセス名として見なされます。プロセステーブルエントリに対して照合されている間は、プロセスパスのベース名だけが ProcPattern に記述されているプロセス名に対して照合されます。プロセスの引数は、考慮されてません。照合プロセスの pid が AMF に登録されます。

表: PROFF 固有のタグ

タグ名	説明
Owner	このプロセスを実行するのはユーザーです。このユーザーの UID と GID は、AMF による PROFF イベントの登録に使用されます。
Path	バイナリの完全なパス。
arg0	バイナリが実行される名前。絶対パスとともに実行される場合、これは指定する必要はありません。
arg0flag	これは、arg0 の照合動作をさらに絞り込むために使用されます。 arg0 で指定した文字列（例: 文字列 A）は、照合するプロセスの arg0 の中で検索されます（例: 文字列 PA）。これは次の値を取ることができます。 FREE: 自由な部分文字列の一致操作を使って、文字列 PA 中の文字列 A を見つけます。 BOUNDLEFT: 左詰めの部分文字列の一致操作を使って、文字列 PA 中の文字列 A を見つけます。 BOUNDRIGHT: 右詰めの部分文字列の一致操作を使って、文字列 PA 中の文字列 A を見つけます。 EXACT: 文字列 A は文字列 PA と正確に一致する必要があります。 arg0flag を指定しない場合、arg0flag のデフォルト値は EXACT と見なされます。メモ: BOUNDLEFT と BOUNDRIGHT は、スペースで区切って一緒に指定できます。BOUNDLEFT と BOUNDRIGHT を一緒に指定することは、EXACT と同じではありません。
args	バイナリが実行される引数。これは、プロセステーブル内でプロセスを検索する際の照合に使用されます。ここでは、完全一致を検索します。
ArgsSubString	引数のデフォルトの完全一致とは別として、照合されているプロセスの引数リストに表示される必要がある部分文字列のリストを指定できます。 ArgsSubString タグを使用して、1 つの部分文字列を指定できます。このような部分文字列を最大 8 個指定できます。メモ: ArgsSubString が指定されている場合、args を指定しないでください。
ArgsSubStringFlag	指定されたそれぞれの部分文字列に対して、追加のフラグを指定して、照合動作を制御できます。指定された各部分文字列（たとえば、ストリング SS）は、照合されているプロセスの args 内を検索されます（たとえば、ストリング PA）。 FREE: 自由な部分文字列の一致操作を使って、文字列 PA 中の文字列 SS を見つけます。 BOUNDLEFT: 左詰めの部分文字列の一致操作を使って、文字列 PA 中の文字列 SS を見つけます。 BOUNDRIGHT: 右詰めの部分文字列の一致操作を使って、文字列 PA 中の文字列 SS を見つけます。すべての ArgsSubString には、対応する ArgsSubStringFlag が必要です。 ArgsSubStringFlag を指定しない場合、デフォルトのフラグは FREE です。
ArgsFlag	このタグは、全体的な部分文字列照合の動作を制御するために使用されます。次の値が含まれます。 MATCH_ALL: 指定されたすべての部分文字列を照合します。 MATCH_ANY: 指定された任意の部分文字列を照合します。 IGNORE_ARGS: 完全に args を無視します。ArgsSubString または args タグが指定されていない場合、これは指定しないでください。一連のゼロまたは追加の ArgsSubString と ArgsSubStringFlag タグの後に、オプショグ ArgsFlag を挿入できます。ArgsFlag を指定しない場合、MATCH_ALL がその ArgsFlag のデフォルト値として見なされます。