Bug 1990802 - [OSP 16.2] [Docs] Declare the deprecation of 'qxl' video model
Summary: [OSP 16.2] [Docs] Declare the deprecation of 'qxl' video model
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat OpenStack
Classification: Red Hat
Component: documentation
Version: 16.2 (Train)
Hardware: Unspecified
OS: Unspecified
unspecified
high
Target Milestone: ga
: 16.2 (Train on RHEL 8.4)
Assignee: Irina
QA Contact: RHOS Documentation Team
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2021-08-06 09:29 UTC by Kashyap Chamarthy
Modified: 2022-08-11 07:37 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: Deprecated Functionality
Doc Text:
In Red Hat Openstack Platform (RHOSP) 16.2, support for the QXL video model is deprecated, due to the removal of support for the Spice graphics software in RHEL 9. This will cause issues for instances that use QXL when migrating from RHEL-8 to RHEL-9. Red Hat recommends using the `virtio` video model for both UEFI and BIOS instances, instead of `qxl`. When creating a new instance from an image, set the video model before launching the new instance: + ---- $ openstack image set --property hw_video_model=virtio <image> ---- + To update the video model for existing instances that use the QXL video model: . Stop the instance. . Snapshot the instance. . Update the image metadata on the instance snapshot image to include the property `hw_video_model=virtio`. . Create a new instance using the instance snapshot. + For more information on supported video models, see https://access.redhat.com/documentation/en-us/red_hat_openstack_platform/16.2/html/creating_and_managing_images/appx-image-config-parameters.
Clone Of:
Environment:
Last Closed: 2021-09-17 13:26:31 UTC
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker OSP-6865 0 None None None 2022-08-10 15:23:37 UTC

Description Kashyap Chamarthy 2021-08-06 09:29:32 UTC
Description of problem
----------------------

"QXL" is one of the possible display devices a Nova instance can use.
However, QXL comes bundled with Spice graphics software, which will be
completely removed in RHEL-9.  The deprecation of Spice itself was
announced in RHEL-8.3[1].  

Note that OSP itself does not support Spice graphics, but only the QXL
video model (which comes with one of Spice libraries) as a possible
option.

This removal of QXL, by consequence of removing Spice, in RHEL-9 has
negative impact on a small portion of OSP guests (using QXL) that are
migrating from RHEL-8 to RHEL-9.


[1] https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/8.3_release_notes/rhel-8-3-0-release#deprecated-functionality_virtualization

What now?
----------

Given the negative impact of QXL removal in RHEL 9, OSP 16.2 needs to
announce the deprecation of 'QXL' video model.  And in OSP 17 we can
remove the support for QXL altogether.


Recommended alternative
-----------------------

For both UEFI and BIOS guests, the 'virtio' (using libvirt terminology) 
video model is recommended.  It's a modern display device designed for
virtual machines.  It works as follows:

When using the 'virtio' display device, any Linux guest with kernel 
4.4[*] — or a kernel with the Linux 'virtio-gpu' driver backported — can
take full advantage of all 'virtio' device features.  In case your guest
kernel does not have the ‘virtio-gpu’ driver, no problem: it will still
have a working display, because the 'virtio' device will gracefully
fallback to VGA compatibility mode. 


[*] This means RHEL-7 and newer guests, and other Linux distributions
using 4.x or 55.x long-term kernels.

Comment 1 Kashyap Chamarthy 2021-08-06 09:49:07 UTC
More notes
----------

(a) For _existing_ instances, the manual procedure to update the video
    model is somewhat involved (read: painful).  Roughly:

    (1) Stop the instance

    (2) Snapshot it 

    (3) Update the image metadata on the snapshot image to use 'virtio' 
        display dev.

    (4) Then rebuild the instance using the snapshot


(b) Before launching _new_ OSP instances on RHEL-9:

    Users can configure the 'virtio' device as a property
    (`hw_video_model`) on the template disk image from which you boot
    VMs: 

    $ openstack image set \
        --property hw_video_model=virtio \
        <template_disk_image_UUID>

    And then boot off the 'template_disk_image_UUID'.  

    Or you can directly specify the video model at the time of guest
    creation too ("server create" is just simply creating VM):

    $ openstack server create --flavor m1.micro \
        --image rhel8.4 \
        --property 'hw_video_model=virtio' vm1

Comment 2 Kashyap Chamarthy 2021-08-06 10:01:30 UTC
(In reply to Kashyap Chamarthy from comment #1)

[...]
 
>     Or you can directly specify the video model at the time of guest
>     creation too ("server create" is just simply creating VM):
> 
>     $ openstack server create --flavor m1.micro \
>         --image rhel8.4 \
>         --property 'hw_video_model=virtio' vm1


Please ignore this above command; it is not valid, as flavor extra specs
do not expose video models.  The only valid approach for new instances
is option (a) — updating the image metadata.  

(Thanks to Lee and Stephen on IRC for the correction.)


Note You need to log in before you can comment on or make changes to this bug.