Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 2. Updating RPMs on a RHEL for Edge system

You can update MicroShift on Red Hat Enterprise Linux for Edge (RHEL for Edge) by embedding the new version of MicroShift on a new operating system image.

2.1. MicroShift updates on an RHEL for Edge system
Copy link

Updating MicroShift on a Red Hat Enterprise Linux for Edge (RHEL for Edge) system requires building a new RHEL for Edge image containing the new version of MicroShift and any associated optional RPMs. After you create the rpm-ostree image with MicroShift embedded, you can 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.18 to 4.19 or from 4.19.2 to 4.19.3. The following details apply:

  • Back up and system rollback are automatic with this update type.
  • You can use the following workflow to update applications running in the MicroShift node. Ensure compatibilities between the application and the adjacent versions of MicroShift and RHEL for Edge before starting an update.

  • Downgrades other than automatic rollbacks are not supported. The following procedure is for updates only.

    Important

    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.

2.2. Applying updates on an RHEL for Edge system
Copy link

To update MicroShift on Red Hat Enterprise Linux for Edge (RHEL for Edge), embed the new version of MicroShift on a new 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.
Important

You cannot downgrade MicroShift with this process. Downgrades other than automatic rollbacks are not supported.

Procedure

  1. Create an image builder configuration file for adding the rhocp-4.19 RPM repository source required to pull MicroShift RPMs by running the following command: 

    $ cat > rhocp-4.19.toml <<EOF
id = "rhocp-4.19"
name = "Red Hat OpenShift Container Platform 4.19 for RHEL 9"
type = "yum-baseurl"
url = "https://cdn.redhat.com/content/dist/layered/rhel9/$(uname -m)/rhocp/4.19/os"
check_gpg = true
check_ssl = true
system = false
rhsm = true
EOF
    Copy to Clipboard Toggle word wrap

  2. Add the update RPM source to the image builder by running the following command: 

    $ sudo composer-cli sources add rhocp-4.19.toml
    Copy to Clipboard Toggle word wrap

  3. Build a new image of RHEL for Edge that contains the new version of MicroShift. To determine the steps required, use the following documentation:

  4. Update the host to use the new image of RHEL for Edge. To determine the steps required, use the following documentation:

  5. Reboot the host to apply updates by running the following command: 

    $ sudo systemctl reboot
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat