This article summarizes the steps required to upgrade from the train release to the ussuri release of openstack.

Prerequisites:

• This documents expects that your cloud is deployed with a recent train tag of the ntnuopenstack repository.
• You have a recent mysql backup in case things go south.
• If you want to do a rolling upgrade, the following key should be set in hiera long enough in advance that all hosts have had an puppet-run to apply it:

  • nova::upgrade_level_compute: 'train'

  • When the upgrade is finished - set this key to 'ussuri'

The recommended order to upgrade the services are listed below:

Keystone

This is the zero downtime approach

Before you begin

• Set apache::service_ensure: 'stopped' in hiera for the node that you plan to run the rolling upgrade from
• Login to a mysql node, start the mysql CLI, and run set global log_bin_trust_function_creators=1;

Upgrade-steps (start with a single node):

1. Run puppet with the ussuri modules/tags
2. Purge the keystone and apache2 package
3. Run apt-get autoremove && apt dist-upgrade
4. Run puppet again
   1. This will re-install keystone (ensure that apache2 does not start - should be ensured by puppet as of the enable: false flag in hiera)
5. Run keystone-manage doctor and ensure nothing is wrong
6. Run keystone-manage db_sync --expand
   1. Returns nothing
7. Run keystone-manage db_sync --migrate
   1. Returns nothing
8. At this point, you may restart apache2 on this node
   1. Remove the  apache::service_ensure: 'stopped' previously set in hiera.
9. Upgrade keystone on the other nodes, one at a time
   1. Basically run step 1-5 on the other nodes
10. When all nodes are upgraded, perform the final DB sync
    1. keystone-manage db_sync --contract