リソースグループと、最終的にはクラスタ上のリソースを管理する Resource Group Manager (RGM) は、コールバックモデル上で動作します。つまり、特定のイベント (ノードの障害など) が発生したとき、RGM は、当該ノード上で動作しているリソースごとにリソースタイプのメソッドを呼び出します。たとえば、RGM は Stop メソッドを呼び出して、当該ノード上で動作しているリソースを停止します。次に、Stop メソッドを呼び出して、異なるノード上でリソースを起動します。このモデルについては、「RGM モデル」と 「コールバックメソッド」のほかに、rt_callbacks(1HA) のマニュアルページを参照してください。
このモデルをサポートするために Agent Builder は、コールバックメソッドの役目をする 8 つの実行可能 C プログラムまたは Korn シェルスクリプトを install_directory/ rt_name/bin ディレクトリに生成します。
厳密には、障害モニターを実装する rt_name_probe プログラムはコールバックプログラムではありません。RGM は rt_name_probe を直接呼び出すのではなく、rt_name_monitor_start および rt_name_monitor_stop を呼び出します。そして、これらのメソッドが rt_name_probe を呼び出すことによって、障害モニターが起動および停止されます。
Agent Builder が生成する 8 つのメソッドは次のとおりです。
rt_name_monitor_check
rt_name_monitor_start
rt_name_monitor_stop
rt_name_probe
rt_name_svc_start
rt_name_svc_stop
rt_name_update
rt_name_validate
各メソッドに固有な情報については、rt_callbacks(1HA) のマニュアルページを参照してください。
Agent Builder は、install_directory/rt_name/src ディレクトリ (C 出力の場合) に、次のファイルを生成します。
ヘッダーファイル (rt_name.h)
すべてのメソッドに共通なコードが記述されているソースファイル (rt_name.c
共通なコード用のオブジェクトファイル (rt_name.o)
各メソッド用のソースファイル (*.c)
各メソッド用のオブジェクトファイル (*.o)
Agent Builder は rt_name.o ファイルを各メソッドの .o ファイルにリンクして、実行可能ファイルを install_directory/rt_name/bin ディレクトリに作成します。
Korn シェル出力の場合、install_directory /rt_name/bin ディレクトリと install_directory/rt_name/src ディレクトリの内容は同じです。それぞれのディレクトリには、7 つのコールバックメソッドと Probe メソッドに対応する 8 つの実行可能スクリプトが含まれています。
Korn シェル出力には、2 つのコンパイル済みユーティリティプログラム (gettime と gethostnames) が含まれています。これらのプログラムは、特定のコールバックメソッドが時間の取得や、検証を行う際に必要です。
ソースコードを編集して、make コマンドを実行すると、コードを再コンパイルできます。さらに、再コンパイル後、make pkg コマンドを実行すると、新しいパッケージを生成できます。ソースコードの修正をサポートするために、Agent Builder はソースコード中の適切な場所 (コードを追加できる場所) にコメント文を埋め込みます。「生成されたソースコードの編集」を参照してください。