Chapter 2. Updating RPMs on an OSTree system
Updating MicroShift on an rpm-ostree system such as Red Hat Enterprise Linux for Edge (RHEL for Edge) requires building a new RHEL for Edge image containing the new version of MicroShift and any associated optional RPMs. After you have the rpm-ostree image with MicroShift embedded, direct your system to boot into that operating system image.
The procedures are the same for minor-version and patch updates. For example, use the same steps to upgrade from 4.16 to 4.17 or from 4.17.2 to 4.17.3.
Downgrades other than automatic rollbacks are not supported. The following procedure is for updates only.
2.1. Applying updates on an rpm-ostree system
To update MicroShift on an rpm-ostree system such as Red Hat Enterprise Linux for Edge (RHEL for Edge), embed the new version of MicroShift on a new operating system image.
- Back up and system rollback are automatic with this update type.
- You can also use this workflow to update applications running in the MicroShift cluster. Ensure compatibility between the application and the adjacent versions of MicroShift and RHEL for Edge before starting an update.
The steps you use depends on how your existing deployment is set up. The following procedure outlines the general steps you can take, with links to the RHEL for Edge documentation. The RHEL for Edge documentation is your resource for specific details on building an updated operating system image.
Prerequisites
- The system requirements for installing MicroShift have been met.
- You have root user access to the host.
- The version of MicroShift you have is compatible with the RHEL for Edge image you are preparing to use.
You cannot downgrade MicroShift with this process. Downgrades other than automatic rollbacks are not supported.
Procedure
Create an image builder configuration file for adding the
rhocp-4.17RPM repository source required to pull MicroShift RPMs by running the following command:$ cat > rhocp-4.17.toml <<EOF id = "rhocp-4.17" name = "Red Hat OpenShift Container Platform 4.17 for RHEL 9" type = "yum-baseurl" url = "https://cdn.redhat.com/content/dist/layered/rhel9/$(uname -m)/rhocp/4.17/os" check_gpg = true check_ssl = true system = false rhsm = true EOF
Add the update RPM source to the image builder by running the following command:
$ sudo composer-cli sources add rhocp-4.17.toml
Build a new image of RHEL for Edge that contains the new version of MicroShift. To determine the steps required, use the following documentation:
Update the host to use the new image of RHEL for Edge. To determine the steps required, use the following documentation:
Reboot the host to apply updates by running the following command:
$ sudo systemctl reboot
