Overview

The OpenStack-Ansible repository provides playbooks and scripts used to upgrade an environment from Kilo to Liberty. 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 Liberty release series of OpenStack-Ansible contain the code for migrating from Kilo to Liberty.

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

# git checkout <liberty-tag>
# ./scripts/run-upgrade.sh

Upgrading manually

Deployers can run the upgrade steps manually. See Manual upgrade steps.

Upgrade actions

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

Configuration changes

The upgrade process modifies files residing in /etc/openstack_deploy in order to reflect new Liberty 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.KILO directory.

MariaDB upgrade

MariaDB and Galera directly facilitate the Liberty upgrade of MariaDB from the 5.5 series to the 10.0.

See repo-server-pip-conf-removal.yml for details.

RabbitMQ upgrade

Upgrade the RabbitMQ server during an OpenStack-Ansible upgrade. When upgrading from an early Kilo release, the update is mandatory.

See repo-server-pip-conf-removal.yml for details.

Neutron port security

OpenStack-Ansible enables neutron ML2 port security driver by default in Liberty, but keeps the driver disabled in environments upgraded from Kilo unless you have enabled it in Kilo.

See disable-neutron-port-security.yml for details.

Table Of Contents

Previous topic

Upgrade Documentation

Next topic

Manual upgrade steps

Project Source

This Page