Files
openstack-ansible/doc/source/upgrade-guide/reference-scripts.rst
Jesse Pretorius 24e63abeb2 Fix 'D001 Line too long' documentation lint failures
Change-Id: I4522fe318541dac7f4ff4e45d72d4cd8869420ba
2016-07-13 21:32:31 +00:00

2.2 KiB

Scripts

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

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

run-upgrade.sh

This script controls the overall upgrade process for deployers choosing not to do so manually.

It provides the following environment variables:

  • SCRIPTS_PATH - path to the top level scripts directory
  • MAIN_PATH - openstack_ansible root directory.
  • UPGRADE_PLAYBOOKS - 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 Mitaka series.

migrate_openstack_vars.py

Upstream decisions influenced the change of some variable names in Newton. 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 of the form /etc/openstack_deploy.NEWTON/VARS_MIGRATED_file. For example, once the script has processed the file /etc/openstack_deploy/user_variables.yml, it creates /etc/openstack_deploy.NEWTON/VARS_MIGRATED_user_variables. This indicates to OpenStack-Ansible to skip this step on successive runs. The script itself does not check for this file.

The variable changes are shown in the following table.

Old Value

New Value

Called by config-change-playbook