openstack/openstack-ansible
Code Issues Proposed changes
0ce0b6506c
openstack-ansible/doc/source/reference/upgrades/reference-scripts.rst
Jean-Philippe Evrard d5937a519f [Docs] Move the upgrade reference into reference 
Now that the upgrade should have moved to the operations guide,
the upgrade reference should head in th reference guide.

In order to accomodate the new data into reference, the reference
landing page now links to both inventory and upgrades.

Change-Id: Ieb3eb0627854b80a7fed532702b77a7ec9a36e64
2018-02-19 15:57:21 +00:00

1.7 KiB
Raw Blame History

Major Upgrade Scripts

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

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

run-upgrade.sh

The run-upgrade.sh script controls the overall upgrade process for deployers who do not want to upgrade manually. It provides the following environment variables:

  • SCRIPTS_PATH - The path to the top level scripts directory
  • MAIN_PATH - The openstack_ansible root directory.
  • UPGRADE_PLAYBOOKS - The path to the playbooks used in upgrading

The upgrade script also bootstraps OpenStack-Ansible (using bootstrap-ansible.sh) in order to provide the new role dependencies introduced in the series.

migrate_openstack_vars.py

Upstream decisions influenced the change of some variable names in . This script replaces any instances of these strings in the variable override files matching the pattern /etc/openstack_deploy/user_*.yml. Variable names within comments are updated.

This script creates files in the form VARS_MIGRATED_<filename> and places them in directory. For example, after the script processes the /etc/openstack_deploy/user_variables.yml file, it creates the VARS_MIGRATED_user_variables.yml file in the directory. This indicates to OpenStack-Ansible to skip this step on successive runs. The script itself does not check for this file.

This script is called by the config-change-playbook.