Sun Cluster データサービスの計画と管理 (Solaris OS 版)

リソースプロパティ

表 A–2 に、Sun Cluster で定義されているリソースタイププロパティの内容を示します。 この説明は、データサービスの開発者を対象としたものです。 特定のデータサービスの詳細は、そのデータサービスのマニュアルページを参照してください。 リソースプロパティ値は、以下のように分類されます。

表 A–2 は、リソースプロパティの調整が可能であるか、および、いつ調整できるかも示しています。

None または False

不可 

True または Anytime

任意の時点 

At_creation

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

When_disabled

リソースが無効なとき  

表 A–2 リソースプロパティ

プロパティ名 

説明  

Affinity_timeout

(整数) 

クライアントが、スティッキスケーラブルサービスへの接続をすべて閉じたあと、IP アフィニティ (IP 対応) が持続する秒数を制御します。 このタイムアウトが終了するまでは、当該クライアントからの新しい接続はすべて同じクラスタノードに転送されます。 値が 0 の場合、クライアントとスケーラブルサービスとの間に接続が存在するかぎり、アフィニティは継続します。 値が -1 の場合、クライアントがバインドされているクラスタノードに障害が起きるか、または再起動されるまで、アフィニティは持続します。 値 -1 は、タイムアウト期間が適用されないことを意味します。

 

このプロパティは Load_balancing_policy が LB_STICKY または LB_STICKYWILD である場合にしか適用されません。

カテゴリ: 任意

デフォルト: 0

調整:任意の時点

Cheap_probe_interval (整数)

リソースの即時障害検証の呼び出しの間隔 (秒数)。 このプロパティは、RGM のみが作成でき、RTR ファイル内で宣言されている場合には、管理者はこのプロパティを利用できます。  

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

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

カテゴリ: 条件付

デフォルト: 上記を参照

調整: 無効時

拡張プロパティ  

開発者は、クラスタ管理者がデータサービスを Sun Cluster に登録するときにデータサービスの初期構成内でリソースタイププロパティを宣言します。 拡張プロパティに設定可能な各属性については、表 A–4 を参照してください。 表 A–4を参照してください。

カテゴリ: 条件付

デフォルト: なし

調整: 特定のプロパティに依存

Failover_mode (列挙)

None、Soft、Hard のいずれかの設定が可能です。 リソースでの START または STOP メソッドの呼び出しの失敗に対して、RGM がリソースグループを再配置するか、またはノードを異常終了させるかを制御します。 None は、RGM が単にリソース状態をメソッド失敗に設定し、オペレータの介入を待つことを示します。 Soft は、START メソッドが失敗したときに、RGM がリソースのグループを別のノードに再配置し、また、STOP メソッドが失敗したときに、RGM がリソース状態を設定し、システム管理者の介入を待つことを示します。 Hard は、START メソッドが失敗したときに、グループの再配置を行い、STOP メソッドが失敗したときに、クラスタノードを異常終了させることで、リソースの強制的な停止を行うことを示します。

カテゴリ: 任意

デフォルト: なし

調整:任意の時点

Load_balancing_policy (文字列)

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

Load_balancing_policy には次の値を設定できます。

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

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

Lb_sticky_wild。 指定のクライアント (クライアントの IP アドレスで識別される) はワイルドカードスティッキサービスの IP アドレスに接続され、送信時に使用されるポート番号とは無関係に、常に同じクラスタノードに送信されます。

カテゴリ: 条件付 / 任意

デフォルト: Lb_weighted

調整: 作成時

Load_balancing_weights (文字配列)

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

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

カテゴリ: 条件付 / 任意

デフォルト: 空の文字列

調整:任意の時点

各コールバックメソッド用の method_timeout (整数)

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

カテゴリ: 条件付 / 任意

デフォルト: メソッド自体が RTR ファイルで宣言されている場合、3,600 (1 時間) です。

調整:任意の時点

Monitored_switch (列挙)

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

カテゴリ: 照会のみ

デフォルト: Enabled

調整: 不可

Network_resources_used (文字配列)

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

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

カテゴリ: 条件付 / 必須

デフォルト: なし

調整: 作成時

On_off_switch (列挙)

クラスタ管理者が管理ユーティリィティーを使用してリソースを有効または無効にすると、RGM によって Enabled または Disabled に設定されます。 無効に設定されると、再び有効に設定されるまで、リソースはコールバックを呼び出しません。

カテゴリ: 照会のみ

デフォルト: Disabled

調整:不可

Port_list (文字配列)

サーバーが待機するポート番号をコンマで区切ったリストです。 各ポート番号に、そのポートが使用しているプロトコルが追加されます (例:Port_list=80/tcp)。 Scalable プロパティが RTR ファイルで宣言されている場合、RGM は自動的に Port_list を作成します。 それ以外の場合、このプロパティは RTR ファイルで明示的に宣言されていない限り使用できません。

Apache 用にこのプロパティを設定する場合は、『Sun Cluster Data Service for Apache ガイド (Solaris OS 版)』を参照してください。

カテゴリ: 条件付 / 必須

