付録  A 標準プロパティ

この付録では、標準リソースタイプ、リソースグループ、リソースプロパティについて説明します。また、システム定義プロパティの変更および拡張プロパティの作成に使用するリソースプロパティ属性についても説明します。

この付録は、次の節で構成されています。

• 「リソースタイププロパティ」

• 「リソースのプロパティ」

• 「リソースグループのプロパティ」

• 「リソースプロパティの属性」

リソースタイププロパティ

この節では、Sun Cluster で定義されているリソースタイププロパティについて説明します。プロパティ値は、次のように分類されます (「カテゴリ」の後)。

• 必須 -- プロパティはリソースタイプ登録 (RTR) ファイルに明示的な値を必要とします。そうでない場合、プロパティが属するオブジェクトは作成できません。空白文字または空の文字列を値として指定することはできません。

• 条件付 — このプロパティが存在するためには、RTR ファイル内で宣言する必要があります。宣言されていない場合は、RGM はこのプロパティを作成しないため、管理ユーティリィティで利用できません。空白文字または空の文字列を値として指定できます。プロパティが RTR ファイル内で宣言されており、値が指定されていない場合には、RGM はデフォルト値を使用します。

• 条件付/明示 — このプロパティが存在するためには、明示的に値を指定し、RTR ファイル内で宣言する必要があります。宣言されていない場合は、RGM はこのプロパティを作成しないため、管理ユーティリィティで利用できません。空白文字または空の文字列を値として指定することはできません。

• 任意 — プロパティを RTR ファイル内で宣言できます。宣言しない場合は、RGM はこのプロパティを作成し、デフォルト値を使用します。プロパティが RTR ファイル内で宣言されており、値が指定されていない場合は、RGM は、プロパティが RTR ファイル内で宣言されないときのデフォルト値と同じ値を使用します。

リソースタイププロパティは管理ユーティリティで更新できません。ただし、Installed_nodes と RT_system は RTR ファイル内で宣言できないため、管理者が設定する必要があります。

最初にプロパティ名が表示され、次に説明が表示されます。

API_version (integer)

このリソースタイプの実装が使用するリソース管理 API のバージョン。

次に、Sun Cluster の各リリースがサポートする API_version の最大値を要約します。

3.1 以前

2

3.1 10/03

3

3.1 4/04

4

3.1 9/04

5

RTR ファイルにおいて、あるリソースタイプの API_version に 2 より大きな値を宣言した場合、そのリソースタイプは、宣言した値より小さな最大値しかサポートしないバージョンの Sun Cluster にはインストールされません。たとえば、あるリソースタイプに API_version=5 を宣言した場合、そのリソースタイプは、3.1 9/04 より前にリリースされたバージョンの Sun Cluster にはインストールされません。

カテゴリ:

オプション

初期値:

2

調整:

いいえ

Boot (string)

任意のコールバックメソッド。RGM がノード上で呼び出すプログラムのパスを指定します。このプログラムは、このリソース型が管理対象になっているとき、クラスタの結合または再結合を行います。このメソッドは、Init メソッドと同様に、このタイプのリソースに対し、初期化アクションを行う必要があります。

カテゴリ:

条件付き / 明示

初期値:

なし

調整:

いいえ

Failover (boolean)

TRUE の場合、複数のノード上で同時にオンラインにできるグループ内にこの型のリソースを構成することはできません。

カテゴリ:

オプション

初期値:

FALSE

調整:

いいえ

Fini (string)

任意のコールバックメソッド。この型のリソースを RGM 管理の対象外にするとき RGM によって呼び出されるプログラムのパスです。

カテゴリ:

条件付き / 明示

初期値:

なし

調整:

いいえ

Init (string)

任意のコールバックメソッド。この型のリソースを RGM 管理対象にするとき RGM によって呼び出されるプログラムのパスです。

カテゴリ:

条件付き / 明示

初期値:

なし

調整:

いいえ

Init_nodes (enum)

指定できる値は、RG_primaries (リソースをマスターできるノードのみ) または RT_installed_nodes (このリソース型がインストールされる全てのノード) のいずれかです。RGM が Init、Fini、 Boot、Validate メソッドをコールするノードを示します。

カテゴリ:

オプション

初期値:

RG_primaries

調整:

いいえ

Installed_nodes (string_array )

リソースタイプの実行が許可されるクラスタノード名のリスト。このプロパティは RGM によって自動的に作成されます。クラスタ管理者は値を設定できます。RTR ファイル内には宣言できません。

カテゴリ:

クラスタ管理者による構成が可能です。

初期値:

すべてのクラスタノード

調整:

Yes

