mirror of
https://github.com/openshift/openshift-docs.git
synced 2026-02-05 12:46:18 +01:00
83 lines
3.4 KiB
Plaintext
83 lines
3.4 KiB
Plaintext
:_mod-docs-content-type: SNIPPET
|
|
[IMPORTANT]
|
|
====
|
|
Before you acknowledge the update, verify that you are not using any of the Kubernetes APIs that are removed from the version you are updating to.
|
|
For example, in {product-title} 4.17, there are no API removals.
|
|
See "Kubernetes API removals" for more information.
|
|
====
|
|
|
|
.Prerequisites
|
|
|
|
* You have verified that APIs for all of the applications running on your cluster are compatible with the next Y-stream release of {product-title}.
|
|
For more details about compatibility, see "Verifying cluster API versions between update versions".
|
|
|
|
.Procedure
|
|
|
|
* Complete the administrative acknowledgment to start the cluster update by running the following command:
|
|
+
|
|
--
|
|
[source,terminal]
|
|
----
|
|
$ oc adm upgrade
|
|
----
|
|
|
|
If the cluster update does not complete successfully, more details about the update failure are provided in the `Reason` and `Message` sections.
|
|
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
Cluster version is 4.15.45
|
|
|
|
Upgradeable=False
|
|
|
|
Reason: MultipleReasons
|
|
Message: Cluster should not be upgraded between minor versions for multiple reasons: AdminAckRequired,ResourceDeletesInProgress
|
|
* Kubernetes 1.29 and therefore OpenShift 4.16 remove several APIs which require admin consideration. Please see the knowledge article https://access.redhat.com/articles/7031404 for details and instructions.
|
|
* Cluster minor level upgrades are not allowed while resource deletions are in progress; resources=PrometheusRule "openshift-kube-apiserver/kube-apiserver-recording-rules"
|
|
|
|
ReleaseAccepted=False
|
|
|
|
Reason: PreconditionChecks
|
|
Message: Preconditions failed for payload loaded version="4.16.34" image="quay.io/openshift-release-dev/ocp-release@sha256:41bb08c560f6db5039ccdf242e590e8b23049b5eb31e1c4f6021d1d520b353b8": Precondition "ClusterVersionUpgradeable" failed because of "MultipleReasons": Cluster should not be upgraded between minor versions for multiple reasons: AdminAckRequired,ResourceDeletesInProgress
|
|
* Kubernetes 1.29 and therefore OpenShift 4.16 remove several APIs which require admin consideration. Please see the knowledge article https://access.redhat.com/articles/7031404 for details and instructions.
|
|
* Cluster minor level upgrades are not allowed while resource deletions are in progress; resources=PrometheusRule "openshift-kube-apiserver/kube-apiserver-recording-rules"
|
|
|
|
Upstream is unset, so the cluster will use an appropriate default.
|
|
Channel: eus-4.16 (available channels: candidate-4.15, candidate-4.16, eus-4.16, fast-4.15, fast-4.16, stable-4.15, stable-4.16)
|
|
|
|
Recommended updates:
|
|
|
|
VERSION IMAGE
|
|
4.16.34 quay.io/openshift-release-dev/ocp-release@sha256:41bb08c560f6db5039ccdf242e590e8b23049b5eb31e1c4f6021d1d520b353b8
|
|
----
|
|
|
|
[NOTE]
|
|
====
|
|
In this example, a linked Red{nbsp}Hat Knowledgebase article (link:https://access.redhat.com/articles/7031404[Preparing to upgrade to {product-title} 4.16]) provides more detail about verifying API compatibility between releases.
|
|
====
|
|
--
|
|
|
|
.Verification
|
|
|
|
* Verify the update by running the following command:
|
|
+
|
|
--
|
|
[source,terminal]
|
|
----
|
|
$ oc get configmap admin-acks -n openshift-config -o json | jq .data
|
|
----
|
|
|
|
.Example output
|
|
[source,terminal]
|
|
----
|
|
{
|
|
"ack-4.14-kube-1.28-api-removals-in-4.15": "true",
|
|
"ack-4.15-kube-1.29-api-removals-in-4.16": "true"
|
|
}
|
|
----
|
|
|
|
[NOTE]
|
|
====
|
|
In this example, the cluster is updated from version 4.14 to 4.15, and then from 4.15 to 4.16 in a Control Plane Only update.
|
|
====
|
|
-- |