From b06895f030f7f7de428cba1b6b742a168d1680c3 Mon Sep 17 00:00:00 2001 From: Matt Riedemann Date: Wed, 31 Jan 2018 15:04:20 -0500 Subject: [PATCH] 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 --- doc/source/user/placement.rst | 14 +++++++++----- 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 40dad80e077a..ca0a41f2d45b 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 `_ * `Scheduler claiming resources to the Placement API `_ * `The Traits API - Manage Traits with ResourceProvider `_ +* `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 36d83146d7ed..61136dae6fdb 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 ` 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.