リソースのプロパティー

この節では、Sun Cluster ソフトウェアによって定義されているリソースプロパティーについて説明します。

プロパティー値は以下のように分類されます。

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

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

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

• 照会のみ。管理ツールで直接設定することはできません。

Tunable 属性 (詳細は 「リソースプロパティーの属性」 を参照) では、リソースプロパティーを更新できるかどうかや、いつ更新できるかを指定します。属性値は次のとおりです。

FALSE または NONE

不可

TRUE または ANYTIME

任意の時点 (Anytime)

AT_CREATION

リソースをクラスタに追加するとき

WHEN_DISABLED

リソースが無効なとき

以下にプロパティー名とその説明を示します。

Affinity_timeout (integer)

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

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

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

カテゴリ:

任意

デフォルト:

デフォルトなし

調整:

ANYTIME

Boot_timeout (Type 内の各コールバックメソッドに対して) (integer)

RGM が当該メソッドの呼び出しに失敗したと判断するまでの時間 (秒)。各リソースタイプのタイムアウトプロパティーは、RTR ファイルで宣言されているメソッドについてのみ定義されます。

カテゴリ:

条件付きまたは任意

デフォルト:

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

調整:

ANYTIME

Cheap_probe_interval (integer)

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

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

カテゴリ:

条件付き

デフォルト:

デフォルトなし

調整:

WHEN_DISABLED

拡張プロパティー

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

カテゴリ:

条件付き

デフォルト:

デフォルトなし

調整:

特定のプロパティーに依存

Failover_mode (enum)

リソースが正常に開始または停止できなかった場合、またはリソースモニターが正常ではないリソースを検出し、その結果再起動またはフェイルオーバーを要求する場合に RGM が取る回復アクションを変更します。

NONE、SOFT、または HARD (メソッドの失敗)

これらの設定は、起動メソッドまたは停止メソッド ( Prenet_start, Start、Monitor_stop、Stop、Postnet_stop) が失敗する場合にフェイルオーバー動作にだけ影響を与えます。また、RESTART_ONLY および LOG_ONLY 設定は、リソースモニターが scha_control コマンドまたは scha_control() 関数の 実行を開始できるかどうかに影響を与える可能性があります。詳細は、scha_control(1HA) および scha_control(3HA) のマニュアルページを参照してください。NONE は、前述の起動メソッドまたは停止メソッドが失敗する場合に RGM が何の復旧処理も行わないことを示します。SOFT または HARD は、Start または Prenet_start メソッドが失敗する場合に RGM がリソースのグループをほかのノードまたはゾーンに再配置することを示します。Start と Prenet_start メソッドにとっては、その処理が失敗する場合、SOFT と HARD は同じ意味を持ちます。

停止メソッド (Monitor_stop、Stop、または Postnet_stop) にとっては、その処理が失敗する場合、SOFT と NONE は同じ意味を持ちます。Failover_mode を HARD に設定すると、これらのメソッドの 1 つが失敗した場合には RGM はノードまたはゾーンを再起動してリソースグループを強制的にオフラインにします。これにより RGM は別のノードまたはゾーンでグループの起動を試みることが可能になります。

RESTART_ONLY または LOG_ONLY

起動メソッドまたは停止メソッドが失敗する場合にフェイルオーバー動作に影響を与える NONE、SOFT、HARD とは異なり、RESTART_ONLY と LOG_ONLY はすべてのフェイルオーバー動作に影響を与えます。フェイルオーバー動作には、モニター起動 (scha_control) によるリソースやリソースグループの再起動や、リソースモニター (scha_control) によって開始されるギブオーバーなどがあります。RESTART_ONLY は、モニターが scha_control を実行してリソースまたはリソースグループを再起動できることを意味します。RGM では、Retry_interval の間に Retry_count 回数だけ再起動を試行できます。試行回数が Retry_count を超えると、それ以上の再起動は許可されません。

---

注 –

Retry_count の負の値は、リソースタイプによっては適用できませんが、リソースを無制限に再起動できることを指定します。より確実に無制限の再起動を指定するには、次の手順を実行します。

• Retry_interval に 1 や 0 などの小さい値を指定します。

• Retry_count に 1000 などの大きい値を指定します。

リソースタイプが Retry_count および Retry_interval プロパティーを宣言しない場合は、リソースは回数の制限なく再起動できます。

---

Failover_mode を LOG_ONLY に設定すると、リソースの再起動もギブオーバーも許可されません。Failover_mode を LOG_ONLY に設定するのは、Failover_mode を RESTART_ONLY に設定し、Retry_count をゼロに設定するのと同じことです。

RESTART_ONLY または LOG_ONLY (メソッドの失敗)

