Preparing to install foundational services

Before you install, review the following installation requirements.

Existing instance of foundational services in the cluster

If you already have foundational services version 3.x.x installed in the cluster and would like to install a new instance of foundational services version 4.x.x, you must check whether the existing instance of foundational services version 3.x.x is under dedicated mode, supporting multiple instances of foundational services installation in the cluster.

Identifying if an existing instance of foundational services version 3.x.x is installed in dedicated mode

Check the common-service-maps ConfigMap under the kube-public namespace and confirm if a dedicated controlNamespace is specified in the ConfigMap. Check the namespaces of the foundational services version 3.x.x instance is listed in the ConfigMap:

apiVersion: v1
kind: ConfigMap
  name: common-service-maps
  namespace: kube-public
  common-service-maps.yaml: |
    controlNamespace: cs-control     <------------- controlNamespace
    - requested-from-namespace:
      - cloudpakns1
      - cloudpakns2
      - cloudpakns3
      map-to-common-service-namespace: ibm-common-services    <---------- Bedrock v3.x instance

If a cluster with an existing instance of foundational services version 3.x.x is not under multiple-namespaces installation, you must convert it to a multiple-namespaces installation before installing a new instance of foundational services version 4.x.x. For more information, see Isolated migration.

OpenShift Container Platform cluster

Hardware sizing requirement

For the hardware requirements, see Hardware requirements and recommendations for foundational services.

Version of OpenShift Container Platform

For more information about the supported versions, see Supported OpenShift versions and platforms.

OpenShift Container Platform CLI tools

If there are no OpenShift Container Platform CLI tools on the boot node, you need to download, decompress, and install the OpenShift Container Platform CLI tools oc from OpenShift Container Platform client binaries Opens in a new tab.

OpenShift console availability

Available storage class

Ensure that you have a pre-configured storage class in OpenShift Container Platform that can be used for creating storage for IBM Cloud Pak foundational services. You need persistent storage for some of the service pods.

You can use the following command to get the storage classes that are configured in your cluster. Pick a storage class that provides block storage.

oc get storageclasses

Following is a sample output:

NAME                                  PROVISIONER                     AGE
rook-ceph-block-internal          42d
rook-ceph-cephfs-internal (default)   42d
rook-ceph-delete-bucket-internal             42d

For an OpenShift cluster that runs on IBM Cloud®, ibmc-block-gold is always available. For installing IBM Cloud Pak foundational services on IBM Cloud®, you might need to use the ibmc-block-gold storage class. For more information, see Deciding on the block storage configuration.

oc get sc

Example output:

NAME                          PROVISIONER         AGEdefault                 4h
ibmc-block-bronze (default)   4h
ibmc-block-custom      4h
ibmc-block-gold        4h
ibmc-block-retain-bronze   4h
ibmc-block-retain-custom   4h
ibmc-block-retain-gold   4h
ibmc-block-retain-silver   4h
ibmc-block-silver      4h
ibmc-file-bronze        4h
ibmc-file-custom        4h
ibmc-file-gold          4h
ibmc-file-retain-bronze    4h
ibmc-file-retain-custom    4h
ibmc-file-retain-gold    4h
ibmc-file-retain-silver    4h
ibmc-file-silver        4h

The default storage class is marked as (default).

The foundational services installer uses the default storage class to install MongoDB and Logging services. If you want to set the default storage class or update the default storage class in your OpenShift Container Platform, see Change the default StorageClassOpens in a new tab.

The storage class provisioner is defined in the PROVISIONER list. To enable dynamic volume provisioning, see Enabling Dynamic ProvisioningOpens in a new tab.

Using Azure File storage class

To use Azure File storage class with IBM Cloud Pak foundational services on Azure environments, complete the following steps before you create the storage class.

  1. Create a project for installing IBM Cloud Pak foundational services.
  2. Run the following command to retrieve the ssc.uid-range of the project:

     oc describe project <project_name>

    In the annotations, find the value of ssc.uid-range and save it. Following is the sample output: 1000630000/10000
  3. When you create the Azure File storage class, set the following MonutOptions:

     - dir_mode=0777
     - file_mode=0777
     - uid=<retrieved_uid>

where uid is the initial part of the value of ssc.uid-range that you retrieved in step 2.

For example:

- dir_mode=0777
- file_mode=0777
- uid=1000630000

Multiple zones requirement

The following prerequisites are applicable if you are installing foundational services in a cluster that has multiple zones.

Storage class

The storage class that you use for the foundational services must have its volumeBindingMode set to WaitForFirstConsumer.

You might need to create your own storage class to set the volumeBindingMode. In the following example, the ibmc-block-gold storage class that is available for clusters on IBM Cloud® is used as a template for creating a custom storage class.

allowVolumeExpansion: true
kind: StorageClass
    app: ibmcloud-block-storage-plugin
  name: ibmc-block-wffc
  billingType: hourly
  classVersion: "2"
  fsType: ext4
  iopsPerGB: "10"
  sizeRange: '[20-4000]Gi'
  type: Endurance
reclaimPolicy: Delete
volumeBindingMode: WaitForFirstConsumer

Required Kubernetes labels

In an on-premises, multizone Red Hat OpenShift Container Platform cluster, if you want the foundational services replicas to be equally spread across zones, you must add the following labels to each worker node. For more information, see and

Important: If you do not add these two labels, Kubernetes might not equally balance the foundational services across zones.

Configure OpenShift Container Platform cluster for foundational services

Before you install foundational services, you must configure your OpenShift Container Platform cluster for services.