Files
openstack-ansible/doc/source/upgrade-guide/reference-scripts.rst
daz 875c5e4e6e [docs] Revise upgrade guide structure
1. Move minor upgrade content from the install guide
to the upgrade guide
2. Revise the overview section to include minor upgrades
3. Restructure the upgrade guide for improved information flow
4. Add configure-keystone.rst to  the old install guide that was
accidently removed in https://review.openstack.org/#/c/328095/

Change-Id: I602ef4a4f95f5ff46ee9b9eaaaa6ccdfd637d1dc
Implements: blueprint osa-install-guide-overhaul
2016-06-16 14:46:55 +10: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