test

Sun Cluster データサービス開発ガイド (Solaris OS 版)

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

以下に、Sun Cluster ソフトウェアによって定義されるリソースタイププロパティーを示します。

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

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

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

注 –

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

カテゴリ:

任意

デフォルト:

2

調整:

NONE

Boot (string)

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

カテゴリ:

条件付きまたは明示

デフォルト:

デフォルトなし

調整:

NONE

Failover (boolean)

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

次の表は、このリソースタイププロパティーを Scalable リソースプロパティーと併用する方法を示しています。

Failover リソースタイプの値

Scalable リソースの値

説明 

TRUE

TRUE

この非論理的な組み合わせは指定しないでください。 

TRUE

FALSE

この組み合わせは、フェイルオーバーサービスに対して指定します。 

FALSE

TRUE

この組み合わせは、ネットワーク負荷分散に SharedAddress リソースを使用するスケーラブルサービスに指定します。

SharedAddress の詳細は、『Sun Cluster の概念 (Solaris OS 版)』を参照してください。

FALSE

FALSE

この組み合わせは一般的ではありませんが、ネットワーク負荷均衡を使用しないマルチマスターサービスを選択するときに使用できます。 

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

カテゴリ:

任意

デフォルト:

FALSE

調整:

NONE

Fini (string)

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

通常、Fini メソッドは Init メソッドによって実行された初期化をすべて取り消します。

RGM は、次の条件が成り立つときに、リソースが管理されなくなった各ノードまたはゾーン上で Fini を実行します。

  • リソースのあるリソースグループが管理されない状態に切り替わる。この場合、RGM はノードリスト内のすべてのノードおよびゾーン上で Fini メソッドを実行します。

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

  • ノードまたはゾーンが、リソースのあるリソースグループのノードリストから削除される。この場合、RGM は削除されたノードおよびゾーン上だけで Fini メソッドを実行します。

「ノードリスト」とは、リソースグループの Nodelist またはリソースタイプの Installed_nodes リストのことです。「ノードリスト」がリソースグループの Nodelist を指すのかリソースタイプの Installed_nodes リストを指すのかは、リソースタイプの Init_nodes プロパティーの設定によって決まります。Init_nodes プロパティーは RG_nodelist または RT_installed_nodes に設定できます。ほとんどのリソースタイプでは、Init_nodes がデフォルトの RG_nodelist に設定されています。この場合は、Init メソッドも Fini メソッドも、リソースグループの Nodelist で指定されたノードまたはゾーン上で実行されます。

Init メソッドが実行する初期化のタイプによって、実装する Fini メソッドが実行する必要のあるクリーンアップのタイプが次のように定義されます。

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

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

カテゴリ:

条件付きまたは明示

デフォルト:

デフォルトなし

調整:

NONE

Global_zone (boolean)

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

注意 – 注意 –

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

カテゴリ:

任意

デフォルト:

FALSE

調整:

ANYTIME

Init (string)

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

カテゴリ:

条件付きまたは明示

デフォルト:

デフォルトなし

調整:

NONE

Init_nodes (enum)

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

カテゴリ:

任意

デフォルト:

RG_PRIMARIES

調整:

NONE

Installed_nodes (string_array)

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

カテゴリ:

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

デフォルト:

すべてのクラスタノードまたはゾーン

調整:

ANYTIME

Is_logical_hostname (boolean

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

カテゴリ:

照会のみ

デフォルト:

デフォルトなし

調整:

NONE

Is_shared_address (boolean)

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

カテゴリ:

照会のみ

デフォルト:

デフォルトなし

調整:

NONE

Monitor_check (string)

任意のコールバックメソッド。障害モニターの要求によってこのリソース型のフェイルオーバーを行う前に、RGM によって実行されるプログラムのパスです。ノードまたはゾーン上でモニター検査プログラムが 0 以外で終了した場合は、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 (boolean)

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

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

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

カテゴリ:

任意

デフォルト:

FALSE

調整:

ANYTIME

Resource_list (string_array)

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

カテゴリ:

照会のみ

デフォルト:

空のリスト

調整:

NONE

Resource_type (string)

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

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 (boolean)

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

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

カテゴリ:

任意

デフォルト:

FALSE

調整:

ANYTIME

RT_version (string)

Sun Cluster 3.1 以降のリリースでは、このリソースタイプの実装の必須バージョン文字列。このプロパティーは Sun Cluster 3.0 ではオプションでした。RT_version は完全なリソースタイプ名の接尾辞コンポーネントです。

カテゴリ:

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

デフォルト:

デフォルトなし

調整:

NONE

Single_instance (boolean)

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

カテゴリ:

任意

デフォルト:

FALSE

調整:

NONE

Start (string)

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

カテゴリ:

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

デフォルト:

デフォルトなし

調整:

NONE

Stop (string)

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

カテゴリ:

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

デフォルト:

デフォルトなし

調整:

NONE

Update (string)

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

カテゴリ:

条件付きまたは明示

デフォルト:

デフォルトなし

調整:

NONE

Validate (string)

任意のコールバックメソッド。この型のリソースのプロパティー値を検査するために RGM が実行するプログラムのパスです。

カテゴリ:

条件付きまたは明示

デフォルト:

デフォルトなし

調整:

NONE

Vendor_ID (string)

Resource_type を参照してください。

カテゴリ:

条件付き

デフォルト:

デフォルトなし

調整:

NONE