リソースタイププロパティ

この節では、Sun Cluster で定義されているリソースタイププロパティについて説明します。プロパティ値は、次のように分類されます (「カテゴリ」の後)。

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

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

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

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

リソースタイププロパティは管理ユーティリティで更新できません。ただし、Installed_nodes と RT_system は RTR ファイル内で宣言できないため、管理者が設定する必要があります。

最初にプロパティ名が表示され、次に説明が表示されます。

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

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

カテゴリ:

オプション

初期値:

2

調整:

いいえ

Boot (string)

任意のコールバックメソッド。RGM がノード上で呼び出すプログラムのパスを指定します。このプログラムは、このリソース型が管理対象になっているとき、クラスタの結合または再結合を行います。このメソッドは、Init メソッドと同様に、このタイプのリソースに対し、初期化アクションを行う必要があります。

カテゴリ:

条件付き / 明示

初期値:

なし

調整:

いいえ

Failover (boolean)

TRUE の場合、複数のノード上で同時にオンラインにできるグループ内にこの型のリソースを構成することはできません。

カテゴリ:

オプション

初期値:

FALSE

調整:

いいえ

Fini (string)

任意のコールバックメソッド。この型のリソースを RGM 管理の対象外にするとき RGM によって呼び出されるプログラムのパスです。

カテゴリ:

条件付き / 明示

初期値:

なし

調整:

いいえ

Init (string)

任意のコールバックメソッド。この型のリソースを RGM 管理対象にするとき RGM によって呼び出されるプログラムのパスです。

カテゴリ:

条件付き / 明示

初期値:

なし

調整:

いいえ

Init_nodes (enum)

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

カテゴリ:

オプション

初期値:

RG_primaries

調整:

いいえ

Installed_nodes (string_array )

リソースタイプの実行が許可されるクラスタノード名のリスト。このプロパティは RGM によって自動的に作成されます。クラスタ管理者は値を設定できます。RTR ファイル内には宣言できません。

カテゴリ:

クラスタ管理者による構成が可能です。

初期値:

すべてのクラスタノード

調整:

Yes

Is_logical_hostname (boolean

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

カテゴリ:

照会のみ

初期値:

デフォルトなし

調整:

いいえ

Is_shared_address (boolean )

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

カテゴリ:

照会のみ

初期値:

デフォルトなし

調整:

いいえ

Monitor_check (string)

任意のコールバックメソッド。障害モニターの要求によってこのリソース型のフェイルオーバーを実行する前に、RGM によって呼び出されるプログラムのパスです。

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Monitor_start (string)

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

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Monitor_stop (string)

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

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Pkglist (string_array)

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

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Postnet_stop (string)

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

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Prenet_start (string)

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

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Resource_type (string)

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

scrgadm -p

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

vendor_id.resource_type:version

リソース型の名前は、 RTR ファイル内に指定された 3 つのプロパティ Vendor_id、Resource_type 、RT_version で構成されます。scrgadm コマンドは、ピリオド (.) とコロン (:) の区切り文字を挿入します。リソースタイプ名の最後の部分、RT_version には、RT_version プロパティと同じ値が入ります。重複を防ぐため、Vendor_id には、リソースタイプの作成元の会社のストックシンボルを使用することをお勧めします。Sun Cluster 3.1 以前に作成されたリソースタイプ名では、引き続き次の構文を使用します。

vendor_id.resource_type

カテゴリ:

必須

初期値:

空の文字列

調整:

いいえ

RT_basedir (string)

コールバックメソッドの相対パスのを補完するディレクトリパスです。このパスは、リソースタイプパッケージのインストール場所に設定します。スラッシュ (/) で開始する完全なパスを指定する必要があります。すべてのメソッドパス名が絶対パスの場合は、指定しなくてもかまいません。

カテゴリ:

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

初期値:

デフォルトなし

調整:

いいえ

RT_description (string)

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

カテゴリ:

条件付き

初期値:

空の文字列

調整:

いいえ

RT_system (boolean)

あるリソースタイプの RT_system が TRUE に設定されているときに、そのリソースタイプでは、許可されている scrgadm(1M) 操作が制限されることを示します。RT_system が TRUE に設定されているリソースタイプのことを「システムリソースタイプ」と呼びます。RT_system の現在の値に関わらず、 RT_system プロパティ自身を編集することは制限されません。

カテゴリ:

オプション

初期値:

FALSE

調整:

Yes

RT_version (string)

Sun Cluster 3.1 以降では、このリソースタイプの実装の必須バージョン文字列。RT_version は、完全なリソースタイプ名の末尾の部分です。RT_version プロパティは Sun Cluster 3.0 では任意でしたが、Sun Cluster 3.1 以降のリリースでは必須です。

カテゴリ:

任意/明示または必須

初期値:

デフォルトなし

調整:

いいえ

Single_instance (boolean)

TRUE は、この型のリソースがクラスタ内に 1 つだけ存在できることを示します。つまり、この型のリソースが実行されるのは、クラスタ全体で 1 箇所だけです。

カテゴリ:

オプション

初期値:

FALSE

調整:

いいえ

Start (string)

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

カテゴリ:

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

初期値:

デフォルトなし

調整:

いいえ

Stop (string)

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

カテゴリ:

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

初期値:

デフォルトなし

調整:

いいえ

Update (string)

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

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Validate (string)

任意のコールバックメソッド。この型のリソースのプロパティ値を検査するために呼び出されるプログラムのパスです。

カテゴリ:

条件付き / 明示

初期値:

デフォルトなし

調整:

いいえ

Vendor_ID (string)

Resource_type を参照してください。

カテゴリ:

条件付き

初期値:

デフォルトなし

調整:

いいえ