Red Hat Training

A Red Hat training course is available for Red Hat Enterprise Linux

20.12. イベントの設定

ドメイン XML の以下のセクションを使用すると、さまざまなイベントで実行されるデフォルトのアクションを上書きできます。

図20.18 イベントの設定


  <on_poweroff>destroy</on_poweroff>
  <on_reboot>restart</on_reboot>
  <on_crash>restart</on_crash>
  <on_lockfailure>poweroff</on_lockfailure>
以下の要素のコレクションでは、ゲスト仮想マシンの OS が、ライフサイクル操作をトリガーする場合にアクションを指定できます。一般的な使用例は、OS の初期インストールを行うときに、再起動を強制的に電源オフとして扱うことです。これにより、仮想マシンをインストール後の初回起動時に再設定できます。
ドメイン XML のこのセクションのコンポーネントは以下のとおりです。

表20.10 イベント設定要素

状態説明
<on_poweroff>ゲスト仮想マシンがパワーオフを要求した場合に実行するアクションを指定します。使用可能な引数は、以下の 4 つです。
  • destroy - この操作によりドメインが完全に終了し、すべてのリソースが解放されます。
  • restart - この操作によりドメインが完全に終了し、同じ設定で再起動します。
  • preserve - この操作によりドメインは完全に終了しますが、リソースは保持されるため、今後の解析に使用できます。
  • rename-restart - この操作によりドメインが完全に終了し、続いて新しい名前で再起動します。
<on_reboot>ゲスト仮想マシンが再起動を要求した場合に実行するアクションを指定します。使用可能な引数は、以下の 4 つです。
  • destroy - この操作によりドメインが完全に終了し、すべてのリソースが解放されます。
  • restart - この操作によりドメインが完全に終了し、同じ設定で再起動します。
  • preserve - この操作によりドメインは完全に終了しますが、リソースは保持されるため、今後の解析に使用できます。
  • rename-restart - この操作によりドメインが完全に終了し、続いて新しい名前で再起動します。
<on_crash>ゲスト仮想マシンがクラッシュした場合に実行するアクションを指定します。さらに、以下の追加アクションに対応します。
  • coredump-destroy - クラッシュしたドメインのコアがダンプされ、ドメインが完全に終了し、すべてのリソースが解放されます。
  • coredump-restart - クラッシュしたドメインのコアがダンプされ、同じ設定でドメインが再起動します。
使用可能な引数は、以下の 4 つです。
  • destroy - この操作によりドメインが完全に終了し、すべてのリソースが解放されます。
  • restart - この操作によりドメインが完全に終了し、同じ設定で再起動します。
  • preserve - この操作によりドメインは完全に終了しますが、リソースは保持されるため、今後の解析に使用できます。
  • rename-restart - この操作によりドメインが完全に終了し、続いて新しい名前で再起動します。
<on_lockfailure>ロックマネージャーがリソースロックを失ったときに実行するアクションを指定します。以下のアクションは、libvirt によって認識されますが、すべてが個々のロックマネージャーによってサポートされる必要はありません。アクションを指定しないと、各ロックマネージャーはデフォルトのアクションを実行します。以下の引数を使用できます。
  • poweroff - ドメインの電源を強制的に切断します。
  • restart - ドメインを再起動して、ロックを再取得します。
  • pause - ロックの問題が解決したときに手動で再開できるように、ドメインを一時停止します。
  • ignore - 何も起こらなかったかのようにドメインを実行し続けます。