Chapter 4. Upgrading ROSA with HCP
4.1. Life cycle policies and planning
To plan an upgrade, review the Red Hat OpenShift Service on AWS update life cycle. The life cycle page includes release definitions, support and upgrade requirements, installation policy information and life cycle dates.
You can manually upgrade your cluster. Red Hat Site Reliability Engineers (SREs) monitor upgrade progress and remedy any issues encountered.
4.2. Upgrading a ROSA cluster
You can upgrade Red Hat OpenShift Service on AWS (ROSA) with hosted control planes (HCP) clusters by using individual upgrades through the Red Hat OpenShift Service on AWS (ROSA) CLI,
When following a scheduled upgrade policy, there might be a delay of no more than thirty minutes before the upgrade process begins, even if it is an immediate upgrade. Additionally, the duration of the upgrade might vary based on your workload configuration and with machine pool upgrades, the number of worker nodes.
4.2.1. Upgrading with the ROSA CLI
You can upgrade a Red Hat OpenShift Service on AWS (ROSA) cluster manually by using the ROSA CLI (
This method schedules the cluster for an immediate upgrade, if a more recent version is available.
- You have installed and configured the latest ROSA CLI on your installation host.
To verify the current version of your cluster, enter the following command:
$ rosa describe cluster --cluster=<cluster_name|cluster_id> 1
<cluster_name|cluster_id>with the cluster name or the ID of the cluster.
To verify that an upgrade is available, enter the following command:
$ rosa list upgrade --cluster=<cluster_name|cluster_id>
The command returns a list of versions to which the cluster can be upgraded, including a recommended version.
To upgrade a cluster to the latest available version, enter the following command:
$ rosa upgrade cluster --cluster=<cluster_name|cluster_id> --control-plane
The cluster is scheduled for an immediate upgrade. This action can take an hour or longer, depending on your workload configuration, such as pod disruption budgets.
You will receive an email when the upgrade is complete. You can also check the status by running the
rosa describe clustercommand again from the ROSA CLI or view the status in OpenShift Cluster Manager console.
- Sometimes a scheduled upgrade does not trigger. See Upgrade maintenance cancelled for more information.