Upgrading Red Hat OpenShift Data Foundation 4.12 to IBM Storage Fusion Data Foundation 4.12 or higher

Steps to upgrade Red Hat® Data Foundation 4.12 to IBM Storage Fusion Data Foundation 4.12 or higher.

Before you begin

Ensure that the OpenShift® Data Foundation version installed is >= 4.12.
Ensure that the OpenShift Data Foundation cluster is healthy and data is resilient. You can get the details from IBM Storage Fusion user interface or OpenShift Container Platform console.
Ensure that all OpenShift Data Foundation Pods, including the operator pods, are in Running state in the openshift-storage namespace.
Ensure that you have sufficient time to complete the OpenShift Data Foundation update process. The update time varies depending on the number of OSDs that run in the cluster.

Ensure IBM Storage Fusion Data Foundation catalogsource exists:

Verify that the isf-data-foundation-catalog catalog exists. The IBM Storage Fusion Data Foundation catalog isf-data-foundation-catalog gets created automatically in openshift-marketplace ns.

oc get catalogsources.operators.coreos.com -n openshift-marketplace

Sample output:

NAME                          DISPLAY                              TYPE   PUBLISHER   AGE
isf-data-foundation-catalog   IBM Storage Fusion Data Foundation   grpc   IBM         66m

If the isf-data-foundation-catalog catalog does not exist, create it as follows:

Create a CatalogSource object that references the catalog image for isf-data-foundation-catalog.

Ensure the CatalogSource object uses the correct registry image.

For example:

apiVersion: operators.coreos.com/v1alpha1
kind: CatalogSource
metadata:
  name: isf-data-foundation-catalog
  namespace: openshift-marketplace
spec:
  displayName: isf-data-foundation-catalog
  publisher: IBM
  sourceType: grpc
  image: icr.io/cpopen/isf-data-foundation-catalog:v4.19
  updateStrategy:
    registryPoll:
      interval: 15m

Create a CatalogSource using this file by running the following command:
```
oc apply -f isf-data-foundation-catalogsource.yaml
```

About this task

Note:

If you installed the latest version of OpenShift Data Foundation that is at a higher level than the latest IBM Storage Fusion Data Foundation version, then upgrade to IBM Storage Fusion Data Foundation is not possible.
This procedure is also applicable for versions 4.12 or higher. The supported versions for IBM Storage Fusion 2.7 is 4.12 and 4.13.

Procedure

Change update approval strategy to Manual.
1. Change update approval strategy to Manual in OpenShift Data Foundation subscription

Modify OpenShift Data Foundation subscription catalog source name.

Update the odf-operator subscription.

oc patch -n openshift-storage subscriptions.operators.coreos.com/odf-operator --patch '{"spec":{"source":"isf-data-foundation-catalog"}}' --type=merge

Update the mcg-operator/ocs-operator/odf-csi-addons-operator subscriptions' catalogsource name.


oc patch -n openshift-storage $(oc get subs -n openshift-storage -l operators.coreos.com/ocs-operator.openshift-storage= -o name) --patch '{"spec":{"source":"isf-data-foundation-catalog"}}' --type=merge

oc patch -n openshift-storage $(oc get subs -n openshift-storage -l operators.coreos.com/mcg-operator.openshift-storage= -o name) --patch '{"spec":{"source":"isf-data-foundation-catalog"}}' --type=merge

oc patch -n openshift-storage $(oc get subs -n openshift-storage -l operators.coreos.com/odf-csi-addons-operator.openshift-storage= -o name) --patch '{"spec":{"source":"isf-data-foundation-catalog"}}' --type=merge

Verify the OpenShift Data Foundation subscription’s catalogsource name is changed.

Make sure all the catalogsource name is updated.

oc get subscriptions.operators.coreos.com -n openshift-storage

Sample output:

NAME                                                                         PACKAGE                   SOURCE                        CHANNEL
mcg-operator-stable-4.13-redhat-operators-openshift-marketplace              mcg-operator              isf-data-foundation-catalog   stable-4.13
ocs-operator-stable-4.13-redhat-operators-openshift-marketplace              ocs-operator              isf-data-foundation-catalog   stable-4.13
odf-csi-addons-operator-stable-4.13-redhat-operators-openshift-marketplace   odf-csi-addons-operator   isf-data-foundation-catalog   stable-4.13
odf-operator

Review the installpan and click Approve, and then wait until all the IBM Storage Fusion Data Foundation pods are upgraded.
Verify the operator status.
1. Check the Version of Fusion Data Foundation and the operator status
  1. Go to Operators > Installed Operators and select the openshift-storage project.
  2. When the upgrade completes, the version updates to a new version number for Fusion Data Foundation and status changes to Succeeded with a green tick.
Verify Fusion Data Foundation cluster is healthy and data is resilient in the IBM Storage Fusion user interface > Data Foundation page. Alternatively, go to Storage > Data Foundation > Storage Systems tab and then click the storage system name. Check for the green tick on the status card of Overview- Block and File and Object tabs. Green tick indicates that the storage cluster, object service, and data resiliency are healthy.

Verify all the CSVs under openshift-storage are Succeeded.

oc get csv -n openshift-storage

Sample output:

NAME                              DISPLAY                          VERSION   REPLACES                                PHASE
mcg-operator.v4.13             NooBaa Operator                      4.13    mcg-operator.v4.13-rhodf              Succeeded
ocs-operator.v4.13              Container Storage                    4.13   ocs-operator.v4.13-rhodf              Succeeded
odf-csi-addons-operator.v4.13   CSI Addons                           4.13    odf-csi-addons-operator.v4.13-rhodf   Succeeded
odf-operator.v4.13              IBM Storage Fusion Data Foundation   4.13    odf-operator.v4.13-rhodf              Succeeded

Note: If any of the verification steps fail, contact IBM Support.

Set the update strategy approval back to Automatic to deploy the latest version as soon as its available.