Chapter 3. Updating Red Hat OpenShift Container Storage 4.8 to Red Hat OpenShift Data Foundation 4.9
This chapter helps you to upgrade between the z-stream release for all Red Hat OpenShift Data Foundation deployments (Internal, Internal-Attached and External). The upgrade process remains the same for all deployments. The Only difference is what gets upgraded and what’s not.
- For Internal and Internal-attached deployments, upgrading OpenShift Container Storage upgrades all OpenShift Container Storage services including the backend Ceph Storage cluster.
For External mode deployments, upgrading OpenShift Container Storage only upgrades the OpenShift Container Storage service while the backend Ceph storage cluster remains untouched and needs to be upgraded separately.
We recommend upgrading RHCS along with OpenShift Container Storage in order to get new feature support, security fixes, and other bug fixes. Since we do not have a strong dependency on RHCS upgrade, you can upgrade the OpenShift Data Foundation operator first followed by RHCS upgrade or vice-versa. See solution to know more about Red Hat Ceph Storage releases.
Upgrading to 4.9 directly from any version older than 4.8 is unsupported.
Prerequisites
- Ensure that the OpenShift Container Platform cluster has been updated to the latest stable release of version 4.9.X, see Updating Clusters.
Ensure that the OpenShift Container Storage cluster is healthy and data is resilient.
- Navigate to Storage → Overview and check both Block and File and Object tabs for the green tick on the status card. Green tick indicates that the storage cluster, object service and data resiliency are all healthy.
Ensure that all OpenShift Container Storage Pods, including the operator pods, are in Running state in the
openshift-storage
namespace.To view the state of the pods, on the OpenShift Web Console, click Workloads → Pods. Select
openshift-storage
from the Project drop-down list.NoteIf the Show default projects option is disabled, use the toggle button to list all the default projects.
- Ensure that you have sufficient time to complete the OpenShift Data Foundation update process, as the update time varies depending on the number of OSDs that run in the cluster.
Procedure
- On the OpenShift Web Console, navigate to OperatorHub.
-
Search for
OpenShift Data Foundation
using the Filter by keyword box and click on the OpenShift Data Foundation tile. - Click Install.
On the install Operator page, click Install. Wait for the Operator installation to complete.
NoteWe recommend using all default settings. Changing it may result in unexpected behavior. Alter only if you are aware of its result.
Verification steps
Verify that the page displays Succeeded message along with the option to Create StorageSystem.
NoteFor the upgraded clusters, since the storage system is automatically created, do not create it again.
- On the notification popup, click Refresh web console link to reflect the OpenShift Data Foundation changes in the OpenShift console.
Verify the state of the pods on the OpenShift Web Console.
- Click Workloads → Pods.
Select
openshift-storage
from the Project drop-down list.NoteIf the Show default projects option is disabled, use the toggle button to list all the default projects.
Wait for all the pods in the
openshift-storage
namespace to restart and reachRunning
state.
Verify that the OpenShift Data Foundation cluster is healthy and data is resilient.
- Navigate to Storage → OpenShift Data foundation → Storage Systems tab and then click on the storage system name.
- Check both Block and File and Object tabs for the green tick on the status card. Green tick indicates that the storage cluster, object service and data resiliency are all healthy.
In case the console plugin option was not automatically enabled after you installed the OpenShift Data Foundation Operator, you need to enable it.
For more information on how to enable the console plugin, see Enabling the Red Hat OpenShift Data Foundation console plugin.
- After updating external mode deployments, you must also update the external secret. For instructions, see Updating the OpenShift Data Foundation external secret.
Additional Resources
If you face any issues while updating OpenShift Data Foundation, see the Commonly required logs for troubleshooting section in the Troubleshooting guide.