Is_logical_hostname (boolean

TRUEは、このリソース型が、フェイルオーバーインターネットプロトコル (IP) アドレスを管理する LogicalHostname リソース型のいずれかのバージョンであることを示します。

カテゴリ:

照会のみ

初期値:

デフォルトなし

調整:

いいえ

Is_shared_address (boolean )

TRUE は、このリソース型が、 フェイルオーバーインターネットプロトコル (IP) アドレスを管理する SharedAddress リソース型のいずれかのバージョンであることを示します。

カテゴリ:

照会のみ

初期値:

デフォルトなし

調整:

いいえ

Monitor_check (string)

任意のコールバックメソッド。障害モニターの要求によってこのリソース型のフェイルオーバーを実行する前に、RGM によって呼び出されるプログラムのパスです。

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Monitor_start (string)

任意のコールバックメソッド。この型のリソースの障害モニターを起動するために RGM によって呼び出されるプログラムのパスです。

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Monitor_stop (string)

Monitor_start が設定されている場合の、必須のコールバックメソッド。この型のリソースの障害モニターを停止するために RGM によって呼び出されるプログラムのパスです。

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Pkglist (string_array)

リソース型のインストールに含まれている任意のパッケージリストです。

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Postnet_stop (string)

任意のコールバックメソッド。この型のリソースがネットワークアドレスリソースに依存している場合、このネットワークアドレスリソースのStopメソッドの呼び出し後に RGM によって呼び出されるプログラムのパスです。ネットワークインタフェースが停止するように構成された後、このメソッドは Stop アクションを実行する必要があります。

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Prenet_start (string)

任意のコールバックメソッド。この型のリソースがネットワークアドレスリソースに依存している場合、このネットワークアドレスリソースの Start メソッドの呼び出し前に RGM によって呼び出されるプログラムのパスです。ネットワークインタフェースが構成される前、このメソッドは Start アクションを実行する必要があります。

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Resource_type (string)

リソースタイプの名前。現在登録されているリソースタイプ名を表示するには、次のコマンドを使用します。

scrgadm -p

Sun Cluster 3.1 以降のリリースでは、リソースタイプ名にバージョンが含まれます (必須)。

vendor_id.resource_type:version

リソース型の名前は、 RTR ファイル内に指定された 3 つのプロパティ Vendor_id、Resource_type 、RT_version で構成されます。scrgadm コマンドは、ピリオド (.) とコロン (:) の区切り文字を挿入します。リソースタイプ名の最後の部分、RT_version には、RT_version プロパティと同じ値が入ります。重複を防ぐため、Vendor_id には、リソースタイプの作成元の会社のストックシンボルを使用することをお勧めします。Sun Cluster 3.1 以前に作成されたリソースタイプ名では、引き続き次の構文を使用します。

vendor_id.resource_type

カテゴリ:

必須

初期値:

空の文字列

調整:

いいえ

RT_basedir (string)

コールバックメソッドの相対パスのを補完するディレクトリパスです。このパスは、リソースタイプパッケージのインストール場所に設定します。スラッシュ (/) で開始する完全なパスを指定する必要があります。すべてのメソッドパス名が絶対パスの場合は、指定しなくてもかまいません。

カテゴリ:

必須 (絶対パスでないメソッドパスがある場合)

初期値:

デフォルトなし

調整:

いいえ

RT_description (string)

リソース型の簡単な説明です。

カテゴリ:

条件付き

初期値:

空の文字列

調整:

いいえ

RT_system (boolean)

あるリソースタイプの RT_system が TRUE に設定されているときに、そのリソースタイプでは、許可されている scrgadm(1M) 操作が制限されることを示します。RT_system が TRUE に設定されているリソースタイプのことを「システムリソースタイプ」と呼びます。RT_system の現在の値に関わらず、 RT_system プロパティ自身を編集することは制限されません。

カテゴリ:

オプション

初期値:

FALSE

調整:

Yes

RT_version (string)

Sun Cluster 3.1 以降では、このリソースタイプの実装の必須バージョン文字列。RT_version は、完全なリソースタイプ名の末尾の部分です。RT_version プロパティは Sun Cluster 3.0 では任意でしたが、Sun Cluster 3.1 以降のリリースでは必須です。

カテゴリ:

任意/明示または必須

初期値:

デフォルトなし

調整:

いいえ

Single_instance (boolean)

TRUE は、この型のリソースがクラスタ内に 1 つだけ存在できることを示します。つまり、この型のリソースが実行されるのは、クラスタ全体で 1 箇所だけです。

カテゴリ:

オプション

初期値:

FALSE

調整:

いいえ

Start (string)

コールバックメソッド。この型のリソースを起動するために RGM によって呼び出されるプログラムのパスです。

カテゴリ:

RTR ファイルで Prenet_start メソッドが宣言されていないかぎり必須

初期値:

デフォルトなし

調整:

いいえ

Stop (string)

コールバックメソッド。この型のリソースを停止するために RGM によって呼び出されるプログラムのパスです。

カテゴリ:

RTR ファイルで Postnet_stop メソッドが宣言されていないかぎり必須

初期値:

デフォルトなし

調整:

いいえ

Update (string)

任意のコールバックメソッド。この型の実行中のリソースのプロパティが変更されたとき RGM によって呼び出されるプログラムのパスです。

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Validate (string)

任意のコールバックメソッド。この型のリソースのプロパティ値を検査するために呼び出されるプログラムのパスです。

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Vendor_ID (string)

Resource_type を参照してください。

カテゴリ:

条件付き

初期値:

デフォルトなし

調整:

いいえ

リソースのプロパティ

この節では、Sun Cluster で定義されているリソースプロパティについて説明します。プロパティ値は、次のように分類されます (「カテゴリ」の後)。

• 必須 — 管理者は、管理ユーティリィティでリソースを作成するときに、必ず値を指定する必要があります。

• 任意 — 管理者がリソースグループの作成時に値を指定しない場合、システムがデフォルト値を提供します。

• 条件付き – プロパティが RTR ファイルで宣言されている場合にのみ、RGM がプロパティを作成します。宣言されていない場合プロパティは存在せず、システム管理者はこれを利用できません。RTR ファイルで宣言されている条件付きのプロパティは、デフォルト値が RTR ファイル内で指定されているかどうかによって、必須または任意になります。詳細については、各条件付きプロパティの説明を参照してください。

• 照会のみ– 管理ツールから直接設定できません。

調整は、次のように、リソースプロパティを更新できるかどうか、および、いつ更新できるかを示します。

最初にプロパティ名が表示され、次に説明が表示されます。

Affinity_timeout (integer )

リソース内のサービスのクライアント IP アドレスからの接続は、この時間 (秒数) 内に同じサーバーノードに送信されます。

このプロパティは、Load_balancing_policy が Lb_sticky または Lb_sticky_wild の場合にかぎり有効です。さらに、Weak_affinity が FALSE (デフォルト値) に設定されている必要があります。

このプロパティは、スケーラブルサービス専用です。

カテゴリ:

オプション

初期値:

デフォルトなし

調整:

ANYTIME

Cheap_probe_interval (integer )

リソースの即時障害検証の呼び出しの間隔 (秒数)。このプロパティは RGM によって作成されます。RTR ファイルに宣言されている場合にかぎり、管理者は使用を許可されます。

RTR ファイル内でデフォルト値が指定されている場合、このプロパティは任意です。Tunable 属性がリソースタイプファイルに指定されていない場合は、プロパティの Tunable 値は WHEN_DISABLED になります。

RTR ファイル内で宣言され、Default 属性が指定されていない場合、このプロパティは必須になります。

カテゴリ:

条件付き

初期値:

デフォルトなし

調整:

WHEN_DISABLED

拡張プロパティ

そのリソースのタイプの RTR ファイルで宣言される拡張プロパティ。リソースタイプの実装によって、これらのプロパティを定義します。拡張プロパティに設定可能な各属性については、「リソースプロパティの属性」を参照してください。

カテゴリ:

条件付き

初期値:

デフォルトなし

調整:

特定のプロパティに依存

Failover_mode (enum)

開始メソッド (Prenet_start または Start) が失敗した場合、NONE、SOFT、および HARD はフェイルオーバーの動作だけに影響します。しかし、リソースが正常に起動した場合、 NONE、SOFT 、および HARD は、これ以降にリソースモニターが scha_control(1HA) または scha_control(3HA) で発行したリソースの再起動またはギブオーバーの動作には影響しません。NONE (デフォルト) は、メソッドが失敗した場合に、RGM がリソースの状態を設定し、ユーザーが介入するまで待機することを示します。SOFT は、Start メソッドが失敗した場合に、RGM がリソースグループを異なるノードに移動することを示します。Stop メソッドまたは Monitor_stop メソッドが失敗した場合、RGM はリソースをStop_failed 状態に設定して、リソースグループを Error_stop_failed 状態に設定します。その後、RGM はユーザーが介入するまで待機します。Stop メソッドまたは Monitor_stop メソッドが失敗した場合、NONE と SOFT は同じです。HARD は、Start メソッドが失敗した場合に、RGM がグループを移動することを示します。Stop メソッドまたは Monitor_stop メソッドが失敗した場合、RGM はクラスタノードを中断して、リソースを停止します。Start メソッドまたは Prenet_start メソッドが失敗した場合、HARD、NONE、および SOFT はフェイルオーバーの動作に影響します。

NONE、SOFT、および HARD とは異なり、RESTART_ONLY および LOG_ONLY はすべてのフェイルオーバーの動作に影響します (モニターが scha_control で発行したリソースとリソースグループの再起動、および、リソースモニターが scha_control で起動したギブオーバーを含む)。RESTART_ONLY は、モニターが scha_control でリソースを再起動できることを示します。しかし、これ以降に scha_control で発行したリソースグループの再起動またはギブオーバーは失敗します。このとき、RGM は Retry_interval 内に Retry_count 回の再起動を許可します。Retry_count を超えた場合、リソースの再起動は許可されません。Failover_mode が LOG_ONLY に設定されている場合、リソースの再起動またはギブオーバーは許可されません。 Failover_mode を LOG_ONLY に設定することは、 Failover_mode を RESTART_ONLY に設定し、 Retry_count をゼロに設定することと同じです。開始メソッドが失敗した場合、RESTART_ONLY および LOG_ONLY は NONE と同じです。つまり、フェイルオーバーは発生せず、リソースは Start_failed 状態になります。

カテゴリ:

オプション

初期値:

デフォルトなし

調整:

ANYTIME

Load_balancing_policy (string )

使用する負荷均衡ポリシーを定義する文字列。このプロパティは、スケーラブルサービス専用です。RTR ファイルに Scalable プロパティが宣言されている場合、RGM は自動的にこのプロパティを作成します。Load_balancing_policy には次の値を設定できます。

Lb_weighted (デフォルト)。Load_balancing_weights プロパティで設定されているウエイトに従って、さまざまなノードに負荷が分散されます。

Lb_sticky。スケーラブルサービスの指定のクライアント (クライアントの IP アドレスで識別される) は、常に同じクラスタノードに送信されます。

Lb_sticky_wild。指定のクライアントの IP アドレスは、ワイルドカードスティッキーサービスの IP アドレスに接続され、IP アドレスが着信したポート番号とは無関係に、常に同じクラスタノードに送信されます。

カテゴリ:

条件付き/任意

初期値:

Lb_weighted

調整:

AT_CREATION

Load_balancing_weights (string_array )

このプロパティは、スケーラブルサービス専用です。RTR ファイルに Scalable プロパティが宣言されている場合、RGM は自動的にこのプロパティを作成します。形式は、「weight@node,weight@node」になります。ここで、weight は、指定したノード (node) に対する負荷分散の相対的な割り当てを示す整数になります。ノードに分散される負荷の割合は、すべてのウエイトの合計でこのノードのウエイトを割った値になります。たとえば、1@1,3@2 は、ノード 1 が負荷の 1/4 を受け取り、ノード 2 が 3/4 を受け取ることを指定します。空の文字列 (“”) は、負荷を均一に分散することを意味します (デフォルト)。明示的にウエイトを割り当てられていないノードのウエイトは、デフォルトで 1 になります。

Tunable 属性がリソースタイプファイルに指定されていない場合は、プロパティの Tunable 値は ANYTIME (任意の時点) になります。このプロパティを変更すると、新しい接続時にのみ分散が変更されます。

カテゴリ:

条件付き/任意

初期値:

空の文字列 (“”)

調整:

ANYTIME

各コールバックメソッドの method_timeout (integer)

RGM がメソッドの呼び出しに失敗したと判断するまでの時間 (秒)。

カテゴリ:

条件付き/任意

初期値:

RTR ファイルにメソッド自体が宣言されている場合は 3,600 (1 時間)

調整:

ANYTIME

Monitored_switch (enum)

クラスタ管理者が管理ユーティリィティを使用してモニターを有効または無効にすると、RGM によって Enabled または Disabled に設定されます。Disabled に設定されると、再び有効に設定されるまで、モニターは Start メソッドを呼び出しません。リソースが、モニターのコールバックメソッドを持っていない場合は、このプロパティは存在しません。

カテゴリ:

照会のみ

初期値:

デフォルトなし

調整:

Never

Network_resources_used (string_array )

リソースが使用する論理ホスト名または共有アドレスネットワークリソースのリスト。スケーラブルサービスの場合、このプロパティは別のリソースグループに存在する共有アドレスリソースを参照する必要があります。フェイルオーバーサービスの場合、このプロパティは同じリソースグループに存在する論理ホスト名または共有アドレスを参照します。RTR ファイルに Scalable プロパティが宣言されている場合、RGM は自動的にこのプロパティを作成します。Scalable が RTR ファイルで宣言されていない場合、Network_resources_used は RTR ファイルで明示的に宣言されていない限り使用できません。

Tunable 属性がリソースタイプファイルに指定されていない場合は、プロパティの Tunable 値は AT_CREATION になります。

---

注 –

このプロパティを CRNP 向けに設定する方法については、SUNW.Event(5) のマニュアルページを参照してください。

---

カテゴリ:

条件付き/必須

初期値:

デフォルトなし

調整:

AT_CREATION

各クラスタノード上の Num_resource_restarts (整数)

このプロパティは、RGM によって、このノード上のこのリソースに対して過去 n 秒以内に行われた scha_control 、Resource_restart、または Resource_is_restarted の呼び出し回数に設定されるため、直接は設定できません。ここで、n はリソースの Retry_interval プロパティの値です。このリソースが scha_control ギブオーバーを実行した場合、ギブオーバーが成功または失敗したかに関わらず、リソースの再起動カウンタは RGM によってゼロにリセットされます。

リソース型が Retry_interval プロパティを宣言していない場合、この型のリソースに Num_resource_restarts プロパティを使用できません。

カテゴリ:

照会のみ

初期値:

デフォルトなし

調整:

いいえ

各クラスタノード上の Num_rg_restarts (integer)

このプロパティは、RGM によって、このノード上のこのリソースに対して過去 n 秒以内に行われた scha_control Restart の呼び出し回数に設定されるため、直接は設定できません。ここで、n はリソースの Retry_interval プロパティの値です。リソース型が Retry_interval プロパティを宣言していない場合、この型のリソースに Num_resource_restarts プロパティを使用できません。

カテゴリ:

説明を参照

初期値:

デフォルトなし

調整:

いいえ

On_off_switch (enum)

クラスタ管理者が管理ユーティリィティを使用してリソースを有効または無効にすると、RGM によって Enabled または Disabled に設定されます。無効にした場合、リソースはオフラインになり、もう一度有効にするまで、コールバックは呼び出されません。

カテゴリ:

照会のみ

初期値:

デフォルトなし

調整:

Never

Port_list (string_array)

サーバーが待機するポートの番号リストです。各ポート番号の後ろには、スラッシュ (/) とそのポートが使用しているプロトコルが続きます (たとえば、Port_list=80/tcp または Port_list=80/tcp6,40/udp6)。指定できるプロトコル値は次のとおりです。

• tcp (TCP IPv4 の場合)

• tcp6 (TCP IPv6 の場合)

• udp (UDP IPv4 の場合)

• udp6 (UDP IPv6 の場合)

Scalable プロパティが RTR ファイルで宣言されている場合、RGM は自動的に Port_list を作成します。それ以外の場合、このプロパティは RTR ファイルで明示的に宣言されていないかぎり使用できません。

このプロパティを Apache 用に設定する方法については、『Sun Cluster データサービスの計画と管理 (Solaris OS 版)』を参照してください。

カテゴリ:

条件付き/必須

初期値:

デフォルトなし

調整:

AT_CREATION

R_description (string)

リソースの簡単な説明。

カテゴリ:

オプション

初期値:

空の文字列

調整:

ANYTIME

Resource_dependencies (string_array )

このリソースが強い依存関係を持っている同じまたは異なるグループ内のリソースのリスト。このリスト内の任意のリソースがオンラインでない場合、このリソースは起動できません。このリソースとリスト内のリソースの 1 つが同時に起動する場合、RGM は、リスト内のリソースが起動するまで待機してから、このリソースを起動します。このリソースの Resource_dependencies リスト内のリソースが起動しない場合、このリソースもオフラインのままになります。リスト内のリソースのリソースグループがオフラインのままであるか、リスト内のリソースが Start_failed 状態である場合、このリソースのリスト内のリソースは起動しない可能性があります。強い依存関係を持っている異なるリソースグループ内のリソースが起動に失敗したために、このリソースがオフラインのままである場合、このリソースのリソースグループは Pending_online_blocked 状態に入ります。

このリソースとリスト内の複数のリソースが同時にオフラインになる場合、このリソースはリスト内のリソースより前に停止します。しかし、このリソースがオンラインのままであったり、停止に失敗した場合でも、リスト内の異なるリソースグループのリソースは停止できます。このリソースが先に無効にならなければ、リスト内のリソースは無効にできません。

デフォルトでは、リソースグループ内では、アプリケーションのリソースはネットワークアドレスリソースに対して、暗黙的に強いリソースの依存関係を持っています。詳細については、「リソースグループのプロパティ」 の Implicit_network_dependencies を参照してください。

リソースグループ内では、Prenet_start メソッドは Start メソッドより前に、依存関係順に実行されます。Postnet_stop メソッドは Stop メソッドより後に、依存関係順に実行されます。異なるリソースグループでは、依存しているリソースは、依存されているリソースが Prenet_start および Start を実行するまで待機してから、Prenet_start を実行します。依存されているリソースは、依存しているリソースが Stop および Postnet_stop を終了するまで待機してから、Stop を実行します。

カテゴリ:

オプション

初期値:

空のリスト

調整:

ANYTIME

Resource_dependencies_restart ( string_array)

このリソースが再起動の依存関係を持っている同じまたは異なるグループ内のリソースのリスト。

このプロパティの動作は Resource_dependencies と似ていますが、再起動の依存関係リスト内にある任意のリソースが再起動した場合、このリソースは再起動されます。リスト内のリソースがオンラインに戻った後、このリソースは再起動されます。

カテゴリ:

オプション

初期値:

空のリスト

調整:

ANYTIME

Resource_dependencies_weak ( string_array)

このリソースが弱い依存関係を持っている同じまたは異なるグループ内のリソースのリスト。弱い依存関係は、メソッドが呼び出される順序を決定します。RGM は、このリスト内のリソースの Start メソッドを呼び出してから、このリソースの Start メソッドを呼び出します。そして、RGM は、このリソースの Stop メソッドを呼び出してから、このリスト内のリソースの Stop メソッドを呼び出します。リスト内のリソースが起動に失敗した場合でも、このリソースは起動できます。

このリソースとその Resource_dependencies_weak リスト内のリソースが同時に起動する場合、RGM は、リスト内のリソースが起動するまで待機してから、このリソースを起動します。リスト内のリソースが起動しない場合 (たとえば、リスト内のリソースのリソースグループがオフラインのままであったり、リスト内のリソースが Start_failed 状態である場合)、このリソースは起動します。このリソースの Resource_dependencies_weak リスト内のリソースが起動すると、このリソースのリソースグループは一時的に Pending_online_blocked 状態に入ることがあります。リスト内のすべてのリソースが起動したとき、あるいは、起動に失敗したとき、このリソースとそのリソースグループは再び Pending_online 状態に入ります。

このリソースとリスト内の複数のリソースが同時にオフラインになる場合、このリソースはリスト内のリソースより前に停止します。このリソースがオンラインのままであったり、停止に失敗した場合でも、リスト内のリソースは停止できます。このリソースを無効にするまで、リスト内のリソースは無効にできません。

リソースグループ内では、Prenet_start メソッドは Start メソッドより前に、依存関係順に実行されます。Postnet_stop メソッドは Stop メソッドより後に、依存関係順に実行されます。異なるリソースグループでは、依存しているリソースは、依存されているリソースが Prenet_start および Start を実行するまで待機してから、Prenet_start を実行します。依存されているリソースは、依存しているリソースが Stop および Postnet_stop を終了するまで待機してから、Stop を実行します。

カテゴリ:

オプション

初期値:

空のリスト

調整:

ANYTIME

Resource_name (string)

リソースインスタンスの名前です。この名前はクラスタ構成内で一意にする必要があります。リソースが作成されたあとで変更はできません。

カテゴリ:

必須

初期値:

デフォルトなし

調整:

Never

Resource_project_name (string )

リソースに関連付けられた Solaris プロジェクト名。このプロパティは、CPU の共有、クラスタデータサービスのリソースプールといった Solaris のリソース管理機能に適用できます。RGM は、リソースをオンラインにすると、このプロジェクト名を持つ関連プロセスを起動します。このプロパティが指定されていない場合、プロジェクト名は、リソースが属しているリソースグループの RG_project_name プロパティから取得されます。rg_properties(5) を参照してください。どちらのプロパティも指定されなかった場合、RGM は事前定義済みのプロジェクト名 default を使用します。プロジェクトデータベース内に存在するプロジェクト名を指定する必要があります。また、root ユーザーは、このプロジェクトのメンバーとして構成されている必要があります。このプロパティは、Solaris 9 以降のバージョンでのみサポートされます。

---

注 –

このプロパティの変更は、このリソースが次回起動されるときに有効になります。

---

カテゴリ:

オプション

初期値:

Null

調整:

ANYTIME

各クラスタノードの Resource_state (enum)

RGM が判断した各クラスタノード上のリソースの状態。使用可能な状態は、Online、Offline、Start_failed、Stop_failed、Monitor_failed、Online_not_monitored、Starting、および Stopping です。

ユーザーはこのプロパティを構成できません。

カテゴリ:

照会のみ

初期値:

デフォルトなし

調整:

Never

Retry_count (integer)

起動に失敗したリソースをモニターが再起動する回数です。このプロパティは RGM によって作成されます。RTR ファイルに宣言されている場合にかぎり、管理者は使用を許可されます。デフォルト値が RTR ファイルに指定されている場合、Retry_count は任意です。

Tunable 属性がリソースタイプファイルに指定されていない場合は、プロパティの Tunable 値は WHEN_DISABLED になります。

RTR ファイル内で宣言され、Default 属性が指定されていない場合、このプロパティは必須になります。

カテゴリ:

条件付き

初期値:

デフォルトなし

調整:

WHEN_DISABLED

Retry_interval (integer)

失敗したリソースを再起動するまでの秒数。リソースモニターは、このプロパティと Retry_count を組み合わせて使用します。このプロパティは RGM によって作成されます。RTR ファイルに宣言されている場合にかぎり、管理者は使用を許可されます。デフォルト値が RTR ファイルに指定されている場合、Retry_interval は任意です。

Tunable 属性がリソースタイプファイルに指定されていない場合は、プロパティの Tunable 値は WHEN_DISABLED になります。

RTR ファイル内で宣言され、Default 属性が指定されていない場合、このプロパティは必須になります。

カテゴリ:

条件付き

初期値:

デフォルトなし

調整:

WHEN_DISABLED

Scalable (boolean)

リソースがスケーラブルであるかどうか、つまり、リソースが Sun Cluster のネットワーキング負荷分散機能を使用するかどうかを表します。

このプロパティが RTR ファイルで宣言されている場合は、そのタイプのリソースに対して、RGM は、次のスケーラブルサービスプロパティを自動的に作成します。つまり、 Affinity_timeout、Load_balancing_policy、Load_balancing_weights、Network_resources_used、Port_list、UDP_affinity、および Weak_affinity です。これらのプロパティは、RTR ファイル内で明示的に宣言されない限り、デフォルト値を持ちます。RTR ファイルに Scalable が宣言されている場合、このプロパティのデフォルトは TRUE です。

RTR ファイルにこのプロパティが宣言されている場合、AT_CREATION 以外の Tunable 属性の割り当ては許可されません。

RTR ファイルにこのプロパティが宣言されていない場合、このリソースはスケーラブルではないため、このプロパティを調整することはできません。RGM は、スケーラビブルサービスプロパティをいっさい設定しません。ただし、Network_resources_used および Port_list プロパティは、スケーラブルサービスでも非スケーラブルサービスでも有用であるため、RTR ファイルに明示的に宣言できます。

このリソースプロパティと Failover リソースタイププロパティの組み合わせと、その説明は次のとおりです。

このリソースプロパティを Failover リソースタイププロパティと組み合わせて使用する方法の詳細については、r_properties(5) を参照してください。

カテゴリ:

オプション

初期値:

デフォルトなし

調整:

AT_CREATION

各クラスタノードの Status ( enum)

リソースモニターが scha_resource_setstatus(1HA) または scha_resource_setstatus(3HA) で設定します。指定可能な値は、 OK、degraded、faulted、unknown、および offline です。リソースがオンラインまたはオフラインになったとき、RGM は自動的に Status 値を設定します (Status 値をリソースのモニターまたはメソッドが設定していない場合)。

カテゴリ:

照会のみ

初期値:

デフォルトなし

調整:

Never

各クラスタノードの Status_msg ( string)

リソースモニターによって、Status プロパティと同時に設定されます。リソースがオンラインまたはオフラインになったとき、RGM は自動的にこのプロパティを空の文字列にリセットします (このプロパティをリソースのメソッドが設定していない場合)。

カテゴリ:

照会のみ

初期値:

デフォルトなし

調整:

Never

Thorough_probe_interval ( integer)

高オーバーヘッドのリソース障害検証の呼び出し間隔 (秒)。このプロパティは RGM によって作成されます。RTR ファイルに宣言されている場合にかぎり、管理者は使用を許可されます。デフォルト値が RTR ファイルに指定されている場合、Thorough_probe_interval は任意です。

Tunable 属性がリソースタイプファイルに指定されていない場合は、プロパティの Tunable 値は WHEN_DISABLED になります。

RTR ファイルのプロパティ宣言内に Default 属性が指定されていない場合、このプロパティは必須です。

カテゴリ:

条件付き

初期値:

デフォルトなし

調整:

WHEN_DISABLED

Type (string)

このリソースがインスタントであるリソースタイプ。

カテゴリ:

必須

初期値:

デフォルトなし

調整:

Never

Type_version (string)

現在このリソースに関連付けられているリソース型のバージョンを指定します。このプロパティは RTR ファイル内に宣言できません。したがって、RGM によって自動的に作成されます。このプロパティの値は、リソースタイプの RT_version プロパティと等しくなります。リソースの作成時、Type_version プロパティはリソースタイプ名の接尾辞として表示されるだけで、明示的には指定されません。リソースを編集すると、Type_version の値が変更されます。

このプロパティの調整は次のソースから継承されます。

• 現在のリソースタイプのバージョン

• RTR ファイル内の #$upgrade_from ディレクティブ

カテゴリ:

説明を参照

初期値:

デフォルトなし

調整:

説明を参照

UDP_affinity (boolean)

true の場合、指定のクライアントからの UDP トラフィックはすべて現在クライアントの TCP トラフィックを処理しているサーバーノードに送信されます。

このプロパティは、Load_balancing_policy が Lb_sticky または Lb_sticky_wild の場合にかぎり有効です。さらに、Weak_affinity が FALSE (デフォルト値) に設定されている必要があります。

このプロパティは、スケーラブルサービス専用です。

カテゴリ:

オプション

初期値:

デフォルトなし

調整:

WHEN_DISABLED

Weak_affinity (boolean)

true の場合、弱い形式のクライアントアフィニティが有効になります。弱い形式のクライアントアフィニティは、1 つのクライアントから複数の接続を同じサーバーノードに送信することを許可します。ただし、次の状態の場合を除きます。

• サーバーのリスナーが起動するのは、たとえば、障害モニターが再起動したとき、リソースがフェイルオーバーまたはスイッチオーバーしたとき、あるいは、ノードが障害の後にクラスタに参加し直したときです。

• 管理アクションによるスケーラブルリソースの Load_balancing_weights の変更時

弱いアフィニティはメモリーの消費とプロセッササイクルの点で、デフォルトの形式よりもオーバーヘッドを低く抑えられます。

このプロパティは、Load_balancing_policy が Lb_sticky または Lb_sticky_wild の場合にかぎり有効です。

このプロパティは、スケーラブルサービス専用です。

カテゴリ:

オプション

初期値:

デフォルトなし

調整:

WHEN_DISABLED

リソースグループのプロパティ

この節では、Sun Cluster で定義されているリソースグループプロパティについて説明します。プロパティ値は、次のように分類されます (「カテゴリ」の後)。

• 必須 — 管理者は、管理ユーティリィティでリソースグループを作成するときに、必ず値を指定する必要があります。

• 任意 — 管理者がリソースグループの作成時に値を指定しない場合、システムがデフォルト値を提供します。

• 照会のみ– 管理ツールから直接設定できません。

各説明は、そのプロパティが初期設定後に更新できる (はい) か更新できない (いいえ) かを示してい ます。

最初にプロパティ名が表示され、次に説明が表示されます。

Auto_start_on_new_cluster ( boolean)

このプロパティを使用すると、新しいクラスタを形成するとき、Resource Group の自動起動を無効にすることができます。

TRUE の場合、クラスタが再起動するとき、Resource Group Manager はリソースグループを自動的に起動して、Desired_primaries を有効にしようと試みます。FALSE に設定されている場合、クラスタのすべてのノードが同時に再起動したとき、Resource Group Manager はリソースグループを自動的に起動しません。

カテゴリ:

オプション

初期値:

TRUE

調整:

Yes

Desired_primaries (integer )

グループが同時にオンラインになることができるノードの数。

RG_mode プロパティが Failover の場合、このプロパティの値を1 より大きく設定することはできません。RG_mode プロパティが Scalable の場合は、1 より大きな値を設定できます。

カテゴリ:

オプション

初期値:

1

調整:

Yes

Failback (boolean)

クラスタのメンバーシップが変更されたとき、グループがオンラインになっているノードセットを再計算するかどうかを示すブール値です。再計算により、RGM は優先度の低いノードをオフラインにし、優先度の高いノードをオンラインにすることができます。

カテゴリ:

オプション

初期値:

FALSE

調整:

Yes

Global_resources_used (string_array )

クラスタファイルシステムがこのリソースグループ内のリソースによって使用されるかどうかを指定します。管理者はアスタリスク (*) か空文字列 (“”) を指定できます。すべてのグローバルリソースを指定するときはアスタリスク、グローバルリソースを一切指定しない場合は空文字列を指定します。

カテゴリ:

オプション

初期値:

すべてのグローバルリソース

調整:

Yes

Implicit_network_dependencies ( boolean)

TRUE の場合、 RGM は、グループ内のネットワークアドレスリソースで非ネットワークアドレスリソースに対する強い依存を強制します。ネットワークアドレスリソースには、論理ホスト名と共有アドレスリソース型があります。

スケーラブルリソースグループの場合、ネットワークアドレスリソースを含んでいないため、このプロパティは効果がありません。

カテゴリ:

オプション

初期値:

TRUE

調整:

Yes

Maximum_primaries (integer )

グループを同時にオンラインにできるノードの最大数です。

RG_mode プロパティが Failover の場合、このプロパティの値を1 より大きく設定することはできません。RG_mode プロパティが Scalable の場合は、1 より大きな値を設定できます。

カテゴリ:

オプション

初期値:

1

調整:

Yes

Nodelist (string_array)

優先順位に従ってグループをオンラインにできるクラスタノードのリスト。これらのノードは、リソースグループの潜在的主ノードまたはマスターです。

カテゴリ:

オプション

初期値:

すべてのクラスタノードのリスト。

調整:

Yes

Pathprefix (string)

リソースグループ内のリソースが重要な管理ファイルを書き込むことができるクラスタファイルシステム内のディレクトリ。一部のリソースの必須プロパティです。Pathprefix の値はリソースグループごとに固有の値を指定します。

カテゴリ:

オプション

初期値:

空の文字列

調整:

Yes

Pingpong_interval (integer )

RGM がリソースグループをオンラインにする場所を決定するときに使用する負でない整数値 (秒)。このプロパティが必要になる条件は次のとおりです。

• 再構成が発生している場合。

• scha_control -O GIVEOVER コマンドまたは scha_control() 関数に SCHA_GIVEOVER 引数を指定して実行します。

再構成が発生したときに、Pingpong_interval で指定した秒数内に特定のノード上で複数回、リソースグループがオンラインになれなかった場合、 そのノードはリソースグループのホストとしては不適切だと判断され、RGM は別のマスターを探します。リソースグループがオンラインになれない原因は、 Start メソッドまたは Prenet_start メソッドがゼロ以外で終了したか、タイムアウトしたかのどちらかです。

リソースの scha_control コマンドまたは関数の呼び出しによって、 Pingpong_interval で指定した秒数内に特定のノード上でリソースグループがオフラインになった場合、別のノードから生じる後続の scha_control() 呼び出しの結果、そのノードはリソースグループのホストとして不適切だと判断されます。

カテゴリ:

オプション

初期値:

3,600 (1 時間)

調整:

Yes

Resource_list (string_array )

グループに含まれるリソースのリスト。管理者はこのプロパティを直接設定しません。このプロパティは、管理者がリソースグループにリソースを追加したり、リソースを削除したときに、RGM によって更新されます。

カテゴリ:

照会のみ

初期値:

デフォルトなし

調整:

いいえ

RG_affinities (string)

RGM は、別のリソースグループの現在のマスターであるノードにリソースグループを配置するか (肯定的なアフィニティの場合)、あるいは、別のリソースグループの現在のマスターでないノード上にリソースグループを配置するか (否定的なアフィニティの場合) しようとします。

RG_affinities には、次の文字列を設定できます。

• ++ (強い肯定的なアフィニティ)

• + (弱い肯定的なアフィニティ)

• - (弱い否定的なアフィニティ)

• -- (強い否定的なアフィニティ)

• +++ (フェイルオーバー委託付きの強い肯定的なアフィニティ)

たとえば、RG_affinities=+RG2,--RG3 は、このリソースグループが RG2 に対しては弱い肯定的なアフィニティを持っており、RG3 に対しては強い否定的なアフィニティを持っていることを示します。

RG_affinities の使用方法については、『Sun Cluster データサービスの計画と管理 (Solaris 編)』の「Administering Data Service Resources」を参照してください。

カテゴリ:

オプション

初期値:

空の文字列

調整:

Yes

RG_dependencies (string_array )

同じノード上の別のグループをオンライン/オフラインにするときの優先順位を示すリソースグループのリスト (任意)。すべての強い RG_affinities (肯定的と否定的) と RG_dependencies が一緒のグラフはサイクルを含むことが許されません。

たとえば、リソースグループ RG2 がリソースグループ RG1 の RG_dependencies リスト内に含まれると仮定します。言い換えると、RG1 が RG2 にリソースグループ依存関係を持っていると仮定します。次のリストに、このリソースグループ依存関係の効果を要約します。

• あるノードがクラスタに参加するとき、RG2 内のリソース上でそのノード上のすべての Boot メソッドが完了するまで、RG1 内のリソース上でそのノード上の Boot メソッドは動作しません。

• RG1 と RG2 が両方とも同じノード上で同時に Pending_online 状態である場合、RG2 内のすべてのリソースが自分の開始メソッドを完了するまで、RG1 内のどのリソースも自分の開始メソッド (Prenet_start または Start) を実行できません。

• RG1 と RG2 が両方とも同じノード上で同時に Pending_offline 状態である場合、RG2 内のすべてのリソースが自分の停止メソッドを完了するまで、RG1 内のどのリソースも自分の停止メソッド (Stop または Postnet_stop) を実行できません。

• プライマリを切り替えたとき、任意のノード上で RG1 がオンラインのままになり、すべてのノード上で RG2 がオフラインになった場合、RG1 または RG2 のプライマリの切り替えは失敗します。詳細については、scswitch(1M) と scsetup(1M) を参照してください。

• RG2 上で Desired_primaries プロパティをゼロに設定した場合、RG1 上で Desired_primaries プロパティをゼロより大きな値に設定することは許可されません。

• RG2 上で Auto_start_on_new_cluster プロパティを FALSE に設定した場合、RG1 上で Auto_start_on_new_cluster プロパティを TRUE に設定することは許可されません。

カテゴリ:

オプション

初期値:

空のリスト

調整:

Yes

RG_description (string)

リソースグループの簡単な説明。

カテゴリ:

オプション

初期値:

空の文字列

調整:

Yes

RG_is_frozen (boolean)

あるリソースグループが依存している大域デバイスをスイッチオーバーするかどうかを表します。このプロパティが TRUE に設定された場合、大域デバイスはスイッチオーバーされます。このプロパティが FALSE に設定された場合、どの大域デバイスもスイッチオーバーされません。リソースグループが大域デバイスに依存するかどうかは、Global_resources_used プロパティの設定によります。

ユーザーは RG_is_frozen プロパティを直接設定できません。RG_is_frozen プロパティは、大域デバイスのステータスが変わったときに、RGM によって更新されます。

カテゴリ:

オプション

初期値:

デフォルトなし

調整:

いいえ

RG_mode (列挙型)

リソースグループがフェイルオーバーグループかスケーラブルグループかを指定します。値が Failover の場合、RGM はグループの Maximum_primaries プロパティの値を 1 に設定し、リソースグループのマスターを単一のノードに制限します。

このプロパティの値が Scalable の場合、RGM は Maximum_primaries プロパティに 1 より大きい値を設定することを許可します。結果として、グループを複数のノードで同時にマスターできます。Failover プロパティの値が TRUE のリソースを、RG_mode の値が Scalable のリソースグループに追加することはできません。

Maximum_primaries が 1 の場合、デフォルトは Failover です。Maximum_primaries が 1 より大きい場合、デフォルトは Scalable です。

カテゴリ:

オプション

初期値:

Maximum_primaries の値に依存。

調整:

いいえ

RG_name (string)

リソースグループの名前。この名前は、クラスタ内で一意である必要があります。

カテゴリ:

必須

初期値:

デフォルトなし

調整:

いいえ

RG_project_name (string)

リソースグループに関連付けられた Solaris プロジェクト名。このプロパティは、CPU の共有、クラスタデータサービスのリソースプールといった Solaris のリソース管理機能に適用できます。RGM は、リソースグループをオンラインにするとき、Resource_project_name プロパティセットを持たないリソースに対して、このプロジェクトで関連付けられたプロセスを起動します。プロジェクトデータベース内に存在するプロジェクト名を指定する必要があります。また、root ユーザーは、このプロジェクトのメンバーとして構成されている必要があります。

このプロパティは、Solaris 9 以降のバージョンでのみサポートされます。

---

注 –

このプロパティの変更は、このリソースが次回起動されるときに有効になります。

---

カテゴリ:

オプション

初期値:

テキスト文字列 “default”。

調整:

ANYTIME

各クラスタ上の RG_state ( enum)

RGM によって各クラスタノード上のグループの状態を表す値に設定されます。設定される値は、Unmanaged 、Online、Offline、Pending_online、Pending_offline、Pending_online_blocked、Error_stop_failed、Online_faulted、または Pending_online_blocked です。

ユーザーはこのプロパティを構成できません。しかし、scswitch(1M) を呼び出すことによって 、あるいは同等の scsetup(1M) か SunPlex Manager コマンドを使用して、このプロパティを間接的に設定することは可能です。

カテゴリ:

照会のみ

初期値:

デフォルトなし

調整:

いいえ

RG_system (boolean)

リソースグループの RG_system プロパティの値が TRUE の場合、そのリソースグループとそのリソースグループ内のリソースに関する特定の操作が制限されます。この制限は、重要なリソースグループやリソースを間違って変更または削除してしまうことを防ぐためにあります。このプロパティの影響を受けるのは、scrgadm(1M) コマンドと scswitch(1M) コマンドだけです。scha_control(1HA) コマンドと scha_control(3HA) コマンドの動作には影響ありません。

リソースグループ (またはリソースグループ内のリソース) の制限操作を実行する前には、まず、リソースグループの RG_system プロパティをFALSE に設定する必要があります。クラスタサービスをサポートするリソースグループ (または、リソースグループ内のリソース) を変更または削除するときには注意してください。

RG_system が TRUE に設定されているリソースグループのことを「システムリソースグループ」と呼びます。RG_system の現在の値に関わらず、 RG_system プロパティ自身を編集することは制限されません。これらの制限の詳細については、rg_properties(5) のマニュアルページを参照してください。

カテゴリ:

オプション

初期値:

FALSE

調整:

Yes

リソースプロパティの属性

次の節では、システム定義のプロパティの変更または拡張プロパティの作成に使用できるリソースプロパティ属性について説明します。

boolean、enum、int タイプのデフォルト値に、Null または空の文字列 ("") は指定できません。

最初にプロパティ名が表示され、次に説明が表示されます。

Array_maxsize

stringarray タイプの場合、設定できる配列要素の最大数。

Array_minsize

stringarray タイプの場合、設定できる配列要素の最小数。

Default

プロパティのデフォルト値を示します。

Description

プロパティを簡潔に記述した注記 (文字列)。RTR ファイル内でシステム定義プロパティに対する Description 属性を設定することはできません。

Enumlist

enum タイプの場合、プロパティに設定できる文字列値のセット。

Extension

リソースタイプの実装によって定義された拡張プロパティが RTR ファイルのエントリで宣言されていることを示します。拡張プロパティが使用されていない場合、そのエントリはシステム定義プロパティです。

Max

int タイプの場合、プロパティに設定できる最大値。

Maxlength

string および stringarray タイプの場合、設定できる文字列の最大。

Min

int タイプの場合、プロパティに設定できる最小値。

Minlength

string および stringarray タイプの場合、設定できる文字列の最小長。

Property

リソースプロパティの名前。

Tunable

クラスタ管理者がリソースのプロパティ値をいつ設定できるかを示します。管理者にプロパティの設定を許可しない場合は、NONE または FALSE に設定します。管理者にプロパティの調整を許可する属性値は、次のとおりです。TRUE または ANYTIME (任意の時点)、AT_CREATION (リソースの作成時のみ)、WHEN_DISABLED (リソースがオフラインのとき)。ほかの調整可能な条件 (「いつ監視を無効にするか」や「いつオフラインにするか」など) を設定するには、この属性を ANYTIME に設定して、Validate メソッドでリソースの状態を検証します。

デフォルトは、標準リソースプロパティごとに異なります (次の節を参照)。RTR ファイルで特に指定していない限り、拡張プロパティを調整する設定のデフォルトは TRUE ( ANYTIME) です。

プロパティのタイプ

指定可能な型は、string、boolean、int、enum、stringarray です。RTR ファイル内で、システム定義プロパティの型の属性を設定することはできません。タイプは、RTR ファイルのエントリに登録できる、指定可能なプロパティ値とタイプ固有の属性を決定します。enum タイプは、文字列値のセットです。