変更されたリソースタイプに提供すべき文書

『Sun Cluster データサービスの計画と管理 (Solaris OS 版)』の「リソースタイプの更新」では、クラスタ管理者に対するリソースタイプのアップグレード方法が説明されています。変更されるリソースタイプをクラスタ管理者がアップグレードできるようにするには、上記の手順に、この節で説明する追加情報を補足します。

通常、新しいリソースタイプを作成する場合、次の内容を含む文書を提供する必要があります。

• 追加、変更、または削除するプロパティーを説明する

• プロパティーを新しい要件に準拠させる方法を説明する

• リソースに対する Tunable 属性の制約を記載する

• 新しいデフォルトプロパティー属性を述べる

• 必要に応じて、既存のリソースプロパティーを適切な値に設定できることをクラスタ管理者に通知する

アップグレードのインストール前に実行すべき事柄に関する情報

次のように、ノード上でのアップグレードパッケージのインストール前に実行すべき事柄を、クラスタ管理者に説明します。

• アップグレードパッケージが既存のメソッドを上書きする場合、非クラスタモードでノードを再起動するようクラスタ管理者に指示します。

• アップグレードパッケージはモニターコードのみを更新し、メソッドコードを変更しない場合は、ノードをクラスタモードで実行し続けるようクラスタ管理者に通知します。また、すべてのリソースタイプの監視をオフにするようクラスタ管理者に通知します。

• アップグレードパッケージは RTR ファイルのみを更新し、モニターコードを変更しない場合は、ノードをクラスタモードで実行し続けるようクラスタ管理者に通知します。また、すべてのリソースタイプの監視をオンのままにするようクラスタ管理者に通知します。

リソースをアップグレードする時点に関する情報

リソースを新しいバージョンのリソースタイプにアップグレードできる時点をクラスタ管理者に説明します。

クラスタ管理者がリソースタイプをアップグレードできる条件は、次に示すように、RTR ファイル内のリソースの各バージョンの #$upgrade_from ディレクティブの Tunable 属性に依存します。

• いつでもよい (ANYTIME)

• リソースが監視されてない場合のみ (WHEN_UNMONITORED)

• リソースがオフラインである場合のみ (WHEN_OFFLINE)

• リソースが無効である場合のみ (WHEN_DISABLED)

• リソースグループが管理されていない場合のみ (WHEN_UNMANAGED )

例 4–2 クラスタ管理者がアップグレードできる時点を #$upgrade_from が定義する方法

次の例では、#$upgrade_from ディレクティブの Tunable 属性が、クラスタ管理者がリソースを新しいバージョンのリソースタイプにアップグレードできる条件にどのように影響するかを示します。

#$upgrade_from   "1.1"   WHEN_OFFLINE
#$upgrade_from   "1.2"   WHEN_OFFLINE
#$upgrade_from   "1.3"   WHEN_OFFLINE
#$upgrade_from   "2.0"   WHEN_UNMONITORED
#$upgrade_from   "2.1"   ANYTIME
#$upgrade_from   ""      WHEN_UNMANAGED

リソースプロパティーに対する変更に関する情報

クラスタ管理者がアップグレードを行う時点で、クラスタ管理者による既存のリソースのプロパティーの変更を要求するリソースタイプに対して行われたすべての変更を説明します。

可能な変更には次のものが含まれます。

• 変更された既存のリソースタイププロパティーのデフォルト設定

• 導入されたリソースタイプの新しい拡張プロパティー

• 取り消されたリソースタイプの既存のプロパティー

• リソースタイプに対して宣言された標準プロパティーのセットに対する変更

• 変更されたリソースプロパティー (min、max、arraymin、arraymax、 default、tunability など) の属性

• 宣言されたメソッドのセットに対する変更

• 変更されたメソッドまたは障害モニターの実装