Alexandra 3bb1c40f72 DOCS: Clean up of the Newton upgrade guide
Forming to conventions applied in the install guide.
This cleans up RST, spelling, and grammar fixes.

Change-Id: Ieeb678bffc2b59a29e05528cc3d908b036e6c1a8
(cherry picked from commit 29ec1bad24946bf86dfc656f47ab90665bb6fd2f)
2016-05-26 10:22:27 +01:00

2.3 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