Chapter 3. Updating the Undercloud
This process updates the undercloud and its overcloud images to the latest Red Hat OpenStack Platform 16.1 version.
3.1. Performing a minor update of a containerized undercloud
Director provides commands to update the main packages on the undercloud node. This allows you to perform a minor update within the current version of your OpenStack Platform environment.
Log in to the director as the
dnfto upgrade the director main packages:
$ sudo dnf update -y python3-tripleoclient* openstack-tripleo-common openstack-tripleo-heat-templates tripleo-ansible ansible
The director uses the
openstack undercloud upgradecommand to update the undercloud environment. Run the command:
$ openstack undercloud upgrade
- Wait until the undercloud upgrade process completes.
Reboot the undercloud to update the operating system’s kernel and other system packages:
$ sudo reboot
- Wait until the node boots.
3.2. Updating the overcloud images
You need to replace your current overcloud images with new versions. The new images ensure the director can introspect and provision your nodes using the latest version of OpenStack Platform software.
- You have updated the undercloud to the latest version.
$ source ~/stackrc
Remove any existing images from the
imagesdirectory on the
stackuser’s home (
$ rm -rf ~/images/*
Extract the archives:
$ cd ~/images $ for i in /usr/share/rhosp-director-images/overcloud-full-latest-16.1.tar /usr/share/rhosp-director-images/ironic-python-agent-latest-16.1.tar; do tar -xvf $i; done $ cd ~
Import the latest images into the director:
$ openstack overcloud image upload --update-existing --image-path /home/stack/images/
Configure your nodes to use the new images:
$ openstack overcloud node configure $(openstack baremetal node list -c UUID -f value)
Verify the existence of the new images:
$ openstack image list $ ls -l /var/lib/ironic/httpboot
When deploying overcloud nodes, ensure the overcloud image version corresponds to the respective heat template version. For example, only use the OpenStack Platform 16.1 images with the OpenStack Platform 16.1 heat templates.
overcloud-full image replaces the old
overcloud-full image. If you made changes to the old image, you must repeat the changes in the new image, especially if you want to deploy new nodes in the future.
3.3. Undercloud Post-Upgrade Notes
If using a local set of core templates in your
stackusers home directory, ensure you update the templates using the recommended workflow in Using Customized Core Heat Templates in the Advanced Overcloud Customization guide. You must update the local copy before upgrading the overcloud.
3.4. Next Steps
The undercloud upgrade is complete. You can now update the overcloud.