Install OpenShift Virtualization to add virtualization functionality to your OpenShift Container Platform cluster.
You can use the OpenShift Container Platform 4.6 web console to subscribe to and deploy the OpenShift Virtualization Operators.
Install OpenShift Container Platform 4.6 on your cluster.
Log in as a user with
Before you install OpenShift Virtualization, subscribe to the
OpenShift Virtualization catalog from the OpenShift Container Platform web console.
Subscribing gives the
openshift-cnv namespace access to the OpenShift Virtualization
Open a browser window and log in to the OpenShift Container Platform web console.
Navigate to the Operators → OperatorHub page.
Search for OpenShift Virtualization and then select it.
Read the information about the Operator and click Install.
On the Install Operator page:
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.
Attempting to install the OpenShift Virtualization Operator in a namespace other than
Select stable from the list of available Update Channel options. This ensures that you install the version of OpenShift Virtualization that is compatible with your OpenShift Container Platform version.
For Approval Strategy, ensure that Automatic, which is the default value, is selected. OpenShift Virtualization automatically updates when a new z-stream release is available.
Click Install to make the Operator available to the
On the Installed Operators screen, the Status displays Succeeded when OpenShift Virtualization finishes installation.
After subscribing to the OpenShift Virtualization catalog, create the OpenShift Virtualization Operator Deployment custom resource to deploy OpenShift Virtualization.
Subscribe to the OpenShift Virtualization catalog in the
Navigate to the Operators → Installed Operators page.
Click OpenShift Virtualization.
Click the OpenShift Virtualization Operator Deployment tab and click Create HyperConverged Cluster.
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
Click Create to launch OpenShift Virtualization.
Navigate to the Workloads → Pods page and monitor the OpenShift Virtualization pods until they are all Running. After all the pods display the Running state, you can access OpenShift Virtualization.
You might want to additionally configure the following components:
The KubeMacPool component provides a MAC address pool service for virtual machine NICs in designated namespaces. Enable a MAC address pool in a namespace by applying the KubeMacPool label to that namespace.
The hostpath provisioner is a local storage provisioner designed for OpenShift Virtualization. If you want to configure local storage for virtual machines, you must enable the hostpath provisioner first.