Prenet_start、Start、Monitor_stop、Stop、または Postnet_stop メソッドが失敗した場合、RESTART_ONLY と LOG_ONLY は NONE と同じことです。つまり、ノードまたはゾーンのフェイルオーバーやリブートはどちらも行われません。

データサービスに対する Failover_mode 設定の影響

Failover_mode の各設定がデータサービスに及ぼす影響は、データサービスが監視されているかどうか、およびデータサービスが Data Services Development Library (DSDL) に基づいているかどうかによって決まります。

• データサービスが監視の対象となるのは、そのサービスが Monitor_start メソッドを実装しており、かつリソースの監視が有効になっている場合です。RGM は、リソースそれ自体を起動した後で Monitor_start メソッドを実行することにより、リソースモニターを起動します。リソースモニターはリソースが正常であるかどうかを検証します。検証が失敗に終わる場合、リソースモニターは scha_control() 関数を呼び出して再起動またはフェイルオーバーを要求することがあります。DSDL ベースのリソースの場合、検証によりデータサービスの部分的な障害 (機能低下) または完全な障害が明らかになる場合があります。部分的な障害が繰り返し蓄積されると、完全な障害になります。

• Monitor_start メソッドを実装していないか、リソースの監視が無効にされている場合には、データサービスは監視の対象となりません。

• DSDL ベースのデータサービスには、Agent Builder や GDS により開発されたデータサービス、または DSDL を直接使用して開発されたデータサービスが含まれます。HA Oracle など一部のデータサービスは、DSDL を使用せずに開発されています。

NONE、SOFT、または HARD (検証の失敗)

Failover_mode を NONE、SOFT、または HARD に設定した場合で、データサービスが DSDL ベースサービスとして監視されており、かつ検証が完全に失敗に終わったとき、モニターは scha_control() 関数を呼び出してリソースの再起動を要求します。検証が失敗し続ける場合、Retry_interval の間、Retry_count に指定されている最大の回数を限度にリソースの再起動が行われます。Retry_count の再起動数に到達した後も検証が再び失敗した場合、モニターは別のノードまたはゾーンに対してリソースのグループのフェイルオーバーを要求します。

Failover_mode を NONE、SOFT、または HARD に設定した場合で、監視の対象とならない DSDL ベースのデータサービスが使用されている状態で失敗が一度検出されるとリソースのプロセスツリーが停止します。リソースのプロセスツリーが故障すると、リソースが再起動されます。

データサービスが DSDL ベースのサービスではない場合、再起動またはフェイルオーバー動作は、リソースモニターがどのようにコード化されているかによって決まります。たとえば Oracle リソースモニターは、リソースまたはリソースグループを再起動するか、リソースグループのフェイルオーバーを行うことで回復します。

RESTART_ONLY (検証の失敗)

Failover_mode を RESTART_ONLY に設定した場合で、監視の対象となる DSDL ベースデータサービスが使用されている状態で検証が完全に失敗すると、Retry_interval の範囲内で Retry_count に指定されている回数だけリソースの再起動が行われます。しかし、Retry_count を超えた時点で、リソースモニターは終了してリソース状態を FAULTED に設定し、状態メッセージ「Application faulted, but not restarted. Probe quitting.」を生成します。この時点で監視はまだ有効ですが、リソースがクラスタ管理者により修復および再起動されるまで、リソースは事実上監視対象外になります。

Failover_mode を RESTART_ONLY に設定した場合で、監視対象でない DSDL ベースのデータサービスが使用されている状態でプロセスツリーが停止すると、リソースは再起動されません。

監視対象データサービスが DSDL ベースのデータサービスではない場合、回復動作はリソースモニターがどのようにコード化されているかに依存します。Failover_mode を RESTART_ONLY に設定した場合には、Retry_interval 内で Retry_count に指定されている回数だけ scha_control() 関数を呼び出してリソースまたはリソースグループを再起動できます。リソースモニターが Retry_count を超えると、再起動は失敗します。また、モニターが scha_control() 関数を呼び出してフェイルオーバーを要求しても、その要求は失敗します。

LOG_ONLY (検証の失敗)

Failover_mode がデータサービスに対して LOG_ONLY に設定されている場合、すべての scha_control() はリソースまたはリソースグループの再起動を要求するか、除外されているグループのフェイルオーバーを要求します。データサービスが DSDL ベースである場合、検証が完全に失敗した場合メッセージが記録されますが、リソースは再起動されません。Retry_interval 内で Retry_count に指定された回数を超えて検証が完全に失敗した場合、リソースモニターは終了してリソース状態を FAULTED に設定し、状態メッセージ「Application faulted, but not restarted. Probe quitting.」を生成します。この時点で監視はまだ有効ですが、リソースがクラスタ管理者により修復および再起動されるまで、リソースは事実上監視対象外になります。

