[enterprise-4.9]OSDOCS-3605-and-Gh-issue-40595: Updates cluster CLI update procedure

modules/update-upgrading-cli.adoc

@@ -34,49 +34,54 @@ $ oc get clusterversion
 [source,terminal]
 ----
 NAME      VERSION   AVAILABLE   PROGRESSING   SINCE   STATUS
-version   4.8.13     True        False         158m    Cluster version is 4.8.13
+version   4.8.37     True        False         158m    Cluster version is 4.8.37
 ----
 
-. Review the current update channel information and confirm that your channel
-is set to `stable-4.9`:
+. View the available updates by running the following command. Note the version number of the update that you want to apply.
+you want to apply:
 +
 [source,terminal]
 ----
-$ oc get clusterversion -o json|jq ".items[0].spec"
+$ oc adm upgrade
 ----
 +
 .Example output
 [source,terminal]
 ----
-{
-  "channel": "stable-4.9",
-  "clusterID": "990f7ab8-109b-4c95-8480-2bd1deec55ff"
-}
+Cluster version is 4.8.37
+
+Upstream is unset, so the cluster will use an appropriate default.
+Channel: stable-4.9 (available channels: candidate-4.8, candidate-4.9, eus-4.10, eus-4.8, fast-4.8, fast-4.9, stable-4.8, stable-4.9)
+
+Recommended updates:
+VERSION IMAGE
+4.8.39  quay.io/openshift-release-dev/ocp-release@sha256:7b6225ae221d92645083a04ceae214974e121108c1edbc8b4985ba84f945f5d8
+4.8.41  quay.io/openshift-release-dev/ocp-release@sha256:5c551dfad2916d4f718b9e060392fc85e2832232351ecfeac2fbda57c62eee9d
+4.9.29  quay.io/openshift-release-dev/ocp-release@sha256:b04ca01d116f0134a102a57f86c67e5b1a3b5da1c4a580af91d521b8fa0aa6ec
+4.9.31  quay.io/openshift-release-dev/ocp-release@sha256:2a28b8ebb53d67dd80594421c39e36d9896b1e65cb54af81fbb86ea9ac3bf2d7
+4.9.32  quay.io/openshift-release-dev/ocp-release@sha256:ecdb6d0df547b857eaf0edb5574ddd64ca6d9aff1fa61fd1ac6fb641203bedfa
+4.9.33  quay.io/openshift-release-dev/ocp-release@sha256:fef77dfcc3e7c6ba175a4983816363511abc1783a0aac6993e74d05c8ab09496
+4.9.35  quay.io/openshift-release-dev/ocp-release@sha256:d617e6436691f002da49503aeeba84028846c50793115ee2ab6e040eb3713ce7
 ----
-+
-[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:
+. Based on your organization requirements, set the upgrade channel to `stable-4.9`, `fast-4.9`, or `eus-4.10` by running the following command:
 +
 [source,terminal]
 ----
-$ oc adm upgrade
+$ oc adm upgrade channel <channel>
 ----
 +
-.Example output
+For example, to set the channel to `stable-4.9`, run the following command:
++
 [source,terminal]
 ----
-Cluster version is 4.8.13
-
-Updates:
-
-VERSION IMAGE
-4.9.0   quay.io/openshift-release-dev/ocp-release@sha256:9c5f0df8b192a0d7b46cd5f6a4da2289c155fd5302dec7954f8f06c878160b8b
+$ oc adm upgrade channel stable-4.9
 ----
++
+[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 +98,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:
 +
@@ -111,7 +116,7 @@ $ oc get clusterversion -o json|jq ".items[0].spec"
   "desiredUpdate": {
     "force": false,
     "image": "quay.io/openshift-release-dev/ocp-release@sha256:9c5f0df8b192a0d7b46cd5f6a4da2289c155fd5302dec7954f8f06c878160b8b",
-    "version": "4.9.0" <1>
+    "version": "4.9.35" <1>
   }
 }
 ----
@@ -136,15 +141,15 @@ $ oc get clusterversion -o json|jq ".items[0].status.history"
     "startedTime": "2021-01-28T20:30:50Z",
     "state": "Partial",
     "verified": true,
-    "version": "4.9.0"
+    "version": "4.9.35"
   },
   {
     "completionTime": "2021-01-28T20:30:50Z",
     "image": "quay.io/openshift-release-dev/ocp-release@sha256:b8fa13e09d869089fc5957c32b02b7d3792a0b6f36693432acc0409615ab23b7",
     "startedTime": "2021-01-28T17:38:10Z",
     "state": "Completed",
     "verified": false,
-    "version": "4.8.13"
+    "version": "4.8.37"
   }
 ]
 ----

updating/updating-cluster-cli.adoc

@@ -46,4 +46,9 @@ include::modules/updating-sno.adoc[leveloffset=+1]
 
 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-changing-update-server-cli.adoc[leveloffset=+1]