A.7. カスタムプロパティーの定義
Red Hat Virtualization Manager によって受け入れられ (次にカスタムフックに渡される) カスタムプロパティーは、engine-config
コマンドを使用して定義されます。このコマンドは、Red Hat Virtualization Manager がインストールされているホストで root ユーザーとして実行します。
UserDefinedVMProperties
および CustomDeviceProperties
設定キーは、サポートされているカスタムプロパティーの名前を格納するために使用されます。名前付きの各カスタムプロパティーの有効な値を定義する正規表現も、これらの設定キーに含まれています。
複数のカスタムプロパティーはセミコロンで区切られます。設定キーを設定すると、そこに含まれている既存の値が上書きされることに注意してください。新規および既存のカスタムプロパティーを組み合わせる場合は、キーの値を設定するために使用されるコマンドのすべてのカスタムプロパティーを含める必要があります。
設定キーが更新されたら、新しい値を有効にするために ovirt-engine サービスを再起動する必要があります。
例A.1 仮想マシンのプロパティー - smartcard
カスタムプロパティーの定義
次のコマンドを使用して、
UserDefinedVMProperties
設定キーによって定義された既存のカスタムプロパティーを確認します。# engine-config -g UserDefinedVMProperties
以下の出力が示すように、カスタムプロパティー
memory
が既に定義されています。正規表現^[0-9]+$
は、カスタムプロパティーに数字のみが含まれるようにします。# engine-config -g UserDefinedVMProperties UserDefinedVMProperties: version: 3.6 UserDefinedVMProperties: version: 4.0 UserDefinedVMProperties : memory=^[0-9]+$ version: 4.0
memory
カスタムプロパティーはUserDefinedVMProperties
設定キーですでに定義されているため、新しいカスタムプロパティーを追加する必要があります。追加のカスタムプロパティーであるsmartcard
が、設定キーの値に追加されます。新しいカスタムプロパティーは、true
またはfalse
の値を保持できます。# engine-config -s UserDefinedVMProperties='memory=^[0-9]+$;smartcard=^(true|false)$' --cver=4.0
UserDefinedVMProperties
設定キーで定義されたカスタムプロパティーが正しく更新されていることを確認します。# engine-config -g UserDefinedVMProperties UserDefinedVMProperties: version: 3.6 UserDefinedVMProperties: version: 4.0 UserDefinedVMProperties : memory=^[0-9]+$;smartcard=^(true|false)$ version: 4.0
最後に、設定の変更を有効にするには、ovirt-engine サービスを再起動する必要があります。
# systemctl restart ovirt-engine.service
例A.2 デバイスプロパティー - interface
カスタムプロパティーの定義
次のコマンドを使用して、
CustomDeviceProperties
設定キーで定義されている既存のカスタムプロパティーを確認します。# engine-config -g CustomDeviceProperties
以下の出力に示されるように、カスタムプロパティーはまだ定義されていません。
# engine-config -g CustomDeviceProperties CustomDeviceProperties: version: 3.6 CustomDeviceProperties: version: 4.0
interface
カスタムプロパティーはまだ存在しないため、そのまま追加できます。この例では、speed
サブプロパティーの値は 0 ~ 99999 の範囲に設定され、duplex
サブプロパティーの値はfull
またはhalf
のいずれかの選択に設定されます。# engine-config -s CustomDeviceProperties="{type=interface;prop={speed=^([0-9]{1,5})$;duplex=^(full|half)$}}" --cver=4.0
CustomDeviceProperties
設定キーで定義されたカスタムプロパティーが正しく更新されていることを確認します。# engine-config -g CustomDeviceProperties UserDefinedVMProperties: version: 3.6 UserDefinedVMProperties: version: 4.0 UserDefinedVMProperties : {type=interface;prop={speed=^([0-9]{1,5})$;duplex=^(full|half)$}} version: 4.0
最後に、設定の変更を有効にするには、ovirt-engine サービスを再起動する必要があります。
# systemctl restart ovirt-engine.service