Chapter 3. Upgrading the Undercloud

Procedure

1. Log into the director as the stack user.

2. Disable the current OpenStack Platform repository:

   $ sudo subscription-manager repos --disable=rhel-7-server-openstack-11-rpms

   Copy to Clipboard Toggle word wrap

3. Enable the new OpenStack Platform repository:

   $ sudo subscription-manager repos --enable=rhel-7-server-openstack-12-rpms

   Copy to Clipboard Toggle word wrap

4. Run yum to upgrade the director’s main packages:

   $ sudo yum update -y python-tripleoclient

   Copy to Clipboard Toggle word wrap
5. Edit the /home/stack/undercloud.conf file and check that the enabled_drivers parameter does not contain the pxe_ssh driver. This driver is deprecated in favor of the Virtual Bare Metal Controller (VBMC) and removed from Red Hat OpenStack Platform. For information on switching pxe_ssh nodes to VBMC, see "Virtual Bare Metal Controller (VBMC)" in the Director Installation and Usage guide.

6. Run the following command to upgrade the undercloud:

   $ openstack undercloud upgrade

   Copy to Clipboard Toggle word wrap

   This command upgrades the director’s packages, refreshes the director’s configuration, and populates any settings that are unset since the version change. This command does not delete any stored data, such as Overcloud stack data or data for existing nodes in your environment.

7. Reboot the node:

   $ sudo reboot

   Copy to Clipboard Toggle word wrap
8. Wait until the node boots.

9. Check the status of all services:

   $ sudo systemctl list-units "openstack*" "neutron*" "openvswitch*"

   Copy to Clipboard Toggle word wrap
   Note

   It might take approximately 10 minutes for the openstack-nova-compute to become active after a reboot.

10. Verify the existence of your overcloud and its nodes:

    $ source ~/stackrc
    $ openstack server list
    $ openstack baremetal node list
    $ openstack stack list

    Copy to Clipboard Toggle word wrap

Procedure

1. Remove any existing images from the images directory on the stack user’s home (/home/stack/images):

   $ rm -rf ~/images/*

   Copy to Clipboard Toggle word wrap

2. Extract the archives:

   $ cd ~/images
   $ for i in /usr/share/rhosp-director-images/overcloud-full-latest-12.0.tar /usr/share/rhosp-director-images/ironic-python-agent-latest-12.0.tar; do tar -xvf $i; done
   $ cd ~

   Copy to Clipboard Toggle word wrap

3. Import the latest images into the director:

   $ openstack overcloud image upload --update-existing --image-path /home/stack/images/

   Copy to Clipboard Toggle word wrap

4. Configure your nodes to use the new images:

   $ openstack overcloud node configure $(openstack baremetal node list -c UUID -f value)

   Copy to Clipboard Toggle word wrap

5. Verify the existence of the new images:

   $ openstack image list
   $ ls -l /httpboot

   Copy to Clipboard Toggle word wrap

Procedure

1. Install the openstack-tripleo-heat-templates-compat package:

   $ sudo yum install openstack-tripleo-heat-templates-compat

   Copy to Clipboard Toggle word wrap

   This installs the previous templates in the compat directory of your Heat template collection (/usr/share/openstack-tripleo-heat-templates/compat) and also creates a link to compat named after the previous version (ocata). These templates are backwards compatible with the upgraded director, which means you can use the latest version of the director to install an overcloud of the previous version.

2. Create a temporary copy of the core Heat templates:

   $ cp -a /usr/share/openstack-tripleo-heat-templates /tmp/osp12

   Copy to Clipboard Toggle word wrap

3. Move the previous version into its own directory:

   $ mv /tmp/osp12/compat /tmp/osp11

   Copy to Clipboard Toggle word wrap

4. Perform a diff on the contents of both directories:

   $ diff -urN /tmp/osp11 /tmp/osp12

   Copy to Clipboard Toggle word wrap

   This shows the core template changes from one version to the next. These changes provide an idea of what should occur during the overcloud upgrade.