Skip to content

Commit c89a0bf

Browse files
authored
Merge pull request #58413 from mburke5678/GH53296-OKD-updating-section-updates
GH53296 OKD Updating clusters section needs to be updated
2 parents 2cc33f0 + 57cdb7c commit c89a0bf

File tree

7 files changed

+46
-2
lines changed

7 files changed

+46
-2
lines changed

_topic_maps/_topic_map.yml

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -585,8 +585,10 @@ Topics:
585585
File: index
586586
- Name: Understanding OpenShift updates
587587
File: understanding-openshift-updates
588+
Distros: openshift-enterprise
588589
- Name: Understanding upgrade channels
589590
File: understanding-upgrade-channels-release
591+
Distros: openshift-enterprise
590592
- Name: Understanding OpenShift update duration
591593
File: understanding-openshift-update-duration
592594
- Name: Preparing to update to OpenShift Container Platform 4.13
@@ -597,6 +599,7 @@ Topics:
597599
Distros: openshift-origin
598600
- Name: Preparing to perform an EUS-to-EUS update
599601
File: preparing-eus-eus-upgrade
602+
Distros: openshift-enterprise
600603
- Name: Preparing to update a cluster with manually maintained credentials
601604
File: preparing-manual-creds-update
602605
- Name: Updating a cluster using the web console
@@ -612,18 +615,23 @@ Topics:
612615
Distros: openshift-enterprise
613616
- Name: Updating a cluster in a disconnected environment
614617
Dir: updating-restricted-network-cluster
615-
Distros: openshift-enterprise
616618
Topics:
617619
- Name: About cluster updates in a disconnected environment
618620
File: index
619621
- Name: Mirroring the OpenShift Container Platform image repository
620622
File: mirroring-image-repository
621623
- Name: Updating a cluster in a disconnected environment using OSUS
622624
File: restricted-network-update-osus
625+
Distros: openshift-enterprise
623626
- Name: Updating a cluster in a disconnected environment without OSUS
624627
File: restricted-network-update
628+
Distros: openshift-enterprise
629+
- Name: Updating a cluster in a disconnected environment by using the CLI
630+
File: restricted-network-update
631+
Distros: openshift-origin
625632
- Name: Uninstalling OSUS from a cluster
626633
File: uninstalling-osus
634+
Distros: openshift-enterprise
627635
- Name: Updating hardware on nodes running on vSphere
628636
File: updating-hardware-on-nodes-running-on-vsphere
629637
- Name: Preflight validation for Kernel Module Management (KMM) Modules

modules/update-changing-update-server-web.adoc

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,12 @@
55
:_content-type: PROCEDURE
66
[id="update-changing-update-server-web_{context}"]
77
= Changing the update server by using the web console
8-
8+
ifndef::openshift-origin[]
99
Changing the update server is optional. If you have an OpenShift Update Service (OSUS) installed and configured locally, you must set the URL for the server as the `upstream` to use the local server during updates.
10+
endif::openshift-origin[]
11+
ifdef::openshift-origin[]
12+
Changing the update server is optional.
13+
endif::openshift-origin[]
1014

1115
.Procedure
1216

modules/update-upgrading-web.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,12 +24,17 @@ link:https://access.redhat.com/downloads/content/290[in the errata section] of t
2424

2525
. From the web console, click *Administration* -> *Cluster Settings* and review the contents of the *Details* tab.
2626

27+
ifndef::openshift-origin[]
2728
. For production clusters, ensure that the *Channel* is set to the correct channel for the version that you want to update to, such as `stable-{product-version}`.
2829
+
2930
[IMPORTANT]
3031
====
3132
For production clusters, you must subscribe to a `stable-\*`, `eus-*` or `fast-*` channel.
3233
====
34+
endif::openshift-origin[]
35+
ifdef::openshift-origin[]
36+
. For production clusters, ensure that the *Channel* is set to `stable-4`.
37+
endif::openshift-origin[]
3338
+
3439
[NOTE]
3540
====

