mkequ

名前

mkequ - リソース同値を作成します。

概要

mkequ [-h] -f data_input_file [-T] [-V]

mkequ [-h] [-p A[,NoFailure | NoControl] | O[,Failback | NoFailure | NoControl]] [-m Minimum_necessary] [-T] [-V] -S "Static_select_string" Equivalency Resource_class

mkequ [-h] [-p A[,NoFailure | NoControl]] [-m Minimum_necessary] [-T] [-V] -D "Dynamic_select_string" Equivalency Resource_class

mkequ [-h] [-p A[,NoFailure | NoControl] | O[,Failback | NoFailure | NoControl]] [-m Minimum_necessary] [-T] [-V] Equivalency Resource_class:Resource_name[:Node] [,Resource_name[:ノード] [, ...]]

説明

mkequ コマンドは、指定されたリソース間でリソース同値を作成します。すべてのリソースは、同じリソース・クラスでなければなりません。

同値とその属性フラグは、構文が示すようにコマンド行で指定することも、 -f オプションが指定されている場合はファイルから指定することもできます。値は、このリソース属性について定義したものと同じデータ・タイプでなければなりません。 lsrsrcdef コマンドを使用して、各属性のデータ・タイプと属性フィールドを確認します。

選択文字列なしのリソース名の明示的指定は、IPv6 が有効な IBM.NetworkInterface 同値メンバーではサポートされません。

Options

-D "dynamic_select_string"

動的選択文字列。指定された選択文字列は、関連する同値の SelectString 属性として保管されます。この selection_string は、リカバリー・マネージャーによって指定されたリソース・クラスのすべてのリソースに適用され、指定された同値にどのメンバーを含めるかが動的に決定されます。このオプションを Resource_name [:Node] パラメーターと組み合わせることはできません。選択文字列は、二重引用符または単一引用符で囲む必要があります。選択文字列に二重引用符が含まれる場合は、選択文字列全体を単一引用符で囲みます。以下に例を示します。

-D 'Name == "testing"'

-D 'Name ?= "test"'

-D オプションを -S オプションまたは ORDERED SelectFromポリシー (-p O) と組み合わせることはできません。

-f データ-input_file

同値の属性情報を含むファイルの名前を指定します。

-h

標準出力にコマンドの使用法ステートメントを書き込みます。

-p A | O [,Failback | NoFailure | NoControl]

同値の選択ポリシーを指定します。以下の値を使用します。

A: Any。これはデフォルト値です。
O: Ordered。この値を -D オプションと一緒に使用することはできません。

オプション (コンマで区切られた) 値:

ANY: メンバー選択に特定の順序はありません。これはデフォルト値です。これが唯一のオプションである場合は、表示されません。
ORDERED: 開始時に、メンバー選択が開始されることを意味します。
Failback: リソースは常に、先頭のメンバーのリソースから開始されます (使用可能な場合)。 ORDERED との組み合わせでのみ使用されます。
NoFailure: NoFailure: 同値に対する依存関係があるリソースの OpState は、指定されたタイムアウト・インターバル内で開始できない場合に、強制的に「Failed Offline」にはなりません。
NoControl: System Automation は、同値のメンバーを開始または停止しませんが、これらのリソースの OpState の変更に対してのみ反応します。

-S "static_select_string"

静的選択文字列。指定された選択文字列は、指定されたリソース・クラスに適用され、同値を構成するリソースが決定されます。これらのリソースは、同値の MemberShip 属性として保存されます。このオプションを Resource_name [:Node] パラメーターと組み合わせることはできません。選択文字列は、二重引用符または単一引用符で囲む必要があります。選択文字列に二重引用符が含まれる場合は、選択文字列全体を単一引用符で囲みます。以下に例を示します。

-S 'Name == "testing"'

-S 'Name ?= "test"'

-S は、-D と組み合わせることはできません。

-m 最小-必要

必要最小数の同値。同値を有効にするための必要最小数のメンバーを指定します。デフォルト値は 1 です。

-T

標準エラー出力にコマンドのトレース・メッセージを書き込みます。ソフトウェア・サービス会社においてのみ使用します。

-V

標準エラーにコマンドの詳細メッセージを書き込みます。

パラメーター

同値

作成する新規同値の固有の名前を指定します。同値の名前にドル記号 ($) を含めることはできません。

Resource_class:Resource_name[:Node]