Failover_mode が LOG_ONLY に設定されていて、データサービスが監視対象外の DSDL ベースのサービスであり、プロセスツリーが故障した場合、メッセージが記録されますが、リソースは再起動されません。

監視対象データサービスが DSDL ベースのデータサービスではない場合、回復動作はリソースモニターがどのようにコード化されているかに依存します。Failover_mode を LOG_ONLY に設定した場合は、リソースまたはリソースグループの再起動あるいはグループのフェイルオーバーを行う scha_control() 要求はすべて失敗します。

カテゴリ:

任意

デフォルト:

NONE

調整:

ANYTIME

Fini_timeout (Type 内の各コールバックメソッドに対して) (integer)

RGM が当該メソッドの呼び出しに失敗したと判断するまでの時間 (秒)。各リソースタイプのタイムアウトプロパティーは、RTR ファイルで宣言されているメソッドについてのみ定義されます。

カテゴリ:

条件付きまたは任意

デフォルト:

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

調整:

ANYTIME

Init_timeout (Type 内の各コールバックメソッドに対して) (integer)

RGM が当該メソッドの呼び出しに失敗したと判断するまでの時間 (秒)。各リソースタイプのタイムアウトプロパティーは、RTR ファイルで宣言されているメソッドについてのみ定義されます。

カテゴリ:

条件付きまたは任意

デフォルト:

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

調整:

ANYTIME

Load_balancing_policy (string)

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

Lb_weighted (デフォルト)。Load_balancing_weights プロパティーに設定されている重みにより、さまざまなノードに負荷が分散されます。

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

Lb_sticky_wild。ワイルドスティッキーサービスの IP アドレスに接続する Lb_sticky_wild で指定されたクライアントの 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 が負荷の 4 分の 1 を受け持ち、ノード 2 が負荷の 4 分の 3 を受け持つことを指定します。デフォルトの空の文字列 ("") は、一定の分散を指定します。明示的にウエイトを割り当てられていないノードのウエイトは、デフォルトで 1 になります。

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

カテゴリ:

条件付きまたは任意

デフォルト:

空の文字列 (“”)

調整:

ANYTIME

Monitor_check_timeout (Type 内の各コールバックメソッドに対して) (integer)

RGM が当該メソッドの呼び出しに失敗したと判断するまでの時間 (秒)。各リソースタイプのタイムアウトプロパティーは、RTR ファイルで宣言されているメソッドについてのみ定義されます。

カテゴリ:

条件付きまたは任意

デフォルト:

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

調整:

ANYTIME

Monitor_start_timeout (Type 内の各コールバックメソッドに対して) (integer)

RGM が当該メソッドの呼び出しに失敗したと判断するまでの時間 (秒)。各リソースタイプのタイムアウトプロパティーは、RTR ファイルで宣言されているメソッドについてのみ定義されます。

カテゴリ:

条件付きまたは任意

デフォルト:

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

調整:

ANYTIME

Monitor_stop_timeout (Type 内の各コールバックメソッドに対して) (integer)

RGM が当該メソッドの呼び出しに失敗したと判断するまでの時間 (秒)。各リソースタイプのタイムアウトプロパティーは、RTR ファイルで宣言されているメソッドについてのみ定義されます。

カテゴリ:

条件付きまたは任意

デフォルト:

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

調整:

ANYTIME

Monitored_switch (enum)

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

カテゴリ:

照会のみ

デフォルト:

デフォルトなし

調整:

NONE

Network_resources_used (string_array)

リソースが依存関係を持っている論理ホスト名または共有アドレスネットワークリソースのリスト。このリストには、プロパティー Resource_dependencies、Resource_dependencies_weak、Resource_dependencies_restart、または Resource_dependencies_offline_restart に現れるすべてのネットワークアドレスリソースが含まれます。

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

このプロパティーは、リソース依存関係プロパティーの設定に基づいて、RGM により自動的に更新されます。このプロパティーを直接設定する必要はありません。しかし、このプロパティーにリソース名を追加する場合、そのリソース名は自動的に Resource_dependencies プロパティーに追加されます。このプロパティーからリソース名を削除する場合、そのリソース名は自動的に、そのリソースが現れるすべてのリソース依存関係プロパティーから削除されます。

カテゴリ:

条件付きまたは任意

デフォルト:

空のリスト

調整:

ANYTIME

Num_resource_restarts (各クラスタノードまたはゾーン上) (integer)

過去 n 秒以内にこのリソースで発生した再起動要求の数。n は、Retry_interval プロパティーの値です。

再起動要求は、次に示す呼び出しのいずれかです。

