[OSDOCS#18553]: Modularization for 4.20 Z-Stream Release Notes by bjahagir-OpenShift · Pull Request #107829 · openshift/openshift-docs

bjahagir-OpenShift · 2026-03-03T17:49:35Z

Version(s):
4.20

Issue:
https://issues.redhat.com/browse/OSDOCS-18553

Link to docs preview:

QE review:
N/A

ocpdocs-previewbot · 2026-03-03T17:57:59Z

🤖 Tue Mar 03 17:57:58 - Prow CI generated the docs preview:

https://107829--ocpdocs-pr.netlify.app/
https://107829--ocpdocs-pr.netlify.app/openshift-enterprise/latest/release_notes/ocp-4-20-release-notes.html

ocpdocs-vale-bot · 2026-03-03T17:59:09Z

modules/zstream-4-20-0.adoc

+
+[id="ocp-4-20-0-updating_{context}"]
+== Updating
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:12Z

modules/zstream-4-20-1.adoc

+
+[id="ocp-4-20-1-updating_{context}"]
+== Updating
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:15Z

modules/zstream-4-20-10.adoc

+[id="zstream-4-20-10-updating_{context}"]
+== Updating
+
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:18Z

modules/zstream-4-20-11.adoc

@@ -19,3 +41,8 @@ The following issues are fixed for this release:
 * Before this update, the instance architecture in worker machines did not match the Amazon Machine Image (AMI) architecture, which caused a mismatch with the user's instance type. This resulted in failed installations. With this release, the ARM64 AMI architecture mismatch with the x86_64 instance type is resolved. As a result, the installation process does not fail due to an architecture mismatch and improves the successful provisioning of worker machines. (link:https://issues.redhat.com/browse/OCPBUGS-70322[OCPBUGS-70322])

 * Before this update, a {op-system-first} networking timeout occurred during agent-based {product-title} installation on Virtual Local Area Network (VLAN) interfaces. As a consequence, {op-system} nodes failed to automatically configure networking during installation on bare metal systems. With this release, the {op-system} networking auto-configuration timeout has been fixed, allowing automatic network setup. As a result, {op-system} nodes automatically configure networking during installation on bare metal systems. (link:https://issues.redhat.com/browse/OCPBUGS-71212[OCPBUGS-71212])


🤖 [error] RedHat.TermsErrors: Use 'bare-metal systems' rather than 'bare metal systems'. For more information, see RedHat.TermsErrors.

ocpdocs-vale-bot · 2026-03-03T17:59:20Z

modules/zstream-4-20-11.adoc

@@ -19,3 +41,8 @@ The following issues are fixed for this release:
 * Before this update, the instance architecture in worker machines did not match the Amazon Machine Image (AMI) architecture, which caused a mismatch with the user's instance type. This resulted in failed installations. With this release, the ARM64 AMI architecture mismatch with the x86_64 instance type is resolved. As a result, the installation process does not fail due to an architecture mismatch and improves the successful provisioning of worker machines. (link:https://issues.redhat.com/browse/OCPBUGS-70322[OCPBUGS-70322])

 * Before this update, a {op-system-first} networking timeout occurred during agent-based {product-title} installation on Virtual Local Area Network (VLAN) interfaces. As a consequence, {op-system} nodes failed to automatically configure networking during installation on bare metal systems. With this release, the {op-system} networking auto-configuration timeout has been fixed, allowing automatic network setup. As a result, {op-system} nodes automatically configure networking during installation on bare metal systems. (link:https://issues.redhat.com/browse/OCPBUGS-71212[OCPBUGS-71212])


🤖 [error] RedHat.TermsErrors: Use 'bare-metal systems' rather than 'bare metal systems'. For more information, see RedHat.TermsErrors.

ocpdocs-vale-bot · 2026-03-03T17:59:22Z

modules/zstream-4-20-11.adoc

+[id="zstream-4-20-11-updating_{context}"]
+== Updating
+
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:25Z

modules/zstream-4-20-12.adoc

+[id="zstream-4-20-12-updating_{context}"]
+== Updating
+
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:27Z

modules/zstream-4-20-13.adoc

+[id="zstream-4-20-13-updating_{context}"]
+== Updating
+
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:30Z

modules/zstream-4-20-14.adoc

 == Updating

-To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:33Z

modules/zstream-4-20-2.adoc

+
+* Before this update, the *Observe -> Metric* page used the cluster-wide metrics API even when you did not have cluster-wide metrics API permissions. As a consequence, the query input displayed an error and the autofill for the query input did not work without cluster-wide metrics API access. With this release, the `namespace-tenancy` metrics API is used if you do not have cluster-wide metrics API permissions, As a result, an error does not occur and autofill is available for the metrics within the selected namespace. (link:https://issues.redhat.com/browse/OCPBUGS-63440[OCPBUGS-63440])
+
+* Before this update, the node log length was unlimited. As a consequence, an extremely large log could prevent the display of the log or cause the browser to crash.  With this release, the node log length is limited to 1,000 lines. As a result, the log displays correctly. (link:https://issues.redhat.com/browse/OCPBUGS-63440[OCPBUGS-63470])


🤖 [error] RedHat.Spacing: Keep one space between words in 'crash. With'. For more information, see RedHat.Spacing.

ocpdocs-vale-bot · 2026-03-03T17:59:35Z

modules/zstream-4-20-2.adoc

+[id="ocp-4-20-2-updating_{context}"]
+== Updating
+
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:39Z

modules/zstream-4-20-3.adoc

+[id="ocp-4-20-3-updating_{context}"]
+== Updating
+
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:42Z

modules/zstream-4-20-4.adoc

+
+* Before this update, during rolling cluster updates from etcd 3.5.19 to a release of 3.6, the wrong membership data could be propagated to new members. As a consequence, cluster updates failed with an error indicating too many learner members in the cluster. With this release, etcd is updated to 3.5.24, which includes fixes that prevent membership-related errors. (link:https://issues.redhat.com/browse/OCPBUGS-63474[OCPBUGS-63474])
+
+* Before this update, the `ccoctl` utility would automatically generate a new keypair if the private key was not found, even when users intentionally provided only the public key as per documented security procedures. This behavior caused a problem, as the newly generated keys would not match the cluster's keys, resulting in service outages for users following the correct process. With this update, the utility was changed to ensure a new keypair is never generated when the `--public-key-file` parameter is specified, and this parameter was added to all create-all functions for consistency. As a result, specifying the public key file now guarantees the provided key is used, ensuring the cluster continues to function as expected without interruption. (link:https://issues.redhat.com/browse/OCPBUGS-63546[OCPBUGS-63546])


🤖 [error] RedHat.TermsErrors: Use 'according to', 'as', or 'as in' rather than 'as per'. For more information, see RedHat.TermsErrors.

ocpdocs-vale-bot · 2026-03-03T17:59:44Z

modules/zstream-4-20-4.adoc

+[id="ocp-4-20-4-updating_{context}"]
+== Updating
+
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:47Z

modules/zstream-4-20-5.adoc

+Support for additional claim mappings::
+You can now use the `uid` and `extra` claim mapping fields when configuring an external OIDC provider for direct authentication.
+
+For more information, see xref:../authentication/external-auth.adoc#external-auth[Enabling direct authentication with an external OIDC identity provider].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:49Z

modules/zstream-4-20-5.adoc

+[id="zstream-4-20-5-updating_{context}"]
+== Updating
+
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:52Z

modules/zstream-4-20-6.adoc

+
+For more information, see the following documentation:
+
+* xref:../installing/installing_with_agent_based_installer/installing-ove.adoc#installing-ove[Installing a cluster without an external registry]


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:54Z

modules/zstream-4-20-6.adoc

+[id="zstream-4-20-6-updating_{context}"]
+== Updating
+
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

ocpdocs-vale-bot · 2026-03-03T17:59:57Z

modules/zstream-4-20-8.adoc

+[id="zstream-4-20-8-updating_{context}"]
+== Updating
+
+To update an {product-title} 4.20 cluster to this latest release, see xref:../updating/updating_a_cluster/updating-cluster-cli.adoc#updating-cluster-cli[Updating a cluster using the CLI].


🤖 [error] OpenShiftAsciiDoc.NoXrefInModules: Do not include xrefs in modules, only assemblies (exception: release notes modules).

openshift-ci · 2026-03-03T18:02:26Z

@bjahagir-OpenShift: all tests passed!

Full PR test history. Your PR dashboard.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

Modularization for 4.20

0e3ed10

openshift-ci bot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label Mar 3, 2026

ocpdocs-vale-bot reviewed Mar 3, 2026

View reviewed changes

		@@ -19,3 +41,8 @@ The following issues are fixed for this release:
		* Before this update, the instance architecture in worker machines did not match the Amazon Machine Image (AMI) architecture, which caused a mismatch with the user's instance type. This resulted in failed installations. With this release, the ARM64 AMI architecture mismatch with the x86_64 instance type is resolved. As a result, the installation process does not fail due to an architecture mismatch and improves the successful provisioning of worker machines. (link:https://issues.redhat.com/browse/OCPBUGS-70322[OCPBUGS-70322])

		* Before this update, a {op-system-first} networking timeout occurred during agent-based {product-title} installation on Virtual Local Area Network (VLAN) interfaces. As a consequence, {op-system} nodes failed to automatically configure networking during installation on bare metal systems. With this release, the {op-system} networking auto-configuration timeout has been fixed, allowing automatic network setup. As a result, {op-system} nodes automatically configure networking during installation on bare metal systems. (link:https://issues.redhat.com/browse/OCPBUGS-71212[OCPBUGS-71212])


		* Before this update, the Observe -> Metric page used the cluster-wide metrics API even when you did not have cluster-wide metrics API permissions. As a consequence, the query input displayed an error and the autofill for the query input did not work without cluster-wide metrics API access. With this release, the `namespace-tenancy` metrics API is used if you do not have cluster-wide metrics API permissions, As a result, an error does not occur and autofill is available for the metrics within the selected namespace. (link:https://issues.redhat.com/browse/OCPBUGS-63440[OCPBUGS-63440])

		* Before this update, the node log length was unlimited. As a consequence, an extremely large log could prevent the display of the log or cause the browser to crash. With this release, the node log length is limited to 1,000 lines. As a result, the log displays correctly. (link:https://issues.redhat.com/browse/OCPBUGS-63440[OCPBUGS-63470])


		* Before this update, during rolling cluster updates from etcd 3.5.19 to a release of 3.6, the wrong membership data could be propagated to new members. As a consequence, cluster updates failed with an error indicating too many learner members in the cluster. With this release, etcd is updated to 3.5.24, which includes fixes that prevent membership-related errors. (link:https://issues.redhat.com/browse/OCPBUGS-63474[OCPBUGS-63474])

		* Before this update, the `ccoctl` utility would automatically generate a new keypair if the private key was not found, even when users intentionally provided only the public key as per documented security procedures. This behavior caused a problem, as the newly generated keys would not match the cluster's keys, resulting in service outages for users following the correct process. With this update, the utility was changed to ensure a new keypair is never generated when the `--public-key-file` parameter is specified, and this parameter was added to all create-all functions for consistency. As a result, specifying the public key file now guarantees the provided key is used, ensuring the cluster continues to function as expected without interruption. (link:https://issues.redhat.com/browse/OCPBUGS-63546[OCPBUGS-63546])


		For more information, see the following documentation:

		* xref:../installing/installing_with_agent_based_installer/installing-ove.adoc#installing-ove[Installing a cluster without an external registry]

Conversation

bjahagir-OpenShift commented Mar 3, 2026

Uh oh!

ocpdocs-previewbot commented Mar 3, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

openshift-ci bot commented Mar 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants