Chapter 1. Container-native virtualization installation

Procedure

1. Create the kubevirt-hyperconverged namespace by running the following command:

   $ oc new-project kubevirt-hyperconverged

2. Create the OperatorGroup and CatalogSource in the kubevirt-hyperconverged namespace by running the following command:

   cat <<EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1alpha2
   kind: OperatorGroup
   metadata:
     name: hco-operatorgroup
     namespace: kubevirt-hyperconverged
   ---
   apiVersion: operators.coreos.com/v1alpha1
   kind: CatalogSource
   metadata:
     name: hco-catalogsource
     namespace: openshift-operator-lifecycle-manager
     imagePullPolicy: Always
   spec:
     sourceType: grpc
     image: registry.redhat.io/container-native-virtualization/hco-bundle-registry:v2.0.0
     displayName: KubeVirt HyperConverged
     publisher: Red Hat
   EOF

Procedure

1. Open a browser window and navigate to the OpenShift Container Platform web console.
2. Select the kubevirt-hyperconverged project from the Projects list.
3. Navigate to the Catalog Operator Management page.
4. In the Operator Catalogs tab, locate KubeVirt HyperConverged Cluster Operator and click Create Subscription.
5. Click Create to launch the container-native virtualization Operators.

Procedure

1. Navigate to the Catalog Installed Operators page.
2. Click KubeVirt HyperConverged Cluster Operator.
3. Click the KubeVirt HyperConverged Cluster Operator Deployment tab and click Create HyperConverged.
4. Click Create to launch container-native virtualization.
5. Navigate to the Workloads Pods page and monitor the container-native virtualization Pods until they are all Running. After all the Pods display the Running state, you can access container-native virtualization.

Procedure

1. From the OpenShift Container Platform web console, select kubevirt-hyperconverged from the Projects list.
2. Navigate to the Catalog Installed Operators page.
3. Click KubeVirt HyperConverged Cluster Operator.
4. Click the KubeVirt HyperConverged Cluster Operator Deployment tab.
5. Click the Options menu in the row containing the kubevirt-hyperconverged custom resource. In the expanded menu, click Delete HyperConverged.
6. Click Delete in the confirmation window.
7. Navigate to the Workloads Pods page to verify that only the Operator Pods are running.

8. Open a terminal window and clean up the remaining KubeVirt resources by running the following command:

   $ oc delete apiservices v1alpha3.subresources.kubevirt.io -n kubevirt-hyperconverged

   Note

   Because some KubeVirt resources are currently improperly retained, you must manually remove them. These resources will be removed automatically after (BZ1712429) is resolved.

Procedure

1. From the OpenShift Container Platform web console, select kubevirt-hyperconverged from the Projects list.
2. Navigate to the Catalog Operator Management page.
3. Click the Operator Subscriptions tab.
4. Click the Options menu in the row that contains the hco-subscription subscription. In the expanded menu, click Remove Subscription.
5. Ensure that the Also completely remove the Operator from the selected namespace check box is selected. If it is not selected, Operator Pods will remain in Workloads Pods when the subscription is removed.
6. Confirm that you want to remove the subscription by clicking Remove again.

Procedure

1. Navigate to Home Projects.
2. Locate the project that you want to delete from the list of projects.
3. On the far right side of the project listing, select Delete Project from the menu. If you do not have permissions to delete the project, the Delete Project option is grayed out and the option is not clickable.