Chapter 2. Updating the Undercloud
This process updates the undercloud and its overcloud images to the latest Red Hat OpenStack Platform 15 version.
2.1. Performing a minor update of a containerized undercloud
The director provides commands to update the packages on the undercloud node. This allows you to perform a minor update within the current version of your OpenStack Platform environment.
Procedure
-
Log into the director as the
stack
user. Run
dnf
to upgrade the director’s main packages:Copy to Clipboard Copied! Toggle word wrap Toggle overflow sudo dnf update -y python3-tripleoclient* openstack-tripleo-common openstack-tripleo-heat-templates
$ sudo dnf update -y python3-tripleoclient* openstack-tripleo-common openstack-tripleo-heat-templates
The director uses the
openstack undercloud upgrade
command to update the undercloud environment. Run the command:Copy to Clipboard Copied! Toggle word wrap Toggle overflow openstack undercloud upgrade
$ openstack undercloud upgrade
- Wait until the undercloud upgrade process completes.
Reboot the undercloud to update the operating system’s kernel and other system packages:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow sudo reboot
$ sudo reboot
- Wait until the node boots.
2.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.
Prerequisites
- You have updated the undercloud to the latest version.
Procedure
Source the
stackrc
file:Copy to Clipboard Copied! Toggle word wrap Toggle overflow source ~/stackrc
$ source ~/stackrc
Remove any existing images from the
images
directory on thestack
user’s home (/home/stack/images
):Copy to Clipboard Copied! Toggle word wrap Toggle overflow rm -rf ~/images/*
$ rm -rf ~/images/*
Extract the archives:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow cd ~/images for i in /usr/share/rhosp-director-images/overcloud-full-latest-15.0.tar /usr/share/rhosp-director-images/ironic-python-agent-latest-15.0.tar; do tar -xvf $i; done cd ~
$ cd ~/images $ for i in /usr/share/rhosp-director-images/overcloud-full-latest-15.0.tar /usr/share/rhosp-director-images/ironic-python-agent-latest-15.0.tar; do tar -xvf $i; done $ cd ~
Import the latest images into the director:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow openstack overcloud image upload --update-existing --image-path /home/stack/images/
$ openstack overcloud image upload --update-existing --image-path /home/stack/images/
Configure your nodes to use the new images:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow openstack overcloud node configure $(openstack baremetal node list -c UUID -f value)
$ openstack overcloud node configure $(openstack baremetal node list -c UUID -f value)
Verify the existence of the new images:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow openstack image list ls -l /httpboot
$ openstack image list $ ls -l /httpboot
When deploying overcloud nodes, ensure the Overcloud image version corresponds to the respective Heat template version. For example, only use the OpenStack Platform 15 images with the OpenStack Platform 15 Heat templates.
2.3. Undercloud Post-Upgrade Notes
-
If using a local set of core templates in your
stack
users home directory, ensure you update the templates using the recommended workflow in Using Customized Core Heat Templates. You must update the local copy before upgrading the overcloud.
2.4. Next Steps
The undercloud upgrade is complete. You can now update the overcloud.