openstack/nova
Code Issues Proposed changes

Merge "Add troubleshooting item about ignored microversions"

Browse Source
This commit is contained in:
Zuul 2018-06-15 03:33:32 +00:00 committed by Gerrit Code Review
commit 9c4622a668
1 changed files with 26 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
doc/source/admin/support-compute.rst
View File

@ -423,3 +423,29 @@ Install the ``sg3-utils`` package on the compute node. For example:
.. code-block:: console
# apt-get install sg3-utils
Requested microversions are ignored
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Problem
-------
When making a request with a microversion beyond 2.1, for example:
.. code-block:: console
$ openstack --os-compute-api-version 2.15 server group create \
--policy soft-anti-affinity my-soft-anti-group
It fails saying that "soft-anti-affinity" is not a valid policy, even
thought it is allowed with the `2.15 microversion`_.
.. _2.15 microversion: https://docs.openstack.org/nova/latest/reference/api-microversion-history.html#id13
Solution
--------
Ensure the ``compute`` endpoint in the identity service catalog is pointing
at ``/v2.1`` instead of ``/v2``. The former route supports microversions,
while the latter route is considered the legacy v2.0 compatibility-mode
route which renders all requests as if they were made on the legacy v2.0 API.