How to configure guest VM shutdown behavior¶
You can customize the libvirt-guests service's behavior to choose how the guest virtual machines manage the shutdown requests received from the host server. For more information about the libvirt-guests service, read libvirt's libvirt-guests documentation.
Configuration file and backup location¶
You can locate the libvirt-guests file, in the following location:
| Operating System type | File path |
|---|---|
| Debian-based OS | /etc/default/libvirt-guests |
| non-Debian-based OS | /etc/sysconfig/libvirt-guests |
If the configuration file already exists, the agent will attempt to create a backup. View the following example:
/etc/default/libvirt-guests.solus.backup
If a backup file already exists, the agent will not overwrite the existing file.
How to customize shutdown behavior¶
You can customize the following variables:
| Variable | Description | Example |
|---|---|---|
ON_SHUTDOWN |
The action taken on host shutdown. | ON_SHUTDOWN=shutdown |
PARALLEL_SHUTDOWN |
The number of guests to shutdown in parallel. | PARALLEL_SHUTDOWN=5 |
SHUTDOWN_TIMEOUT |
The amount of time to wait for guest vm shutdown, in seconds. | SHUTDOWN_TIMEOUT=200 |
The agent will always write the following variables and their set values. You cannot adjust them:
BYPASS_CACHE=0SYNC_TIME=1ON_BOOT=ignore
After you change the configuration, restart the SolusVM Agent service.
Example configuration file¶
# Managed by SolusVM
# ON_SHUTDOWN, PARALLEL_SHUTDOWN and SHUTDOWN_TIMEOUT can be changed in
# /etc/solus/agent.json with libvirt_guests_on_shutdown,
# libvirt_guests_parallel_shutdown and libvirt_guests_shutdown_timeout.
# Restart solus-agent.service to apply changes.
ON_SHUTDOWN=shutdown
PARALLEL_SHUTDOWN=5
SHUTDOWN_TIMEOUT=200
BYPASS_CACHE=0
SYNC_TIME=1
ON_BOOT=ignore