Chapter 11. Updating OpenShift Container Storage

It is recommended to use the same version of Red Hat OpenShift Container Platform with Red Hat OpenShift Container Storage. Upgrade Red Hat OpenShift Container Platform first, and then upgrade Red Hat OpenShift Container Storage. Refer to this Red Hat Knowledgebase article for a complete OpenShift Container Platform and OpenShift Container Storage supportability and compatibility matrix.

If using Local Storage Operator, Local Storage Operator version must match with the Red Hat OpenShift Container Platform version in order to have the Local Storage Operator fully supported with Red Hat OpenShift Container Storage. Local Storage Operator does not get upgraded when Red Hat OpenShift Container Platform is upgraded. To check if your OpenShift Container Storage cluster uses the Local Storage Operator, see the Checking for Local Storage Operator deployments section of the Troubleshooting Guide.

Important

If your cluster was deployed using local storage devices and uses the Local Storage Operator in Openshift Container Storage version 4.3, you must re-install the cluster and not upgrade to version 4.4. For details on installation, see Installing OpenShift Container Storage using local storage devices.

11.1. Enabling automatic updates for OpenShift Container Storage operator

Use this procedure to enable automatic update approval for updating OpenShift Container Storage operator in OpenShift Container Platform.

Prerequisites

  • Update the OpenShift Container Platform cluster to the latest stable release of version 4.3.X or 4.4.Y, see Updating Clusters.
  • Switch the Red Hat OpenShift Container Storage channel channel from stable-4.3 to stable-4.4. For details about channels, see OpenShift Container Platform upgrade channels and releases.

    Note

    You are required to switch channels only when you are updating minor versions (for example, updating from 4.3 to 4.4) and not when updating between batch updates of 4.4 (for example, updating from 4.4.0 to 4.4.1).

  • Ensure that all OpenShift Container Storage nodes are in Ready status.
  • Under Persistent Storage in Status card, confirm that the Ceph cluster is healthy and data is resilient.
  • Ensure that you have sufficient time to complete the Openshift Container Storage (OCS) update process, as the update time varies depending on the number of OSDs that run in the cluster.

Procedure

  1. Log in to OpenShift Web Console.
  2. Click OperatorsInstalled Operators
  3. Select the openshift-storage project.
  4. Click on the OpenShift Container Storage operator name.
  5. Click Subscription tab and click the link under Approval.
  6. Select Automatic (default) and click Save.
  7. Perform one of the following depending on the Upgrade Status:

    • Upgrade Status shows requires approval.

      1. Click on the Install Plan link.
      2. On the InstallPlan Details page, click Preview Install Plan.
      3. Review the install plan and click Approve.
      4. Wait for the Status to change from Unknown to Created.
      5. Click OperatorsInstalled Operators
      6. Select the openshift-storage project.
      7. Wait for the Status to change to Up to date
    • Upgrade Status does not show requires approval:

      1. Wait for the update to initiate. This may take up to 20 minutes.
      2. Click OperatorsInstalled Operators
      3. Select the openshift-storage project.
      4. Wait for the Status to change to Up to date

Verification steps

  1. Click Overview → Persistent Storage tab and in Status card confirm that the OpenShift Container Storage cluster has a green tick mark indicating it is healthy.
  2. Click OperatorsInstalled OperatorsOpenShift Container Storage Operator.
  3. Under Storage Cluster, verify that the cluster service status in Ready.

    Note

    Once updated from OpenShift Container Storage version 4.3 to 4.4, the Version field here will still display 4.3. This is because the ocs-operator does not update the string represented in this field.

  4. If verification steps fail, kindly contact Red Hat Support.

11.2. Manually updating OpenShift Container Storage operator

Use this procedure to update OpenShift Container Storage operator by providing manual approval to the install plan.

Prerequisites

  • Update the OpenShift Container Platform cluster to the latest stable release of version 4.3.X or 4.4.Y, see Updating Clusters.
  • Switch the Red Hat OpenShift Container Storage channel channel from stable-4.3 to stable-4.4. For details about channels, see OpenShift Container Platform upgrade channels and releases.

    Note

    You are required to switch channels only when you are updating minor versions (for example, updating from 4.3 to 4.4) and not when updating between batch updates of 4.4 (for example, updating from 4.4.0 to 4.4.1).

  • Ensure that all OpenShift Container Storage nodes are in Ready status.
  • Under Persistent Storage in Status card, confirm that the Ceph cluster is healthy and data is resilient.
  • Ensure that you have sufficient time to complete the Openshift Container Storage (OCS) update process, as the update time varies depending on the number of OSDs that run in the cluster.

Procedure

  1. Log in to OpenShift Web Console.
  2. Click OperatorsInstalled Operators
  3. Select the openshift-storage project.
  4. Click Subscription tab and click the link under Approval.
  5. Select Manual and click Save.
  6. Wait for the Upgrade Status to change to Upgrading.
  7. If the Upgrade Status shows requires approval, click on requires approval.
  8. On the InstallPlan Details page, click Preview Install Plan.
  9. Review the install plan and click Approve.
  10. Wait for the Status to change from Unknown to Created.
  11. Click OperatorsInstalled Operators
  12. Select the openshift-storage project.
  13. Wait for the Status to change to Up to date

Verification steps

  1. Click Overview → Persistent Storage tab and in Status card confirm that the Ceph cluster has a green tick mark indicating it is healthy.
  2. Click OperatorsInstalled OperatorsOpenShift Container Storage Operator.
  3. Under Storage Cluster, verify that the cluster service status in Ready.

    Note

    Once updated from OpenShift Container Storage version 4.3 to 4.4, the Version field here will still display 4.3. This is because the ocs-operator does not update the string represented in this field.

  4. If verification steps fail, kindly contact Red Hat Support.