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:
    1. Verify the isf-data-foundation-catalog is created. 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

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

  1. Change update approval strategy to Manual.
    1. Change update approval strategy to Manual in OpenShift Data Foundation subscription
  2. Modify OpenShift Data Foundation subscription catalog source name.
    1. 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
    2. 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
  3. Verify the OpenShift Data Foundation subscription’s catalogsource name is changed.
    1. 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
  4. Review the installpan and click Approve, and then wait until all the IBM Storage Fusion Data Foundation pods are upgraded.
  5. 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.
  6. 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.
  7. 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.