openstack/placement
Code Issues Proposed changes
Files
ac1e0f8afed31ca927f2788e8836874d476fb22c
placement/doc/source/admin/upgrade-notes.rst
Tetsuro Nakamura ac1e0f8afe Clean up document's index 
In the top index page of the document, some sections had actual
contents and some had only links to the contents. However, this
makes it difficult for readers to get what is in the document and
what isn't at a glance.

This patch cleans it up to simplify the top index. This patch also
renames some of the directories to follow the doc layout rules[1].

[1] https://specs.openstack.org/openstack/docs-specs/specs/pike/os-manuals-migration.html

Note that the following ToDo is left for further cleanup:

 * Publish the api guide and move the microversion history to
   the `/api-guide` directory

Change-Id: Ideb1d5e7c74d1d564d07bac1a1e7c86c55ede873
2019-09-24 15:45:11 +00:00

2.1 KiB
Raw Blame History

Upgrade Notes

This section provide notes on upgrading to a given target release.

Note

As a reminder, the placement-status upgrade check <placement-status-checks> tool can be used to help determine the status of your deployment and how ready it is to perform an upgrade.

For releases prior to Stein, please see the nova upgrade notes.

Stein (1.0.0)

If you are upgrading an existing OpenStack installation from Rocky to Stein, and wish to use the newly extracted placement, you will need to copy some data and configuration settings from nova.

  • Configuration and policy files are, by default, located in /etc/placement.
  • The placement server side settings in nova.conf should be moved to a separate placement configuration file placement.conf.
  • The default configuration value of [placement]/policy_file is changed from placement-policy.yaml to policy.yaml
  • Several tables in the nova_api database need to be migrated to a new placement database.

Following these steps will ensure that future changes to placement configuration and code will not conflict with your setup.

As stated above, using the extracted placement code is not required in Stein, there is a copy in the Stein release of Nova. However that code will be deleted in the Train cycle so you must upgrade to external Placement prior to upgrading to Train.