資源タイプのプロパティー

次の情報は、Sun Cluster ソフトウェアによる定義されたリソースタイププロパティーを示します。

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

• 必須。プロパティーはリソースタイプ登録 (Resource Type Registration、RTR) ファイルに明示的な値を必要とします。そうでない場合、プロパティーが属するオブジェクトは作成できません。空白文字または空の文字列を値として指定することはできません。

• 条件付き。RTR ファイル内に宣言を必要とするプロパティーです。宣言がない場合、RGM はこのプロパティーを作成しません。したがって、このプロパティーを管理ユーティリティーから利用することはできません。空白文字または空の文字列を値として指定できます。プロパティーが RTR ファイル内で宣言されており、値が指定されていない場合には、RGM はデフォルト値を使用します。

• 条件付/明示。RTR ファイル内に宣言と明示的な値を必要とするプロパティーです。宣言がない場合、RGM はこのプロパティーを作成しません。したがって、このプロパティーを管理ユーティリティーから利用することはできません。空白文字または空の文字列を値として指定することはできません。

• 任意。RTR ファイル内に宣言できるプロパティーです。プロパティーが RTR ファイル内で宣言されていない場合は、RGM がこれを作成し、デフォルト値を与えます。プロパティーが RTR ファイル内で宣言されており、値が指定されていない場合は、RGM は、プロパティーが RTR ファイル内で宣言されないときのデフォルト値と同じ値を使用します。

• 照会のみ– 管理ツールから直接設定できません。

Installed_nodes と RT_system 以外のリソースタイププロパティーは、管理ユーティリティーで更新を行うことはできません。また、Installed_nodes は RTR ファイル内に宣言できないため、クラスタ管理者のみが設定できます。RT_system には RTR ファイル内で初期値を割り当てることができ、またクラスタ管理者が設定することもできます。

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

API_version や Boot などのリソースタイププロパティー名では、大文字と小文字が区別されません。プロパティー名を指定する際には、大文字と小文字を任意に組み合わせることができます。

API_version (integer)

このリソースタイプの実装のサポートに必要なリソース管理 API の最小バージョン。

次に、Sun Cluster の各リリースがサポートする API_version の最大値を要約します。

3.1 以前

2

3.1 10/03

3

3.1 4/04

4

3.1 9/04

5

3.1 8/05

6

3.2

7

3.2 2/08

8

3.2

9

RTR ファイルにおいて API_version に 2 より大きな値を宣言した場合、そのリソースタイプは、宣言した値より小さな最大バージョンしかサポートしないバージョンの Sun Cluster にはインストールされません。たとえば、あるリソースタイプに API_version=7 を宣言すると、このリソースタイプは、3.2 より前にリリースされた Sun Cluster のバージョンにはインストールされません。

---

注 –

このプロパティーを宣言しないか、このプロパティーをデフォルト値 (2) に設定すると、データサービスは Sun Cluster 3.0 以降の Sun Cluster の任意のバージョンにインストールできます。

---

カテゴリ:

任意

デフォルト:

2

調整:

NONE

Boot (string)

Boot メソッドプログラムのパスを指定する任意のコールバックメソッド。RGM は、クラスタを結合または再結合するノード上で、このタイプの各管理対象リソースに対して Boot メソッドを実行します。

Boot、Init、Fini、または Validate メソッドが実行されるノードセットは、リソースタイプの Init_nodes プロパティーの設定によって決まります。Init_nodes プロパティーは、リソースタイプの Installed_nodes プロパティーで指定されているノードを示す RG_PRIMARIES に設定することができます。

カテゴリ:

条件付/明示

デフォルト:

デフォルトなし

調整:

NONE

Failover (boolean)

このプロパティーを TRUE に設定した場合、このタイプのリソースは、複数のノードで同時にオンラインになる可能性があるどのグループ内でも構成できません。

このリソースタイプのプロパティーは、次のように Scalable リソースのプロパティーと一緒に使用します。

Failover リソースタイプの値	Scalable リソースの値	説明
TRUE	TRUE	この非論理的な組み合わせは指定しないでください。
TRUE	FALSE	この組み合わせは、フェイルオーバーサービスに対して指定します。
FALSE	TRUE	この組み合わせは、ネットワーク負荷分散に SharedAddress リソースを使用するスケーラブルサービスに指定します。 SharedAddress については、『Sun Cluster の概念 (Solaris OS 版) 』を参照してください。 スケーラブルリソースは、グローバルクラスタ非投票ノードで動作するように構成できます。ただし、同じ Solaris ホストの複数のグローバルクラスタ非投票ノードで動作するようにスケーラブルリソースを構成しないでください。
FALSE	FALSE	この組み合わせは、ネットワーク負荷分散を使用しない複数マスターサービスを選択 する場合に使用します。  このタイプのスケーラブルサービスはゾーン内で使用可能です。

