Jump to: navigation, search

LibvirtDistroSupportMatrix

Libvirt OS distribution support matrix

This page documents the libvirt versions present in the various distro versions that OpenStack Nova aims to be deployable with.

Libvirt min version change policy

At the start of each Nova development cycle this matrix will be consulted to determine if it is viable to drop support for any end-of-life or otherwise undesired distro versions. Based on this distro evaluation, it may be possible to increase the min required version of libvirt in Nova, and thus drop some compatibility code for older versions.

When a decision to update the minimum required libvirt version is made, there must be a warning issued for one cycle. This is achieved by editting nova/virt/libvirt/driver.py to set

 NEXT_MIN_LIBVIRT_VESION = (X, Y, Z)

This causes a deprecation warning to be printed when Nova starts up warning the admin that the version of libvirt they are on will be dropped in the subsequent release.

After a version has been listed in NEXT_MIN_LIBVIRT_VERSION for one release cycle, the corresponding actual min required libvirt can be updated by setting

 MIN_LIBVIRT_VESION = (X, Y, Z)

At this point of course, an even newer version might be set in NEXT_MIN_LIBVIRT_VERSION to repeat the process....

There is more background on the rationale used for picking minimum versions in the operators mailing list thread here:

http://lists.openstack.org/pipermail/openstack-operators/2015-May/007012.html

QEMU min version change policy

After deciding the minimum libvirt version, the minimum QEMU version is determined by looking for the lowest QEMU version from all the distros that support the decided libvirt version

Nova release min version

Nova version Current min libvirt Next min libvirt Current min QEMU Next min QEMU
Havana 0.9.6 0.9.6
Icehouse 0.9.6 0.9.11
Juno 0.9.11 0.9.11
Kilo 0.9.11 0.9.11
Liberty 0.9.11 0.10.2
Mitaka 0.10.2 1.2.1
Newton 1.2.1 1.2.1 1.5.3 1.5.3
Ocata 1.2.1 1.2.9 1.5.3 2.1.0
Pike 1.2.9 1.3.1 2.1.0 2.5.0
Queens 1.2.9 1.3.1 2.1.0 2.5.0
Rocky 1.3.1 3.0.0 2.5.0 2.8.0
Stein 3.0.0 4.0.0 2.8.0 2.11.0
Train 3.0.0 4.0.0 2.8.0 2.11.0
Ussuri 4.0.0 5.0.0 2.11.0 4.0.0
Victoria 5.0.0 6.0.0 4.0.0 4.2.0
Wallaby 6.0.0 7.0.0 4.2.0 5.2.0
Xena (draft)  ?  ?  ?  ?

Distro minimum versions

This table provides information on a representative sample of OS distros and the version of libirt/qemu/libguestfs that they ship. This is *NOT* intended to be an exhaustive list of distros where OpenStack Nova can run - it is intended to run on any Linux distro which can satisfy the minimum required software versions. This table merely aims to help identify when min required versions can be reasonably updated without losing support for important OS distros.

When NEXT_MIN_LIBVIRT_VERSION is updated, any distros which don't meet that version should be changed to have strikethrough format.

When MIN_LIBVIRT_VERSION is updated, any distros which don't meet that version should be deleted from this table

OS Distro GA date Libvirt QEMU/KVM libguestfs
Debian
9.x (Stretch) 2017-06-17 3.0.0 2.8.0 1.34.6
10.x (Buster) ("stable") as of 2020-05-15 5.0.0 3.1 1.40
11.x (Bullseye) ("sid" - unstable) No GA date as of 2020-05-15 6.0.0 5.0 1.42.0
Fedora
31 2019-10-29 5.6.0 4.1 1.40
32 2020-04-28 6.1.0 4.2.0 1.42.0
SUSE
Leap 15.0 2018-05 4.0.0 2.11.1 1.38.0
Leap 15.1 2019-05-22 5.1.0 3.1.1 1.38.0
Leap 15.2 2020-07-02 (scheduled) 6.0.0 4.2.0 1.38.0
Oracle Linux *
7 4.7.0 * 3.0.0 * 1.38.2
8  ?  ?  ?  ?
RHEL *
7.7 2019-08-06 libvirt-4.5.0-23.el7 qemu-kvm-rhev-2.12.0-33.el7_7.4 libguestfs-1.40.2-5.el7
8.1 2019-11-05 libvirt-5.6.0-6.module+el8.1.0+4244+9aa4e6bb qemu-kvm-4.1.0-14.module+el8.1.0+4548+ed1300f4 libguestfs-1.40.2-14.module+el8.1.0+4230+0b6e3259
8.2 2020-04-28 libvirt-6.0.0-17.2.module+el8.2.0+6629+3fc0f2c2 qemu-kvm-4.2.0-19.module+el8.2.0+6296+6b821950 libguestfs-1.40.2-22.module+el8.2.0+6029+618ef2ec
SLES
12 1.2.5 2.0.2 1.26.9
12SP1 2016-01-12 1.2.18 2.3.1 1.26.10
12SP2 2016-11 2.0.0 2.6.1 1.32.4
12SP3 2017-09 3.3.0 2.9.0 1.32.4
12SP4 TBD 4.0.0 2.11.2 1.32.4
15 2018-07 4.0.0 2.11.1 1.38.0
15.1 2019 5.1.0 3.1.1 1.38.0
15.2 2020 6.0.0 4.2.1 1.38.0
Ubuntu
14.04 (Trusty LTS) 1.2.2 2.0.0 1.24.5
16.04 (Xenial LTS) 1.3.1 2.5.0 1.32.2
18.04 (Bionic LTS - Cloud Archive) as of 2019-11-18 5.4 4.0 1.36
20.04 (Focal Fossa) 2020-04-23 6.0.0 4.2 1.40.2

NB: maintain alphabetical ordering of distros, followed by oldest released versions first

NB2: RHEL versions of QEMU refer to the qemu-kvm-rhev RPM, not the qemu-kvm RPM, since the former is what is intended for use with OpenStack

NB3: Oracle Linux versions for QEMU and libvirt refer to those available from the KVM Utils YUM repository, not those included with the base OS (which are aligned with RHEL). The Oracle OpenStack product uses docker containers which include the latest versions at the time of release.