How to upgrade ROSA cluster via rosa CLI

Solution Verified - Updated -

Environment

  • Red Hat OpenShift Service on AWS (ROSA)
    • 4

Issue

  • Upgrading a ROSA cluster using rosa CLI

Resolution

Note: Some ROSA versions requires specific steps for upgrading. Refer to OSD/ROSA cluster requires user action before install or upgrade for additional information.

Steps

  1. Please make sure the latest version of rosa CLI is installed and configured by following the documentation Install and configure rosa CLI

  2. To verify the current version of the ROSA cluster, run the following command:

    $ rosa describe cluster --cluster=<cluster_name|cluster_id>

    Replace <cluster_name|cluster_id> with the cluster name or the ID of the cluster.

  3. To make sure an upgrade is available, run the following command

    $ rosa list upgrade --cluster=<cluster_name|cluster_id>

    The above command output provides a list of versions to which the cluster can be upgraded along with the recommended version.

  4. To upgrade the ROSA cluster to the latest version, run the following command:

    $ rosa upgrade cluster --cluster=<cluster_name|cluster_id>

    This command will schedule the cluster for an immediate upgrade.

Note: The above action can take an hour or more depending on the cluster's workload configuration.

It's possible to check the live status by running the rosa describe cluster command again from rosa CLI.

Root Cause

Using oc adm upgrade is not allowed for upgrading ROSA clusters, as the rosa CLI does additional checks before the cluster upgrade.

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.

Comments