• RESOURCE_RESTART 引数を持つ scha_control(1HA) コマンド。

• RESOURCE_RESTART 引数を持つ scha_control(3HA) 関数。

• RESOURCE_IS_RESTARTED 引数を持つ scha_control コマンド。

• SCHA_RESOURCE_IS_RESTARTED 引数を持つ scha_control 関数。

リソースが次に示す処理のいずれかを実行した場合、RGM は、ある特定のノードまたはゾーン上にある特定のリソースに対して再起動カウンタを必ず 0 にリセットします。

• GIVEOVER 引数を持つ scha_control コマンド。

• SCHA_GIVEOVER 引数を持つ scha_control 関数。

カウンタは、ギブオーバーの試行が成功した場合でも失敗した場合でもリセットされます。

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

カテゴリ:

照会のみ

デフォルト:

デフォルトなし

調整:

説明を参照

Num_rg_restarts (各クラスタノードまたはゾーン上) (integer)

過去 n 秒以内にこのリソースに対して発生したリソースグループ再起動要求の数。n は、Retry_interval プロパティーの値です。

リソースグループ再起動要求は、次に示す呼び出しのいずれかです。

• RESTART 引数を持つ scha_control(1HA) コマンド。

• SCHA_RESTART 引数を持つ scha_control(3HA) 関数。

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

カテゴリ:

照会のみ

デフォルト:

デフォルトなし

調整:

説明を参照

On_off_switch (enum)

クラスタ管理者が管理ユーティリィティーを使ってリソースを有効または無効にすると、RGM によって Enabled または Disabled に設定されます。無効に設定すると、リソースはオフラインになり、再び有効にされるまでコールバックが行われることはありません。

カテゴリ:

照会のみ

デフォルト:

デフォルトなし

調整:

NONE

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 Data Service for Apache Guide for Solaris OS』を参照してください。

カテゴリ:

条件付きまたは必須

デフォルト:

デフォルトなし

調整:

ANYTIME

Postnet_stop_timeout (Type 内の各コールバックメソッドに対して) (integer)

RGM が当該メソッドの呼び出しに失敗したと判断するまでの時間 (秒)。各リソースタイプのタイムアウトプロパティーは、RTR ファイルで宣言されているメソッドについてのみ定義されます。

カテゴリ:

条件付きまたは任意

デフォルト:

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

調整:

ANYTIME

Prenet_start_timeout (Type 内の各コールバックメソッドに対して) (integer)

RGM が当該メソッドの呼び出しに失敗したと判断するまでの時間 (秒)。各リソースタイプのタイムアウトプロパティーは、RTR ファイルで宣言されているメソッドについてのみ定義されます。

カテゴリ:

条件付きまたは任意

デフォルト:

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

調整:

ANYTIME

Proxied_service_instances

リソースによってプロキシされる SMF サービスに関する情報を含みます。値はプロキシされるすべての SMF サービスを含むファイルのパスです。ファイル内の各行は 1 つのSMF サービス専用で、svc fmri および対応するサービスマニフェストファイルのパスを指定します。

たとえば、リソースが 2 つのサービス、 restarter_svc_test_1:default と restarter_svc_test_2:default を管理する必要がある場合、ファイルには次に示す 2 行が含まれているはずです。

<svc:/system/cluster/restarter_svc_test_1:default>,svc:/system/cluster/\
restarter_svc_test_1:default>,</var/svc/manifest/system/cluster/\
restarter_svc_test_1.xml>

<svc:/system/cluster/restarter_svc_test_2:default>,</var/svc/manifest/\
system/cluster/restarter_svc_test_2.xml>

デフォルト: ""

調整: When_disabled

R_description (string)

リソースの簡単な説明。

カテゴリ:

任意

デフォルト:

空の文字列

調整:

ANYTIME

Resource_dependencies (string_array)

対象のリソースが強い依存性を持っている、依存先リソースのリストです。強い依存性によってメソッドの呼び出し順序が決まります。

リソースへの依存性を持つリソース (「依存するリソース」と呼ぶ) は、リスト内のリソース (「依存されるリソース」と呼ぶ) のどれか 1 つでもオンラインでない場合、起動することができません。依存するリソースと、リスト内のいずれかの依存されるリソースが、同時に起動した場合、RGM はリスト内の依存されるリソースが起動するまで、依存するリソースの起動を待ちます。依存されるリソースが起動しなければ、依存するリソースはオフラインのままになります。依存されるリソースは、リスト内の依存対象リソースが属するリソースグループがオフラインのままになっているか、または Start_failed 状態になっているために、起動しないことがあります。別のリソースグループにある依存されるリソースが起動に失敗しているか、無効またはオフラインであるために、依存するリソースがオフラインのままになっている場合、依存するリソースのグループは Pending_online_blocked 状態に入ります。依存するリソースと依存されるリソースが同じリソースグループにあり、依存されるリソースが起動に失敗したか、無効になっているか、またはオフラインになっている場合には、リソースグループは Pending_online_blocked 状態に入りません。

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

