Installing IBM Storage Fusion on IBM Cloud

Procedure to install IBM Storage Fusion on OpenShift® Container Platform that runs on IBM Cloud®.

Before you begin

Ensure you complete all the prerequisites before you proceed with the installation. For the prerequisites, see Prerequisites.

For more information about deployments and their supported services, see IBM Storage Fusion Services support matrix.

For steps to create a image pull secret for installing IBM Storage Fusion on IBM Cloud, see Creating image pull secret for IBM Cloud based installation.

About this task

Support is available for only one instance of IBM Storage Fusion per OpenShift Container Platform.

Procedure

  1. If you have not configured the IBM Operator Catalog, then configure it. For the procedure to add IBM Operator catalog, see Adding the IBM operator catalog.
    Note: IBM Operator Catalog is not specific to a version of IBM Storage Fusion.
  2. Log in to Red Hat OpenShift Container Platform web management console.
  3. Go to Operators > OperatorHub.
  4. Under Source, select IBM Operator Catalog.
    It lists all operators that are part of the IBM Operator Catalog including IBM Storage Fusion.
  5. Click IBM Storage Fusion.
    The Version, Capability level, Source, and Provider type of IBM Storage Fusion is available.
  6. Click Install.
    It opens the Install Operator page for IBM Storage Fusion operator.
  7. Select v2.0 in the update channel where the current operator is published.
    Note: You can also subscribe for updates. The subscription to the channel helps to keep the operator up to date.
  8. In the Installation mode, select A specific namespace on the cluster.
    The operator will be available in a single Namespace only.
  9. Select ibm-spectrum-fusion-ns in the Operator recommended namespace. Alternatively, use the Select a namespace option to select an existing namespace or create a new namespace.
  10. Important: Always set Update approval to Manual as IBM Storage Fusion does not support Automatic.
    In the Update approval section, you can select either Manual or Automatic strategy.
    Always set Update approval to Manual because the Automatic option automatically upgrades the operator whenever a new version of the operator is released to the channel. This automatic upgrade might have an impact on your running workloads.
  11. Click Install.
    The installation of the operator begins.
  12. Wait for the operator to complete the installation.
    After the successful installation of the operator, the following message gets displayed:
    Installed operator - operand required

    Generally, it completes in few minutes. If it takes more time, check whether all pods are up and running.

  13. From the Applications menu in the title bar of OpenShift Container Platform, click IBM Storage Fusion.
    The License agreement page gets displayed.
  14. Go through the license agreement, click I have read and accept the license agreement, and click Continue.
    The Welcome to IBM Storage Fusion dialog box gets displayed.
  15. In the IBM Storage Fusion user interface, click Install services to install the services right away or click Maybe later to do it later.
  16. If you want to enable the services from the IBM Storage Fusion user interface, see the following procedures accordingly:
    1. For Data Cataloging, see Data Cataloging.
    2. For Data Foundation, see Data Foundation.
    3. For Backup & Restore, see Backup & Restore.
  17. Optional: If you want to install IBM Storage Fusion services using OpenShift Container Platform, then do the following steps:
    Note: It is recommended to install the services from IBM Storage Fusion user interface.
    1. In the OpenShift Container Platform web console, go to Installed Operators > IBM Storage Fusion > Fusion Service instance tab.
    2. Create the FusionServiceInstance object for the respective service with the following specifications:
      Data Foundation
      
      apiVersion: service.isf.ibm.com/v1
      kind: FusionServiceInstance
      metadata:
        name: odfmanager
        namespace: ibm-spectrum-fusion-ns
      spec:
        creator: User
        doInstall: false
        parameters:
          - name: namespace
            provided: true
            value: ''
          - name: creator
            provided: true
            value: Fusion
          - name: backingStorageType
            provided: true
            value: Local
          - name: autoUpgrade
            provided: true
            value: 'true'
        serviceDefinition: data-foundation-service
        triggerUpdate: false
      
      Note: In the CR, input a supported backingStorageType based on your platform. For more information about platform support, see Platform support table in the About the task section of Data Foundation. In the CR, the valid input for backingStorageType > Value are Dynamic, Local, or External. Ensure that you capitalize the first letter of the value.
      Data Cataloging
      
      apiVersion: service.isf.ibm.com/v1
      kind: FusionServiceInstance
      metadata:
        name: data-cataloging-service-instance
        namespace: ibm-spectrum-fusion-ns
      spec:
        creator: User
        doInstall: true
        parameters:
          - name: namespace
            provided: false
            value: ibm-data-cataloging
          - name: rwx_storage_class
            provided: true
            value: <stoarage-class-name>
          - name: doInstall
            provided: false
            value: 'true'
          - name: license
            provided: false
            value: '{"accept": true}'
        serviceDefinition: data-cataloging-service-definition
        triggerUpdate: false
      
      Backup & Restore
      Backup & Restore server:
      
      apiVersion: service.isf.ibm.com/v1
      kind: FusionServiceInstance
      metadata:
        name: ibm-backup-restore-service-instance
        namespace: ibm-spectrum-fusion-ns
      spec:
        creator: User
        doInstall: true
        parameters:
          - name: namespace
            provided: false
            value: ibm-backup-restore
          - name: storageClass
            provided: true
            value:<storage-class-name>
          - name: doInstall
            provided: false
            value: 'true'
        serviceDefinition: ibm-backup-restore-service
        triggerUpdate: false