Contact Us 1-800-596-4880
  1. Homepage
  2. Runtime Fabric (3.0)
  3. Setting Up Runtime Fabric
  4. Upgrading Runtime Fabric

  5. Upgrading Runtime Fabric on OpenShift

Upgrading Runtime Fabric on OpenShift

Red Hat OpenShift console allows you to run upgrades automatically (default) or manually. You can change this setting in the Subscription tab in the Runtime Fabric Operator.

Starting with Runtime Fabric agent version 2.4.0, for any new Mule app deployment, you must use a Mule runtime image built on Aug 8, 2023, or later.

Before You Upgrade

Before you upgrade Runtime Fabric on Red Hat OpenShift, make sure that:

  • Your cluster runs a Kubernetes version that the target Runtime Fabric version supports. For the supported Kubernetes versions for each release, see Runtime Fabric Release Notes.

    To check the Kubernetes version of your cluster, run this command in your terminal:

    oc version

    If OperatorHub doesn’t offer a newer Runtime Fabric operator, your cluster’s Kubernetes version might be lower than the minimum version that the newer operator supports. Upgrade your OpenShift cluster, and then upgrade Runtime Fabric.

  • If you use a local registry, you have synchronized the images for the target Runtime Fabric version. If an image is missing, the upgrade stalls. See Synchronize Runtime Fabric Core Software Images.

  • You don’t edit component versions in the Runtime Fabric agent ConfigMap or in app-config manually. The operator manages these values and overwrites manual changes.

Upgrade Runtime Fabric on Red Hat OpenShift

To upgrade Runtime Fabric on Red Hat OpenShift, use the Runtime Fabric operator in the Red Hat OpenShift console.

  1. In the Red Hat OpenShift console, navigate to Operators > Installed Operators.

  2. Select the Runtime Fabric operator.

  3. Click Upgrade.

Upgrade to an Intermediate Runtime Fabric on Red Hat OpenShift

To upgrade to an intermediate Runtime Fabric OpenShift operator, you need to uninstall the previous version and install the intermediate version:

  1. From the OpenShift console, uninstall the Runtime Fabric operator, without deleting or uninstalling Runtime Fabric instances or clusters.

  2. On the OpenShift console find the Runtime Fabric operator in the Operator Hub and install the desired version.

This automatically triggers the upgrade of the existing Runtime Fabric instances.

Verify the Upgrade

To verify the upgrade, run these commands in your terminal:

  1. Check that the operator version is the target version and that its phase is Succeeded:

    oc get csv -n <rtf_namespace>

  2. Check that the Runtime Fabric pods are running and ready:

    oc get pods -n <rtf_namespace>

See Also