Chapter 10. Upgrading or uninstalling the Migration Toolkit for Virtualization

Procedure

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

2. Change the update channel to the correct release.

   See Changing the update channel for an Operator in the Red Hat OpenShift documentation.

3. Confirm that Upgrade status changes from Up to date to Upgrade available. If it does not, restart the CatalogSource pod:

   1. Note the catalog source, for example, redhat-operators.

   2. From the command line, retrieve the catalog source pod:

      $ oc get pod -n openshift-marketplace | grep <catalog_source>

   3. Delete the pod:

      $ oc delete pod -n openshift-marketplace <catalog_source_pod>

      Upgrade status changes from Up to date to Upgrade available.

      If you set Update approval on the Subscriptions tab to Automatic, the upgrade starts automatically.

4. If you set Update approval on the Subscriptions tab to Manual, approve the upgrade.

   See Manually approving a pending Operator upgrade in the Red Hat OpenShift documentation.

5. If you are upgrading from MTV 2.2 and have defined VMware source providers, edit the VMware provider by adding a VDDK init image. Otherwise, the update will change the state of any VMware providers to Critical. For more information, see Adding a VMware source provider.
6. If you mapped to NFS on the Red Hat OpenShift destination provider in MTV 2.2, edit the AccessModes and VolumeMode parameters in the NFS storage profile. Otherwise, the upgrade will invalidate the NFS mapping. For more information, see Customizing storage profiles.

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 pop-up 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 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.

Procedure

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

   $ oc delete ForkliftController --all -n openshift-mtv

2. Delete the subscription to the MTV Operator by running the following command:

   $ oc get subscription -o name|grep 'mtv-operator'| xargs oc delete

3. Delete the clusterserviceversion for the MTV Operator by running the following command:

   $ oc get clusterserviceversion -o name|grep 'mtv-operator'| xargs oc delete

4. Delete the plugin console CR by running the following command:

   $ oc delete ConsolePlugin forklift-console-plugin

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

6. Optional: Perform cleanup by deleting the MTV project by running the following command:

   oc delete project openshift-mtv