Files
openstack-ansible/doc/source/upgrade-guide/reference-upgrade-playbooks.rst
Jimmy McCrory c399270b5c Remove Newton specific upgrade playbooks
Remove playbooks and references to them in scripts and docs that are
only applicable to Mitaka->Newton upgrades.

Change-Id: I2c581f30d2906411282994b7950a7354d6abd96a
2016-10-21 11:46:23 -07:00

2.8 KiB

Upgrade playbooks

This section describes the playbooks that are used in the upgrade process in further detail.

Within the main scripts directory there is an upgrade-utilities directory, which contains an additional playbooks directory. These playbooks facilitate the upgrade process.

ansible_fact_cleanup.yml

This calls a script to removes files in /etc/openstack_deploy/ansible_facts/

deploy-config-changes.yml

This playbook backs up the /etc/openstack_deploy directory before changing the configuration.

/etc/openstack_deploy copies once to .

user-secrets-adjustment.yml

This playbook ensures that the user secrets file is updated based on the example file in the main repository, making it possible to guarantee all secrets move into the upgraded environment and generate appropriately. This adds only new secrets, such as those necessary for new services or new settings added to existing services. Values set previously are not changed.

pip-conf-removal.yml

The presence of pip.conf locks down all Python installations to packages on the repo servers. If pip.conf exists on a repo server or a physical node, it will cause a circular dependency issue and the upgrade will fail.

setup-infrastructure.yml

The playbooks directory contains the setup-infrastructure.yml playbook. The run-upgrade.sh script calls setup-insfrastructure.yml with specific arguments to upgrade MariaDB and RabbitMQ.

For example, to run an upgrade for both components at once, run the following commands:

# openstack-ansible setup-infrastructure.yml -e 'rabbitmq_upgrade=true' \
  -e 'galera_upgrade=true'

The rabbitmq_upgrade variable tells the rabbitmq_server role to upgrade RabbitMQ.

Note

The RabbitMQ server role installs patch releases automatically, regardless of the value of rabbitmq_upgrade. This variable only controls upgrading the major or minor versions.

Upgrading RabbitMQ in the release is optional. The run-upgrade.sh script does not automatically upgrade it. To upgrade RabbitMQ, insert the rabbitmq_upgrade: true line into a file, such as: /etc/openstack_deploy/user_variables.yml.

The galera_upgrade variable tells the galera_server role to remove the current version of MariaDB and Galera and upgrade to the 10.x series.

memcached-flush.yml

Sends "flush_all" to memcached with the help of nc.