openstack-ansible/doc/source/upgrade-guide/overview.rst
Kevin Carter a88778f2ae Initial commit to enable mitaka>newton upgrades
This commit imports much of the documentation, scripts, and
playbooks from the Liberty>Mitaka upgrade process and
applies the appropriate series name changes.

Implements: blueprint upgrade-mitaka-newton
Change-Id: If8e43f1549e6fd121eae7b8d98d8cb16b01e2aab
Signed-off-by: Kevin Carter <kevin.carter@rackspace.com>
(cherry picked from commit 5a09cb7c8d)
2016-05-13 22:26:19 +01:00

1.8 KiB

Overview

The OpenStack-Ansible repository provides playbooks and scripts used to upgrade an environment from Mitaka to Newton. The run-upgrade.sh script runs each upgrade playbook in the correct order, or playbooks can be run individually if necessary.

Running the Upgrade script

The Newton series releases of OpenStack-Ansible contain the code for migrating from Mitaka to Newton.

Warning

The upgrade script is still under active development and should not be run at this time.

To upgrade from Mitaka to Newton using the upgrade script, perform the following steps in the openstack-ansible directory:

# git checkout stable/newton
# LATEST_TAG=$(git describe --abbrev=0 --tags)
# git checkout ${LATEST_TAG}
# ./scripts/run-upgrade.sh

Upgrading Manually

Deployers can run the upgrade steps manually. See manual-upgrade. Manual execution is useful for scoping the changes in the upgrade process (For example, in very large deployments with strict SLA requirements), or for inclusion into other orchestration for upgrade automation beyond what OpenStack-Ansible provides.

Upgrade Actions

Both the upgrade script and manual upgrade steps perform the actions and use the concepts introduced below.

Configuration Changes

The upgrade process will modify files residing in /etc/openstack_deploy in order to reflect new Newton values.

Flag Files

Some flag files are created by the migration scripts in order to achieve idempotency. These files are placed in the /etc/openstack_deploy.NEWTON directory.

RabbitMQ Upgrade

The RabbitMQ server can be upgraded during an OpenStack-Ansible upgrade.

See setup-infra-playbook for details.