libvirt/docs
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
..
css css: Move generic styles to 'generic.css' 2024-02-08 16:48:47 +01:00
fonts meson: Work around configure_file(copy:true) deprecation 2023-04-20 15:30:18 +02:00
gitdm
go docs: go: Add 'go-import' metadata via rST 2023-06-02 09:39:10 +02:00
html docs: xsl: Properly propagate 'href_base' as XSL template parameter 2024-02-08 16:48:47 +01:00
images meson: Work around configure_file(copy:true) deprecation 2023-04-20 15:30:18 +02:00
js js: Separate the virt-tools blog planet loader code 2024-02-08 16:48:47 +01:00
kbase docs: fix typo in qemu-passthrough-security 2024-01-03 16:05:03 +00:00
logos meson: Work around configure_file(copy:true) deprecation 2023-04-20 15:30:18 +02:00
manpages Extend libvirt-guests to shutdown only persistent VMs 2024-04-04 09:10:00 +02:00
404.rst docs: Convert 404 page to rST 2023-02-21 10:58:59 +01:00
acl.rst docs: acl: Convert to 'rst' 2023-05-17 16:54:23 +02:00
aclpolkit.rst docs: acl: Convert to 'rst' 2023-05-17 16:54:23 +02:00
advanced-tests.rst tests: Rename 'qemuxml2argvtest' to 'qemuxmlconftest' 2024-01-17 17:31:12 +01:00
android-chrome-192x192.png
android-chrome-256x256.png
api_extension.rst docs: Format lists of files better 2024-02-26 12:10:27 +01:00
api.rst
apple-touch-icon.png
apps.rst docs: apps: Add a new section for backup utilities and mention 'virtnbdbackup' 2023-04-03 11:09:39 +02:00
auditlog.rst
auth.rst
best-practices.rst
bindings.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
browserconfig.xml
bugs.rst docs: Don't use "line blocks" 2024-02-26 12:10:27 +01:00
cgroups.rst
ci-dashboard.rst
ci-runners.rst docs: ci-runners: Add a note on a new runner registration process 2023-10-11 09:43:09 +02:00
ci.rst docs: ci: Update the description on the integration CI GitLab variables 2023-10-11 09:43:09 +02:00
clangd.rst docs: expand clangd instructions 2023-07-17 10:43:29 -05:00
coding-style.rst coding style: Follow our own rule on comment style 2023-04-04 12:16:09 +02:00
committer-guidelines.rst
compiling.rst docs: compiling: Add a note about use of CFLAGS for optimization 2023-09-04 13:32:28 +02:00
contact.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
contribute.rst docs: Missing "full-stop"/"period" on some bullet items 2023-07-14 15:19:10 +02:00
csharp.rst
daemons.rst
dbus.rst
docs.rst docs: Link to java.libvirt.org 2023-04-27 11:06:42 +02:00
downloads.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
drivers.rst
drvbhyve.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
drvch.rst
drvesx.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
drvhyperv.rst
drvlxc.rst
drvnodedev.rst docs: Remove unnecessary whitespace 2024-02-26 12:10:27 +01:00
drvopenvz.rst
drvqemu.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
drvsecret.rst
drvtest.rst
drvvbox.rst vbox: Drop support for virtualbox-6.0.0 2023-01-24 10:24:07 +01:00
drvvirtuozzo.rst
drvvmware.rst
drvxen.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
errors.rst
favicon-16x16.png
favicon-32x32.png
favicon.ico
firewall.rst docs: Don't use "line blocks" 2024-02-26 12:10:27 +01:00
format.rst
formatbackup.rst
formatcaps.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
formatcheckpoint.rst
formatdomain.rst conf: Automatically assign address to usb-net device 2024-04-03 10:40:14 +02:00
formatdomaincaps.rst docs: Update documentation of CPU models in domain caps 2024-03-07 14:32:20 +01:00
formatnetwork.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
formatnetworkport.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
formatnode.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
formatnwfilter.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
formatsecret.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
formatsnapshot.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
formatstorage.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
formatstoragecaps.rst
formatstorageencryption.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
glib-adoption.rst
goals.rst
golang.rst docs: Add sub-page for all golang modules 2023-02-15 12:38:45 +01:00
governance.rst
hacking.rst docs: Advise running CI tests prior to submission 2023-07-14 15:19:24 +02:00
hooks.rst docs: Other fixes to :since: tags 2024-02-26 12:10:27 +01:00
index.rst docs: index: Fix import of blog planet javascript 2024-03-01 12:51:55 +01:00
issue-handling.rst
libvirt-go-xml.rst docs: go: Add 'go-import' metadata via rST 2023-06-02 09:39:10 +02:00
libvirt-go.rst docs: go: Add 'go-import' metadata via rST 2023-06-02 09:39:10 +02:00
logging.rst
macos.rst
manifest.json
meson.build meson: Rename build_tests -> tests_enabled 2023-10-26 11:31:25 +02:00
migration.rst
mstile-150x150.png
newapi.xsl docs: newapi: Fix generation of type definition tables 2024-03-01 12:51:56 +01:00
newreposetup.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
nss.rst
page.xsl docs: page: Fix declaration of main javascript source 2024-03-01 12:51:55 +01:00
pci-addresses.rst tests: remove explicit <driver name='vfio'/> from hostdev test cases 2024-01-07 23:59:00 -05:00
pci-hotplug.rst
platforms.rst
programming-languages.rst
python.rst
remote.rst
securityprocess.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
site.xsl docs: site: Don't generate '<?xml' header for HTML documents 2024-03-01 12:51:55 +01:00
storage.rst
strategy.rst
styleguide.rst Use 'libvirt.org' instead of 'www.libvirt.org' 2023-04-03 09:19:05 +02:00
submitting-patches.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
support.rst
testapi.rst docs: update docs pointing to old mailing list addrs 2023-10-31 10:04:27 +00:00
testing.rst docs: testing: Adjust the docs on how to run container workloads locally 2023-10-11 09:43:09 +02:00
testtck.rst docs: testtck: Expand the 'Run TCK' section on making use of ci/jobs.sh 2023-10-11 09:43:09 +02:00
uri.rst
windows.rst