Creating a virtualized Hosted Control Plane cluster

Create an OpenShift® virtualization Hosted Control Plane cluster.

Before you begin

About this task

If the virtual cluster is not created or has issues, see Troubleshooting hosted control planes.

Procedure

  1. Log in to OpenShift Container Platform console, and go to Multi Cluster Engine (MCE) view.
  2. Go to Infrastructure > Clusters.
  3. In the Cluster list tab, click Create cluster.
  4. Select Red Hat OpenShift Virtualization as your infrastructure provider.
  5. In the Control plane type, select Hosted. A Create cluster wizard page gets displayed.
  6. In the Create cluster wizard, enter your cluster details:
    1. In the Cluster details wizard page, enter your cluster details.
      Release image
      Select your OpenShift version. For more information about the supported versions, see Interoperability matrix.
      Note: No multi arch images must be used while provisioning Hosted Control Plane clusters.
      Additional labels
      Enter isf.ibm.com/fusion-base=, isf.ibm.com/fusion-fdf=, and isf.ibm.com/fusion-backup= labels to install IBM Fusion, Fusion Data Foundation, and Backup & Restore service on the newly created cluster.
      Pull secret
      A pull secret is required for the creation of a Hosted Control Plane cluster. Include the cp.icr.io for the Fusion services.
    2. Click Next to go to the Node pools page of the wizard.
    3. In the Node pools page, enter the location and size of the nodes.
    4. Click Next to go to the Review and create page of the wizard.
    5. In the Review and create page, go through the details and click Create.
    Alternatively, use the following command line example to create a Hosted Control Plane for OpenShift Virtualization by using the KubeVirt platform type.
    Note: Ensure you check the following points before you proceed:
    • Make sure you export the variables used in the example with their right values.
    • Also, check whether you have the latest Hosted Control Plane Command Line interface (CLI). If you do not have the latest version, go to Red Hat® OpenShift Container Platform console and download the latest version from Command line tools page.
    # Set environment variables
    export CLUSTER_NAME=example
    export PULL_SECRET="$HOME/pull-secret"
    export MEM="6Gi"
    export CPU="2"
    export WORKER_COUNT="2"
    
    hcp create cluster kubevirt \
     --name $CLUSTER_NAME \
     --node-pool-replicas $WORKER_COUNT \
     --pull-secret $PULL_SECRET \
     --memory $MEM \
     --cores $CPU \
     --etcd-storage-class lvms-hcp-etcd \
     --infra-availability-policy HighlyAvailable \
     --root-volume-storage-class ocs-storagecluster-ceph-rbd-virtualization \
     --root-volume-volume-mode Block \
    --root-volume-access-modes ReadWriteMany
    Run the following command to get a list of available parameters:
    hcp create cluster kubevirt --help
  7. To validate the clusters, do the following steps:
    1. Log in to the OpenShift Container Platform console of the hub, and go to multi cluster view.
    2. Go to Infrastructure > Clusters.
    3. From the Clusters list, click a hosted cluster name link to view the details.
    Note: Hosted Control Plane cluster creation can take more than 30 minutes.

What to do next

  1. Install the IBM Fusion base on the Hosted Control Plane cluster. For instructions, see Installing the IBM Fusion base.
  2. Install the Fusion Data Foundation storage client on the Hosted Control Plane cluster. For instructions, see Installing Fusion Data Foundation on a Hosted Control Plane cluster.