同じリソースグループ内では、依存性の順序に従って Prenet_start メソッドが Start メソッドより先に実行されます。同様に、Postnet_stop メソッドは Stop メソッドよりあとに実行されます。異なるリソースグループ内では、依存されるリソースが Prenet_start と Start を終了してから、依存するリソースが Prenet_start を実行します。同様に、依存するリソースが Stop と Postnet_stop を終了してから、依存されるリソースが Stop を実行します。

依存関係の範囲を指定するには、このプロパティーを指定するときに、次の修飾子を中括弧 {} を含めてリソース名に付加します。

{LOCAL_NODE}

指定される依存関係をノード単位またはゾーン単位に限定します。依存関係の動作は、同じノード上またはゾーン上でのみ依存されるリソースに影響されます。依存するリソースは、依存されるリソースが同じノードまたはゾーンで起動されるまで待機します。終了と再起動、および有効化と無効化の場合も同様です。

{ANY_NODE}

指定された依存関係を任意のノードまたはゾーンに拡張します。依存関係の動作は、どのノードまたはゾーンでも依存されるリソースに影響されます。依存するリソースは、自分が起動する前に依存されるリソースが少なくとも 1 つの主ノードまたは主ゾーンで起動するまで待機します。終了と再起動、および有効化と無効化の場合も同様です。

依存するリソースのリソースグループが依存されるリソースのリソースグループに対してポジティブアフィニティーを持っている場合でも、依存性は ANY_NODE のままになります。

{FROM_RG_AFFINITIES}

リソースのリソースグループの RG_affinities 関係に基づいて、依存関係が LOCAL_NODE か ANY_NODE かを指定します。

依存するリソースのグループが依存されるリソースのグループに対してポジティブアフィニティーを持っていて、それらが同じノード上で起動または終了する場合、依存関係は LOCAL_NODE とみなされます。そのようなポジティブアフィニティーが存在しない場合、または各グループが別々のノード上で起動している場合には、依存関係は ANY_NODE とみなされます。

修飾子を指定しない場合は、FROM_RG_AFFINITIES 修飾子がデフォルトで使用されます。

同じリソースグループにある 2 つのリソース間のリソース依存関係は常に LOCAL_NODE になります。

カテゴリ:

任意

デフォルト:

空のリスト

調整:

ANYTIME

Resource_dependencies_offline_restart (string_array)

対象のリソースがオフライン再起動の依存性を持っている、依存先リソースのリストです。オフライン再起動の依存性によってメソッドの呼び出し順序が決まります。

このプロパティーの機能は Resource_dependencies と同じであり、さらに次の機能を持ちます。オフライン再起動の依存対象のリストにあるいずれかのリソース (「依存されるリソース」と呼ぶ) がオフラインになった場合、RGM は、リソースの依存性を持つリソース (「依存するリソース」と呼ぶ) の再起動を実行します。依存するリソースは直ちに終了し、依存されるリソースが再起動されるまでオフラインのままになります。リスト内の依存されるリソースがオンラインに戻ると、RGM は依存するリソースを再起動します。この再起動の動作は、依存するリソースと依存されるリソースのあるリソースグループがオンラインのままであるときに発生します。

依存されるリソースがいずれか 1 つでもオンラインでない場合には、依存するリソースを起動することはできません。依存するリソースと、リスト内のいずれかの依存されるリソースが、同時に起動した場合、RGM はリスト内の依存されるリソースが起動するまで、依存するリソースの起動を待ちます。依存されるリソースが起動しなければ、依存するリソースはオフラインのままになります。依存されるリソースは、リスト内の依存対象リソースが属するリソースグループがオフラインのままになっているか、または Start_failed 状態になっているために、起動しないことがあります。別のリソースグループにある依存されるリソースが起動に失敗しているか、無効またはオフラインであるために、依存するリソースがオフラインのままになっている場合、依存するリソースのグループは Pending_online_blocked 状態に入ります。同じリソースグループにある依存されるリソースが、起動に失敗したか、無効になっているか、またはオフラインである場合、リソースグループは Pending_online_blocked 状態に入りません。

依存関係の範囲を指定するには、このプロパティーを指定するときに、次の修飾子を中括弧 {} を含めてリソース名に付加します。

{LOCAL_NODE}

