4.2. Installing OpenShift Virtualization

Procedure

1. Create a YAML file that contains the following manifest:

   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-cnv
     labels:
       openshift.io/cluster-monitoring: "true"
   ---
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: kubevirt-hyperconverged-group
     namespace: openshift-cnv
   spec:
     targetNamespaces:
       - openshift-cnv
   ---
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: hco-operatorhub
     namespace: openshift-cnv
   spec:
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     name: kubevirt-hyperconverged
     startingCSV: kubevirt-hyperconverged-operator.v4.19.25
     channel: "stable"

   Using the stable channel ensures that you install the version of OpenShift Virtualization that is compatible with your OpenShift Container Platform version.

2. Create the required Namespace, OperatorGroup, and Subscription objects for OpenShift Virtualization by running the following command:

   $ oc apply -f <filename>.yaml

1. Check that the ClusterServiceVersion (CSV) object was created successfully. Run the following command and verify the output:

   $ oc get csv -n openshift-cnv

   If the CSV was created successfully, the output shows an entry that contains a NAME value of kubevirt-hyperconverged-operator-*, a DISPLAY value of OpenShift Virtualization, and a PHASE value of Succeeded, as shown in the following example output:

   Example output:

   NAME                                       DISPLAY                    VERSION   REPLACES                                   PHASE
   kubevirt-hyperconverged-operator.v4.19.25   OpenShift Virtualization   4.19.25    kubevirt-hyperconverged-operator.v4.18.0   Succeeded

2. Check that the HyperConverged custom resource (CR) has the correct version. Run the following command and verify the output:

   $ oc get hco -n openshift-cnv kubevirt-hyperconverged -o json | jq .status.versions

   Example output:

   {
   "name": "operator",
   "version": "4.19.25"
   }

3. Verify the HyperConverged CR conditions. Run the following command and check the output:

   $ oc get hco kubevirt-hyperconverged -n openshift-cnv -o json | jq -r '.status.conditions[] | {type,status}'

   Example output:

   {
     "type": "ReconcileComplete",
     "status": "True"
   }
   {
     "type": "Available",
     "status": "True"
   }
   {
     "type": "Progressing",
     "status": "False"
   }
   {
     "type": "Degraded",
     "status": "False"
   }
   {
     "type": "Upgradeable",
     "status": "True"
   }

Procedure

1. Create a YAML file that contains the following manifest:

   apiVersion: hco.kubevirt.io/v1beta1
   kind: HyperConverged
   metadata:
     name: kubevirt-hyperconverged
     namespace: openshift-cnv
   spec:

2. Deploy the OpenShift Virtualization Operator by running the following command:

   $ oc apply -f <file_name>.yaml