Chapter 3. Upgrading the Undercloud

Procedure

1. Log in to director as the stack user.

2. Disable the current OpenStack Platform repository:

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

   Copy to Clipboard Toggle word wrap

3. Set the RHEL version to RHEL 7.9:

   $ sudo subscription-manager release --set=7.9

   Copy to Clipboard Toggle word wrap

4. Enable the new OpenStack Platform repository:

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

   Copy to Clipboard Toggle word wrap

5. Re-enable updates to the overcloud base images:

   $ sudo yum-config-manager --setopt=exclude= --save

   Copy to Clipboard Toggle word wrap

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

   $ sudo yum update -y python-tripleoclient

   Copy to Clipboard Toggle word wrap

7. Run the following command to upgrade the undercloud:

   $ openstack undercloud upgrade

   Copy to Clipboard Toggle word wrap
8. Wait until the undercloud upgrade process completes.

9. Reboot the undercloud to update the operating system’s kernel and other system packages:

   $ sudo reboot

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

Procedure

1. Source the undercloud access details:

   $ source ~/stackrc

   Copy to Clipboard Toggle word wrap

2. 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

3. Extract the archives:

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

   Copy to Clipboard Toggle word wrap

4. Import the latest images into the director:

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

   Copy to Clipboard Toggle word wrap

5. 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

6. 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 (pike). 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/osp13

   Copy to Clipboard Toggle word wrap

3. Move the previous version into its own directory:

   $ mv /tmp/osp13/compat /tmp/osp12

   Copy to Clipboard Toggle word wrap

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

   $ diff -urN /tmp/osp12 /tmp/osp13

   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.