Uninstalling OKD Virtualization

    You uninstall OKD Virtualization by using the to perform the following tasks:

    1. Delete the HyperConverged CR.

    2. .

    3. Delete the openshift-cnv namespace.

    4. .

    To uninstall OKD Virtualization, you first delete the custom resource (CR).

    Prerequisites

    • You have access to an OKD cluster using an account with cluster-admin permissions.

    Procedure

    1. Navigate to the Operators → Installed Operators page.

    2. Select the OKD Virtualization Operator.

    3. Click the Options menu beside kubevirt-hyperconverged and select Delete HyperConverged.

    4. Click Delete in the confirmation window.

    Cluster administrators can delete installed Operators from a selected namespace by using the web console.

    • You have access to an OKD cluster web console using an account with cluster-admin permissions.

    Procedure

    1. Navigate to the Operators → Installed Operators page.

    2. Scroll or enter a keyword into the Filter by name field to find the Operator that you want to remove. Then, click on it.

    3. On the right side of the Operator Details page, select Uninstall Operator from the Actions list.

      An Uninstall Operator? dialog box is displayed.

    4. Select Uninstall to remove the Operator, Operator deployments, and pods. Following this action, the Operator stops running and no longer receives updates.

      This action does not remove resources managed by the Operator, including custom resource definitions (CRDs) and custom resources (CRs). Dashboards and navigation items enabled by the web console and off-cluster resources that continue to run might need manual clean up. To remove these after uninstalling the Operator, you might need to manually delete the Operator CRDs.

    You can delete a namespace by using the OKD web console.

    Prerequisites

    • You have access to an OKD cluster using an account with cluster-admin permissions.

    Procedure

    1. Navigate to Administration → Namespaces.

    2. Locate the namespace that you want to delete in the list of namespaces.

    3. On the far right side of the namespace listing, select Delete Namespace from the Options menu kebab.

    4. When the Delete Namespace pane opens, enter the name of the namespace that you want to delete in the field.

    5. Click Delete.

    You can delete the OKD Virtualization custom resource definitions (CRDs) by using the web console.

    Procedure

    1. Navigate to Administration → CustomResourceDefinitions.

    2. Select the Label filter and enter operators.coreos.com/kubevirt-hyperconverged.openshift-cnv in the Search field to display the OKD Virtualization CRDs.

    3. Click the Options menu beside each CRD and select Delete CustomResourceDefinition.

    Uninstalling OKD Virtualization by using the CLI

    You can uninstall OKD Virtualization by using the .

    Prerequisites

    • You have access to an OKD cluster using an account with cluster-admin permissions.

    • You have installed the OpenShift CLI (oc).

    • You have deleted all virtual machines, , and data volumes. You cannot uninstall OKD Virtualization while its workloads remain on the cluster.

    Procedure

    1. Delete the HyperConverged custom resource:

    2. Delete the OKD Virtualization Operator subscription:

      1. $ oc delete subscription kubevirt-hyperconverged -n openshift-cnv

    3. Delete the OKD Virtualization resource:

    4. List the OKD Virtualization custom resource definitions (CRDs) by running the oc delete crd command with the dry-run option:

      1. $ oc delete crd --dry-run=client -l operators.coreos.com/kubevirt-hyperconverged.openshift-cnv

      Example output

    5. Delete the CRDs by running the oc delete crd command without the option: