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
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
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
manpages Extend libvirt-guests to shutdown only persistent VMs 2024-04-04 09:10:00 +02:00
404.rst
acl.rst
aclpolkit.rst
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
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 docs: Move the CI dashboard to its own RST module 2022-07-14 17:31:21 +02:00
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
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
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 docs: Convert 'drvsecret' page to rST 2022-04-01 16:33:19 +02:00
drvtest.rst
drvvbox.rst
drvvirtuozzo.rst
drvvmware.rst docs: Convert 'drvvmware' page to rST 2022-04-01 16:33:19 +02:00
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
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
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