詳細は、r_properties(5)のマニュアルページにある Scalable の説明、および『Sun Cluster の概念 (Solaris OS 版)』の第 3 章「重要な概念 - システム管理者とアプリケーション開発者」を参照してください。

カテゴリ:

任意

デフォルト:

FALSE

調整:

NONE

Fini (string)

Fini メソッドプログラムのパスを指定する任意のコールバックメソッド。RGM は、このタイプのリソースが RGM の管理対象外になったときに Fini メソッドを実行します。

Fini メソッドは、通常、Init メソッドにより実行された初期化を元に戻します。

Boot、Init、 Fini、または Validate メソッドが実行されるノードセットは、リソースタイプの Init_nodes プロパティーの設定によって決まります。Init_nodes プロパティーは、リソースタイプの Installed_nodes プロパティーで指定されているノードを示す RG_PRIMARIES に設定することができます。

RGM は、次の状態が発生した場合、リソースが管理されなくなったノード上で Fini を実行します。

• リソースを含むリソースグループが管理対象外状態に切り替わる。この場合、RGM はノードリストのすべてのノード上で Fini メソッドを実行します。

• 管理されているリソースグループからリソースが削除される。この場合、RGM はノードリストのすべてのノード上で Fini メソッドを実行します。

• リソースを含むリソースグループのノードリストからノードが削除されます。この場合、RGM は削除されたノード上でのみ Fini メソッドを実行します。

「ノードリスト」はリソースグループの Nodelist またはリソースタイプの Installed_nodes リストのいずれかです。「ノードリスト」がリソースグループの Nodelist とリソースタイプの Installed_nodes リストのどちらを指すかは、リソースタイプの Init_nodes プロパティーの設定に依存します。Init_nodes プロパティーは RG_primaries または RT_installed_nodes に設定できます。大部分のリソースタイプでは、Init_nodes はデフォルトである RG_primaries に設定されます。この場合、Init メソッドと Fini メソッドは両方とも、リソースグループの Nodelist で指定されているノード上で実行されます。

Init メソッドが実行する初期化の種類は、次のように、ユーザーが実装した Fini メソッドが実行する必要があるクリーンアップの種類を定義します。

• ノード固有の構成のクリーンアップ。

• クラスタ全体の構成のクリーンアップ。

カテゴリ:

条件付/明示

デフォルト:

デフォルトなし

調整:

NONE

Global_zone (ブール型 )

RTR ファイルで宣言されている場合、このリソースタイプのメソッドが大域ゾーン (つまり、ゾーンクラスタノードまたはグローバルクラスタ非投票ノードのいずれか) で実行されるかどうかを示すブール値。このプロパティーに TRUE が設定されている場合、リソースを含むリソースグループが非大域ゾーンで動作しているときでも、メソッドは大域ゾーンで実行されます。このプロパティーに TRUE を設定するのは、ネットワークアドレスやファイルシステムなど、大域ゾーンから管理できるサービスに対してだけです。

---

注意 –

信頼できる既知のソースであるリソースタイプを除いて、Global_zone プロパティーに TRUE が設定されているリソースタイプは登録しないでください。このプロパティーに TRUE を設定したリソースタイプは、ゾーン分離をすり抜け、危険があります。

---

カテゴリ:

任意

デフォルト:

FALSE

調整:

ANYTIME

Init (string)

Init メソッドプログラムのパスを指定する任意のコールバックメソッド。RGM は、このタイプのリソースが RGM の管理対象になったときに Init メソッドを実行します。

Boot、Init、 Fini、または Validate メソッドが実行されるノードセットは、リソースタイプの Init_nodes プロパティーの設定によって決まります。Init_nodes プロパティーは、リソースタイプの Installed_nodes プロパティーで指定されているノードを示す RG_PRIMARIES に設定することができます。

カテゴリ:

条件付/明示

デフォルト:

デフォルトなし

調整:

NONE

Init_nodes (enum)

RGM が Init、Fini、Boot、Validate の各メソッドをコールするノードを示します。指定できる値は、リソースをマスターできるノードのみを指定する RG_PRIMARIES、またはこのリソースタイプがインストールされるすべてのノードを指定する RT_INSTALLED_NODES のいずれかです。

