diff --git a/modules/migrating-to-multi-arch-cli.adoc b/modules/migrating-to-multi-arch-cli.adoc index 4248aa2670..f9d33b4e46 100644 --- a/modules/migrating-to-multi-arch-cli.adoc +++ b/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. +. Optional: To retrieve more detailed information about the status of your update, monitor the migration by running the following command: + -//For `oc get mcp`, expect `UPDATED=True`, `UPDATING=False`, and `DEGRADED=False` on all machine config pools. -+ -//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. diff --git a/updating/updating_a_cluster/migrating-to-multi-payload.adoc b/updating/updating_a_cluster/migrating-to-multi-payload.adoc index 981e55b3f8..45a99473fe 100644 --- a/updating/updating_a_cluster/migrating-to-multi-payload.adoc +++ b/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)] \ No newline at end of file