Upgrading IBM Storage Fusion

1. Complete steps 1 to 8 of Mirroring Data Cataloging images procedure.
2. Update the redhat-operators catalog source.

   apiVersion: operators.coreos.com/v1alpha1
   kind: CatalogSource
   metadata:
     name: redhat-operators-data-cataloging
     namespace: openshift-marketplace
   spec:
     displayName: Red Hat Operators for Data Cataloging
     image: "$PRUNED_RED_HAT_OPERATORS_IMAGE"
     sourceType: grpc
     updateStrategy:
       registryPoll:
         interval: 15m

3. If a new TARGET_PATH value is used for the upgrade, then update the existing ImageContentSourcePolicy.

   apiVersion: operator.openshift.io/v1alpha1
   kind: ImageContentSourcePolicy
   metadata:
     labels:
       operators.openshift.org/catalog: "true"
     name: isd-mirror
   spec:
     repositoryDigestMirrors:
     - mirrors:
       - $TARGET_PATH
       source: icr.io/cpopen
     - mirrors:
       - $TARGET_PATH
       source: registry.redhat.io/redhat
     - mirrors:
       - $TARGET_PATH/amq
       - $TARGET_PATH
       source: registry.redhat.io/amq7
     - mirrors:
       - $TARGET_PATH/ibm-spectrum-discover
       source: cp.icr.io/cp/ibm-spectrum-discover
     - mirrors:
       - $TARGET_PATH/db2u
       source: icr.io/db2u

1. Complete steps 1 to 7 of Mirroring Data Foundation images deployed on OpenShift Container Platform version 4.12 topic.
2. Before you upgrade IBM Storage Fusion, from the Services page of the IBM Storage Fusion user interface, disable Automatic updates for Data Foundation service.
3. Go to Operators > Installed Operators > IBM Storage Fusion Data Foundation > Subscription, and check whether the Update approval is changed to Manually.
4. Start the IBM Storage Fusion version upgrade.
5. Update the image digest ID after you upgrade the IBM Storage Fusion as follows:
   1. Run the following command to get the catalog source image digest ID.

      skopeo inspect docker://<enterprise registry host:port>/<target-path>/cpopen/isf-data-foundation-catalog:v4.12 | jq -r ".Digest"
      

      You need to record the image digest ID. It is used in deployment phase only.

   2. Ensure that the data-foundation-service FusionServiceDefinition CR is created.

      oc get fusionservicedefinitions.service.isf.ibm.com -n ibm-spectrum-fusion-ns data-foundation-service
      

   3. Update the imageDigest in the FusionServiceDefinition data-foundation-service.

      skopeo inspect docker://<enterprise registry host:port>/<target-path>/cpopen/isf-data-foundation-catalog:v4.12 | jq -r ".Digest"
      

   4. Edit the data-foundation-service .spec.onboarding.serviceOperatorSubscription.multiVersionCatSrcDetails.ocp412-t.imageDigest.

      oc edit fusionservicedefinitions.service.isf.ibm.com -n ibm-spectrum-fusion-ns data-foundation-service
      

      Example output:

      spec:
        hasRelatedDefinition: false
        onboarding:
      ...
          serviceOperatorSubscription:
            catalogSourceName: isf-data-foundation-catalog
            createCatalogSource: true
            globalCatalogSource: true
            isClusterWide: false
            multiVersionCatSrcDetails:
              ocp49:
                skipCatSrcCreation: true
              ocp410:
                skipCatSrcCreation: true
              ocp411:
                skipCatSrcCreation: true
              ocp412-t:
                displayName: Data Foundation Catalog
                imageDigest: sha256:ed94a66296d1a4fe047b0a79db0e8653e179a8a2a646b0c05e435762d852de73
                imageName: isf-data-foundation-catalog
                imageTag: v4.12
                publisher: IBM
                registryPath: icr.io/cpopen
                skipCatSrcCreation: false

6. Change Update approval to the original value in IBM Storage Fusion user interface.

For example 2.6.1:

{
isfimagepath: <path to the mirrored images within the regsitry>   
 isfregistry: <isf-enterprise-registry>:<port>
 isfregistrypassword: <enterprise registry password>
 isfregistryuser: <enterprise registry user name>
 isPrivateRegistry: true
}

kind: Secret
apiVersion: v1
metadata:
  name: user-install-secret
  namespace: ibm-spectrum-fusion-ns
data:
    isfregistry: <enterprise registry host:enterprise registry port>
    isfimagepath: <isf 2.6.1 mirror path>
    isfregistryuser: <enterprise registry user name>
    isfregistrypassword: <enterprise registry password>
    isPrivateRegistry: true