openstack-ansible/doc/source/install-guide/app-minorupgrade.rst

Home OpenStack-Ansible Installation Guide

Appendix C. Minor Upgrades

Upgrades between minor versions of OpenStack-Ansible are handled by simply updating the repository clone to the latest tag, then executing playbooks against the target hosts.

A minor upgrade will typically require the execution of the following:

1. Change directory into the repository clone root directory

   # cd /opt/openstack-ansible

2. Update the git remotes

   # git fetch --all

3. Checkout the latest tag (the below tag is an example)

   # git checkout 13.0.1

4. Update all the dependent roles to the latest versions

   # ./scripts/bootstrap-ansible.sh

5. Change into the playbooks directory

   # cd playbooks

6. Update the Hosts

   # openstack-ansible setup-hosts.yml

7. Update the Infrastructure

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

8. Update all OpenStack Services

   # openstack-ansible setup-openstack.yml

Note that if you wish to scope the upgrades to specific OpenStack components then each of the component playbooks may be executed and scoped using groups. For example:

1. Update only the Compute Hosts

   # openstack-ansible os-nova-install.yml --limit nova_compute

2. Update only a single Compute Host. Note that skipping the 'nova-key' tag is

   necessary as the keys on all compute hosts will not be gathered.

   # openstack-ansible os-nova-install.yml --limit <node-name> \
       --skip-tags 'nova-key'

If you wish to see which hosts belong to which groups, the inventory-manage.py script will show all groups and their hosts. For example:

1. Change directory into the repository clone root directory

   # cd /opt/openstack-ansible

2. Show all groups and which hosts belong to them

   # ./scripts/inventory-manage.py -G

3. Show all hosts and which groups they belong to

   # ./scripts/inventory-manage.py -g

You may also see which hosts a playbook will execute against, and which tasks will be executed:

1. Change directory into the repository clone playbooks directory

   # cd /opt/openstack-ansible/playbooks

2. See the hosts in the nova_compute group which a playbook will execute against

   # openstack-ansible os-nova-install.yml --limit nova_compute \
                                           --list-hosts

3. See the tasks which will be executed on hosts in the nova_compute group

   # openstack-ansible os-nova-install.yml --limit nova_compute \
                                           --skip-tags 'nova-key' \
                                           --list-tasks

---