1. Documentation
    2. history bug_report picture_as_pdf
×

Upgrading ROSA with HCP

edit

You can upgrade Red Hat OpenShift Service on AWS (ROSA) with hosted control planes (HCP) clusters by individually upgrading the hosted control plane and the machine pools with the ROSA command line interface (CLI), rosa.

Use one of the following methods to upgrade your HCP clusters:

  • Upgrade only your hosted control plane. This does not impact your worker nodes.

  • Upgrade only your machine pool. This initiates a rolling reboot of a specific machine pool and temporarily impacts the worker nodes on the specific machine pool. It does not impact all your worker nodes if you have multiple machine pools.

  • Upgrade your hosted control plane first and then your machine pool.

    If you want to upgrade both your hosted control plane and your machine pool to the same version, you must upgrade the hosted control plane first.

To plan an upgrade, review the ROSA with HCP update life cycle documentation. The life cycle page includes release definitions, support and upgrade requirements, installation policy information, and life cycle dates.

Hosted control plane upgrade duration varies based on your workload configuration, and machine pool upgrade duration varies based on the number of worker nodes.
edit

Upgrading with the ROSA CLI

You can manually upgrade a ROSA with HCP cluster by using the ROSA CLI. This method schedules the cluster for an immediate upgrade if a more recent version is available.

Your control plane only supports machine pools within two minor Y-stream versions. For example, a ROSA with HCP cluster with a control plane using version 4.15.z supports machine pools with version 4.13.z and 4.14.z, but the control plane does not support machine pools using version 4.12.z.
Prerequisites

  • You have installed and configured the latest version of the ROSA CLI.

Procedure

  1. Verify the current version of your cluster by running the following command:

    $ rosa describe cluster --cluster=<cluster_name_or_id> (1)
    1 Replace <cluster_name_or_id> with the cluster name or the cluster ID.

  2. List the versions that you can upgrade your control plane and machine pools to by running the following commands:

    1. For the control plane versions, run the following command:

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

      The command returns a list of available updates, including the recommended version.

      Example output
      VERSION  NOTES
4.14.8   recommended
4.14.7
4.14.6

    2. For the machine pool versions, run the following command:

      $ rosa list upgrade --cluster <cluster-name> --machinepool <machinepool_name>

      The command returns a list of available updates, including the recommended version.

      Example output
      VERSION  NOTES
4.14.5   recommended
4.14.4
4.14.3
4.14.2
4.14.1

      The latest available update for machine pools is limited to the current current version of the control plane. Ensure your control plane is up to date first.

  3. Upgrade your cluster with one of the following options:

    • Upgrade the cluster’s hosted control plane by running the following command:

      $ rosa upgrade cluster -c <cluster_name> --control-plane [--schedule-date=XX --schedule-time=XX] [--version <version_number>]

      Your hosted control plane is now scheduled for an upgrade.

    • Upgrade a specific machine pool on your cluster by running the following command:

      $ rosa upgrade machinepool -c <cluster_name> <your_machine_pool_id> [--schedule-date=XX --schedule-time=XX] [--version <version_number>]

      Your machine pool is now scheduled for an upgrade.

Troubleshooting