カテゴリ:

任意

デフォルト:

RG_PRIMARIES

調整:

NONE

Installed_nodes (string_array)

リソースタイプを実行できるクラスタノードの名前のリスト。すべてのクラスタノードを明示的に含めるには、アスタリスク (*) を指定します。これがデフォルトです。

カテゴリ:

このプロパティはクラスタ管理者が構成できます。

デフォルト:

すべてのクラスタノード

調整:

ANYTIME

Is_logical_hostname (boolean)

TRUEは、このリソースタイプが、フェイルオーバーインターネットプロトコル (Internet Protocol、IP) アドレスを管理するLogicalHostname リソースタイプのいずれかのバージョンであることを示します。

カテゴリ:

照会のみ

デフォルト:

デフォルトなし

調整:

NONE

Is_shared_address (boolean)

TRUE は、このリソースタイプが、共有インターネットプロトコル (Internet Protocol、IP) アドレスを管理する共有アドレスリソースタイプのいずれかのバージョンであることを示します。

カテゴリ:

照会のみ

デフォルト:

デフォルトなし

調整:

NONE

Monitor_check (string)

任意のコールバックメソッド。障害モニターの要求によってこのリソースタイプのフェイルオーバーを実行する前に、RGM によって実行されるプログラムのパスです。ノードに対するモニターチェックプログラムがゼロ以外の値で終了した場合、GIVEOVER タグ付きで scha_control を呼び出した結果としてそのノードにフェイルオーバーしようとしても実行できません。

カテゴリ:

条件付/明示

デフォルト:

デフォルトなし

調整:

NONE

Monitor_start (string)

任意のコールバックメソッド。この型のリソースの障害モニターを起動するために RGM によって実行されるプログラムのパスです。

カテゴリ:

条件付/明示

デフォルト:

デフォルトなし

調整:

NONE

Monitor_stop (string)

Monitor_start が設定されている場合、必須のコールバックメソッドになります。この型のリソースの障害モニターを停止するために RGM によって実行されるプログラムのパスです。

カテゴリ:

条件付/明示

デフォルト:

デフォルトなし

調整:

NONE

Pkglist (string_array)

リソースタイプのインストールに含まれている任意のパッケージリストです。

カテゴリ:

条件付/明示

デフォルト:

デフォルトなし

調整:

NONE

Postnet_stop (string)

任意のコールバックメソッド。この型のリソースがネットワークアドレスリソースに依存している場合、このネットワークアドレスリソースのStopメソッドの呼び出し後に RGM によって実行されるプログラムのパスです。ネットワークインタフェースが停止するように構成されたあと、このメソッドは Stop アクションを実行する必要があります。

カテゴリ:

条件付/明示

デフォルト:

デフォルトなし

調整:

NONE

Prenet_start (string)

任意のコールバックメソッド。この型のリソースがネットワークアドレスリソースに依存している場合、このネットワークアドレスリソースの Start メソッドの呼び出し前に RGM によって実行されるプログラムのパスです。このメソッドは、ネットワークインタフェースが構成される前に必要な Start アクションを行います。

カテゴリ:

条件付/明示

デフォルト:

デフォルトなし

調整:

NONE

Proxy (ブール型)

このタイプのリソースがプロキシリソースかどうかを示すブール値です。

「プロキシリソース」は、リソースの状態を Oracle Cluster Ready Services (CRS) などの別のクラスタフレームワークからインポートする Sun Cluster リソースです。Oracle クラスタウェア CRS として現在知られている Oracle CRS は、クラスタ環境向けのプラットフォームに依存しないシステムサービスセットです。

プロキシリソースタイプは、Prenet_start メソッドを使用して、外部のプロキシリソースの状態を監視するデーモンを起動します。Postnet_stop メソッドは、この監視デーモンを停止します。この監視デーモンは、CHANGE_STATE_ONLINE または CHANGE_STATE_OFFLINE タグとともに scha_control コマンドを実行し、プロキシリソースの状態をそれぞれ Online または Offline に設定します。scha_control() 関数も同じように SCHA_CHANGE_STATE_ONLINE および SCHA_CHANGE_STATE_OFFLINE タグを使用します。詳細は、scha_control(1HA) と scha_control(3HA)のマニュアルページを参照してください。

TRUE に設定されている場合、リソースはプロキシリソースです。

カテゴリ:

任意

デフォルト:

FALSE

調整:

NEVER

Resource_list (string_array)

