From 2dcdef0d43fb269447b5a00c8c29dc508919768d Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Tue, 29 Jun 2021 22:42:29 +1000 Subject: [PATCH] doc/cephadm: improving "Monitoring the Upgrade" This PR improves the section "Monitoring the Upgrade" in the "Upgrading Ceph" chapter of the cephadm documentation. This PR introduces a couple of section breaks with signposting information in their titles, and rewrites some sentences in order to reduce the cognitive load of the reader. Signed-off-by: Zac Dover --- doc/cephadm/upgrade.rst | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/doc/cephadm/upgrade.rst b/doc/cephadm/upgrade.rst index 8b6023e82ad5..c7d38c49d993 100644 --- a/doc/cephadm/upgrade.rst +++ b/doc/cephadm/upgrade.rst @@ -41,28 +41,32 @@ For example, to upgrade to v15.2.1: Monitoring the upgrade ====================== -Determine whether an upgrade is in process and what version the cluster is -upgrading to with: +Determine (1) whether an upgrade is in progress and (2) which version the +cluster is upgrading to by running the following command: .. prompt:: bash # ceph orch upgrade status -While the upgrade is underway, you will see a progress bar in the ceph -status output. For example: +Watching the progress bar during a Ceph upgrade +----------------------------------------------- -.. prompt:: bash # +During the upgrade, a progress bar is visible in the ceph status output. It +looks like this: - ceph -s +.. code-block:: console -Expected output:: + # ceph -s [...] progress: Upgrade to docker.io/ceph/ceph:v15.2.1 (00h 20m 12s) [=======.....................] (time remaining: 01h 43m 31s) -You can also watch the cephadm log by running the following command: +Watching the cephadm log during an upgrade +------------------------------------------ + +Watch the cephadm log by running the following command: .. prompt:: bash # -- 2.47.3