第3章 Cmdline リソース設定時の注意点

本章で説明する注意点は、Solaris/Linux 共通です。

ISV アプリケーションや利用者アプリケーションを userApplication の状態に連動して起動／停止したり、逆にアプリケーションの停止に連動して userApplication を状態遷移させたりする場合には、利用者がスクリプトを作成する必要があります。
作成したスクリプトは、Cmdline リソースに設定し、そのリソースを userApplication に設定します。
ここでは、スクリプトの例と、スクリプト作成時の注意事項を説明します。

Cmdline に設定できるスクリプトの種類は以下の 3 種類です。

Start スクリプト

userApplication が Online または Standby に状態遷移する場合に起動されます。
利用者プログラムを起動するためのスクリプトです。
Stop スクリプト

userApplication が Offline に状態遷移する場合に起動されます。
利用者プログラムを停止するためのスクリプトです。
Check スクリプト

Start/Stop スクリプトにより起動/停止されるリソース（利用者プログラム）の状態を監視するために使用します。RMS 起動後、定周期 (*) に起動されます。Check スクリプトは、利用者プログラムの状態を報告するためのスクリプトです。

(*) Check スクリプト処理時間（Check スクリプト起動から復帰までの時間）が約 0.25 秒以内の場合は、約 10 秒間隔で起動されます。Check スクリプト処理時間が約 0.25 秒を超える場合は、最大約 20 秒間隔で起動されます。

なお、Start スクリプト、Stop スクリプトはそれぞれ、Online スクリプト、Offline スクリプトと呼ぶこともあります。

Cmdline リソースに設定できる属性を、表 3.1 に示します。

[表3.1 Cmdlineリソースの属性]

属性	概要
NULLDETECTOR	userApplicationのOnline/Offline処理に連動して、CmdlimeリソースのOnline/Offlineスクリプトを実行するだけです。CmdlineリソースのOnline/Offlineスクリプトの処理が成功した後の監視は行われません。また、他のFlagの値はすべて"No"に設定されます。デフォルト値は "No" です。
ALLEXITCODES	"No" に設定すると、Check スクリプトの終了コードは以下のように解釈されます。 0　　： Online 0 以外： Offline "Yes" に設定すると、Check スクリプトの終了コードの値により、以下のように解釈されます。 0 ： online 1 ： offline 2 ： faulted 3 ： unknown 4 ： standby 5 ： onlinewarning 6 ： offlinefaulted デフォルト値は "No" です。 ※ 3, 5, 6 および上記以外の値は、特殊な状態を示すものであり、スクリプト内の復帰値として使用しないでください。 PRIMECLUSTER 対応製品の指示がある場合に限り使用してください。
CLUSTEREXCLUSIVE	"Yes" に設定した場合には、クラスタ内で 1 度に 1つのノード上だけでリソースが Online でなければなりません。Check スクリプトの問題などにより 2つ以上のノードで同時に Online 状態であることを検出すると、このリソースが属する userApplication の状態は Inconsistent となります。デフォルト値は "No" です。 "Yes" を設定することを推奨します。
AUTORECOVER	"Yes" に設定すると、リソースが故障した場合、userApplication をフェイルオーバさせる前に同じノード上で再起動を試みます。この試みは 1 度だけ行われます。デフォルト値は "No" です。
MONITORONLY	リソースが faulted となった場合に userApplication を faulted にするかどうかを制御します。"Yes" に設定すると、リソースが faulted になった場合でも、それをトリガに userApplication は faulted にはなりません。 GUI から作成できる Cmdline では、この値を "Yes" に設定することが許されていません。この値を "Yes" に設定すると RMS が起動しなくなるため、本属性は、"No" のまま使用してください。デフォルト値は "No" です。
STANDBYCAPABLE	"Yes" に設定すると、RMS はこのリソースのために StandbyCapable 属性を "1" に設定します。属性に関する詳しい情報については、"付録 A RMS 属性一覧"を参照してください。デフォルト値は "No" です。
REALTIME	"No" に設定すると、Check スクリプトが TS クラスで開始されます。 "Yes" に設定すると、Check スクリプトは、RT クラスで開始されます。 RT クラスで開始されたプロセスは、OS で最高の優先度が割り当てられるため、スクリプトやコマンドのバグが、システムの性能に大きな影響を与えるかもしれないことに注意してください。デフォルト値は "No" です。
TIMEOUT	プログラムの開始と停止のためのタイムアウト時間（秒）を設定します。デフォルト値は "300" です。

PRIMECLUSTER 対応製品の指示がない場合は、Cmdline リソースの ReturnCodes を変更しないでください。

3.1 スクリプトと状態遷移
3.2 スクリプト作成時の注意事項
3.3 スクリプトの留意事項について

目次索引