デフォルト: なし

調整: 作成時

R_description (文字列)

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

カテゴリ: 任意

デフォルト: 空の文字列

調整:任意の時点

Resource_dependencies (文字配列)

このリソースをオンラインにするために、順にオンラインにする必要のある同じグループ内のリソースをコンマで区切ったリストです。 リスト内の任意のリソースの起動に失敗した場合、このリソースは起動されません。 グループをオフラインにすると、このリソースを停止してから、リスト内のリソースが停止されます。 このリソースが先に無効にならなければ、リスト内のリソースは無効にできません。 

カテゴリ: 任意

デフォルト: 空のリスト

調整:任意の時点

Resource_dependencies_weak (文字配列)

グループ内のメソッド呼び出しの順序を決定する同じグループ内のリソースのリスト。 RGM は、このリスト内のリソースの Start メソッドを先に呼び出してから、このリソースの Start メソッドを呼び出します。また、停止する場合は、このリソースの Stop メソッドを先に呼び出してから、リスト内のリソースの Stop メソッドを呼び出します。 リスト内のリソースが開始に失敗した場合、または無効になっても、リソースはオンラインを維持できます。 

カテゴリ: 任意

デフォルト: 空のリスト

調整:任意の時点

Resource_name (文字列)

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

カテゴリ: 必須

デフォルト: なし

調整:不可

Resource_project_name (文字列)

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

 

カテゴリ: 任意

デフォルト: 上記を参照

調整: 任意の時点

Resource_state: 各クラスターノード (列挙)

RGM が判断した各クラスタノード上のリソースの状態。 可能な状態は次のとおりです。 ONLINEOFFLINESTOP_FAILED START_FAILEDMONITOR_FAILEDONLINE_NOT_MONITORED

ユーザーは、このプロパティの設定を許可されていません。 

カテゴリ: 照会のみ

デフォルト: なし

調整:不可

Retry_count (整数)

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

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

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

カテゴリ: 条件付

デフォルト: 上記を参照

調整: 無効時

Retry_interval (整数)

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

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

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

カテゴリ: 条件付

デフォルト: 上記を参照

調整: 無効時

Scalable (ブール値)

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

このプロパティが RTR ファイルで宣言されている場合、Tunable 属性は、At_creation (作成時) に設定する必要があります。設定しなければ、リソースの生成に失敗します。

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

カテゴリ: 任意

デフォルト: 上記を参照

調整: 作成時

Status: 各クラスターノード (列挙)

リソースモニターによって設定されます。 指定可能な値は、 OKdegradedfaultedunknown、および offline です。 RGM は、リソースがオンラインになると、値を unknown に設定し、オフラインになると offline に設定します。

カテゴリ: 照会のみ

デフォルト: なし

調整:不可

Status_msg: 各クラスターノード (文字列)

リソースモニターによって、Status プロパティと同時に設定されます。 このプロパティは、各ノードのリソースごとに調整できます。 RGM は、リソースがオフラインになると、このプロパティに空の文字列を設定します。

カテゴリ: 照会のみ

デフォルト: なし

調整:不可

Thorough_probe_ interval (整数)

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

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

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

カテゴリ: 条件付

デフォルト: なし

調整: 無効時

Type (文字列)

インスタンスのリソースタイプ。 

カテゴリ: 必須

デフォルト: なし

調整:不可

Type_version (文字列)

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

RT_version は、データサービスのバージョンをアップグレードするときに使用します。

次の項目から派生: 

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

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

Udp_affinity

(ブール値) 

TRUE の場合、あるクライアントからの UDP パケットは、TCP 接続と同様の方法で、同じクラスタサーバーノードに転送されます。 クライアントの TCP 接続がサーバーノードに「スティック」されている場合、その UDP パケットもそのノードに送信されます。 FALSE の場合、この動作は保持されません。あるクライアントからの UDP パケットは、そのクライアントからの TCP 接続とは異なるクラスタサーバーノードに転送されます。 

このプロパティは Load_balancing_policy が LB_STICKY または LB_STICKYWILD である場合にしか適用されません。

カテゴリ: 任意

デフォルト: False

調整: 無効時

Weak_affinity

(ブール値) 

スティッキスケーラブルサービスに IP アフィニティを設定します。ただし、次の場合、このプロパティは中断されます。 (1) 障害モニターの再起動、リソースのフェイルオーバー、スイッチオーバーなどが原因でサーバーリスナーが再起動する場合か、あるいはフェイルオーバーのあとでノードがクラスタに再結合する場合。 (2) 管理アクションのためにスケーラブルリソースの load_balancing_weights が変更されたとき。 メモリー消費とプロセッササイクルの点で、デフォルトの形式よりもオーバーヘッドは低くなります。 アフィニティタイムアウト値は使用しません。 Weak_affinity は、上記の割り込みが発生しないかぎり持続します。

このプロパティは Load_balancing_policy が LB_STICKY または LB_STICKYWILD である場合にしか適用されません。

 

カテゴリ: 任意

デフォルト: False

調整: 無効時