libvirt/docs/manpages
Benjamin Taubmann a39dd25715 Extend libvirt-guests to shutdown only persistent VMs
At the moment, there is no configuration option for the libvirt-guests
service that allows users to define that only persistent virtual machines
should be shutdown on host shutdown.

Currently, the service config allows to choose between two ON_SHUTDOWN
actions that are executed on running virtual machines when the host goes
down: shutdown, suspend.
The ON_SHUTDOWN action should be orthogonal to the type of the virtual
machine. However, the existing implementation, does not suspend
transient virtual machines.
This is the matrix of actions that is executed on virtual machines based
on the configured ON_SHUTDOWN action and the type of a virtual machine.

         | persistent | transient
shutdown | shutdown   | shutdown (what we want to change)
suspend  | suspend    | nothing

Add config option PERSISTENT_ONLY to libvirt-guests config that allows
users to define if the ON_SHUTDOWN action should be applied only on
persistent virtual machines. PERSISTENT_ONLY can be set to true, false,
default. The default option will implement the already existing logic.

Case 1: PERSISTENT_ONLY=default
         | persistent | transient
shutdown | shutdown   | shutdown
suspend  | suspend    | nothing

Case 2: PERSISTENT_ONLY=true
         | persistent | transient
shutdown | shutdown   | nothing
suspend  | suspend    | nothing

Case 3: PERSISTENT_ONLY=false
         | persistent | transient
shutdown | shutdown   | shutdown
suspend  | suspend    | suspend

Signed-off-by: Benjamin Taubmann <benjamin.taubmann@nutanix.com>
Reviewed-by: Martin Kletzander <mkletzan@redhat.com>
2024-04-04 09:10:00 +02:00
..
index.rst
libvirt-guests.rst Extend libvirt-guests to shutdown only persistent VMs 2024-04-04 09:10:00 +02:00
libvirtd.rst
meson.build
virsh.rst
virt-admin.rst
virt-host-validate.rst
virt-login-shell.rst
virt-pki-query-dn.rst
virt-pki-validate.rst
virt-qemu-qmp-proxy.rst
virt-qemu-run.rst
virt-qemu-sev-validate.rst
virt-sanlock-cleanup.rst
virt-ssh-helper.rst
virt-xml-validate.rst
virtbhyved.rst
virtinterfaced.rst
virtlockd.rst
virtlogd.rst
virtlxcd.rst
virtnetworkd.rst
virtnodedevd.rst
virtnwfilterd.rst
virtproxyd.rst
virtqemud.rst docs: manpages: Clarify that only TLS/TCP remote access needs 'virtproxyd' 2023-04-24 12:57:17 +02:00
virtsecretd.rst
virtstoraged.rst
virtvboxd.rst
virtvzd.rst
virtxend.rst