Sun Cluster 3.0 データサービス開発ガイド

リソースとリソースタイププロパティの設定

Sun Cluster は、データサービスの静的な構成を定義するためのリソースタイププロパティを提供します。リソースタイププロパティは、リソースのタイプ、そのバージョン、API のバージョンなどを指定できると同時に、各コールバックメソッドへのパスも指定できます。表 A-1 に、すべてのリソースタイププロパティのリストを示します。

リソースタイププロパティは、リソースタイプ登録 (RTR) ファイルで宣言します。RTR ファイルは、クラスタ管理者が Sun Cluster でデータサービスを登録するときの、データサービスの初期構成を定義します。Installed_nodes の例外を除いて、クラスタ管理者はリソースタイププロパティを構成できません。

注 -

表 A-1 は、リソースタイププロパティとともに、そのプロパティが任意、必須、または条件付きのどれであるかも示します。任意プロパティは、必ずしも RTR ファイルに指定する必要はありません。任意プロパティを RTR ファイルに指定しなかった場合、システムがデフォルト値を提供します。この表には、任意プロパティのデフォルト値も示します。必須プロパティを RTR ファイルに宣言しなかった場合、データサービスの登録は失敗します。条件付きプロパティを RTR ファイルに宣言しなかった場合、RGM はそのプロパティを作成しないため、クラスタ管理者は使用できません。

次に、RTR ファイルにおけるリソースタイププロパティのエントリの例を示します。

# リソースタイプの登録情報の例
Resource_type = example_RT; 
Vendor_id = SUNW;
Pkglist = SUNWxxx;
RT_Basedir = /opt/SUNWxxx;
START			=	bin/service_start;
STOP			=	bin/service_stop;

ヒント -

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

Sun Cluster はまた、Failover_mode、Thorough_probe_interval、およびメソッドタイムアウトなど、リソースの静的な構成を定義するリソースプロパティも提供します。Resource_state や Status などの動的なリソースプロパティは、管理しているリソースのアクティブな状態を反映します。リソースプロパティに加えて、リソースはそのリソースタイププロパティも継承します。表 A-2 に、リソースプロパティのリストを示します。

リソースタイププロパティと同様に、リソースプロパティも RTR ファイルに宣言します。Sun Cluster が提供するリソースプロパティ、いわゆる、システム定義プロパティの場合、特定の属性を RTR ファイルで変更できます。たとえば、Sun Cluster は、各コールバックメソッドのメソッドタイムアウトプロパティとそのデフォルト値を提供します。RTR ファイルを使用すれば、デフォルト値を変更できます。

また、RTR ファイルには、新しいリソースプロパティも指定できます。このようなプロパティのことを拡張プロパティと呼びます。拡張プロパティを指定するには、Sun Cluster が提供するプロパティ属性セットを使用します。表 A-4 に、リソースプロパティを変更および定義するための属性のリストを示します。

慣習上、RTR ファイルでは、リソースプロパティ宣言はリソースタイプ宣言の後に続きます。エントリは左中括弧で始まり、右中括弧で終わります。次に、RTR ファイルにおけるリソース宣言の例を示します。

...

# リソースプロパティ宣言は、リソースタイプ宣言の後にある中括弧で囲まれたエントリのリストである。

# プロパティ名宣言は、リソースプロパティエントリの左中括弧の直後にある最初の属性である必要がある。

#

# メソッドタイムアウトには、最小値とデフォルト値を設定する。

{

Property = Start_timeout;

MIN=60;

DEFAULT=300;

}

{

Property = Stop_timeout;

MIN=60;

DEFAULT=300;

}

# リソースの作成時に設定できる拡張属性

{

Property = Log_level;

Extension;

enum {OFF, TERSE, VERBOSE};

DEFAULT = TERSE;

TUNABLE = AT_CREATION;

DESCRIPTION = "Controls the detail of message logging";

}

Start_timeout と Stop_timeout はシステム定義リソースプロパティです。Sun Cluster は、すべてのタイムアウトに最小値 (1 秒) とデフォルト値 (3600 秒) を提供します。上記の例の RTR ファイルでは、最小値を 60 秒に、デフォルト値を 300 秒に変更しています。タイムアウト値には、デフォルト値を使用するか 60 秒以上の値に変更できます

注 -

条件付きシステム定義リソースプロパティをそのタイプのリソースとして使用できるようにするには、リソースタイプ登録ファイルに宣言する必要があります。つまり、宣言していない条件付きプロパティは設定または照会できません。

リソースプロパティの重要な点は、クラスタ管理者がある条件下でリソースプロパティを構成できることです。次の表に、クラスタ管理者がリソースプロパティを構成できる条件を表す TUNABLE 属性を示します。

`NONE` または `FALSE`	不可
`TRUE` または `ANYTIME`	常時
`AT_CREATION`	データサービスをクラスタに追加するとき
`WHEN_DISABLED`	データサービスを無効にするとき

プロパティの構成可能性を制限できる属性もあります。たとえば、Min 属性や Max 属性を使用すると、整数プロパティの範囲を設定できます。リソースプロパティの属性の完全なリストについては、表 A-4 を参照してください。