Data Foundation

The service provides a foundational data layer for applications to function and interact with data in a simplified, consistent, and scalable manner.

Before you begin

  • If you already have an installation of IBM Storage Fusion Data Foundation cluster or Red Hat® OpenShift® Data Foundation cluster, then the IBM Storage Fusion UI automatically discovers it. However, in the Data Foundation page, you can only view the Usable capacity, Health, and information about the storage nodes.
  • If you have a Rook-Ceph operator, then contact IBM Support for the expected behavior.
  • You can use a maximum of nine storage devices per node. The high number of storage devices leads to a higher recovery time during the loss of a node. This recommendation ensures that nodes stay below the cloud provider dynamic storage device attachment limits, and limits the recovery time after node failure with local storage devices.

    It is recommended to add nodes in the multiple of three, each of them in different failure domains.

    For deployments having three failure domains, you can scale up the storage by adding disks in the multiple of three, with the same number of disks coming from nodes in each of the failure domains.

  • Run following steps to ensure that there is no previously installed IBM Storage Fusion Data Foundation, Red Hat OpenShift Data Foundation, OpenShift Container Storage, or Rook-Ceph in this OpenShift cluster before you enable the IBM Storage Fusion Data Foundation service:

    1. Verify that the namespace openshift-storage does not exist.
    2. Run the following command to confirm that no resources exist: 
      oc get storagecluster -A; oc get cephcluster -A
    3. Run the following command to confirm that none of the nodes have a IBM Storage Fusion Data Foundation storage label or Red Hat OpenShift Data Foundation storage label: 
      oc get node -l cluster.ocs.openshift.io/openshift-storage=
  • Infrastructure nodes
    Ensure that the following prerequisites are met:
    • For infrastructure requirements, see Infrastructure requirements of IBM Storage Fusion Data Foundation.
    • For IBM Storage Fusion Data Foundation resource requirements, see ODF sizer tool. For common IBM Storage Fusion Data Foundation components per instance requirements of CPU and Memory, see Resource requirements.
    • If you want to deploy IBM Storage Fusion Data Foundation in an Infra node, make sure the worker node label exists.
      oc get node -l "node-role.kubernetes.io/worker="
    • Ensure that there are no taints in the infra or compute nodes that are used as storage nodes.

About this task

  • A IBM Spectrum Scale remote mount can coexist with IBM Storage Fusion Data Foundation.
  • You can configure only local or dynamic storage for IBM Storage Fusion Data Foundation but not both.
  • For Red Hat OpenShift Data Foundation deployed outside of IBM Storage Fusion, you cannot add nodes from IBM Storage Fusion instead you get redirected to add nodes from OpenShift Container Platform web console.
  • The IBM Storage Fusion supported Global data platform and IBM Storage Fusion Data Foundation work together scenarios:
    • Deploy IBM Storage Fusion Data Foundation dedicated mode first and then deploy Global data platform.
      • Support is available to deploy IBM Storage Fusion Data Foundation dedicated first and then deploy Global data platform. Support is not available to deploy Global data platform first and then deploy IBM Storage Fusion Data Foundation dedicated.
      • If you want to deploy IBM Storage Fusion Data Foundation in a dedicated mode, then you need to deploy IBM Storage Fusion Data Foundation first and then Global data platform.
  • The following table shows IBM Storage Fusion IBM Storage Fusion Data Foundation service supported platforms and backend devices to provision a storage cluster:
    Platform Support
    VMware Local device and dynamic storage class
    Bare Metal Local device
    Linux on IBM zSystems Local device
    ROKS on IBM Cloud (ROKS on VPC and Classic Bare Metal) Cloud-managed IBM Storage Fusion Data Foundation service. For the procedure to install, see Understanding IBM Storage Fusion Data Foundation.
    Self managed OpenShift Container Platform on Microsoft Azure Dynamic storage class
    Self managed OpenShift Container Platform on Amazon Web Services Dynamic storage class
  • On platforms that uses dynamic storage class to install IBM Storage Fusion Data Foundation, IBM Storage Fusion user interface supports to install Data Foundation service and configure IBM Storage Fusion Data Foundation storage cluster. You can also view the storage cluster status in IBM Storage Fusion user interface. For more information about how to configure Data Foundation dynamic storage from IBM Storage Fusion user interface, see Configuring Data Foundation dynamic storage.
  • For IBM Storage Fusion services and platform support matrix and reference links for the installation of IBM Storage Fusion Data Foundation on ROSA and ARO, see IBM Storage Fusion Services support matrix.

