Chapter 14. Uninstalling the Migration Toolkit for Virtualization


You can uninstall the Migration Toolkit for Virtualization (MTV) by using the Red Hat OpenShift web console or the command-line interface (CLI).

14.1. Uninstalling MTV by using the Red Hat OpenShift web console

You can uninstall Migration Toolkit for Virtualization (MTV) by using the Red Hat OpenShift web console.

Prerequisites

  • You must be logged in as a user with cluster-admin privileges.

Procedure

  1. In the Red Hat OpenShift web console, click Operators > Installed Operators.
  2. Click Migration Toolkit for Virtualization Operator.

    The Operator Details page opens in the Details tab.

  3. Click the ForkliftController tab.
  4. Click Actions and select Delete ForkLiftController.

    A confirmation window opens.

  5. Click Delete.

    The controller is removed.

  6. Open the Details tab.

    The Create ForkliftController button appears instead of the controller you deleted. There is no need to click it.

  7. On the upper-right side of the page, click Actions and select Uninstall Operator.

    A confirmation window opens, displaying any operand instances.

  8. To delete all instances, select the Delete all operand instances for this operator checkbox. By default, the checkbox is cleared.

    Important

    If your Operator configured off-cluster resources, these will continue to run and will require manual cleanup.

  9. Click Uninstall.

    The Installed Operators page opens, and the Migration Toolkit for Virtualization Operator is removed from the list of installed Operators.

  10. Click Home > Overview.
  11. In the Status section of the page, click Dynamic Plugins.

    The Dynamic Plugins popup opens, listing forklift-console-plugin as a failed plugin. If the forklift-console-plugin does not appear as a failed plugin, refresh the web console.

  12. Click forklift-console-plugin.

    The ConsolePlugin details page opens in the Details tab.

  13. On the upper right-hand side of the page, click Actions and select Delete ConsolePlugin from the list.

    A confirmation window opens.

  14. Click Delete.

    The plugin is removed from the list of Dynamic plugins on the Overview page. If the plugin still appears, restart the Overview page.

14.2. Uninstalling MTV from the command line

You can uninstall Migration Toolkit for Virtualization (MTV) from the command line.

Note

This action does not remove resources managed by the MTV Operator, including custom resource definitions (CRDs) and custom resources (CRs). To remove these after uninstalling the MTV Operator, you might need to manually delete the MTV Operator CRDs.

Prerequisites

  • You must be logged in as a user with cluster-admin privileges.

Procedure

  1. Delete the forklift controller by running the following command:

    $ oc delete ForkliftController --all -n openshift-mtv
    Copy to clipboard
  2. Delete the subscription to the MTV Operator by running the following command:

    $ oc get subscription -o name|grep 'mtv-operator'| xargs oc delete
    Copy to clipboard
  3. Delete the clusterserviceversion for the MTV Operator by running the following command:

    $ oc get clusterserviceversion -o name|grep 'mtv-operator'| xargs oc delete
    Copy to clipboard
  4. Delete the plugin console CR by running the following command:

    $ oc delete ConsolePlugin forklift-console-plugin
    Copy to clipboard
  5. Optional: Delete the custom resource definitions (CRDs) by running the following command:

    oc get crd -o name | grep 'forklift.konveyor.io' | xargs oc delete
    Copy to clipboard
  6. Optional: Perform cleanup by deleting the MTV project by running the following command:

    oc delete project openshift-mtv
    Copy to clipboard
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat, Inc.