Installing Fusion Data Foundation

The Fusion Data Foundation service provides a foundational data layer for applications to function and interact with data in a simplified, consistent, and scalable manner. The provider mode is similar to an external Data Foundation configuration. It acts as the provider and base storage on the host cluster. You can provision new clusters within a managed rack and consume storage from the central provider cluster.

1. Go to Services page in IBM Fusion user interface.
2. In the Available section, click the Data Foundation tile.
3. In the Storage providers section, click the Data Foundation tile to install and configure storage service.
   Note: You cannot install other dependent services until you install and configure a storage service.
4. In the Data Foundation page, go through the details about the service and click Install.
   The IBM Fusion HCI supports both provider mode and MCG only mode.
5. Choose the following options and click Install:
   • Automatic updates
     Note: If you select Automatic updates, then IBM Fusion auto upgrades Fusion Data Foundation version.

     This upgrades Fusion Data Foundation service within the subscription channel.

     For example, 4.16.x to 4.16.y. For storage support matrix, see IBM Fusion support matrix.

   The Fusion Data Foundation operator starts to deploy and you can see Data Foundation in the Installed section of the Services page. Initially, the status shows as Installing and progress of the installation is mentioned in percentage. After successful completion of the installation, the status changes to Running.
6. To validate the installation, do the following steps in OpenShift Container Platform web console:
   • Go to Installed Operators to check whether the Fusion Data Foundation operator is listed and Status shows as Succeeded.
7. Verify the Fusion Data Foundation service installation.
   1. To verify the installation of Fusion Data Foundation on IBM Fusion, perform the checks specified in Verify the installation.
   2. Additionally, run the command to verify that Fusion Data Foundation service is installed successfully:

      oc describe odfmanager/odfmanager -n <Fusionns>

      Update <Fusions> with your namespace value.

   Table 1. Install states Fusion Data Foundation service

   Install State	Description
   Installing	Fusion Data Foundation installation is ongoing, and there are no errors yet.
   Failing	There is an installation error but IBM Fusion retries to install Fusion Data Foundation. If the problem is solved, this status changes to Installing or Completed.
   Completed	Fusion Data Foundation installation completed successfully.

   Table 2. Upgrade states Fusion Data Foundation service

   Upgrade State	Description
   Not started	Fusion Data Foundation upgrade has not started yet.
   Upgrading	Fusion Data Foundation upgrade is ongoing, and there are no errors yet.
   Failing	There is an installation error but IBM Fusion retries to upgrade Fusion Data Foundation. If the problem is solved, this status changes to Upgrading or Completed.
   Completed	Fusion Data Foundation upgrade completed successfully.

   Table 3. Health states Fusion Data Foundation service

   State	Description
   Installing	Fusion Data Foundation installation is ongoing.
   Upgrading	Fusion Data Foundation upgrade is ongoing.
   Healthy	Fusion Data Foundation installation completed successfully and the service is in normal state.
   Degraded	Fusion Data Foundation installation completed successfully but the service is not in normal state.

8. Validate the installation.

   Verify the Fusion Data Foundation installation was completed successfully from the OpenShift Container Platform console:

   1. Go to Installed Operators to check whether the Fusion Data Foundation operator is listed and status is Succeeded.
   2. Verify pods from the Red Hat®OpenShift Container Platform web console:
      1. Go to Workloads > Pods.
      2. Select the openshift-storage namespace, where the Fusion Data Foundation is installed.
      3. Check whether the following pods are running successfully:
         • csi-addons-controller-manager
         • ocs-metrics-exporter
         • ocs-operator
         • odf-console
         • odf-operator-controller-manager
         • rook-ceph-operator
         • ceph-csi-controller-manager
   3. Alternatively, you can verify the installation by running the OC commands:

      oc get pod -n openshift-storage

      A sample result of the OC command is as follows:

      [root@fu40 ~]# oc get pod -n openshift-storage
      NAME                                               READY   STATUS              RESTARTS   AGE
      csi-addons-controller-manager-bdb965b47-jvfhs      2/2     Running             0          119s
      ocs-metrics-exporter-69cfc56fd9-jk49s              1/1     Running             0          2m45s
      ocs-operator-6879c74556-pppj9                      1/1     Running             0          2m46s
      odf-console-849f64fdd7-rqd97                       1/1     Running             0          3m3s
      odf-operator-controller-manager-5bd4c85d6b-q8g2f   2/2     Running             0          3m3s
      rook-ceph-operator-76699f976c-2zpms                1/1     Running             0          2m46s

   4. Ensure that all the pods are up and running.
   5. Verify the Fusion Data Foundation status as follows:
      1. Click Operators > Install operators. Select the namespace in which IBM Fusion was installed from the Project tab.
      2. Select the IBM Fusion.
      3. Go to Fusion Service Instance tab and click odfmanager from the list.
      4. Open YAML tab and ensure that .status.health is Healthy.
   6. Alternatively, you can verify the status by running the OC commands:

      oc get fusionserviceinstances.service.isf.ibm.com -n ibm-spectrum-fusion-ns odfmanager -o jsonpath='{.status.health}{"\n"}'

   7. Verify the local storage operator pods:
      1. Click Operators > Install operators. Select the ibm-spectrum-fusion-ns namespace from the Project tab.
      2. Select the IBM Fusion.
      3. Go to Fusion Service Instance tab and click odfmanager from the list.
      4. Click YAML tab and check the backingStorageType.

         
         - name: backingStorageType
           provided: true
           value: Provider

      5. Alternatively, you can verify the backing storage type by running the oc commands.

         oc get fusionserviceinstances.service.isf.ibm.com -n ibm-spectrum-fusion-ns odfmanager -o jsonpath='{.spec.parameters}{"\n"}'

      6. Verify pods from the Red HatOpenShift Container Platform web console:
         1. Go to Workloads > Pods.
         2. Select the openshift-local-storage namespace, where the local storage operator is installed.
         3. Check whether the following pods are running successfully: local-storage-operator-xxxxx

            For example: local-storage-operator-75c55cf57d-pfjcp

      7. Ensure that all pods are running.
      8. Alternatively, you can verify the installation by running the oc commands:

         oc get pod -n openshift-local-storage

         A sample result of the oc command is as follows:

         [root@fu40 ~]# oc get pod -n openshift-local-storage
         NAME                                      READY   STATUS    RESTARTS   AGE
         local-storage-operator-75c55cf57d-pfjcp   1/1     Running   0          109s