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
- In the Red Hat OpenShift web console, click Operators > Installed Operators.
Click Migration Toolkit for Virtualization Operator.
The Operator Details page opens in the Details tab.
- Click the ForkliftController tab.
Click Actions and select Delete ForkLiftController.
A confirmation window opens.
Click Delete.
The controller is removed.
Open the Details tab.
The Create ForkliftController button appears instead of the controller you deleted. There is no need to click it.
On the upper-right side of the page, click Actions and select Uninstall Operator.
A confirmation window opens, displaying any operand instances.
To delete all instances, select the Delete all operand instances for this operator checkbox. By default, the checkbox is cleared.
ImportantIf your Operator configured off-cluster resources, these will continue to run and will require manual cleanup.
Click Uninstall.
The Installed Operators page opens, and the Migration Toolkit for Virtualization Operator is removed from the list of installed Operators.
- Click Home > Overview.
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.
Click forklift-console-plugin.
The ConsolePlugin details page opens in the Details tab.
On the upper right-hand side of the page, click Actions and select Delete ConsolePlugin from the list.
A confirmation window opens.
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.
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
Delete the
forklift
controller by running the following command:oc delete ForkliftController --all -n openshift-mtv
Copy to clipboardCopied$ oc delete ForkliftController --all -n openshift-mtv
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 clipboardCopied$ oc get subscription -o name|grep 'mtv-operator'| xargs oc delete
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 clipboardCopied$ oc get clusterserviceversion -o name|grep 'mtv-operator'| xargs oc delete
Delete the plugin console CR by running the following command:
oc delete ConsolePlugin forklift-console-plugin
Copy to clipboardCopied$ oc delete ConsolePlugin forklift-console-plugin
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 clipboardCopiedoc get crd -o name | grep 'forklift.konveyor.io' | xargs oc delete
Optional: Perform cleanup by deleting the MTV project by running the following command:
oc delete project openshift-mtv
Copy to clipboardCopiedoc delete project openshift-mtv