Installing Fusion Data Foundation on a Hosted Control Plane cluster

Install the Fusion Data Foundation client as the storage type for the hosted cluster.

Before you begin

Remember: Fusion Data Foundation is supported on hosted clusters running OpenShift® Container Platform versions N, N-1, and N-2, where N is the OpenShift Container Platform version on the hub cluster.

About this task

During the installation of the Fusion Data Foundation client, you can set a storage quota to limit its storage usage.

If the storage quota not assigned during installation, then the storage quota defaults to unlimited for Fusion Data Foundation versions 4.17 and higher.

After the storage quota is set, you cannot reduce it later. Therefore, it is recommended to allocate required storage quota for Fusion Data Foundation clients during the installation of the hosted clusters to ensure the better storage management. For more information about how to set the quota value, see step 4.

Procedure

  1. Log in to the OpenShift Container Platform web console and select All clusters.
  2. From the Infrastructure menu, select the Clusters tab.
    The Cluster list page appears.
  3. In the Cluster list tab, click the ellipsis menu of the required cluster and select Edit labels.
    The Edit labels window appears.
  4. To allocate a specific storage quota for the Fusion Data Foundation client, do one of the following methods before adding the isf.ibm.com/fusion-fdf label:
    Important: If you skip this step and proceed to step 5, the storage quota is set to unlimited by default for this Fusion Data Foundation client (if version is 4.17 or higher). Also, the isf.ibm.com/fusion-fdf-quota label appears on the Labels field.
    • By modifying the Labels field of the hosted cluster:
      1. Add the isf.ibm.com/fusion-fdf-quota=<value> label specifying the required storage quota.

        Remember: The storage quota value must match the pattern <integar-value><Gi/Ti>, such as 10Gi, 10Ti, or so on. Otherwise, an error message appears on the screen.
        For example:
        isf.ibm.com/fusion-fdf-quota=300Gi
        Alternatively, if you can add the isf.ibm.com/fusion-fdf-quota=<value> label from the hub cluster by using the following oc command:
        oc label managedcluster <consumer_cluster_name> isf.ibm.com/fusion-fdf-quota='300Gi'
      2. Click Save.
    • By modifying the configmap of the hub cluster:
      1. Go to the hub cluster.
      2. Select the IBM Fusion namespace from the Project list.

        For example, ibm-spectrum-fusion-ns namespace.

      3. Go to Workloads > ConfigMaps.
      4. Select the fusion-addon-config configmap and go to the YAML tab.
      5. Add the default-fdf-storage-quota: <value> parameter and click Save.

        Remember: The storage quota value must match the pattern <integar-value><Gi/Ti>, such as 10Gi, 10Ti, or so on. Otherwise, an error message appears on the screen.
        For example:
        default-fdf-storage-quota: 200Gi
        Important: This storage quota value is set as a default storage quota for all the hosted clusters associated with this hub cluster whenever you add the isf.ibm.com/fusion-fdf label. To override it, add the isf.ibm.com/fusion-fdf-quota=<value> label with the required value before adding the isf.ibm.com/fusion-fdf label.
      6. Go back to the All clusters > Infrastructure > Clusters.

        The Cluster list page appears.

      7. Click the ellipsis menu of the required cluster and select Edit labels.

        The Edit labels window appears.

  5. In the Edit labels window, add the isf.ibm.com/fusion-fdf label and click Save.
    Alternatively, if you can add the isf.ibm.com/fusion-fdf label from the hub cluster by using the following oc command:
    oc label managedcluster <consumer_cluster_name> isf.ibm.com/fusion-fdf=''
    The Fusion Data Foundation service starts to install automatically, and it might take 5–10 minutes to complete the installation.
    Note: A notification appears after the successful installation.
  6. Verify whether the Fusion Data Foundation client installation is complete and healthy as follows.
    1. Go to the IBM Fusion user interface of the hosted cluster and open the Services tab.
      Ensure that the Fusion Data Foundation service status is healthy.
    2. On the Storage tab, check that the storage status shows as normal and the connection status shows as connected for the local storage.
    3. Go to the hub cluster in the OpenShift Container Platform web console and select the Storage Consumers tab under the Storage menu.

      The Storage Consumers tab displays installed storage clients with the allotted storage quota.

      To increase the storage quota, see Updating the storage quota of a Hosted Control Plane cluster.

If you face any issues during the installation of the Fusion Data Foundation client, see Troubleshooting issues and known limitations in Hosted Control Plane cluster.

What to do next

To backup applications on the hosted cluster, see Backup & Restore of applications in Hosted Control Plane clusters.