同値のメンバーにする 1 つ以上のリソースを指定します。すべてのリソースは、同じリソース・クラスでなければなりません。同値リソースは、リソース名 (Resource_name)、およびオプションで、リソースが存在するノード (Node) を示します。

リソース名には、ドル記号 ($) を含めることはできません。 Resource_name と Node は、コロンで区切られている必要があります。複数のリソースを指定でき、これらはコンマで区切ります。 Resource_class は、同値リソースが属するリソース・クラスの名前です。最初のリソースまたは Resource_name[:Node] の前にリソースが属する Resource_class を記述し、これをコロン (:) 区切り文字で区切る必要があります。

すべてのリソースが同じクラスでなければならないため、構文に示されたように Resource_class は 1 回のみ指定します。

この構文は、IPv6 が有効な IBM.NetworkInterface 同値メンバーではサポートされません。選択文字列の構文を使用してください。

終了状況

0: コマンドは正常に実行されました。
1: RMC でエラーが発生しました。
2: CLI スクリプトでエラーが発生しました。
3: コマンド行に不正なフラグがあります。
4: コマンド行に不正なパラメーターがあります。
5: RMC で誤ったコマンド行入力に基づくエラーが発生しました。
6: 指定されたリソースが見つかりません。
7: このリソースは既に存在しています。

Security

このコマンドを実行するには、root 権限、または適切なアクセス権を持つユーザー ID が必要です。詳しくは、コマンド・ライン・インターフェースの非 root ユーザー ID のセットアップを参照してください。

例

同値を作成するには、データ入力ファイルを使用します。
1. ファイルでこれらのリソースを定義するのに役立つテンプレートを生成するには、以下のように入力します。
```
lsrsrcdef -i IBM.Equivalency >& /tmp/Equ.rdef
```
2. 任意のテキスト・エディターを使用して、ファイル /tmp/Equ.rdef を編集します (タイプの適切な値を代入してすべての属性値を入力するか、デフォルト値が適切な場合はブランクのままにします)。
3. 以下のように、ファイルを使用して mkequ コマンドを実行します。
```
mkequ -f /tmp/Equ.rdef
```
mkequ のサンプル・データ入力ファイル:

すべての属性の値を入力して以下に示す値を変更するか、デフォルト値が適切な場合はその属性が含まれる行を除去できます。
```
PersistentResourceAttributes::
resource 1:
 Name = "Equiv"
 MemberClass = "IBM.NetworkInterface"
 Membership = "{'eth0:node-name','eth0:node-name'}"
resource 2: 
 Name = "Equiv2"
 MemberClass = "IBM.Application"
 Membership = "{'App1:node-name','App2:node-name','App3:node-name'}"
 SelectFromPolicy = "Any" 
 MinimumNecessary = 2 
resource 3: 
 Name = "Equiv3" 
 MemberClass = "IBM.Test" 
 SelectString = "Name ?='Test'" 
 SelectFromPolicy = "Any" 
 MinimumNecessary = 1
```
リソース・クラス IBM.Application のすべてのメンバーを使用して、resA という同値を作成するには、以下のように入力します。
```
mkequ -S 'Name like "%"' resA IBM.Application
```
リソース・クラス IBM.Application の選択されたメンバー testerA、testerB、および testerC を使用して resA という同値を作成し、そのポリシーを「ordered」に設定するには、以下のように入力します。
```
mkequ -p O resA IBM.Application:testerA:node-name,testerB:node-name,testerC:node-name
```
同値を作成するためのすべてのリソースは固定である必要があるため、ノード名を指定する必要があります。
静的選択文字列を使用して選択されたリソース・クラス IBM.Application のメンバーを使用し、testerB という同値を作成するには、以下のように入力します。
```
mkequ -S "ResourceType==0" testerB IBM.Application 
```
動的選択文字列を使用して選択されたリソース・クラス IBM.Application のメンバーを使用し、Jfoo という同値を作成するには、以下のように入力します。
```
mkequ -D "ResourceType==0" Jfoo IBM.Application
```
リソース・クラス IBM.NetworkInterface のノード node1 および node2 から選択したメンバー eth0 で netequ という名前の同値を作成し、そのポリシーを Ordered および Failback に設定するには、次のように入力します。
```
mkequ -p O,Failback netequ IBM.NetworkInterface:eth0:node1,eth0:node2 
```

ファイル

/usr/sbin/rsct/bin/mkequ: mkequ コマンドの場所。
data_input_file: 例および Resource_Data_Input ファイルのマニュアル・ページを参照してください。