diff options
| author | Matt Riedemann <mriedem.os@gmail.com> | 2018-01-31 15:04:20 -0500 |
|---|---|---|
| committer | Matt Riedemann <mriedem.os@gmail.com> | 2018-02-01 17:17:57 -0500 |
| commit | b06895f030f7f7de428cba1b6b742a168d1680c3 (patch) | |
| tree | 06878fdccdcea71eb56d14571cf65a2743cb7135 /doc/source/user | |
| parent | 477a14e81e8c69b91a39395d78d845c8603e10fd (diff) | |
| download | nova-b06895f030f7f7de428cba1b6b742a168d1680c3.tar.gz | |
doc: placement upgrade notes for queens
This adds a mention of the nova-scheduler service requiring
placement 1.17 and also links to the placement upgrade notes
from the more general upgrade notes, since we are now firmly
in a place where placement needs to be upgraded before nova.
Since we consider placement global, this removes the 1.14
note about nova-compute since we assume that if you're going
to upgrade placement to get 1.17 for the scheduler, and control
services should be upgraded before computes, then the computes
are going to get a new enough placement service automatically.
Change-Id: I06937c7642dca4a1932cbbf46569acc9c58e44a6
Diffstat (limited to 'doc/source/user')
| -rw-r--r-- | doc/source/user/placement.rst | 14 | ||||
| -rw-r--r-- | doc/source/user/upgrade.rst | 7 |
2 files changed, 16 insertions, 5 deletions
diff --git a/doc/source/user/placement.rst b/doc/source/user/placement.rst index 40dad80e07..ca0a41f2d4 100644 --- a/doc/source/user/placement.rst +++ b/doc/source/user/placement.rst @@ -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 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>`_ +* `Request Traits During Scheduling`_ .. _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 ========== @@ -180,10 +182,12 @@ placement-api service. from nova-compute to the placement-api service. +.. _placement-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:: @@ -269,10 +273,10 @@ Pike (16.0.0) Queens (17.0.0) ~~~~~~~~~~~~~~~ -* The minimum Placement API microversion required by the *nova-compute* service - is ``1.14`` in order to support `Nested Resource Providers`_. This means you - must upgrade the Placement service before upgrading any *nova-compute* - services to Queens. +* The minimum Placement API microversion required by the *nova-scheduler* + service is ``1.17`` in order to support `Request Traits During Scheduling`_. + This means you must upgrade the placement service before upgrading any + *nova-scheduler* services to Queens. REST API diff --git a/doc/source/user/upgrade.rst b/doc/source/user/upgrade.rst index 36d83146d7..61136dae6f 100644 --- a/doc/source/user/upgrade.rst +++ b/doc/source/user/upgrade.rst @@ -80,6 +80,13 @@ same time. #. 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 the services (i.e. SIG_TERM) except nova-compute. |