updating/index.adoc

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,29 +8,43 @@ toc::[]
88

99
You can update an {product-title} 4 cluster with a single operation by using the web console or the OpenShift CLI (`oc`).
1010

11+
ifndef::openshift-origin[]
1112
[id="updating-clusters-overview-understanding-container-platform-updates"]
1213
== Understanding OpenShift Container Platform updates
1314
xref:../updating/understanding-openshift-updates.adoc#update-service-about_understanding-openshift-updates[About the OpenShift Update Service]: For clusters with internet access, Red Hat provides over-the-air updates by using an {product-title} update service as a hosted service located behind public APIs.
15+
endif::openshift-origin[]
1416

1517
[id="updating-clusters-overview-upgrade-channels-and-releases"]
1618
== Understanding upgrade channels and releases
19+
ifndef::openshift-origin[]
1720
xref:../updating/understanding-upgrade-channels-release.adoc#understanding-upgrade-channels_understanding-upgrade-channels-releases[Upgrade channels and releases]: With upgrade channels, you can choose an upgrade strategy. Upgrade channels are specific to a minor version of {product-title}. Upgrade channels only control release selection and do not impact the version of the cluster that you install. The `openshift-install` binary file for a specific version of the {product-title} always installs that minor version. For more information, see the following:
1821

1922
* xref:../updating/understanding-upgrade-channels-release.adoc#upgrade-version-paths_understanding-upgrade-channels-releases[Upgrading version paths]
2023
* xref:../updating/understanding-upgrade-channels-release.adoc#fast-stable-channel-strategies_understanding-upgrade-channels-releases[Understanding fast and stable channel use and strategies]
2124
* xref:../updating/understanding-upgrade-channels-release.adoc#restricted-network-clusters_understanding-upgrade-channels-releases[Understanding restricted network clusters]
2225
* xref:../updating/understanding-upgrade-channels-release.adoc#switching-between-channels_understanding-upgrade-channels-releases[Switching between channels]
2326
* xref:../updating/understanding-upgrade-channels-release.adoc#conditional-updates-overview_understanding-upgrade-channels-releases[Understanding conditional updates]
27+
endif::openshift-origin[]
28+
ifdef::openshift-origin[]
29+
With upgrade channels, you can choose an upgrade strategy. Upgrade channels are specific to a minor version of {product-title}. Upgrade channels only control release selection and do not impact the version of the cluster that you install. The `openshift-install` binary file for a specific version of the {product-title} always installs that minor version.
30+
31+
{product-title} {product-version} offers the following update channel:
32+
33+
* `stable-4`
34+
endif::openshift-origin[]
35+
2436

2537
include::modules/determining-upgrade-viability-conditiontype.adoc[leveloffset=+1]
2638

2739
include::modules/determining-upgrade-viability-cv-conditiontype.adoc[leveloffset=+1]
2840

41+
ifndef::openshift-origin[]
2942
[id="updating-clusters-overview-prepare-eus-to-eus-update"]
3043
== Preparing to perform an EUS-to-EUS update
3144
xref:../updating/preparing-eus-eus-upgrade.adoc#preparing-eus-eus-upgrade[Preparing to perform an EUS-to-EUS update]: Due to fundamental Kubernetes design, all {product-title} updates between minor versions must be serialized. You must update from {product-title} 4.10 to 4.11, and then to 4.12. You cannot update from {product-title} 4.10 to 4.12 directly. However, if you want to update between two Extended Update Support (EUS) versions, you can do so by incurring only a single reboot of non-control plane hosts. For more information, see the following:
3245

3346
* xref:../updating/preparing-eus-eus-upgrade.adoc#updating-eus-to-eus-upgrade_eus-to-eus-upgrade[Updating EUS-to-EUS]
47+
endif::openshift-origin[]
3448

