この付録では、標準リソースタイプ、リソースグループ、リソースプロパティについて説明します。 また、システム定義プロパティの変更および拡張プロパティの作成に使用するリソースプロパティ属性についても説明します。
この章の内容は次のとおりです。
True や False などのプロパティ値は、大文字と小文字は区別されません。
表 A–1 に、Sun Cluster で定義されているリソースタイププロパティの内容を示します。 プロパティ値は以下のように分類されます。
必須 — Resource Type Registration (RTR) ファイル内に利用値を必要とするプロパティです。値がない場合は、プロパティが属するオブジェクトを作成できません。 空白文字または空の文字列を値として指定することはできません。
条件付 — プロパティが存在するためには、RTR ファイル内で宣言する必要があります。宣言されていない場合は、Resource Group Manager (RGM) はプロパティを作成しないため、管理ユーティリティで利用できません。 空白文字または空の文字列を値として指定できます。 プロパティが RTR ファイル内で宣言されており、値が指定されていない場合には、RGM はデフォルト値を使用します。
条件付 / 明示 — プロパティが存在するためには、 明示的に値を指定して、RTR ファイル内で宣言する必要があります。宣言されていない場合は、RGM はこのプロパティを作成しないため、管理ユーティリティで利用できません。 空白文字または空の文字列を値として指定することはできません。
任意 — プロパティは RTR ファイル内で宣言できます。宣言されていなければ、RGM がプロパティを作成し、デフォルト値を適用します。 プロパティが RTR ファイル内で宣言されており、値が指定されていない場合は、RGM は、プロパティが RTR ファイル内で宣言されないときのデフォルト値と同じ値を使用します。
リソースタイププロパティは、管理ユーティリティで更新することはできません。ただし、Installed_nodes は例外です。Installed_nodes は RTR ファイル内に宣言できないため、管理者が設定する必要があります。
表 A–1 リソースタイププロパティ
プロパティ名 |
説明 |
---|---|
API_version (整数) |
このリソース型の実装が使用するリソース管理 API のバージョンです。 カテゴリ: 任意 デフォルト: 2 調整: 不可 |
BOOT (文字列) |
任意のコールバックメソッド。 ノード上で RGM が起動するプログラムへのパス。このプログラムは、このタイプのリソースがすでに管理状態にあるときに、クラスタの結合または再結合を行います。 このメソッドは、INIT メソッドと同様に、このタイプのリソースの初期化を行う必要があります。 カテゴリ: 条件付 / 明示 デフォルト: なし 調整: 不可 |
Failover (ブール値) |
True は、複数のノード上で同時にオンラインになることのできる任意のグループで、このタイプのリソースを構成できないことを示します。 カテゴリ: 任意 デフォルト: False 調整: 不可 |
FINI (文字列) |
任意のコールバックメソッド。 RGM 管理からこのタイプのリソースを削除するときに RGM が起動するプログラムへのパス。 カテゴリ: 条件付 / 明示 デフォルト: なし 調整: 不可 |
INIT (文字列) |
任意のコールバックメソッド。 このタイプのリソースが RGM によって管理されるようになったときに、RGM が起動するプログラムへのパス。 カテゴリ: 条件付 / 明示 デフォルト: なし 調整: 不可 |
Init_nodes (列挙) |
RGM が INIT、FINI、BOOT 、VALIDATE の各メソッドを呼び出すノードを指定します。 値には、RG_primaries (リソースをマスターできるノードだけ)、または RT_installed_nodes (リソースタイプがインストールされるすべてのノード) を指定できます。 カテゴリ: 任意 デフォルト: RG_primaries 調整: 不可 |
Installed_nodes (文字配列) |
リソースタイプを実行することができるクラスタノードのリストです。 RGM は、自動的にこのプロパティを作成します。 クラスタ管理者は値を設定できます。 RTR ファイル内には宣言できません。 カテゴリ: クラスタ管理者は構成可能 デフォルト: 全てのクラスタノード 調整:任意の時点 |
Monitor_check (文字列) |
任意のコールバックメソッド。 このタイプのリソースのフォルトモニターが要求するフェイルオーバーを行う前に、RGM が起動するプログラム。 カテゴリ: 条件付 / 明示 デフォルト: なし 調整: 不可 |
Monitor_start (文字列) |
任意のコールバックメソッド。 このタイプのリソースのフォルトモニターを起動するために、RGM がアクティブにするプログラムへのパス。 カテゴリ: 条件付 / 明示 デフォルト: なし 調整:不可 |
Monitor_stop (文字列) |
Monitor_start が設定されている場合の、必須のコールバックメソッド。 このタイプのリソースのフォルトモニターを停止するために、RGM がアクティブにするプログラムへのパス。 カテゴリ: 条件付 / 明示 デフォルト: なし 調整:不可 |
各クラスタノード上の Num_resource_restart (整数)。 |
このプロパティは、RGM によって、このノード上のこのリソースに対して過去 n 秒間 (n はリソースの Retry_interval プロパティの値) に実行された scha_control RESTART 呼び出しの回数に設定されます。 リソースタイプが Retry_interval プロパティを宣言していない場合、この型のリソースは Num_resource_restarts プロパティを使用できません。 |
Pkglist (文字配列) |
リソース型のインストールに含まれている任意のパッケージリストです。 カテゴリ: 条件付 / 明示 デフォルト: なし 調整:不可 |
Postnet_stop (文字列) |
任意のコールバックメソッド。 このタイプのリソースが依存する任意のネットワークアドレスリソース (Network_resources_used) の STOP メソッドを呼び出したあとで、RGM が起動するプログラムへのパス。 このメソッドは、ネットワークインタフェースの停止設定に続いて、必要な Stop アクションを行います。 カテゴリ: 条件付 / 明示 デフォルト: なし 調整:不可 |
Prenet_start (文字列) |
任意のコールバックメソッド。 このタイプのリソースが依存する、任意のネットワークアドレスリソース (Network_resources_used) の START メソッドを呼び出す前に、 RGM が起動するプログラムへのパス。 ネットワークインタフェースが起動に構成される前に必要な Start アクションを行う必要があります。 カテゴリ: 条件付 / 明示 デフォルト: なし 調整:不可 |
RT_basedir (文字列) |
コールバックメソッドの相対パスのを補完するディレクトリパスです。 リソース型パッケージのインストール先のパスになります。 スラッシュ (/) で開始する完全なパスを指定する必要があります。 すべてのメソッドパス名が絶対パスの場合は、指定しなくてもかまいません。 カテゴリ: 必須 (絶対パスではないメソッドパスがある場合) デフォルト: なし 調整:不可 |
RT_description (文字列) |
リソースタイプの簡単な説明です。 カテゴリ: 条件付 デフォルト: 空の文字列 調整:不可 |
Resource_type (文字列) |
リソースタイプの名前。 現在登録されているリソースタイプ名を表示するには、次のコマンドを使用します。 scrgadm —p Sun Cluster 3.1 以降、リソースタイプ名は次の形式をとります。 vendor_id.resource_type:version リソースタイプ名の 3 つのコンポーネントは、Vendor_id、 Resource_type、および RT_version として RTR ファイル内で指定されています。 scrgadm コマンドはピリオドおよびコロン区切りを挿入します。 リソースタイプ名の最後の部分、RT_version には、RT_version プロパティと同じ値が入ります。 重複を防ぐため、Vendor_id には、リソース型の作成元の会社のストックシンボルを使用することをお勧めします。 Sun Cluster 3.1 以前に作成されたリソースタイプ名は次の形式をとります。 vendor_id.resource_type カテゴリ: 必須 デフォルト: 空の文字列 調整:不可 |
RT_version (文字列) |
Sun Cluster 3.1 以降、このリソースタイプの実装に必要なバージョンを指定します。 RT_version は、完全なリソースタイプ名の末尾の部分です。 カテゴリ: 条件付 / 明示 デフォルト: なし 調整:不可 |
Single_instance (ブール値) |
True の場合は、このタイプのリソースがクラスタ内に 1 つだけ存在できることを指定します。 したがって、RGM は、同時に 1 つのこのリソースタイプだけに、クラスタ全体に渡っての実行を許可します。 カテゴリ: 任意 デフォルト: False 調整:不可 |
START (文字列) |
コールバックメソッド。 このタイプのリソースを開始するために RGM がアクティブにするプログラムへのパス。 カテゴリ: 必須 (RTR ファイルで PRENET_START メソッドが宣言されていない場合) デフォルト: なし 調整:不可 |
STOP (文字列) |
コールバックメソッド。 このタイプのリソースを停止するために RGM がアクティブにするプログラムへのパス。 カテゴリ: 必須 (RTR ファイルで POSTNET_STOP メソッドが宣言されていない場合) デフォルト: なし 調整:不可 |
UPDATE (文字列) |
任意のコールバックメソッド。 実行中のこのタイプのリソースのプロパティが変更された場合に、RGM が起動するプログラムへのパス。 カテゴリ: 条件付 / 明示 デフォルト: なし 調整:不可 |
VALIDATE (文字列) |
任意のコールバックメソッド。 このタイプのリソースのプロパティ値を検査するために呼び出すプログラムへのパス。 カテゴリ: 条件付 / 明示 デフォルト: なし 調整:不可 |
Vendor_ID (文字列) |
Resource_type を参照してください。 カテゴリ: 条件付 デフォルト: なし 調整:不可 |
表 A–2 に、Sun Cluster で定義されているリソースタイププロパティの内容を示します。 この説明は、データサービスの開発者を対象としたものです。 特定のデータサービスの詳細は、そのデータサービスのマニュアルページを参照してください。 リソースプロパティ値は、以下のように分類されます。
必須 — 管理者は、管理ユーティリィティーでリソースを作成するときに、必ず値を指定する必要があります。
任意 — 管理者がリソースグループの作成時に値を指定しない場合、システムがデフォルト値を提供します。
条件付 — プロパティが RGM ファイルで宣言されている場合にのみ、RGM がプロパティを作成します。 宣言されていない場合プロパティは存在せず、システム管理者はこれを利用できません。 RTR ファイルで宣言されている条件付きのプロパティは、デフォルト値が RTR ファイル内で指定されているかどうかによって、必須または任意になります。 詳細については、各条件付きプロパティの説明を参照してください。
照会のみ— 管理ツールから直接設定できません。
表 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 が判断した各クラスタノード上のリソースの状態。 可能な状態は次のとおりです。 ONLINE、OFFLINE、STOP_FAILED、 START_FAILED、MONITOR_FAILED、ONLINE_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: 各クラスターノード (列挙) |
リソースモニターによって設定されます。 指定可能な値は、 OK、degraded、faulted、unknown、および 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 は、データサービスのバージョンをアップグレードするときに使用します。 次の項目から派生:
|
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 調整: 無効時 |
表 A–3 に、Sun Cluster で定義されているリソースグループプロパティの内容を示します。
表 A–3 リソースグループプロパティ
プロパティ名 |
説明 |
---|---|
Auto_start_on_new_cluster (ブール値) |
このプロパティは、新しいクラスタの形成時にリソースグループマネージャが自動的にリソースグループを起動するかどうかを制御します。 デフォルトは TRUE です。 TRUE に設定した場合、クラスタのすべてのノードが同時に再起動すると、リソースグループマネージャはリソースグループを自動的に起動して Desired_primaries を取得しようとします。 FALSE に設定されている場合、クラスタのすべてのノードが同時に再起動したとき、Resource Group Manager はリソースグループを自動的に起動しません。 カテゴリ: 任意 デフォルト: True 調整:任意の時点 |
Desired_ primaries (整数) |
グループが同時に実行できるノード数として望ましい値。 デフォルトは 1 です。 RG_mode プロパティが Failover の場合、このプロパティの値を 1 より大きく設定することはできません。 RG_mode プロパティが Scalable の場合は、1 より大きな値を設定できます。 カテゴリ: 任意 デフォルト: 1 (上記を参照) 調整:任意の時点 |
Failback (ブール値) |
クラスタのメンバーシップが変更されたとき、グループがオンラインになっているノードセットを再計算するかどうかを示すブール値です。 再計算によって、RGM はグループを優先度の低いノードでオフラインにし、優先度の高いノードでオンラインにします。 カテゴリ: 任意 デフォルト: False 調整: 任意の時点 |
Global_ resources_ used (文字配列) |
クラスタファイルシステムがこのリソースグループ内のリソースによって使用されるかどうかを指定します。 管理者は、すべてのグローバルリソース (アスタリスク記号 *) またはグローバルリソースなし (空の文字列 "") に指定できます。 カテゴリ: 任意 デフォルト: すべてのグローバルリソース 調整:任意の時点 |
Implicit_ network_ dependencies(ブール値) |
True の場合に、グループ内のネットワークアドレスリソースに対し、非ネットワークアドレスリソースの暗黙の強い依存性を RGM が強制することを指定するブール値。 つまり、RGM はグループ内のすべてのネットワークアドレスリソースを起動してからほかのすべてのリソースを起動し、ほかのリソースのあとにネットワークアドレスリソースを停止します。 ネットワークアドレスリソースには、論理ホスト名と共有アドレスリソース型があります。 スケーラブルなリソースグループ内では、このプロパティの影響はありません。これは、スケーラブルなリソースグループにはネットワークアドレスリソースが含まれないからです。 カテゴリ: 任意 デフォルト: True 調整: 無効時 |
Maximum_ primaries (整数) |
グループを同時にオンラインにできるノードの最大数です。 デフォルトは 1 です。 RG_mode プロパティが Failover の場合、このプロパティの値を 1 より大きく設定することはできません。 RG_mode プロパティが Scalable の場合は、1 より大きな値を設定できます。 カテゴリ: 任意 デフォルト: 1 (上記を参照) 調整:任意の時点 |
Nodelist (文字配列) |
グループを優先度順にオンラインにできるクラスタノードをコンマで区切ったリストです。 これらのノードは、リソースグループの稼動系もしくは待機系です。 カテゴリ: 任意 デフォルト: すべてのクラスタノードの順不同のリスト 調整:任意の時点 |
Pathprefix (文字列) |
クラスタファイルシステム内のディレクトリです。グループ内のリソースは、このディレクトリ内に必要な管理ファイルを書き込むことができます。 一部のリソースの必須プロパティです。 各リソースグループの Pathprefix は、一意にする必要があります。 カテゴリ: 任意 デフォルト: 空の文字列 調整:任意の時点 |
Pingpong_interval (整数) |
再構成が生じた場合、あるいは scha_control giveover コマンドまたは関数の実行結果として、どのノードでリソースグループをオンラインにするかを判断するときに RGM が使用する負以外の整数値 (秒)。 再構成において、リソースの START または PRENET_START メソッドがゼロ以外の値で終了、またはタイムアウトによって終了したことが原因で、Pingpong_interval で指定した秒数内に、リソースグループをオンラインにするのを 2 回以上失敗した場合、RGM はそのノードはリソースグループのホストとして不適切だと判断し、別のマスターを捜します。 リソースの scha_control(1HA) コマンドまたは scha_control(3HA) 機能の呼び出しによって、Pingpong_interval で指定した秒数内に特定のノード上でリソースグループがオフラインになった場合、scha_control 呼び出しの結果、そのノードはリソースグループのホストとして不適切だと判断されます。 カテゴリ: 任意 デフォルト: 3,600(1 時間) 調整:任意の時点 |
Resource_ list (文字配列) |
グループ内に含まれるリソースのリストです。 管理者はこのプロパティを直接設定しません。 このプロパティは、管理者がリソースグループにリソースを追加したり、リソースグループからリソースを削除すると、RGM により自動的に更新されます。 カテゴリ: 照会のみ デフォルト: 空のリスト 調整:不可 |
RG_ dependencies (文字配列) |
このグループが依存するリソースグループをコンマで区切ったリストです。 このリストにより、同じノード上のその他のグループをオンラインまたはオフラインにする優先度が指定されます。 別のノードでグループをオンラインにする場合は、このリストは無効です。 カテゴリ: 任意 デフォルト: 空のリスト 調整: 任意の時点 |
RG_description (文字列) |
リソースグループの簡単な説明です。 カテゴリ: 任意 デフォルト: 空の文字列 調整:任意の時点 |
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 調整:不可 |
RG_name (文字列) |
リソースグループの名前。 これは必須プロパティです。この値は、クラスタ内で一意でなければなりません。 カテゴリ: 必須 デフォルト: なし 調整:不可 |
RG_project_name |
リソースグループに関連付けられた Solaris プロジェクト名。 このプロパティは、CPU の共有、クラスタデータサービスのリソースプールといった Solaris のリソース管理機能に適用できます。 RGM は、リソースグループをオンラインにするとき、Resource_project_name プロパティセットを持たないリソースに対して、このプロジェクトで関連付けられたプロセスを起動します。 プロジェクトデータベース内に存在するプロジェクト名を指定する必要があります (SRM のマニュアルページを参照)。また、root ユーザーは、このプロジェクトのメンバーとして構成されている必要があります。 このプロパティは、Solaris 9 以降のリリースでサポートされます。 Solaris プロジェクト名の詳細は、『Solaris のシステム管理 (資源管理とネットワークサービス)』を参照してください。
カテゴリ: 任意 デフォルト: Default (上記を参照) 調整: 任意の時点 |
RG_state: 各クラスターノード (列挙) |
RGM によって Online、Offline、Pending_online、 Pending_offline、Error_stop_failed に設定され、各クラスタノード上のグループの状態を示します。 RGM の制御下にないときは、グループは管理されていない状態で存在することもできます。 ユーザーは、このプロパティの設定を許可されていません。 カテゴリ: 照会のみ デフォルト: Offline 調整:不可 |
表 A–4 に、システム定義プロパティの変更または拡張プロパティの作成に使用できるリソースプロパティの属性を示します。
boolean、enum、int タイプのデフォルト値に、NULL または空の文字列 ("") は指定できません。
プロパティ |
説明 |
---|---|
Property |
リソースプロパティの名前。 |
Extension |
リソースタイプの実装によって定義された拡張プロパティが RTR ファイルのエントリで宣言されていることを示します。 拡張プロパティが使用されていない場合、そのエントリはシステム定義プロパティです。 |
Description |
プロパティを簡潔に記述した注記 (文字列)。 RTR ファイル内でシステム定義プロパティに対する Description 属性を設定することはできません。 |
プロパティのタイプ |
指定可能なタイプは、string、boolean、int、enum、stringarray です。 RTR ファイル内で、システム定義プロパティの型の属性を設定することはできません。 タイプは、RTR ファイルのエントリに登録できる、指定可能なプロパティ値とタイプ固有の属性を決定します。 enum タイプは、文字列値のセットです。 |
Default |
プロパティのデフォルト値を示します。 |
Tunable |
クラスタ管理者がリソースのプロパティ値をいつ設定できるかを示します。 管理者にプロパティの設定を許可しない場合は、None または False に設定します。 管理者にプロパティの調整を許可する属性値は、次のとおりです。True または Anytime (任意の時点)、At_creation (リソースの作成時のみ)、When_disabled (リソースがオフラインのとき)。
デフォルトは、True (Anytime) です。 |
Enumlist |
enum タイプの場合、プロパティに設定できる文字列値のセット。 |
Min |
int タイプの場合、プロパティに設定できる最小値。 |
Max |
int タイプの場合、プロパティに設定できる最大値。 |
Minlength |
string および stringarray タイプの場合、設定できる文字列の最小長。 |
Maxlength |
string および stringarray タイプの場合、設定できる文字列の最大。 |
Array_minsize |
stringarray タイプの場合、設定できる配列要素の最小数。 |
Array_maxsize |
stringarray タイプの場合、設定できる配列要素の最大数。 |