charm-deployment-guide/deploy-guide/source/upgrade-stein-to-train.rst

Upgrade: Stein to Train

This page contains notes specific to the Stein to Train upgrade path. See the main upgrade-openstack page for full coverage.

New placement charm

As of OpenStack Train, the Placement API is managed by the new placement charm and is no longer managed by the nova-cloud-controller charm. The upgrade to Train therefore involves some coordination to transition to the new API endpoints.

Prior to upgrading nova-cloud-controller services to Train, the placement charm must be deployed for Train and related to the Stein-based nova-cloud-controller application. It is important that the nova-cloud-controller unit leader is paused while the API transition occurs (paused prior to adding relations for the placement charm) as the placement charm will migrate existing placement tables from the nova_api database to a new placement database. Once the new placement endpoints are registered, nova-cloud-controller can be resumed.

Here are example commands for the process just described:

juju deploy --series bionic --config openstack-origin=cloud:bionic-train cs:placement
juju run-action --wait nova-cloud-controller/leader pause
juju add-relation placement percona-cluster
juju add-relation placement keystone
juju add-relation placement nova-cloud-controller

List endpoints and ensure placement endpoints are now listening on the new placement IP address. Follow this up by resuming nova-cloud-controller:

openstack endpoint list
juju run-action --wait nova-cloud-controller/leader resume

Finally, upgrade the nova-cloud-controller services. Below all units are upgraded simultaneously but see the paused-single-unit service upgrade method for a more controlled approach:

juju config nova-cloud-controller openstack-origin=cloud:bionic-train

The Compute service (nova-compute) should then be upgraded.

Placement endpoints not updated in Keystone service catalog

When the placement charm is deployed during the upgrade to Train (as described above) the Keystone service catalog is not updated accordingly. This issue is tracked in bug LP #1928992, which also includes an explicit workaround (comment #4).

Neutron LBaaS retired

As of Train, support for Neutron LBaaS has been retired. The load-balancing services are now provided by Octavia LBaaS. There is no automatic migration path, please review the cg:admin/networking/load-balancing page in the Charm Guide for more information.

Designate encoding issue

When upgrading Designate to Train, there is an encoding issue between the designate-producer and memcached that causes the designate-producer to crash. See bug LP #1828534. This can be resolved by restarting the memcached service.

juju run --application=memcached 'sudo systemctl restart memcached'