rules コマンド

目的

デバイス設定規則を管理し、 Virtual I/O Server (VIOS) にデプロイします。

構文

規則 -o 操作 [ -l deviceInstanceName | -t クラス／サブクラス／タイプ ][ -a 属性=値 ] [-d] [-n] [-s] [ -f RulesFile ] [-F] [-h]

説明

rules コマンドは、 VIOS 規則の取り込み、デプロイ、変更、比較、および表示に使用されます。 AIX® ランタイム・エキスパート・ソリューション (ARTEX) テクノロジーを活用します。 VIOS には、 VIOS のベスト・プラクティスとして推奨される VIOS デバイス構成の重要な規則を含む、事前定義されたデフォルト規則が用意されています。 rules コマンドを使用して、 VIOS上のデバイス設定規則を管理できます。

パラメーター

パラメーター名	説明
-o 操作	収集 VIOS上の現行システム構成をキャプチャーします。現行規則が存在する場合、新たにキャプチャーされたシステム構成によって既存の構成が上書きされます。存在しない場合、現行システム設定をキャプチャーするために出荷時のデフォルト規則がテンプレートとして使用されます。
	導入推奨される出荷時のデフォルト規則をベスト・プラクティスとして適用するか、現行規則を VIOSに適用します。このパラメーターは新規設定をデバイス・タイプに実装するだけでなく、デバイス・インスタンスに対する変更も行います。現行規則が存在しない場合、このパラメーターは現行システム設定に基づいて規則ファイルを新規作成します。さらに、規則を変更して再実装するように指示します。新規設定はシステムのリブートが行われるまで有効になりません。
	IMPORT ユーザー指定の規則ファイルを VIOS 現行規則にインポートします。マージ操作の実行中に現行規則ファイル内に同じ規則が存在する場合、ユーザー指定のものが最重要規則として優先されます。既存の現行規則ファイルがない場合、デフォルト規則に基づいて現行規則ファイルが作成されます。ルールまたはデバイスが AIX ARTEX カタログでサポートされていない場合、インポート操作は失敗し、無効なルールを削除して再試行するように通知されます。変更後の値が ODM 内の現行のデフォルトより低い値である場合、ユーザーの注意を促す警告が表示されます。ただし、インポート操作はそのまま続行し、完了できます。規則の互換性を制御するために、デフォルトでは、`ioslevel` 規則が現行規則およびユーザー指定規則と比較されます。ユーザー指定の `ioslevel` が現行規則より下位であるか、または存在しない場合、操作は停止します。検査を行わずにインポート操作を強制的に続行するには、-F フラグを使用する必要があります。
	list 規則テンプレートに基づいて、規則ファイルの内容またはシステム構成をリストおよび表示します。出力の最初の列は以下のとおりです。`class/subclass/type`2 番目は`attribute`3 番目は`value`.
	diff - 2 つのファイルを比較し、違いを表示する -n フラグを指定すると、不一致のデバイスと属性がリストされ、差異が数値で定量化されます。
	追加デバイス・インスタンス名またはデバイス固有タイプに基づいて、 VIOS 現行規則またはユーザー指定規則ファイルに新規規則を追加します。その規則が既に存在する場合は、エラーが返されます。ただし、デバイス・インスタンスまたはデバイス・タイプは、既存の AIX ARTEX カタログでサポートされている必要があります。このパラメーターがないと、コマンドは失敗します。注: コマンド `rules -o add -l hdisk0 -a reserve_policy=no_reserve` は、 hdisk0 専用ではなく、disk/fcp/mpioosdisk 用の規則を追加するために使用されます。これは、 ODM 情報がない場合に `rules -o add -t class/subclass/type -a reserve_policy=no_reserve` と比較すると、より簡単で便利なバージョン呼び出しです。
	変更デバイス・タイプまたはデバイス・インスタンスに基づいて、現行規則またはユーザー指定規則のファイル内の規則を変更できます。変更しようとしている規則が存在しない場合、規則を変更しようとするのではなく、規則を追加するように求めるエラー・メッセージが表示されます。注: デバイス・インスタンスおよびタイプの使用法については、 add 操作の注を参照してください。
	削除現行規則またはユーザー指定規則のファイルから規則を削除します。削除しなければならない規則が存在しない場合、エラー・メッセージが表示されます。現行規則またはユーザー指定規則のファイルから、デフォルト規則に含まれる規則を削除することはできません。注: デバイス・インスタンスおよびタイプの使用法については、 add 操作の注を参照してください。
-l deviceInstanceName	ODM 内のデバイス・タイプ (class/subclass/type) を検索する場合に、デバイス・インスタンス名を使用できます。これにより、ODM 情報に関する知識がなくても、新規規則を作成できます。 -l フラグは -t フラグと同時に指定できません。
-t クラス/サブクラス/タイプ	タグを使用して、デバイス・クラス、サブクラス、およびデバイスのタイプを指定できます。 -t フラグは -l フラグと同時に指定できません。
-a Attribute=Value	デバイス・タイプでは属性と値がペアで設定されます。このパラメーターは、特定の属性における規則の追加または規則の変更で必要になります。
-d	システムのデフォルト規則を設定します。
-n	`rules -o diff` コマンドと一緒に使用すると、相違の数が表示されます。
-s	`rules -o diff` コマンドと一緒に使用すると、現在のシステム設定が表示され、リストされます。
-f rulesFile	ユーザー指定規則ファイルに使用されます。
-F	`rules -o import` コマンドと一緒に使用すると、致命的でないエラーが検出された場合でもインポート操作が強制的に続行されます。
-h	使用法を表示します。

終了状況

このコマンドは、以下の終了値を戻します。

戻りコード	説明
0	正常終了。
>0	エラーが発生しました。