指定される依存関係をノード単位またはゾーン単位に限定します。依存関係の動作は、同じノード上またはゾーン上でのみ依存されるリソースに影響されます。依存するリソースは、依存されるリソースが同じノードまたはゾーンで起動されるまで待機します。終了と再起動、および有効化と無効化の場合も同様です。

{ANY_NODE}

指定された依存関係を任意のノードまたはゾーンに拡張します。依存関係の動作は、どのノードまたはゾーンでも依存されるリソースに影響されます。依存するリソースは、自分が起動する前に依存されるリソースが少なくとも 1 つの主ノードまたは主ゾーンで起動するまで待機します。終了と再起動、および有効化と無効化の場合も同様です。

依存するリソースのリソースグループが依存されるリソースのリソースグループに対してポジティブアフィニティーを持っている場合でも、依存性は ANY_NODE のままになります。

{FROM_RG_AFFINITIES}

リソースのリソースグループの RG_affinities 関係に基づいて、依存関係が LOCAL_NODE か ANY_NODE かを指定します。

依存するリソースのグループが依存されるリソースのグループに対してポジティブアフィニティーを持っていて、それらが同じノード上で起動または終了する場合、依存関係は LOCAL_NODE とみなされます。そのようなポジティブアフィニティーが存在しない場合、または各グループが別々のノード上で起動している場合には、依存関係は ANY_NODE とみなされます。

修飾子を指定しない場合は、FROM_RG_AFFINITIES 修飾子がデフォルトで使用されます。

同じリソースグループにある 2 つのリソース間のリソース依存関係は常に LOCAL_NODE になります。

カテゴリ:

任意

デフォルト:

空のリスト

調整:

ANYTIME

Resource_dependencies_restart (string_array)

対象のリソースが再起動の依存性を持っているリソースのリストです。再起動の依存性によってメソッドの呼び出し順序が決まります。

このプロパティーの機能は Resource_dependencies と同じであり、さらに次の機能を持ちます。再起動の依存対象のリストにあるいずれかのリソース (「依存されるリソース」と呼ぶ) が再起動された場合、リソースの依存性を持つリソース (「依存するリソース」と呼ぶ) が再起動されます。リスト内の依存されるリソースがオンラインに戻ると、RGM は依存するリソースを終了して再起動します。この再起動の動作は、依存するリソースと依存されるリソースのあるリソースグループがオンラインのままであるときに発生します。

リソースへの依存性を持つリソース (「依存するリソース」と呼ぶ) は、リスト内のリソース (「依存されるリソース」と呼ぶ) のどれか 1 つでもオンラインでない場合、起動することができません。依存するリソースと、リスト内のいずれかの依存されるリソースが、同時に起動した場合、RGM はリスト内の依存されるリソースが起動するまで、依存するリソースの起動を待ちます。依存されるリソースが起動しなければ、依存するリソースはオフラインのままになります。依存されるリソースは、リスト内の依存対象リソースが属するリソースグループがオフラインのままになっているか、または Start_failed 状態になっているために、起動しないことがあります。別のリソースグループにある依存されるリソースが起動に失敗しているか、無効またはオフラインであるために、依存するリソースがオフラインのままになっている場合、依存するリソースのグループは Pending_online_blocked 状態に入ります。依存するリソースと依存されるリソースが同じリソースグループにあり、依存されるリソースが起動に失敗したか、無効になっているか、またはオフラインになっている場合には、リソースグループは Pending_online_blocked 状態に入りません。

依存関係の範囲を指定するには、このプロパティーを指定するときに、次の修飾子を中括弧 {} を含めてリソース名に付加します。

{LOCAL_NODE}

指定される依存関係をノード単位またはゾーン単位に限定します。依存関係の動作は、同じノード上またはゾーン上でのみ依存されるリソースに影響されます。依存するリソースは、依存されるリソースが同じノードまたはゾーンで起動されるまで待機します。終了と再起動、および有効化と無効化の場合も同様です。

{ANY_NODE}

指定された依存関係を任意のノードまたはゾーンに拡張します。依存関係の動作は、どのノードまたはゾーンでも依存されるリソースに影響されます。依存するリソースは、自分が起動する前に依存されるリソースが少なくとも 1 つの主ノードまたは主ゾーンで起動するまで待機します。終了と再起動、および有効化と無効化の場合も同様です。

依存するリソースのリソースグループが依存されるリソースのリソースグループに対してポジティブアフィニティーを持っている場合でも、依存性は ANY_NODE のままになります。

{FROM_RG_AFFINITIES}

リソースのリソースグループの RG_affinities 関係に基づいて、依存関係が LOCAL_NODE か ANY_NODE かを指定します。

