リソースのプロパティー

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

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

• 必須。クラスタ管理者は、管理ユーティリティーを使ってリソースを作成するとき、必ず値を指定しなければなりません。

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

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

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

「リソースプロパティーの属性」で説明されている Tunable 属性は、次のように、リソースプロパティーを更新できるかどうか、および、いつ更新できるかを示します。

FALSE または NONE

しない

TRUE または ANYTIME

すべての時刻

AT_CREATION

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

WHEN_DISABLED

リソースが無効なとき

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

Affinity_timeout (integer)

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

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

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

カテゴリ:

任意

デフォルト:

デフォルトなし

調整:

ANYTIME

各コールバックメソッドの Boot_timeout (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 に設定されている場合、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 (integer)

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

カテゴリ:

条件付き/任意

デフォルト:

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

調整:

ANYTIME

各コールバックメソッドの Init_timeout ( 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 が負荷の 1/4 を受け取り、ノード 2 が負荷の 3/4 を受け取ることを指定します。デフォルトの空の文字列 ("") は、一定の分散を指定します。明示的にウエイトを割り当てられていないノードのウエイトは、デフォルトで 1 になります。

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

カテゴリ:

条件付き/任意

デフォルト:

空の文字列 (“”)

調整:

ANYTIME

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

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

カテゴリ:

条件付き/任意

デフォルト:

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

調整:

ANYTIME

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

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

カテゴリ:

条件付き/任意

デフォルト:

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

調整:

ANYTIME

各コールバックメソッドの Monitor_stop_timeout (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) コマンド。

• SCHA_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 (integer)

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

カテゴリ:

条件付き/任意

デフォルト:

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

調整:

ANYTIME

各コールバックメソッドの Prenet_start_timeout (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)

リソースが強い依存関係を持っているリソースのリスト。強い依存関係は、メソッド呼び出しの順序を決定します。

リソースの依存関係を有するリソースは依存しているリソースと呼ばれ、依存されているリソースと呼ばれるリスト内のリソースがオンラインでないと依存しているリソースを起動することはできません。依存しているリソースと、リスト内のいずれかの依存されているリソースが同時に起動した場合、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 とよく似ていますが、1 点例外があります。依存されているリソースと呼ばれる、オフライン再起動の依存関係リストのリソースがオフラインになると、RGM は、依存しているリソースと呼ばれる、リソースの依存関係を有するリソースの再起動をトリガーします。依存しているリソースはただちに停止し、依存されているリソースが再起動されるまでオフラインのままになります。リスト内の依存されているリソースがオンラインに戻ると、RGM は依存しているリソースを再起動します。このような再起動動作が発生するのは、依存しているリソースと依存されているリソースを含むリソースグループがオンラインのままである場合です。

依存されているリソースがオンラインでない場合、依存しているリソースを起動することはできません。依存しているリソースと、リスト内のいずれかの依存されているリソースが同時に起動した場合、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 とよく似ていますが、1 点例外があります。依存されているリソースと呼ばれる、再起動の依存関係リストのリソースが再起動すると、依存しているリソースと呼ばれるリソースの依存関係を有するリソースが再起動します。リスト内の依存されているリソースがオンラインに戻ったあと、RGM は依存しているリソースを停止し、再起動します。このような再起動動作が発生するのは、依存しているリソースと依存されているリソースを含むリソースグループがオンラインのままである場合です。

リソースの依存関係を有するリソースは依存しているリソースと呼ばれ、依存されているリソースと呼ばれるリスト内のリソースがオンラインでないと依存しているリソースを起動することはできません。依存しているリソースと、リスト内のいずれかの依存されているリソースが同時に起動した場合、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)

リソースが弱い依存関係を持っているリソースのリスト。弱い依存関係は、メソッド呼び出しの順序を決定します。

依存しているリソースと呼ばれる、リソースの依存関係を有するリソースの Start メソッドの前に、RGM は、依存されているリソースと呼ばれるこのリスト内のリソースの 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) のマニュアルページと 『System Administration Guide: Solaris Containers-Resource Management and Solaris Zones』 を参照)。

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

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

カテゴリ:

任意

デフォルト:

デフォルトなし

調整:

AT_CREATION

各コールバックメソッドの Start_timeout ( 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 (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 (integer)

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

カテゴリ:

条件付き/任意

デフォルト:

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

調整:

ANYTIME

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

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

カテゴリ:

条件付き/任意

デフォルト:

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

調整:

ANYTIME

Weak_affinity (boolean)

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

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

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

• クラスタ管理者により管理アクションが実行されたため、スケーラブルリソースの Load_balancing_weights が変更された場合。

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

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

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

カテゴリ:

任意

デフォルト:

デフォルトなし

調整:

WHEN_DISABLED