ファイル

アイテム	説明
/usr/sbin/rules	rules コマンドが入っています。

セキュリティー

rules コマンドは RBAC によってサポートされており、padmin および root のユーザーがアクセスできます。

例

新規規則を追加するには、次のコマンドを入力します。
```
rules -o add -t disk/vscsi/cvdisk -a queue_depth=8
```
インスタンスが hdisk0 であるデバイス・タイプに関して reserve_policy 規則を現行規則に追加するには、次のコマンドを入力します。
```
rules -o add -l hdisk0 -a reserve_policy=no_reserve
```
デバイス・タイプ disk/fcp/mpioosdisk に関して serve_policy 規則を現行規則に追加するには、次のコマンドを入力します。
```
rules -o add -t disk/fcp/mpioosdisk -a reserve_policy=no_reserve
```
インスタンスが hdisk0 であるデバイス・タイプに関して service_policy 規則をユーザー指定規則ファイルに追加するには、次のコマンドを入力します。
```
rules -o add -l hdisk0 -a reserve_policy=no_reserve -f/tmp/rules.xml
```
規則を削除するには、次のコマンドを入力します。
```
rules -o delete -t disk/vscsi/cvdisk -a queue_depth
```
disk/fcp/mpioapdisk デバイス・タイプに関して reserve_policy を現行規則から削除するには、次のコマンドを入力します。
```
rules -o delete -t disk/fcp/mpioapdisk -a reserve_policy
```
hdisk0 デバイス・タイプに関して reserve_policy を現行規則から削除するには、次のコマンドを入力します。
```
rules -o delete -l hdisk0 -a reserve_policy
```
hdisk0 デバイス・タイプに関して reserve_policy を /tmp/rules.xml 規則ファイルから削除するには、次のコマンドを入力します。
```
rules -o delete -l hdisk0 -a  reserve_policy -f /tmp/rules.xml
```
既存の規則を変更するには、次のコマンドを入力します。
```
rules -o modify -t adapter/pciex/df1000fe -a num_cmd_elems=2048
```
disk/fcp/mpioapdisk デバイス・タイプに関して reserve_policy 規則を現行規則ファイルから削除するには、次のコマンドを入力します。
```
rules -o modify -t disk/fcp/mpioapdisk -a reserve_policy=no_reserve
```
hdisk0 デバイス・タイプに関して現行規則ファイルの reserve_policy 規則を変更するには、次のコマンドを入力します。
```
rules -o modify -l hdisk0 -a reserve_policy=no_reserve
```
hdisk0 デバイス・タイプに関して /tmp/rules.xml 規則ファイルの reserve_policy 規則を変更するには、次のコマンドを入力します。
```
rules -o modify -l hdisk0 -a reserve_policy=no_reserve -f /tmp/rules.xml
```
デフォルト規則をリストして表示するには、次のコマンドを入力します。
```
rules -o list -d
```
現行規則をリストして表示するには、次のコマンドを入力します。
```
rules -o list
```
現行システム設定をリストして表示するには、次のコマンドを入力します。
```
rules -o list -s
```
ユーザー指定ファイルの規則内容をリストして表示するには、次のコマンドを入力します。
```
rules -o list -f user_rules.xml
```
VIOS システム設定と現行規則の間の不一致デバイスおよび属性をリストするには、次のコマンドを入力します。
```
rules -o diff -s
```
VIOS システム設定とデフォルト規則の間の不一致デバイスおよび属性をリストするには、次のコマンドを入力します。
```
rules -o diff -s -d
```
現行規則と出荷時のデフォルト規則の間で一致していないデバイスと属性をリストするには、次のコマンドを入力します。
```
rules -o diff -d
```
現行規則と user_rules.xml ファイルの間で一致していないデバイスと属性をリストするには、次のコマンドを入力します。
```
rules -o diff -f user_rules.xml
```
2 つの規則ファイル間で一致していないデバイスと属性をリストするには、次のコマンドを入力します。
```
rules -o diff -f rules1.xml rules2.xml
```
2 つのファイル間で一致していない数を確認するには、次のコマンドを入力します。
```
rules -o diff -n -f rules1.xml rules2.xml
```

システム内の規則をリストするには、次のコマンドを入力します。

rules -o list -s

システムは次の出力を表示します。

disk/fcp/mpioosdisk            reserve_policy       no_reserve
disk/fcp/mpioapdisk            reserve_policy       single_path
disk/fcp/nonmpiodisk           reserve_policy       no_reserve
disk/fcp/aixmpiods8k           reserve_policy       no_reserve
disk/sas/mpioapdisk            reserve_policy       no_reserve
disk/sas/mpioosdisk            reserve_policy       no_reserve
disk/sas/scsd                  reserve_policy       no_reserve
disk/sas/sisarray              reserve_policy       no_reserve
disk/vscsi/cvdisk              reserve_policy       no_reserve

VIOS 現行システム設定を取り込み、それを現行規則ファイルに保管するには、次のコマンドを入力します。
```
rules -o capture
      
```
VIOS 推奨デフォルト規則をデプロイするには、次のコマンドを入力します。
```
rules -o deploy -d
```
VIOS 現行規則をデプロイするには、次のコマンドを入力します。
```
rules -o deploy
```
ユーザー指定の規則ファイルを現行規則にインポートするには、次のコマンドを入力します。
```
rules -o import -f user_rules.xml
```
ファイル user_rules.xml に含まれているユーザー指定の規則を現行規則にインポートし、ioslevel が非互換でも無視するには、次のコマンドを入力します。
```
rules -o import -f user_rulex.xml -F
```
rules コマンドの使用法を表示するには、次のコマンドを入力します。
```
rules -h
```