Chapter 1. About MicroShift updates
Upgrades are supported on MicroShift beginning with the General Availability version 4.14. Supported upgrades include those from one minor version to the next in sequence, for example, from 4.14 to 4.15. Patch updates are also supported from z-stream to z-stream, for example 4.14.1 to 4.14.2.
1.1. Understanding MicroShift updates
MicroShift updates are supported on both rpm-ostree edge-deployed hosts and non-OSTree hosts. You can complete updates using the following methods:
-
Embed the latest version of MicroShift in a new
rpm-ostreesystem image such as Red Hat Enterprise Linux for Edge (RHEL for Edge). See * Applying updates on an OSTree system - Manually update the RPMs on a non-OSTree system such as Red Hat Enterprise Linux (RHEL). See * Applying updates manually with RPMs
Only rpm-ostree updates include automatic rollbacks.
1.1.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 must build a new rpm-ostree image and embed the new MicroShift version in that image. 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.
Check following compatibility table for details:
Red Hat Device Edge release compatibility matrix
The two products of Red Hat Device Edge work together as a single solution for device-edge computing. To successfully pair your products, use the verified releases together for each as listed in the following table:
| RHEL for Edge Version | MicroShift Version | MicroShift Release Status | MicroShift Supported Updates |
| 9.2, 9.3 | 4.14 | Generally Available | 4.14.0→4.14.z and 4.14→4.15 |
| 9.2 | 4.13 | Technology Preview | None |
| 8.7 | 4.12 | Developer Preview | None |
1.1.2. Manual RPM updates
You can use the manual RPM update path to replace your existing version of MicroShift. The versions of RHEL and MicroShift must be compatible. Ensuring system health and completing additional system backups are manual processes.
1.2. Checking version update path
Before attempting an update of either Red Hat Device Edge component, determine which versions of MicroShift and RHEL for Edge or RHEL you have installed. Plan for the versions of each that you intend to use.
MicroShift update paths
- Generally Available Version 4.14 to 4.14.z on RHEL for Edge 9.2 or 9.3
- Generally Available Version 4.14 to 4.14.z on RHEL 9.2 or 9.3
