Chapter 1. Update options with Red Hat build of MicroShift and Red Hat Device Edge Updates are supported on Red Hat build of MicroShift beginning with the General Availability version 4.14. 1.1. Red Hat Device Edge updates You can update Red Hat Enterprise Linux for Edge (RHEL for Edge) images or Red Hat Enterprise Linux (RHEL) with or without updating the Red Hat build of MicroShift version if the version combination is supported. See the following table for details: Red Hat Device Edge release compatibility matrix Red Hat Enterprise Linux (RHEL) and MicroShift work together as a single solution for device-edge computing. You can update each component separately, but the product versions must be compatible. Supported configurations of Red Hat Device Edge use verified releases for each together as listed in the following table: RHEL Version(s) MicroShift Version Supported MicroShift Version -> Version Updates 9.4 4.18 4.18.0 -> 4.18.z 9.4 4.17 4.17.1 -> 4.17.z, 4.17 -> 4.18 9.4 4.16 4.16.0 -> 4.16.z, 4.16 -> 4.17, 4.16 -> 4.18 9.2, 9.3 4.15 4.15.0 -> 4.15.z, 4.15 -> 4.16 on RHEL 9.4 9.2, 9.3 4.14 4.14.0 -> 4.14.z, 4.14 -> 4.15, 4.14 -> 4.16 on RHEL 9.4 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 cluster, or both. For more information, see the Red Hat Device Edge release compatibility matrix . 1.2. Standalone MicroShift updates Consider the following when planning to update MicroShift: You can potentially update MicroShift without reinstalling your applications and Operators. RHEL or RHEL for Edge updates are only required to update MicroShift if the existing operating system is not compatible with the new version of MicroShift that you want to use. MicroShift operates as an in-place update and does not require removal of the version. Data backups beyond those required for the usual functioning of your applications are also not required. Note Only rpm-ostree updates include automatic rollbacks. 1.2.1. RPM-OSTree updates Using the RHEL for Edge rpm-ostree update path allows for automated backup and system rollback in case any part of the update fails. You can update MicroShift on an rpm-ostree system such as RHEL for Edge by building a new system image containing the new version of MicroShift. The rpm-ostree image can be the same version or an updated version, but the versions of RHEL for Edge and MicroShift must be compatible. The following features are available in the RHEL for Edge update path: The system automatically rolls back to a healthy system state if the update fails. Applications do not need to be reinstalled. Operators do not need to be reinstalled. You can update an application without updating MicroShift using this update type. The image you build can contain other updates as needed. To begin a MicroShift update by embedding in a RHEL for Edge image, use the procedures in the following documentation: Applying updates on an OSTree system To understand more about Greenboot, see the following documentation: The Greenboot health check Greenboot workload health check scripts 1.2.2. Manual RPM updates You can update MicroShift manually on a non-OSTree system such as Red Hat Enterprise Linux (RHEL) by updating the RPMs. To complete this update type, use the subscription manager to enable the repository that contains the new RPMs. Use manual processes to ensure system health and complete additional system backups. To begin a manual RPM update, use the procedures in the following documentation: About updating MicroShift RPMs manually 1.2.2.1. Keeping MicroShift and RHEL in a supported configuration When using RPM updates, avoid creating an unsupported configuration or breaking your cluster by carefully managing your RHEL repositories. Prerequisites You understand the support status of the version of MicroShift you are using. You have root-user access to your build host. You reviewed the Red Hat Device Edge release compatibility matrix . Procedure Avoid unintended updates by locking your operating system version by running the following command: USD sudo subscription-manager release --set=<x.y> 1 1 Replace <x.y> with the major and minor version of your compatible RHEL system. For example, 9.4 . Update both MicroShift and RHEL versions by running the following command: USD sudo subscription-manager release --set=<9.4> command. 1 1 Replace <9.4> with the major and minor version of your compatible RHEL system. If you are using an EUS MicroShift release, disable the RHEL standard-support-scope repositories by running the following command: USD sudo subscription-manager repos \ --disable=rhel-<9>-for-x86_64-appstream-rpms \ 1 --disable=rhel-<9>-for-x86_64-baseos-rpms 1 Replace <9> with the major version of your compatible RHEL system. After you disable the standard-support repositories, enable the RHEL EUS repos by running the following command: USD sudo subscription-manager repos \ --enable rhel-<9>-for-x86_64-appstream-eus-rpms \ 1 --enable rhel-<9>-for-x86_64-baseos-eus-rpms` 1 Replace <9> with the major version of your compatible RHEL system. Verification List the repositories you have enabled for RHEL by running the following command: USD sudo subscription-manager repos --list-enabled Example output +----------------------------------------------------------+ Available Repositories in /etc/yum.repos.d/redhat.repo +----------------------------------------------------------+ Repo ID: rhel-9-for-x86_64-baseos-eus-rpms Repo Name: Red Hat Enterprise Linux 9 for x86_64 - BaseOS - Extended Update Support (RPMs) Repo URL: https://cdn.redhat.com/content/eus/rhel9/USDreleasever/x86_64/baseos/os Enabled: 1 Repo ID: rhel-9-for-x86_64-appstream-eus-rpms Repo Name: Red Hat Enterprise Linux 9 for x86_64 - AppStream - Extended Update Support (RPMs) Repo URL: https://cdn.redhat.com/content/eus/rhel9/USDreleasever/x86_64/appstream/os Enabled: 1 1.3. Standalone RHEL for Edge updates You can update RHEL for Edge or RHEL without updating MicroShift, on the condition that the two versions are compatible. Check compatibilities before beginning an update. Use the RHEL for Edge documentation specific to your update path. Additional resources Managing RHEL for Edge images 1.4. Simultaneous MicroShift and operating system updates You can update RHEL for Edge or RHEL and update MicroShift at the same time, on the condition that the versions are compatible. Use the following workflow: Check for compatibility before beginning an update. Use the RHEL for Edge and RHEL documentation specific to your update path to plan and update the operating system. Enable the correct MicroShift repository to ensure alignment between your RHEL and MicroShift versions. Use the MicroShift update type specific to your update path. Additional resources How to Access EUS Composing a customized RHEL system image Applying updates on an OSTree system Applying updates manually with RPMs The Greenboot system health check Greenboot workload scripts

Commands:
sudo subscription-manager release --set=<x.y> 1
sudo subscription-manager release --set=<9.4> command. 1
sudo subscription-manager repos --disable=rhel-<9>-for-x86_64-appstream-rpms \ 1 --disable=rhel-<9>-for-x86_64-baseos-rpms
sudo subscription-manager repos --enable rhel-<9>-for-x86_64-appstream-eus-rpms \ 1 --enable rhel-<9>-for-x86_64-baseos-eus-rpms`
sudo subscription-manager repos --list-enabled
+----------------------------------------------------------+ Available Repositories in /etc/yum.repos.d/redhat.repo +----------------------------------------------------------+ Repo ID: rhel-9-for-x86_64-baseos-eus-rpms Repo Name: Red Hat Enterprise Linux 9 for x86_64 - BaseOS - Extended Update Support (RPMs) Repo URL: https://cdn.redhat.com/content/eus/rhel9/USDreleasever/x86_64/baseos/os Enabled: 1 Repo ID: rhel-9-for-x86_64-appstream-eus-rpms Repo Name: Red Hat Enterprise Linux 9 for x86_64 - AppStream - Extended Update Support (RPMs) Repo URL: https://cdn.redhat.com/content/eus/rhel9/USDreleasever/x86_64/appstream/os Enabled: 1