OpenShift docs are moving and will soon only be available at docs.redhat.com, the home of all Red Hat product documentation. Explore the new docs experience today.
  1. Documentation
    2. history
×

Installing container-native virtualization

Install container-native virtualization to add virtualization functionality to your OpenShift Container Platform cluster.

You can use the OpenShift Container Platform 4.4 web console to subscribe to and deploy the container-native virtualization Operators.

Prerequisites

  • OpenShift Container Platform 4.4

Container-native virtualization is a Technology Preview feature only. Technology Preview features are not supported with Red Hat production service level agreements (SLAs) and might not be functionally complete. Red Hat does not recommend using them in production. These features provide early access to upcoming product features, enabling customers to test functionality and provide feedback during the development process.

For more information about the support scope of Red Hat Technology Preview features, see https://access.redhat.com/support/offerings/techpreview/.

Subscribing to the container-native virtualization catalog

Before you install container-native virtualization, subscribe to the container-native virtualization catalog from the OpenShift Container Platform web console. Subscribing gives the openshift-cnv namespace access to the container-native virtualization Operators.

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.

      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.

Deploying container-native virtualization

Create the CNV Operator Deployment custom resource to deploy container-native virtualization.

Prerequisites

  • An active subscription to the container-native virtualization catalog in the openshift-cnv namespace.

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.

    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.