Working with Hosted Control Plane on Fusion Data Foundation

Create a Hosted Control Plane OpenShift® Virtualization cluster.

Before you begin

  • In 2.8.1, set the value for IBM Storage Fusion spoke and Fusion Data Foundation catalog source in fusion-addon-config. For the procedure, see Add-on packages are not deployed automatically.
  • On a six node IBM Storage Fusion HCI System, you must create only a maximum of five Hosted Control Plane clusters. On a larger configuration rack having ten or more nodes, you must create a maximum of ten Hosted Control Plane clusters. Go through the sizing guidelines. See Hosted control plane sizing guidance.
  • The IBM Storage Fusion HCI System with the Multi-Cluster Engine version 2.4.x supports hosted clusters, which run on OpenShift version 4.16. The upgrade of OpenShift Container Platform is supported on Hosted Control Plane clusters.

About this task

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

Note: Only Hosted Control Plane using OpenShift Virtualization is supported.

Procedure

  1. Log in to OpenShift Container Platform console, and go to Advanced Cluster Management 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 OpenShift 4.16
      Additional labels
      Enter isf.ibm.com/fusion-base=, isf.ibm.com/fusion-fdf=, and isf.ibm.com/fusion-backup= labels to install IBM Storage Fusion, Fusion Data Foundation, and Backup & Restore service on the newly created cluster.
    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. Make sure you export the variables used in the example with their right values.
    # 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 \
     --root-volume-volume-mode Block \
    --root-volume-access-modes ReadWriteMany
    For the complete procedure, see Red Hat Advanced Cluster Management documentation.
    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 the Advanced Cluster Management 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 45 minutes to one hour.

What to do next

  1. From the IBM Storage Fusion HCI System hub cluster, initiate an installation of IBM Storage Fusion on the hosted cluster.
  2. From the IBM Storage Fusion HCI System hub cluster, initiate the installation of Fusion Data Foundation storage on the IBM Storage Fusion spoke cluster. For more information, see Data Foundation.