Merge pull request #45326 from darshan-nagaraj/OSDOCS-3605

OSDOCS-3605: Added oc adm upgrade channel command

Author: jeana-redhat

modules/update-upgrading-cli.adoc

@@ -37,28 +37,6 @@ NAME      VERSION   AVAILABLE   PROGRESSING   SINCE   STATUS
 version   4.9.23     True        False         158m    Cluster version is 4.9.23
 ----
 
-. Review the current update channel information and confirm that your channel
-is set to `stable-4.10`:
-+
-[source,terminal]
-----
-$ oc get clusterversion -o json|jq ".items[0].spec"
-----
-+
-.Example output
-[source,terminal]
-----
-{
-  "channel": "stable-4.10",
-  "clusterID": "990f7ab8-109b-4c95-8480-2bd1deec55ff"
-}
-----
-+
-[IMPORTANT]
-====
-For production clusters, you must subscribe to a `stable-\*` or `fast-*` channel.
-====
-
 . View the available updates and note the version number of the update that
 you want to apply:
 +
@@ -78,6 +56,25 @@ VERSION IMAGE
 4.10.0  quay.io/openshift-release-dev/ocp-release@sha256:9c5f0df8b192a0d7b46cd5f6a4da2289c155fd5302dec7954f8f06c878160b8b
 ----
 
+. Based on your organization requirements, set the upgrade channel to `stable-4.10`, `fast-4.10`, or `eus-4.10`:
++
+[source,terminal]
+----
+$ oc adm upgrade channel <channel>
+----
++
+For example, to set the channel to `stable-4.10`:
++
+[source,terminal]
+----
+$ oc adm upgrade channel stable-4.10
+----
++
+[IMPORTANT]
+====
+For production clusters, you must subscribe to a `stable-\*`, `eus-*`, or `fast-*` channel.
+====
+
 . Apply an update:
 ** To update to the latest version:
 +
@@ -93,7 +90,7 @@ $ oc adm upgrade --to-latest=true <1>
 $ oc adm upgrade --to=<version> <1>
 ----
 <1> `<version>` is the update version that you obtained from the output of the
-previous command.
+`oc adm upgrade` command.
 
 . Review the status of the Cluster Version Operator:
 +

updating/updating-cluster-cli.adoc

@@ -54,6 +54,12 @@ include::modules/updating-sno.adoc[leveloffset=+1]
 * For information on which machine configuration changes require a reboot, see the note in xref:../architecture/control-plane.adoc#understanding-machine-config-operator_control-plane[Understanding the Machine Config Operator].
 
 include::modules/update-upgrading-cli.adoc[leveloffset=+1]
+
+[role="_additional-resources"]
+.Additional resources
+
+* xref:../updating/understanding-upgrade-channels-release.adoc#understanding-upgrade-channels-releases[Understanding upgrade channels and releases]
+
 include::modules/update-conditional-updates.adoc[leveloffset=+1]
 
 [role="_additional-resources"]