Merge "doc: placement upgrade notes for queens"

This commit is contained in:
Zuul 2018-02-02 09:55:58 +00:00 committed by Gerrit Code Review
commit 8ac8c995ca
2 changed files with 16 additions and 5 deletions

View File

@ -54,8 +54,10 @@ changed or be partially complete at this time.
* `Scheduler Filters in DB <http://specs.openstack.org/openstack/nova-specs/specs/ocata/implemented/resource-providers-scheduler-db-filters.html>`_ * `Scheduler Filters in DB <http://specs.openstack.org/openstack/nova-specs/specs/ocata/implemented/resource-providers-scheduler-db-filters.html>`_
* `Scheduler claiming resources to the Placement API <http://specs.openstack.org/openstack/nova-specs/specs/pike/approved/placement-claims.html>`_ * `Scheduler claiming resources to the Placement API <http://specs.openstack.org/openstack/nova-specs/specs/pike/approved/placement-claims.html>`_
* `The Traits API - Manage Traits with ResourceProvider <http://specs.openstack.org/openstack/nova-specs/specs/pike/approved/resource-provider-traits.html>`_ * `The Traits API - Manage Traits with ResourceProvider <http://specs.openstack.org/openstack/nova-specs/specs/pike/approved/resource-provider-traits.html>`_
* `Request Traits During Scheduling`_
.. _Nested Resource Providers: http://specs.openstack.org/openstack/nova-specs/specs/queens/approved/nested-resource-providers.html .. _Nested Resource Providers: http://specs.openstack.org/openstack/nova-specs/specs/queens/approved/nested-resource-providers.html
.. _Request Traits During Scheduling: https://specs.openstack.org/openstack/nova-specs/specs/queens/approved/request-traits-in-nova.html
Deployment Deployment
========== ==========
@ -180,10 +182,12 @@ placement-api service.
from nova-compute to the placement-api service. from nova-compute to the placement-api service.
.. _placement-upgrade-notes:
Upgrade Notes Upgrade Notes
============= =============
The follow sub-sections provide notes on upgrading to a given target release. The following sub-sections provide notes on upgrading to a given target release.
.. note:: .. note::
@ -269,10 +273,10 @@ Pike (16.0.0)
Queens (17.0.0) Queens (17.0.0)
~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~
* The minimum Placement API microversion required by the *nova-compute* service * The minimum Placement API microversion required by the *nova-scheduler*
is ``1.14`` in order to support `Nested Resource Providers`_. This means you service is ``1.17`` in order to support `Request Traits During Scheduling`_.
must upgrade the Placement service before upgrading any *nova-compute* This means you must upgrade the placement service before upgrading any
services to Queens. *nova-scheduler* services to Queens.
REST API REST API

View File

@ -80,6 +80,13 @@ same time.
#. During maintenance window: #. During maintenance window:
* Several nova services rely on the external placement service, and while
efforts are made for the nova code to work with older versions of the
placement API, it is generally best to upgrade placement before any nova
services. See the
:ref:`placement upgrade notes <placement-upgrade-notes>` for more
details on upgrading the placement service.
* For maximum safety (no failed API operations), gracefully shutdown all * For maximum safety (no failed API operations), gracefully shutdown all
the services (i.e. SIG_TERM) except nova-compute. the services (i.e. SIG_TERM) except nova-compute.