Migration Toolkit for Virtualization (MTV) operator version is higher than the supported OpenShift Cluster version

Solution Verified - Updated

Environment

  • Red Hat OpenShift Container Platform (RHOCP)
    • < 4.18
  • Migration Toolkit for Virtualization 2.x.

Issue

Due to the incident documented in Red Hat Operator has version higher than the cluster version
, the Migration Toolkit for Virtualization (MTV) operator may have been upgraded to a version higher than what is supported by the current OpenShift Container Platform (RHOCP) cluster version.

Resolution

Since the MTV operator uses y-stream release channels for subscriptions, it does not automatically upgrade to a newer major version. However, if an administrator manually selected a newer channel and upgraded during the brief incident window, the unsupported version must be uninstalled. After uninstalling, reinstall the operator using a version supported by your cluster.

Steps
Ideally, use the OpenShift console's OperatorHub to uninstall the MTV Operator. If CLI is preferred:

Note: replace the namespace in all commands with your actual namespace where MTV Operator is installed.

  1. Get your currently installed version of MTV Operator
oc get sub,csv,installplan -n openshift-mtv
  1. Delete your subscription
oc delete subscription mtv-operator -n openshift-mtv
  1. Delete the operator CSV
    Note: replace the CSV name with your actual CSV name
oc delete csv mtv-operator.v2.10.5 -n openshift-mtv
  1. Delete the operator's ForkliftController resource
    Note: replace the forklift-controller name with your actual FC CR name
oc delete forkliftcontrollers.forklift.konveyor.io forklift-controller -n openshift-mtv

Note: operator's pod workloads will be running even after the FC removal and they will be replaced once you install new operator version.

  1. Recreate the operator subscription from the one of the supported operator versions, e.g. using the OpenShift console's OperatorHub. Ideally, disable automatic install plan approvals and verify the installation.

Root Cause

The incident incorrectly exposed the following MTV operator channels to older, unsupported OCP versions:

  • release-v2.10 was visible on OCP 4.12 through 4.17
  • release-v2.9 was visible on OCP 4.12 through 4.16
  • release-v2.8 was visible on OCP 4.12 through 4.15

Diagnostic Steps

Run the following command to identify the current version of the MTV operator:

# oc get csv -n openshift-mtv|grep "Migration Toolkit for Virtualization Operator"

Compare the installed MTV version with the supported versions for your cluster using the compatibility guidelines below:

SBR
Product(s)
Components
Category

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.