×

Install OpenShift Virtualization to add virtualization functionality to your OpenShift Container Platform cluster.

You can use the OpenShift Container Platform 4.7 web console to subscribe to and deploy the OpenShift Virtualization Operators.

Installing the OpenShift Virtualization Operator

You can install the OpenShift Virtualization Operator from the OpenShift Container Platform web console.

Prerequisites
  • Install OpenShift Container Platform 4.7 on your cluster.

  • Log in to the OpenShift Container Platform web console as a user with cluster-admin permissions.

Procedure
  1. Open a browser window and log in to the OpenShift Container Platform web console.

  2. From the Administrator perspective, click OperatorsOperatorHub.

  3. In the Filter by keyword field, type OpenShift Virtualization.

  4. Select the OpenShift Virtualization tile.

  5. Read the information about the Operator and click Install.

  6. On the Install Operator page:

    1. 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.

      • When you update OpenShift Container Platform, OpenShift Virtualization automatically updates to the next minor version.

    2. 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 openshift-cnv causes the installation to fail.

    3. 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.

  7. Click Install to make the Operator available to the openshift-cnv namespace.

  8. When the Operator installs successfully, click Create HyperConverged.

  9. Optional: Configure Infra and Workloads node placement options for OpenShift Virtualization components.

  10. Click Create to launch OpenShift Virtualization.

Verification
  • Navigate to the WorkloadsPods page and monitor the OpenShift Virtualization pods until they are all Running. After all the pods display the Running state, you can use OpenShift Virtualization.

Next steps

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.