Home OpenStack-Ansible Installation Guide

Appendix C: Minor upgrades

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

A minor upgrade typically requires 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

Scope upgrades to specific OpenStack components by executing each of the component playbooks 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

   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'
   

To see which hosts belong to which groups, the inventory-manage.py script shows 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:

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

To see which hosts a playbook will execute against, and to see which tasks will execute.

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 executes 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
   

---

• Documentation Home
• Installation Guide
• Upgrade Guide
• Developer Documentation