Apply patch updates using RPMs

Updating MicroShift on non rpm-ostree systems such as Red Hat Enterprise Linux (RHEL) requires downloading then updating the RPMs. For example, use the following procedure to upgrade from 4.20.1 to 4.20.2.

Warning

Keeping component versions in a supported configuration of Red Hat Device Edge can require updating MicroShift and RHEL at the same time. Ensure that your version of RHEL is compatible with the version of MicroShift you are updating to, especially if you are updating MicroShift across two minor versions. Otherwise, you can create an unsupported configuration, break your node, or both. For more information, see the following link:

Note

You cannot downgrade MicroShift with this process. Downgrades are not supported.

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 to upgrade to the version you are preparing to use.

  • You have verified that your host operating system is compatible with the version of MicroShift you are preparing to install.

  • You have completed a system backup.

Procedure
  1. Update the MicroShift RPMs by running the following command:

    $ sudo dnf update microshift
  2. Restart MicroShift by running the following command:

    $ sudo systemctl restart microshift
    Note

    The greenboot system health check runs on this update type, but does not perform any actions. If the update fails, an error message appears with the instruction to check the logs.