表 A-2 に、Sun Cluster によって定義されているリソースプロパティを示します。プロパティ値は、以下のように分類されます (分類の列)。
必須 - 管理者は、管理ユーティリィティでリソースを作成するときに、必ず値を指定する必要があります。
任意 - 管理者がリソースグループの作成時に値を指定しない場合、システムがデフォルト値を提供します。
条件付 - プロパティが RTR ファイルで宣言されている場合にのみ、RGM がプロパティを作成します。宣言されていない場合は、プロパティは存在せず、システム管理者はこれを利用できません。RTR ファイルで宣言されている条件付のプロパティは、デフォルト値が RTR ファイル内で指定されているかどうかによって、必須または任意になります。詳細は、各条件付プロパティの説明を参照してください。
照会のみ - 管理ツールから直接設定できません。
表 A-2 は、リソースプロパティが更新可能かどうか、また、いつ更新できるかも示しています。
None または False |
更新不可 |
True または Anytime |
任意の時点 |
At_creation |
リソースをクラスタに追加するとき |
When_disabled |
リソースを無効にするとき |
表 A-2 リソースプロパティ
プロパティ名 |
説明 |
更新 |
分類 |
---|---|---|---|
Cheap_probe_ interval (整数) |
リソースの即時障害検証の呼び出しの間隔 (秒数)。このプロパティは、RGM のみが作成でき、RTR ファイル内で宣言されている場合は、管理者は利用できます。 デフォルト値が RTR ファイル内で指定されている場合は、このプロパティは任意です。リソースタイプファイル内で、Tunable 属性が指定されていない場合は、プロパティの Tunable 値は、When_disabled (無効にするとき) になります。 Default 属性が RTR ファイル内のプロパティ宣言で指定されていない場合は、このプロパティは必須です。 |
無効にするとき |
条件付 |
拡張プロパティ |
そのリソースのタイプの RTR ファイルで宣言される拡張プロパティ。リソースタイプの実装によって、これらのプロパティを定義します。拡張プロパティに設定可能な各属性については、表 A-4 を参照してください。 |
特定のプロパティに依存 |
条件付 |
Failover_mode (列挙) |
リソースでの START または STOP メソッドの呼び出しの失敗に対して、RGM がリソースグループを再配置するか、またはノードを異常終了させるかを制御します。None は、RGM が単にリソース状態をメソッド失敗に設定し、システム管理者の介入を待つことを示します。 Soft は、START メソッドが失敗したときに、RGM がリソースのグループを別のノードに再配置し、また、STOP メソッドが失敗したときに、RGM がリソース状態を設定し、システム管理者の介入を待つことを示します。 Hard は、START メソッドが失敗したときに、グループの再配置を行い、STOP メソッドが失敗したときに、クラスタノードを異常終了させることで、リソースの強制的な停止を行うことを示します。
デフォルトは、None です。 |
任意の時点 |
任意 |
Load_balancing_ policy (文字列) |
使用する負荷均衡ポリシーを定義する文字列。このプロパティは、スケーラブルサービスに対してのみ使用します。Scalable プロパティが RTR ファイルで宣言されている場合は、RGM は自動的にこのプロパティを作成します。 Load_balancing_policy は、次の値をとることができます。 Lb_weighted (デフォルト) ― Load_balancing_weights プロパティで設定されているウエイトに従って、さまざまなノードに負荷が分散されます。
Lb_sticky ― スケーラブルサービスの指定のクライアント (クライアントの IP アドレスで識別される) は、常に同じクラスタノードに送信されます。
Lb_sticky_wild ― 指定のクライアント (クライアントの IP アドレスで識別される) はワイルドカードスティッキーサービスの IP アドレスに接続され、送信時に使用されるポート番号とは無関係に、常に同じクラスタノードに送信されます。
デフォルト値は、Lb_weighted です。 |
作成時 |
条件付/任意 |
Load_balancing_ weights (文字配列) |
このプロパティは、スケーラブルサービスに対してのみ使用します。Scalable プロパティが RTR ファイルで宣言されている場合は、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 (文字配列) |
リソースが使用する論理ホスト名または共有アドレスネットワークリソースのリスト。スケーラブルサービスの場合、このプロパティは別のリソースグループに存在する共有アドレスリソースを参照する必要があります。フェイルオーバーサービスの場合、このプロパティは同じリソースグループに存在する論理ホスト名または共有アドレスを参照します。Scalable プロパティが RTR ファイルで宣言されている場合、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 用にこのプロパティを設定する場合は、このマニュアルの Apache に関する章を参照してください。 |
作成時 |
条件付/必須 |
R_description (文字列) |
リソースの簡単な説明。
デフォルトは、空の文字列です。 |
任意の時点 |
任意 |
Resource_ dependencies (文字配列) |
このリソースをオンラインにするために、順にオンラインにする必要のある同じグループ内のリソースのリスト。リスト内の任意のリソースの起動に失敗した場合、このリソースは起動されません。グループをオフラインにすると、このリソースを停止してから、リスト内のリソースが停止されます。このリソースが先に無効にならなければ、リスト内のリソースは無効にできません。
デフォルトは、空のリストです。 |
任意の時点 |
任意 |
Resource_ dependencies_ weak (文字配列) |
グループ内のメソッド呼び出しの順序を決定する同じグループ内のリソースのリスト。RGM は、このリスト内のリソースの START メソッドを先に呼び出してから、このリソースの START メソッドを呼び出します。また、停止する場合は、このリソースの STOP メソッドを先に呼び出してから、リスト内のリソースの STOP メソッドを呼び出します。リスト内のリソースが開始に失敗した場合、または無効になっても、リソースはオンラインを維持できます。
デフォルトは、空のリストです。 |
任意の時点 |
任意 |
Resource_name (文字列) |
リソースインスタンスの名前。クラスタ構成内で一意にする必要があります。リソースが作成された後で変更はできません。 |
不可 |
必須 |
各クラスタノードの Resource_state (列挙) |
RGM が判断した各クラスタノード上のリソースの状態。可能な状態は次のとおりです。 Online、Offline、Stop_failed、Start_failed、Monitor_failed、Online_not_monitored、Detached。
このプロパティは、ユーザーが構成することはできません。 |
不可 |
照会のみ |
Retry_count (整数) |
リソースの起動に失敗した場合に、モニターが再起動を試みる試行回数。このプロパティは、RGM のみが作成でき、RTR ファイルで宣言されている場合は、管理者は利用できます。デフォルト値が RTR ファイルで指定されている場合は、このプロパティは任意です。
リソースタイプファイル内で Tunable 属性が指定されていない場合は、プロパティの Tunable 値は、When_disabled (無効化にするとき) になります。 Default 属性が RTR ファイルのプロパティ宣言に指定されていない場合は、このプロパティは必須です。 |
無効にする |
条件付 |
Retry_interval (整数) |
失敗したリソースを再起動する回数をカウントする間隔 (秒)。リソースモニターは、Retry_count と共にこのプロパティを使用します。このプロパティは、RGM のみが作成でき、RTR ファイルで宣言されている場合は、管理者は利用できます。デフォルト値が RTR ファイルで指定されている場合は、このプロパティは任意です。
リソースタイプファイル内で Tunable 属性が指定されていない場合は、プロパティの Tunable 値は、When_disabled (無効化にするとき) になります。 Default 属性が RTR ファイルのプロパティ宣言に指定されていない場合は、このプロパティは必須です。 |
無効にする |
条件付 |
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 (列挙) |
リソースモニターによって設定されます。指定可能な値は、 degraded、faulted、unknown、 offline です。 RGM は、リソースがオンラインになると、値を unknown に設定し、オフラインになると offline に設定します。 |
不可 |
照会のみ |
各クラスタノードの Status_msg (文字列) |
リソースモニターによって、Status プロパティと同時に設定されます。このプロパティは、各ノードのリソースごとに設定可能です。RGM は、リソースがオフラインになると、このプロパティに空の文字列を設定します。 |
不可 |
照会のみ |
Thorough_probe_ interval (整数) |
高オーバーヘッドのリソース障害検証の呼び出し間隔 (秒)。このプロパティは、RGM のみが作成でき、RTR ファイルで宣言されている場合は、管理者は利用できます。デフォルト値が RTR ファイルで指定されている場合は、このプロパティは任意です。
リソースタイプファイル内で Tunable 属性が指定されていない場合は、プロパティの Tunable 値は、When_disabled (無効化にするとき) になります。 Default 属性が RTR ファイルのプロパティ宣言に指定されていない場合は、このプロパティは必須です。 |
無効にする |
条件付 |
Type (文字列) |
このリソースがインスタントであるリソースタイプ。 |
不可 |
必須 |