Merge pull request #85287 from obrown1205/multi-arch-migration

Migration to multi-arch oc adm upgrade status reference

Author: mburke5678

modules/migrating-to-multi-arch-cli.adoc

@@ -65,23 +65,27 @@ $ oc adm upgrade --to-multi-arch
 $ oc adm upgrade
 ----
 +
+.Example output
+
+[source,terminal]
+----
+working towards ${VERSION}: 106 of 841 done (12% complete), waiting on machine-config
+----
++
 [IMPORTANT]
 ====
 Machine launches may fail as the cluster settles into the new state. To notice and recover when machines fail to launch, we recommend deploying machine health checks. For more information about machine health checks and how to deploy them, see _About machine health checks_.
 ====
 +
-//commenting this section out until https://issues.redhat.com/browse/OCPBUGS-8256 is resolved:
-//For `oc get co`, expect `AVAILABLE=True`, `PROGRESSING=False`, and `DEGRADED=False` on all cluster Operators.
-+
-//For `oc get mcp`, expect `UPDATED=True`, `UPDATING=False`, and `DEGRADED=False` on all machine config pools.
+. Optional: To retrieve more detailed information about the status of your update, monitor the migration by running the following command:
 +
-//For `oc adm upgrade`, here is an example of a response:
-+
-//[source,terminal]
-//----
-//working towards ${VERSION}: 106 of 841 done (12% complete), waiting on etcd, kube-apiserver
-//----
+[source,terminal]
+----
+$ oc adm upgrade status
+----
 +
+For more information about how to use the `oc adm upgrade status` command, see _Gathering cluster update status using oc adm upgrade status (Technology Preview)_.
+
 The migrations must be complete and all the cluster operators must be stable before you can add compute machine sets with different architectures to your cluster.
 
 

updating/updating_a_cluster/migrating-to-multi-payload.adoc

@@ -36,3 +36,4 @@ include::modules/migrating-to-multi-arch-cli.adoc[leveloffset=+1]
 * xref:../../updating/understanding_updates/understanding-update-channels-release.adoc#understanding-update-channels-releases[Understanding update channels and releases]
 * xref:../../installing/overview/installing-preparing.adoc#installing-preparing-selecting-cluster-type[Selecting a cluster installation type]
 * xref:../../machine_management/deploying-machine-health-checks.adoc#machine-health-checks-about_deploying-machine-health-checks[About machine health checks]
+* xref:../../updating/updating_a_cluster/updating-cluster-cli.adoc#update-upgrading-oc-adm-upgrade-status_updating-cluster-cli[Gathering cluster update status using oc adm upgrade status (Technology Preview)]