依存するリソースのグループが依存されるリソースのグループに対してポジティブアフィニティーを持っていて、それらが同じノード上で起動または終了する場合、依存関係は LOCAL_NODE とみなされます。そのようなポジティブアフィニティーが存在しない場合、または各グループが別々のノード上で起動している場合には、依存関係は ANY_NODE とみなされます。

修飾子を指定しない場合は、FROM_RG_AFFINITIES 修飾子がデフォルトで使用されます。

同じリソースグループにある 2 つのリソース間のリソース依存関係は常に LOCAL_NODE になります。

カテゴリ:

任意

デフォルト:

空のリスト

調整:

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 を実行します。

依存関係の範囲を指定するには、このプロパティーを指定するときに、次の修飾子を中括弧 {} を含めてリソース名に付加します。

{LOCAL_NODE}

指定される依存関係をノード単位またはゾーン単位に限定します。依存関係の動作は、同じノード上またはゾーン上でのみ依存されるリソースに影響されます。依存するリソースは、依存されるリソースが同じノードまたはゾーンで起動されるまで待機します。終了と再起動、および有効化と無効化の場合も同様です。

{ANY_NODE}

指定された依存関係を任意のノードまたはゾーンに拡張します。依存関係の動作は、どのノードまたはゾーンでも依存されるリソースに影響されます。依存するリソースは、自分が起動する前に依存されるリソースが少なくとも 1 つの主ノードまたは主ゾーンで起動するまで待機します。終了と再起動、および有効化と無効化の場合も同様です。

依存するリソースのリソースグループが依存されるリソースのリソースグループに対してポジティブアフィニティーを持っている場合でも、依存性は ANY_NODE のままになります。

{FROM_RG_AFFINITIES}

リソースのリソースグループの RG_affinities 関係に基づいて、依存関係が LOCAL_NODE か ANY_NODE かを指定します。

依存するリソースのグループが依存されるリソースのグループに対してポジティブアフィニティーを持っていて、それらが同じノード上で起動または終了する場合、依存関係は LOCAL_NODE とみなされます。そのようなポジティブアフィニティーが存在しない場合、または各グループが別々のノード上で起動している場合には、依存関係は ANY_NODE とみなされます。

修飾子を指定しない場合は、FROM_RG_AFFINITIES 修飾子がデフォルトで使用されます。

同じリソースグループにある 2 つのリソース間のリソース依存関係は常に LOCAL_NODE になります。

カテゴリ:

任意

デフォルト:

空のリスト

調整:

ANYTIME

Resource_name (string)

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

カテゴリ:

必須

デフォルト:

デフォルトなし

調整:

NONE

Resource_project_name (string)

リソースに関連付けられた Solaris プロジェクト名。このプロパティーは、CPU の共有、クラスタデータサービスのリソースプールといった Solaris のリソース管理機能に適用できます。RGM は、リソースをオンラインにすると、このプロジェクト名を持つ関連プロセスを起動します。このプロパティーが指定されなかった場合は、リソースのあるリソースグループの RG_project_name プロパティーからプロジェクト名が取得されます (rg_properties(5) のマニュアルページを参照)。どちらのプロパティーも指定されなかった場合、RGM は事前定義済みのプロジェクト名 default を使用します。プロジェクトデータベース内に存在するプロジェクト名を指定する必要があります (projects(1) のマニュアルページと 『Solaris のシステム管理 (Solaris コンテナ : 資源管理と Solaris ゾーン)』を参照)。

このプロパティーは Solaris 9 OS からサポートされるようになりました。

---

注 –

このプロパティーへの変更を有効にするためには、リソースを起動し直す必要があります。

---

カテゴリ:

任意

デフォルト:

Null

調整:

ANYTIME

Resource_state (各クラスタノードまたはゾーン上) (enum)

RGM が判断した各クラスタノード上またはゾーン上のリソースの状態。この状態には、Online、Offline、 Start_failed、Stop_failed、Monitor_failed、Online_not_monitored、Starting、Stopping があります。

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

カテゴリ:

照会のみ

デフォルト:

デフォルトなし

調整:

NONE

Retry_count (integer)

起動に失敗したリソースをモニターが再起動する回数です。

Retry_count を超えると、データサービスと、Failover_mode プロパティーの設定に応じ、次に示す処理のどれかをモニターが行う可能性があります。

• リソースがエラー状態であっても現在の主ノードまたは主ゾーンにリソースグループが留まることができるようにする

• ほかのノードまたはゾーンへのリソースグループのフェイルオーバーを要求する

このプロパティーは RGM によって作成されます。このプロパティーが RTR ファイルに宣言されている場合にかぎり、クラスタ管理者は使用を許可されます。RTR ファイル内でデフォルト値が指定されている場合、このプロパティーは任意です。

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

---

注 –

このプロパティーにマイナスの値を指定すると、モニターは無限回リソースの再起動を試みます。