3549
[id="updating-clusters-overview-update-cluster-using-web-console"]
3650
== Updating a cluster using the web console
@@ -61,13 +75,15 @@ xref:../updating/update-using-custom-machine-config-pools.adoc#update-using-cust
6175
* xref:../updating/update-using-custom-machine-config-pools.adoc#update-using-custom-machine-config-pools-unpause_update-using-custom-machine-config-pools[Unpausing the machine configuration pools]
6276
* xref:../updating/update-using-custom-machine-config-pools.adoc#update-using-custom-machine-config-pools-mcp-remove_update-using-custom-machine-config-pools[Moving a node to the original machine configuration pool]
6377

78+
ifndef::openshift-origin[]
6479
[id="updating-clusters-overview-update-cluster-with-rhel-compute-machines"]
6580
== Updating a cluster that includes {op-system-base} compute machines
6681
xref:../updating/updating-cluster-rhel-compute.adoc#updating-cluster-rhel-compute[Updating a cluster that includes {op-system-base} compute machines]: If your cluster contains {op-system-base-full} machines, you must perform additional steps to update those machines. You can perform the following procedures:
6782

6883
* xref:../updating/updating-cluster-rhel-compute.adoc#update-upgrading-web_updating-cluster-rhel-compute[Updating a cluster by using the web console]
6984
* xref:../updating/updating-cluster-rhel-compute.adoc#updating-cluster-rhel-compute-hooks[Optional: Adding hooks to perform Ansible tasks on {op-system-base} machines]
7085
* xref:../updating/updating-cluster-rhel-compute.adoc#rhel-compute-updating-minor_updating-cluster-rhel-compute[Updating {op-system-base} compute machines in your cluster]
86+
endif::openshift-origin[]
7187

7288
[id="updating-clusters-overview-update-restricted-network-cluster"]
7389
== Updating a cluster in a disconnected environment

updating/understanding-openshift-update-duration.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,9 +39,11 @@ include::modules/update-duration-mco.adoc[leveloffset=+2]
3939

4040
include::modules/update-duration-estimate-cluster-update-time.adoc[leveloffset=+1]
4141

42+
ifndef::openshift-origin[]
4243
include::modules/update-duration-rhel-nodes.adoc[leveloffset=+1]
4344

4445
[role="_additional-resources"]
4546
.Additional resources
4647

4748
* xref:../updating/updating-cluster-rhel-compute.adoc#updating-cluster-rhel-compute[Updating RHEL compute machines]
49+
endif::openshift-origin[]

updating/updating-cluster-cli.adoc

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,9 +55,12 @@ include::modules/update-upgrading-cli.adoc[leveloffset=+1]
5555

5656
include::modules/update-conditional-updates.adoc[leveloffset=+1]
5757

58+
// OKD removed the section that this link points to.
59+
ifndef::openshift-origin
5860
[role="_additional-resources"]
5961
.Additional resources
6062

6163
* xref:../updating/understanding-upgrade-channels-release.adoc#understanding-upgrade-channels_understanding-upgrade-channels-releases[Upgrade channels and release paths]
64+
endif::openshift-origin
6265

6366
include::modules/update-changing-update-server-cli.adoc[leveloffset=+1]

updating/updating-restricted-network-cluster/restricted-network-update.adoc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
:_content-type: ASSEMBLY
2+
ifndef::openshift-origin[]
23
[id="updating-restricted-network-cluster"]
34
= Updating a cluster in a disconnected environment without the OpenShift Update Service
5+
endif::openshift-origin[]
6+
ifdef::openshift-origin[]
7+
[id="updating-restricted-network-cluster"]
8+
= Updating a cluster in a disconnected environment by using the CLI
9+
endif::openshift-origin[]
410
include::_attributes/common-attributes.adoc[]
511
:context: updating-restricted-network-cluster
612

0 commit comments

Comments
 (0)