nova/releasenotes/notes/deprecate-keymap-options-b4...

35 lines
1.5 KiB
YAML

---
deprecations:
- |
Two keymap-related configuration options have been deprecated:
- ``[vnc] keymap``
- ``[spice] keymap``
The VNC option affects the libvirt and VMWare virt drivers, while the SPICE
option only affects libvirt. For the libvirt driver, configuring these
options resulted in lossy keymap conversions for the given graphics method.
It is recommended that users should unset these options and configure their
guests as necessary instead. In the case of noVNC, noVNC 1.0.0 should be
used as this provides support for QEMU's Extended Key Event messages. Refer
to `bug #1682020`__ and the `QEMU RFB pull request`__ for more information.
For the VMWare driver, only the VNC option applies. However, this option is
deprecated and will not affect any other driver in the future. A new option
has been added to the ``[vmware]`` group to replace this:
- ``[vmware] vnc_keymap``
The ``[vnc] keymap`` and ``[spice] keymap`` options will be removed in a
future release.
__ https://bugs.launchpad.net/nova/+bug/1682020
__ https://github.com/novnc/noVNC/pull/596
upgrade:
- |
noVNC 1.0.0 introduced a breaking change in the URLs used to access the
console. Previously, the ``vnc_auto.html`` path was used but it is now
necessary to use the ``vnc_lite.html`` path. When noVNC is updated to
1.0.0, ``[vnc] novncproxy_base_url`` configuration value must be updated on
each compute node to reflect this change.