Skip to main content

Utilize the python libvirt API to start and stop qemu-kvm machines in a blocking fashion

Project description


I wanted to start and stop individual libvirt virtual machines with a systemd unit.

Calling virsh start %i or virsh stop %i from the unit doesn't cut it. This is because it doesn't block while shutting down so you don't know if the machine is really down unless you wrap it all in a bash script and employ a dirty hack along the lines of virsh list | grep myVM.

Starting a machine is also challenging because virsh start uses exit status 1 for multiple error conditions, including "machine is already running".

The purpose of this script is to start / stop a given virtual machine through the libvirt python bindings in a way that is easily consumable from systemd. This means I try to handle the "already running" case gracefully. Shutting down happens in a blocking fashion, with the option to yank the virtual power cord from the machine in case it ignores our polite requests.

I also took the opportunity to issue shutdown requests every second until the machine is down. This should be unnecessary when the virtual machine has the libvirt guest agent running, but it can sometimes help to convince windows to really shut down instead of asking "really shutdown?" on the virtual console with nobody around to click ok.

Example systemd unit file:

Description=virsh start / stop %i

ExecStart=/opt/ --machine %i --state started
ExecStop=/opt/ --machine %i --state stopped --timeout 80


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

virsh_start_stop-0.0.1.tar.gz (5.6 kB view hashes)

Uploaded Source

Built Distributions

virsh_start_stop-0.0.1-py3.6.egg (5.4 kB view hashes)

Uploaded Source

virsh_start_stop-0.0.1-py3-none-any.whl (4.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page