ただし、一部のリソースタイプでは、Retry_count に負の値を設定できません。より確実に無制限の再起動を指定するには、次の手順を実行します。

• Retry_interval に 1 や 0 などの小さい値を指定します。

• Retry_count に 1000 などの大きい値を指定します。

---

カテゴリ:

条件付き

デフォルト:

上記を参照

調整:

WHEN_DISABLED

Retry_interval (integer)

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

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

カテゴリ:

条件付き

デフォルト:

デフォルトなし (上記を参照)

調整:

WHEN_DISABLED

Scalable (boolean)

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

---

注 –

スケーラブルなリソースグループ (ネットワーク負荷分散を使用) を、非大域ゾーンで動作するよう構成することができます。ただし、そのようなスケーラブルなリソースグループを実行できるのは、物理ノードごとに 1 つのゾーン内だけです。

---

このプロパティーが 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 は、スケーラビブルサービスプロパティーをいっさい設定しません。しかし、RTR ファイルで Network_resources_used プロパティーと Port_list プロパティーを明示的に宣言することができます。これらのプロパティーは、スケーラブルサービスだけでなく、非スケーラブルサービスでも有用です。

このリソースプロパティーと Failover リソースタイププロパティーの併用については、r_properties(5) のマニュアルページで詳しく説明されています。

カテゴリ:

任意

デフォルト:

デフォルトなし

調整:

AT_CREATION

Start_timeout (Type 内の各コールバックメソッドに対して) (integer)

RGM が当該メソッドの呼び出しに失敗したと判断するまでの時間 (秒)。各リソースタイプのタイムアウトプロパティーは、RTR ファイルで宣言されているメソッドについてのみ定義されます。

カテゴリ:

条件付きまたは任意

デフォルト:

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

調整:

ANYTIME

Status (各クラスタノードまたはゾーン上) (enum)

scha_resource_setstatus コマンド、scha_resource_setstatus() 関数、または scha_resource_setstatus_zone() 関数で、リソースモニターにより設定されます。取り得る値は、OK、DEGRADED、 FAULTED、UNKNOWN、および OFFLINE です。リソースがオンラインまたはオフラインにされると、RGM は Status 値を自動的に設定します。ただし、Status 値がリソースのモニターやメソッドによって設定される場合を除きます。

カテゴリ:

照会のみ

デフォルト:

デフォルトなし

調整:

NONE

Status_msg (各クラスタノードまたはゾーン上) (string)

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

カテゴリ:

照会のみ

デフォルト:

デフォルトなし

調整:

NONE

Stop_timeout (Type 内の各コールバックメソッドに対して) (integer)

RGM が当該メソッドの呼び出しに失敗したと判断するまでの時間 (秒)。各リソースタイプのタイムアウトプロパティーは、RTR ファイルで宣言されているメソッドについてのみ定義されます。

カテゴリ:

条件付きまたは任意

デフォルト:

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

調整:

ANYTIME

Thorough_probe_interval (integer)

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

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

カテゴリ:

条件付き

デフォルト:

デフォルトなし

調整:

WHEN_DISABLED

Type (string)

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

カテゴリ:

必須

デフォルト:

デフォルトなし

調整:

NONE

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

Update_timeout (Type 内の各コールバックメソッドに対して) (integer)

RGM が当該メソッドの呼び出しに失敗したと判断するまでの時間 (秒)。各リソースタイプのタイムアウトプロパティーは、RTR ファイルで宣言されているメソッドについてのみ定義されます。

カテゴリ:

条件付きまたは任意

デフォルト:

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

調整:

ANYTIME

Validate_timeout (Type 内の各コールバックメソッドに対して) (integer)

RGM が当該メソッドの呼び出しに失敗したと判断するまでの時間 (秒)。各リソースタイプのタイムアウトプロパティーは、RTR ファイルで宣言されているメソッドについてのみ定義されます。

カテゴリ:

条件付きまたは任意

デフォルト:

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

調整:

ANYTIME

Weak_affinity (boolean)

このプロパティーを TRUE に設定すると、弱い形式のクライアントアフィニティーが有効になります。

弱い形式のクライアントアフィニティーが有効になっている場合、特定のクライアントからの接続は、次の場合を除き、同じサーバーノードに送信されます。

• 障害モニターの再起動や、リソースのフェイルオーバーまたはスイッチオーバー、障害後のノードとクラスタの再結合などが行われたことに対応してサーバーリスナーが起動する。

• クラスタ管理者が管理作業を行なったために、スケーラブルリソースの Load_balancing_weights が変更される。

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

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

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

カテゴリ:

任意

デフォルト:

デフォルトなし

調整:

WHEN_DISABLED