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

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

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

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

property_name = value;

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

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

# Sun Cluster Data Services Builder テンプレート バージョン 1.0
# smpl 用の登録情報とリソース
#
# ▼注: キーワードには大文字と小文字の区別がないため、
# 大文字小文字の使い方は自由である。
#
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_type と Vendor_id) はパッケージ名として使用されます。パッケージ名は 9 文字に制限されているので、これら 2 つのプロパティの文字数の合計も 9 文字以内に制限するのがいいでしょう (ただし、RGM にはこの制限はありません)。一方、Agent Builder はリソースタイプ名からパッケージ名を明示的に生成しますので、それ自体には 9 文字の制限はありません。

  ---

• Rt_version-サンプルのデータサービスのバージョンを指定します。

• API_version-API のバージョンを指定します。 「API_version = 2」は、データサービスが Sun Cluster バージョン 3.0 の下で動作することを示します。

• Failover = TRUE-同時に複数のノード上でオンラインになることができるリソースグループでは、データサービスが動作できないことを示します。つまり、フェイルオーバーデータサービスを指定します。詳細については、「フェイルオーバーリソースの実装」を参照してください。

• START、STOP、VALIDATE など-RGM が呼び出す各コールバックメソッドプログラムへのパスを提供します。これらのパスは、RT_basedir で指定されたディレクトリからの相対パスです。

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

• Init_nodes = RG_PRIMARIES-データサービスをマスターできるノード上だけで、RGM が INIT、BOOT、FINI、および VALIDATE のメソッドを呼び出すことを指定します。RG_PRIMARIES で指定されたノードは、データサービスがインストールされているすべてのノードのサブセットです。この値に RT_INSTALLED_NODES を設定した場合、データサービスがインストールされているすべてのノード上で、RGM が上記メソッドを呼び出すことを指定します。

• RT_basedir-コールバックメソッドパスのように、ディレクトリパスに /opt/SUNWsample/bin を付加して、相対パスを補います。

• START、STOP、VALIDATE など-RGM が呼び出す各コールバックメソッドプログラムへのパスを提供します。これらのパスは、RT_basedir で指定されたディレクトリからの相対パスです。