Sun Cluster データサービス開発ガイド (Solaris OS 版)

リソースタイププロパティの宣言

クラスタ管理者は、RTR ファイルで宣言されているリソースタイププロパティを構成することはできません。 このようなリソースタイププロパティは、リソースタイプの恒久的な構成の一部を形成します。


注 –

Installed_nodes というリソースタイププロパティは、システム管理者が構成できます。 事実、Installed_nodes はシステム管理者が構成できる唯一のリソースタイププロパティであり、RTR ファイルでは宣言できません。


次に、リソースタイプ宣言の構文を示します。


property_name = value;

注 –

RGM はプロパティ名の大文字と小文字を区別します。 Sun が提供する RTR ファイルのプロパティに対する命名規則では、名前の最初の文字が大文字で、残りが小文字です (メソッド名は例外)。 メソッド名は、プロパティ属性と同様にすべて大文字です。


次に、サンプルのデータサービス (smpl) 用の RTR ファイルにおけるリソースタイプ宣言を示します。

# Sun Cluster Data Services Builder template version 1.0
# Registration information and resources for smpl
#
#NOTE: Keywords are case insensitive, i.e., you can use
#any capitalization style you prefer.
#
Resource_type = "smpl";
Vendor_id = SUNW;
RT_description = "Sample Service on Sun Cluster";

RT_version ="1.0"; 
API_version = 2;
Failover = TRUE;

Init_nodes = RG_PRIMARIES;

RT_basedir=/opt/SUNWsmpl/bin;

Start           =    smpl_svc_start;
Stop            =    smpl_svc_stop;

Validate        =    smpl_validate;
Update          =    smpl_update;

Monitor_start   =    smpl_monitor_start;
Monitor_stop    =    smpl_monitor_stop;
Monitor_check   =    smpl_monitor_check;

ヒント –

RTR ファイルの最初のエントリには、Resource_type プロパティを宣言する必要があります。 宣言しないと、リソースタイプの登録は失敗します。


リソースタイプ宣言の最初のセットは、次のようなリソースタイプについての基本的な情報を提供します。

Resource_type および Vendor_id

リソースタイプの名前を提供します。 リソースタイプ名は Resource_type プロパティ(この例では「smpl」) 単独で指定できます。Vendor_id を接頭辞として使用し、 リソースタイプ(この例では「 SUNW.smpl」) との区切りにドット (.) を入力することもできます。 Vendor_id を使用する場合、リソースタイプを定義する企業の略号にします。 リソースタイプ名はクラスタ内で一意である必要があります。


注 –

便宜上、リソースタイプ名 (Resource_typeVendor_id) はパッケージ名として使用されます。 パッケージ名は 9 文字に制限されているので、これら 2 つのプロパティの文字数の合計も 9 文字以内に制限することをお勧めします。RGM は 9 文字の制限を適用しません。 一方、Agent Builder はリソースタイプ名からパッケージ名を系統だてて生成します。つまり、Agent Builder は 9 文字の制限を適用します。


Rt_version

サンプルデータサービスのバージョンです。

API_version

API のバージョンです。 たとえば、「API_version =2」は、データサービスが Sun Cluster バージョン 3.0 の管理下で動作していることを示します。

Failover = TRUE

このデータサービスが、複数のノード上で同時にオンラインにできるリソースグループ 上では実行できないサービス、すなわちフェイルオーバーデータサービスであることを示します。 詳細については、データサービスをクラスタに転送する方法を参照してください。

StartStop Validate など

RGM によって呼び出されるコールバックメソッドプログラムのパスを提供します。 これらのパスは、 RT_basedir で指定されたディレクトリからの相対パスです。

リソースタイプ宣言の残りのセットは、次のような構成情報を提供します。

Init_nodes = RG_PRIMARIES

RGM が、データサービスをマスターできるノード上でのみ InitBootFiniValidate の各メソッドを呼び出すように指定します。 RG_PRIMARIES で指定されたノードは、データサービスがインストールされているすべてのノードのサブセットです。 この値に RT_INSTALLED_NODES を設定した場合、RGM は、データサービスがインストールされているすべてのノード上で上記メソッドを呼び出します。

RT_basedir

コールバックメソッドパスのような完全な相対パスとして、/opt/SUNWsample/bin をポイントします。

StartStop Validate など

RGM によって呼び出されるコールバックメソッドプログラムのパスを提供します。 これらのパスは、 RT_basedir で指定されたディレクトリからの相対パスです。