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
-
Log in to OpenShift Container Platform console, and go to
Advanced Cluster Management view.
- Go to Infrastructure >
Clusters.
- In the Cluster list tab, click Create
cluster.
- Select Red Hat OpenShift Virtualization as your infrastructure
provider.
- In the Control plane type, select Hosted. A Create
cluster wizard page gets displayed.
- In the Create cluster wizard, enter your cluster details:
- 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.
- Click Next to go to the Node pools page of
the wizard.
- In the Node pools page, enter the location and size of the
nodes.
- Click Next to go to the Review and create
page of the wizard.
- 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
- To validate the clusters, do the following steps:
- Log in to the OpenShift Container Platform console of
the hub, and go to the Advanced Cluster Management View.
- Go to
.
- 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
- From the IBM Storage Fusion HCI System hub cluster, initiate an
installation of IBM Storage Fusion on the hosted cluster.
- 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.