Create an OpenShift®
virtualization Hosted Control Plane cluster.
Before you begin
- The IBM Fusion with the Multi-Cluster
Engine version 2.7 or higher supports hosted clusters, which run on OpenShift version 4.16. For more information
about the supported versions, see Interoperability matrix. The upgrade of OpenShift Container Platform is supported on Hosted Control Plane clusters. For creating a hosted cluster with
KubeVirt platform by using CLI, see Red Hat Documentation.
- Ensure you meet the following prerequisites:
About this task
If the virtual cluster is not created or has issues, see Troubleshooting hosted control planes.
Procedure
-
Log in to OpenShift Container Platform console, and go to Multi
Cluster Engine (MCE) 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 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.
- 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.
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
- To validate the clusters, do the following steps:
- Log in to the OpenShift Container Platform console of
the hub, and go to multi cluster 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 30 minutes.
What to do next
- Install the IBM Fusion base on the Hosted Control Plane cluster. For instructions, see Installing the IBM Fusion base.
- 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.