IBM Support

Data Foundation upgrade to version 4.13 is not starting

Troubleshooting


Problem

When attempting to upgrade OpenShift/Fusion Data Foundation to version 4.13, the upgrade may not start when FlashSystems ODF operator is installed. 

Symptom

Despite setting the upgrade channel to 4.13 in the Data Foundation Subscription page, the upgrade will not start and the following error could be observed in Conditions:
constraints not satisfiable: subscription ibm-storage-odf-operator exists, no operators found in channel stable-v1.3 of package ibm-storage-odf-operator in the catalog referenced by subscription ibm-storage-odf-operator

Cause

The issue can happen when the Data Foundation has a FlashSystems storage configured in external mode. When FlashSystems storage configured, ibm-storage-odf-operator is installed. Data Foundation v4.13 supports ibm-storage-odf-operator version 1.4 while Data Foundation v4.12 supports ibm-storage-odf-operator v1.3. During the upgrade process a compatibility issue may arise where Data Foundation upgrade cannot proceed due to version mismatch and manual intervention might be required. 

Environment

  • OCP 4.13
  • ODF/FDF 4.12
  • ibm-storage-odf-operator v1.3

Diagnosing The Problem

Despite setting the upgrade channel to 4.13 in the Data Foundation Subscription page, the upgrade will not start and the following error could be observed in Conditions:
constraints not satisfiable: subscription ibm-storage-odf-operator exists, no operators found in channel stable-v1.3 of package ibm-storage-odf-operator in the catalog referenced by subscription ibm-storage-odf-operator

Resolving The Problem

  1. Validate that the Data Foundation is ready to be upgraded per product documentation
  2. In the OCP console, go to "Installed Operators", choose "OpenShift Data Foundation", go the "Subscription" tab, set the upgrade channel to "stable-4.13"
  3. Open a CLI session
  4. Set the project to openshift-storage 
    • $ oc project openshift-storage
  5. Edit the following configMap:
    • $ oc edit cm odf-operator-manager-config
  6. Set the ibm-storage-odf-operator to version 1.4
    • IBM_SUBSCRIPTION_CHANNEL: stable-v1.4
  7. Set the IBM_SUBSCRIPTION_STARTINGCSV to version 1.4.1
    • IBM_SUBSCRIPTION_STARTINGCSV: ibm-storage-odf-operator.v1.4.1
  8. The relevant portion of this configMap should look like this: 
    •   .
  .
  IBM_SUBSCRIPTION_CATALOGSOURCE: certified-operators
  IBM_SUBSCRIPTION_CATALOGSOURCE_NAMESPACE: openshift-marketplace
  IBM_SUBSCRIPTION_CHANNEL: stable-v1.3
  IBM_SUBSCRIPTION_NAME: ibm-storage-odf-operator
  IBM_SUBSCRIPTION_PACKAGE: ibm-storage-odf-operator
  IBM_SUBSCRIPTION_STARTINGCSV: ibm-storage-odf-operator.v1.3.0
  .
  .
  9. Save and exit.
  10. Restart the odf controller manager pod, e.g.:
    • $ oc get pods | grep odf-operator-control
    • $ oc delete pod odf-operator-controller-manager-xxxxxxxxx-xxxxxx
  11. Wait and confirm the pod is properly restarted
  12. Restart the ocs operator pod, e.g.:
    • $ oc get pods | grep ocs-operator
    • $ oc delete pod ocs-operator-xxxxxxxxx-xxxxx
  13. Wait and confirm the pod is properly restarted
  14. Set the ibm-storage-odf-operator upgrade channel to "stable-v1.4"
    1. Go to Deployments
    2. Choose ibm-storage-odf-operator from the list
    3. Click the operator name under the title
    4. Go to the "Subscription" tab and click "Update Channel"
    5. Set the channel to "stable-v1.4"
  15. Check that the upgrade has started and monitor. One can use the subscription page or 'oc get csv' and/or 'oc get subs' commands.
Step 13 visual:
Step 13.1, 13.2
Step 13.1
Step 13.3
Step 13.3
Step 13.4
Step 13.3
Step 13.5
Step 13.5

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB66","label":"Technology Lifecycle Services"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SSSEWFV","label":"Storage Fusion Data Foundation"},"ARM Category":[{"code":"a8m3p000000UoIUAA0","label":"Documentation"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
23 March 2025

UID

ibm17158068

Page Feedback