Red Hat Summit Red Hat SummitSupportKonsoleEntwicklerDemo startenKontakt

Dieser Inhalt ist in der von Ihnen ausgewählten Sprache nicht verfügbar.

23.13. Events Configuration

Using the following sections of domain XML it is possible to override the default actions for various events: 
  <on_poweroff>destroy</on_poweroff>
  <on_reboot>restart</on_reboot>
  <on_crash>restart</on_crash>
  <on_lockfailure>poweroff</on_lockfailure>
Copy to Clipboard Toggle word wrap

Figure 23.23. Events Configuration

The following collections of elements allow the actions to be specified when a guest virtual machine operating system triggers a life cycle operation. A common use case is to force a reboot to be treated as a power off when doing the initial operating system installation. This allows the VM to be re-configured for the first post-install boot up.
The components of this section of the domain XML are as follows:
Expand
Table 23.9. Event configuration elements
State Description
<on_poweroff> Specifies the action that is to be executed when the guest virtual machine requests a power off. Four arguments are possible:
  • destroy - This action terminates the domain completely and releases all resources.
  • restart - This action terminates the domain completely and restarts it with the same configuration.
  • preserve - This action terminates the domain completely but and its resources are preserved to allow for future analysis.
  • rename-restart - This action terminates the domain completely and then restarts it with a new name.
<on_reboot> Specifies the action to be executed when the guest virtual machine requests a reboot. Four arguments are possible:
  • destroy - This action terminates the domain completely and releases all resources.
  • restart - This action terminates the domain completely and restarts it with the same configuration.
  • preserve - This action terminates the domain completely but and its resources are preserved to allow for future analysis.
  • rename-restart - This action terminates the domain completely and then restarts it with a new name.
<on_crash> Specifies the action that is to be executed when the guest virtual machine crashes. In addition, it supports these additional actions:
  • coredump-destroy - The crashed domain's core is dumped, the domain is terminated completely, and all resources are released.
  • coredump-restart - The crashed domain's core is dumped, and the domain is restarted with the same configuration settings.
Four arguments are possible:
  • destroy - This action terminates the domain completely and releases all resources.
  • restart - This action terminates the domain completely and restarts it with the same configuration.
  • preserve - This action terminates the domain completely but and its resources are preserved to allow for future analysis.
  • rename-restart - This action terminates the domain completely and then restarts it with a new name.
<on_lockfailure> Specifies the action to take when a lock manager loses resource locks. The following actions are recognized by libvirt, although not all of them need to be supported by individual lock managers. When no action is specified, each lock manager will take its default action. The following arguments are possible:
  • poweroff - Forcefully powers off the domain.
  • restart - Restarts the domain to reacquire its locks.
  • pause - Pauses the domain so that it can be manually resumed when lock issues are solved.
  • ignore - Keeps the domain running as if nothing happened.
Nach oben
Red Hat logoGithubredditYoutubeTwitter

Lernen

Testen, kaufen und verkaufen

Communitys

Über Red Hat Dokumentation

Wir helfen Red Hat Benutzern, mit unseren Produkten und Diensten innovativ zu sein und ihre Ziele zu erreichen – mit Inhalten, denen sie vertrauen können. Entdecken Sie unsere neuesten Updates.

Mehr Inklusion in Open Source

Red Hat hat sich verpflichtet, problematische Sprache in unserem Code, unserer Dokumentation und unseren Web-Eigenschaften zu ersetzen. Weitere Einzelheiten finden Sie in Red Hat Blog.

Über Red Hat

Wir liefern gehärtete Lösungen, die es Unternehmen leichter machen, plattform- und umgebungsübergreifend zu arbeiten, vom zentralen Rechenzentrum bis zum Netzwerkrand.

Theme

© 2025 Red Hat