リソースタイプの全リソースのリストです。クラスタ管理者はこのプロパティーを直接設定しません。ただし、クラスタ管理者がこの型のリソースをリソースグループに追加したり、リソースグループから削除した場合、RGM はこのプロパティーを更新します。

カテゴリ:

照会のみ

デフォルト:

空のリスト

調整:

NONE

Resource_type (文字配列型)

リソース型の名前です。現在登録されているリソースタイプ名を表示するには、次のコマンドを使用します。

resourcetype show +

Sun Cluster 3.1 および Sun Cluster 3.2 では、リソースタイプ名にバージョンが含まれます (必須)。

vendor-id.resource-type:rt-version

リソースタイプ名は RTR ファイル内に指定された 3 つのプロパティー vendor-id、resource-type 、rt-version で構成されます。resourcetype コマンドは、ピリオド (.) とコロン (:) の区切り文字を挿入します。リソースタイプの名前の最後の部分、rt-version には、RT_version プロパティーと同じ値が入ります。vendor_id が一意であることを保証するためには、リソース型を作成した会社の株式の略号を使用します。Sun Cluster 3.1 以前に登録されたリソースタイプ名では、引き続き次の構文を使用します。

vendor-id.resource-type

カテゴリ:

必要

デフォルト:

空の文字列

調整:

NONE

RT_basedir (string)

コールバックメソッドの相対パスのを補完するディレクトリパスです。このパスは、リソースタイプパッケージのインストールディレクトリに設定する必要があります。このパスには、スラッシュ (/) で開始する完全なパスを指定する必要があります。

カテゴリ:

必須 (絶対パスでないメソッドパスがある場合)

デフォルト:

デフォルトなし

調整:

NONE

RT_description (string)

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

カテゴリ:

条件付き

デフォルト:

空の文字列

調整:

NONE

RT_system (ブール型)

リソースタイプの RT_system プロパティーが TRUE の場合、そのリソースタイプは削除できません (resourcetype unregister resource-type-name) . このプロパティーは、LogicalHostname など、クラスタのインフラをサポートするリソースタイプを間違って削除してしまうことを防ぎます。しかし、RT_system プロパティーはどのリソース型にも適用できます。

RT_system プロパティーが TRUE に設定されたリソース型を削除するには、まず、このプロパティーを FALSE に設定する必要があります。クラスタサービスをサポートするリソースを持つリソース型を削除するときには注意してください。

カテゴリ:

任意

デフォルト:

FALSE

調整:

ANYTIME

RT_version (文字配列型)

Sun Cluster 3.1 リリース以降では、このリソースタイプの実装を特定する必須バージョン文字列。Sun Cluster 3.0 ではこのプロパティーは任意でした。RT_version は完全なリソースタイプ名のサフィックスコンポーネントです。

カテゴリ:

条件付き/明示または必須

デフォルト:

デフォルトなし

調整:

NONE

Single_instance (boolean)

TRUE は、この型のリソースがクラスタ内に 1 つだけ存在できることを示します。

カテゴリ:

任意

デフォルト:

FALSE

調整:

NONE

Start (文字配列型)

コールバックメソッド。この型のリソースを起動するために RGM によって実行されるプログラムのパスです。

カテゴリ:

RTR ファイルで Prenet_start メソッドが宣言されていないかぎり必須

デフォルト:

デフォルトなし

調整:

NONE

Stop (文字配列型)

コールバックメソッド。この型のリソースを停止するために RGM によって実行されるプログラムのパスです。

カテゴリ:

RTR ファイルで Postnet_stop メソッドが宣言されていないかぎり必須

デフォルト:

デフォルトなし

調整:

NONE

Update (文字配列型)

任意のコールバックメソッド。この型の実行中のリソースのプロパティーが変更されたときに、RGM によって実行されるプログラムのパスです。

カテゴリ:

条件付/明示

デフォルト:

デフォルトなし

調整:

NONE

Validate (文字配列型)

Validate メソッドプログラムのパスを指定する任意のコールバックメソッド。RGM は、このタイプのリソースのプロパティーの値を確認するために Validate メソッドを実行します。

Boot、Init、 Fini、または Validate メソッドが実行されるノードセットは、リソースタイプの Init_nodes プロパティーの設定によって決まります。Init_nodes プロパティーは、リソースタイプの Installed_nodes プロパティーで指定されているノードを示す RG_PRIMARIES に設定することができます。

カテゴリ:

条件付/明示

デフォルト:

デフォルトなし

調整:

NONE

Vendor_ID (文字配列型)

Resource_type を参照してください。

カテゴリ:

条件付き

デフォルト:

デフォルトなし

調整:

NONE