×

Install OKD Virtualization to add virtualization functionality to your OKD cluster.

You can use the OKD 4.12 web console to subscribe to and deploy the OKD Virtualization Operators.

Installing the OKD Virtualization Operator

You can install the OKD Virtualization Operator from the OKD web console.

Prerequisites
  • Install OKD 4.12 on your cluster.

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

Procedure
  1. From the Administrator perspective, click OperatorsOperatorHub.

  2. In the Filter by keyword field, type Virtualization.

  3. Select the {CNVOperatorDisplayName} tile with the Red Hat source label.

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

  5. On the Install Operator page:

    1. Select stable from the list of available Update Channel options. This ensures that you install the version of OKD Virtualization that is compatible with your OKD 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 OKD Virtualization Operator in a namespace other than openshift-cnv causes the installation to fail.

    3. For Approval Strategy, it is highly recommended that you select Automatic, which is the default value, so that OKD Virtualization automatically updates when a new version is available in the stable update channel.

      While it is possible to select the Manual approval strategy, this is inadvisable because of the high risk that it presents to the supportability and functionality of your cluster. Only select Manual if you fully understand these risks and cannot use Automatic.

      Because OKD Virtualization is only supported when used with the corresponding OKD version, missing OKD Virtualization updates can cause your cluster to become unsupported.

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

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

  8. Optional: Configure Infra and Workloads node placement options for OKD Virtualization components.

  9. Click Create to launch OKD Virtualization.

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

Next steps

You might want to additionally configure the following components:

  • The hostpath provisioner is a local storage provisioner designed for OKD Virtualization. If you want to configure local storage for virtual machines, you must enable the hostpath provisioner first.