Procedure

  1. Go to Services page in IBM Storage Fusion user interface.
  2. In the Data Foundation section, click Install.
  3. If you are on On-premises VMware, then in the Install Data Foundation window, select whether the Device type is Local or Dynamic.
  4. Choose whether to Enable automatic updates and click Install.
    Note: If you select Enable automatic updates, then IBM Storage Fusion auto upgrades IBM Storage Fusion Data Foundation version.

    This upgrade can only upgrade IBM Storage Fusion Data Foundation within the subscription channel, which can upgrade IBM Storage Fusion Data Foundation from 4.12.x to 4.12.y, but cannot upgrade Red Hat OpenShift Data Foundation 4.10 to IBM Storage Fusion Data Foundation 4.12. For the procedure to upgrade Red Hat OpenShift Data Foundation 4.10 to IBM Storage Fusion Data Foundation 4.12, see Upgrading Red Hat OpenShift Data Foundation 4.10 to IBM Storage Fusion Data Foundation 4.12.

    The IBM Storage Fusion Data Foundation operator starts to deploy and you can see Data Foundation in the Installed list 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. A Data Foundation page is added to the menu.
  5. To validate the installation, do the following steps in OpenShift Container Platform web console:
    • Go to Installed Operators to check whether the IBM Storage Fusion Data Foundation operator is listed and Status shows as Succeeded.
    • Additionally, if the installed platform is Bare Metal, Linux on IBM zSystems, or VMware using local device, check whether the Local Storage operators is installed and its status shows as Succeeded.
    Note: Only on VMware platform, you can select to use local or dynamic.
  6. Verify whether the IBM Storage Fusion Data Foundation IBM Storage Fusion service and Storage cluster creation was successful.
    1. To verify the installation of IBM Storage Fusion Data Foundation on IBM Storage Fusion, perform the checks specified in Verify the IBM Storage Fusion Data Foundation.
    2. Additionally, run the command to verify IBM Storage Fusion Data Foundation IBM Storage Fusion service and the Storage cluster creation is successful. 
      oc describe odfmanager/odfmanager -n <Fusionns>
    3. Run the command to check the cluster details. 
      oc describe odfcluster/odfcluster -n <Fusionns>
    Table 1. Install states IBM Storage Fusion Data Foundation service
    Install State Description
    Installing IBM Storage Fusion Data Foundation installation is ongoing, and there are no errors yet.
    Failing There is an installation error but IBM Storage Fusion retries to install IBM Storage Fusion Data Foundation. If the problem is solved, this status changes to Installing or Comleted.
    Completed IBM Storage Fusion Data Foundation installation completed successfully.
    Table 2. Upgrade states IBM Storage Fusion Data Foundation service
    Upgrade State Description
    Not started IBM Storage Fusion Data Foundation upgrade has not started yet.
    Upgrading IBM Storage Fusion Data Foundation upgrade is ongoing, and there are no errors yet.
    Failing There is an installation error but IBM Storage Fusion retries to upgrade IBM Storage Fusion Data Foundation. If the problem is solved, this status changes to Upgrading or Completed.
    Completed IBM Storage Fusion Data Foundation upgrade completed successfully.
    Table 3. Health states IBM Storage Fusion Data Foundation service
    State Description
    Installing IBM Storage Fusion Data Foundation installation is ongoing. For more information about installation status details, see Table 1.
    Upgrading IBM Storage Fusion Data Foundation upgrade is ongoing. For more information about upgrading status details, see Table 2.
    Healthy IBM Storage Fusion Data Foundation installation completed successfully and the service is in normal state.
    Degraded IBM Storage Fusion Data Foundation installation completed successfully but the service is not in normal state.

What to do next

Configure storage in your environment. Provision the amount of usable capacity that your environment needs and select the nodes to run the Data Foundation workloads. Optionally, you also setup encryption to use an external Key Management System.