upgrade-2.md

Scenario 2: One service at a time

In this scenario, you upgrade one service at a time.

The procedure for upgrading an OpenStack service generally looks something like:

1. Stop the service:

     # openstack-service stop <service>
   

2. Upgrade the packages that provide that service:

     # yum upgrade \*<service>\*
   

3. Update the database schema for that service:

     # openstack-db --service <service> --update
   

   See the Database Upgrades document for the specific command used by each individual service to perform the database schema upgrade.

4. Restart the service:

     # openstack-service start <service>
   

Pre-upgrade

On all of your hosts:

1. Install the Juno yum repository.

Service upgrades

Upgrade each of your services. The following is a reasonable order in which to perform the upgrade:

1. Keystone
2. Swift
3. Cinder
4. Glance
5. Neutron (only if you are using Neutron networking in your OpenStack environment)
6. Horizon
7. Nova

After you have upgraded each service, you should test to make sure that the service is functioning properly. You will also want to review any new (*.rpmnew) configuration files installed by the upgraded package.

Post-upgrade

Perform a final package upgrade to ensure that all of your installed packages are at the latest version.