Chapter 3. Container-native virtualization installation

Procedure

1. Open a browser window and log in to the OpenShift Container Platform web console.
2. Navigate to the Operators OperatorHub page.
3. Search for OpenShift Virtualization and then select it.
4. Read the information about the Operator and click Install.

5. On the Create Operator Subscription page:

   1. For Installed Namespace, ensure that the Operator recommended namespace option is selected. This installs the Operator in the mandatory openshift-cnv namespace, which is automatically created if it does not exist.

      Warning

      Attempting to install the container-native virtualization Operator in a namespace other than openshift-cnv causes the installation to fail.

   2. Select 2.3 from the list of available Update Channel options.
   3. For Approval Strategy, ensure that Automatic, which is the default value, is selected. Container-native virtualization automatically updates when a new z-stream release is available.

6. Click Subscribe to make the Operator available to the openshift-cnv namespace.

   On the Installed Operators screen, the Status displays Succeeded when container-native virtualization finishes installation.

Procedure

1. Navigate to the Operators Installed Operators page.
2. Click OpenShift Virtualization.

3. Click the CNV Operator Deployment tab and click Create HyperConverged Cluster.

   Warning

   To avoid deployment errors, do not rename the custom resource. Before you proceed to the next step, ensure that the custom resource is named the default kubevirt-hyperconverged.

4. View the YAML to ensure that BareMetalPlatform: true. If necessary, change the value from false to true before continuing.
5. Click Create to launch container-native virtualization.
6. 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 openshift-cnv from the Projects list.
2. Navigate to the Operators Installed Operators page.
3. Click OpenShift Virtualization.
4. Click the CNV Operator Deployment tab.
5. Click the Options menu in the row containing the kubevirt-hyperconverged custom resource. In the expanded menu, click Delete HyperConverged Cluster.
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 resources by running the following command:

   $ oc delete apiservices v1alpha3.subresources.kubevirt.io -n openshift-cnv

Procedure

1. Navigate to the Operators OperatorHub page.
2. Search for OpenShift Virtualization and then select it.
3. Click Uninstall.

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 .
4. When the Delete Namespace pane opens, enter the name of the namespace that you want to delete in the field.
5. Click Delete.