---
name: openshift-openshift_versions_417
title: 4.17 version information and update actions
description: Review information about version 4.17 of Red Hat OpenShift on IBM Cloud. This version is based on Kubernetes version 1.30.
last-updated: 2026-07-30
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/openshift?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# 4.17 version information and update actions
{: #cs_versions_417}

Review information about version 4.17 of Red Hat OpenShift on IBM Cloud. This version is based on Kubernetes version 1.30. 
{: shortdesc}

Looking for general information about updating clusters, or information on a different version? See [Red Hat Red Hat OpenShift on IBM Cloud version information](https://cloud.ibm.com/docs/openshift?topic=openshift-openshift_versions&format=markdown) and the version [4.17 release notes](https://docs.redhat.com/en/documentation/openshift_container_platform/4.17/html/release_notes/ocp-4-17-release-notes#ocp-4-17-release-notes){: external}.
{: tip}


![This badge indicates Kubernetes version 1.30 certification for Red Hat OpenShift on IBM Cloud](images/certified-kubernetes-color.svg){: caption="Kubernetes version 1.30 certification badge" caption-side="bottom"}

Red Hat OpenShift on IBM Cloud is a Certified Kubernetes product for version 1.30 under the CNCF Kubernetes Software Conformance Certification program. _Kubernetes® is a registered trademark of The Linux Foundation in the United States and other countries, and is used pursuant to a license from The Linux Foundation._


## Release timeline 
{: #release_timeline_417}

The following table includes the expected release timeline for version 4.17. You can use this information for planning purposes, such as to estimate the general time that the version might become unsupported. 
{: shortdesc}

Dates that are marked with a dagger (`†`) are tentative and subject to change.
{: important}

| Supported? | Red Hat OpenShift / Kubernetes version | Release date | Unsupported date |
| --- | --- | --- | --- |
| Supported | 4.17 / 1.30 | 20 November 2024 | 23 October 2026`†` |
{: caption="Release history for Red Hat OpenShift on IBM Cloud version 4.17." caption-side="bottom"}


## Preparing to update
{: #prep-up-417}

Review changes that you might need to make when you [update a cluster](https://cloud.ibm.com/docs/openshift?topic=openshift-update&format=markdown) to version 4.17. This information summarizes updates that are likely to have an impact on deployed apps when you update.
{: shortdesc}


### Update before master
{: #417_before}

The following table shows the actions that you must take before you [update the cluster master](https://cloud.ibm.com/docs/openshift?topic=openshift-update&format=markdown#master).
{: shortdesc}

For clusters that run version 4.17 or later, you can use the `oc adm upgrade status` command to check the update status of your cluster master during a master version update. For more information, see [Viewing cluster upgrade status with the `oc adm upgrade status` command](https://cloud.ibm.com/docs/openshift?topic=openshift-upgrade-status&format=markdown).
{: tip}

| Type | Description |
| --- | --- |
| Preparing to update OpenShift | For more information, review the [Preparing to update to OpenShift Container Platform 4.17](https://docs.redhat.com/en/documentation/openshift_container_platform/4.17/html/updating_clusters/preparing-to-update-a-cluster) for possible actions required. The etcd backup and version selection upgrade preparation actions do not apply to Red Hat OpenShift on IBM Cloud clusters since both of these actions are handled for you. |
| Deprecated and removed OpenShift features | For more information, review the [OpenShift Container Platform version 4.17 deprecated and removed features](https://docs.redhat.com/en/documentation/openshift_container_platform/4.17/html/release_notes/ocp-4-17-release-notes#ocp-4-17-deprecated-removed-features_release-notes) for possible actions required. |
| Known OpenShift issues | For more information, review the [OpenShift Container Platform version 4.17 known issues](https://docs.redhat.com/en/documentation/openshift_container_platform/4.17/html/release_notes/ocp-4-17-release-notes#ocp-4-17-known-issues_release-notes) for possible actions required. |
| Upgrade requires OpenShift cluster version currency | A cluster master upgrade will be canceled if the OpenShift cluster version status indicates that an update is already in progress. See [Why does OpenShift show the cluster version is not up to date?](https://cloud.ibm.com/docs/openshift?topic=openshift-ts-cluster-version-downlevel&format=markdown) for details. |
| Upgrade requires resolution to OpenShift cluster version upgradeable conditions | A cluster master upgrade will be canceled if the OpenShift cluster version `Upgradeable` status condition indicates that the cluster is not upgradeable. To determine if the cluster is upgradeable, see [Checking the Upgradeable status of your cluster](https://cloud.ibm.com/docs/openshift?topic=openshift-cs_versions_417&format=markdown#status-check-417). |
| RHEL 9.2 micro-architecture requirement | Red Hat OpenShift on IBM Cloud version 4.17 is based on the RHEL 9.2 host operating system thus increasing the [micro-architecture requirements](https://docs.redhat.com/en/documentation/openshift_container_platform/4.17/html/updating_clusters/preparing-to-update-a-cluster#rhel-micro-architecture-update-requirements){: external} to x86-64-v2. As a result, host machines for IBM Cloud Satellite must support x86-64-v2 architecture for any location that contains a Red Hat OpenShift on IBM Cloud version 4.17 cluster. See [Host system requirements](https://cloud.ibm.com/docs/satellite?topic=satellite-host-reqs&format=markdown) for details. In addition, client machines used to run `oc` client version 4.17 must also support x86-64-v2 architecture. Client machines that do not meet this micro-architecture requirement must use a RHEL 8 based `oc` version 4.17 client. Review the list of available `oc` [version 4.17 clients](https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable-4.17/){: external} |
| RHEL 9 is the default operating system | RHEL 9 is now the default operating system for Red Hat OpenShift on IBM Cloud version 4.17 Classic or VPC clusters. Upgrading a cluster to version 4.17 does not change the operating system for an existing worker pool. For more information and possible migration actions related to RHEL 9, see [Migrating to a new Red Hat Enterprise Linux version](https://cloud.ibm.com/docs/openshift?topic=openshift-rhel_migrate&format=markdown). |
| Node label `node-role.kubernetes.io/master` removed | VPC clusters with CoreOS enabled no longer set the `node-role.kubernetes.io/master` node label for version 4.17 worker nodes. If your apps rely on this node label, update them accordingly. |
{: caption="Changes to make before you update the master to Red Hat OpenShift 4.17" caption-side="bottom"}

## Checking the `Upgradeable` status of your cluster
{: #status-check-417}

Run the following command to check the `Upgradeable` status of your cluster.

```sh
oc get clusterversion version -o json | jq '.status.conditions[] | select(.type == "Upgradeable")'
```
{: pre}

Example output where the `Upgradeable` status is `False`.

```sh
{
  "lastTransitionTime": "2024-11-17T19:29:34Z",
  "message": "Cluster operator operator-lifecycle-manager should not be upgraded between minor versions: ClusterServiceVersions blocking cluster upgrade: default/test is incompatible with OpenShift minor versions greater than 4.16",
  "reason": "IncompatibleOperatorsInstalled",
  "status": "False",
  "type": "Upgradeable"
}
```
{: screen}

If the `Upgradeable` status is `False`, the condition information provides instructions that must be followed before upgrading.


## RHEL 9
{: #417_rhel9}

RHEL 9 is available for Classic or VPC clusters that run version 4.17.

You can provision a new cluster with RHEL 9 in the console by specifying the RHEL operating system for your worker node flavor or [in the CLI](https://cloud.ibm.com/docs/openshift?topic=openshift-kubernetes-service-cli&format=markdown#cluster-create-vpc-gen2-cli) by including the `--operating-system RHEL_9_64` option when you run the `ibmcloud oc cluster create` command. 

If you upgrade an existing cluster to version 4.17 and want your worker nodes to run RHEL 9, you must [follow the steps to migrate your worker nodes](https://cloud.ibm.com/docs/openshift?topic=openshift-rhel_migrate&format=markdown).

For more information on RHEL 9, see the [Red Hat OpenShift release notes](https://docs.redhat.com/documentation/red_hat_enterprise_linux/9/html/9.4_release_notes/index){: external}.