From 734a7bcdbfafb401dc9a29b38eb76bbcbe9e3501 Mon Sep 17 00:00:00 2001
From: Redouane Kachach <rkachach@redhat.com>
Date: Wed, 18 Oct 2023 14:33:46 +0200
Subject: [PATCH] docs: adding specific instructions to upgrade Rook toolbox

Closes: https://github.com/rook/rook/issues/13010

Signed-off-by: Redouane Kachach <rkachach@redhat.com>
(cherry picked from commit 0e132f45a6948859114af8d65e4c0ef50a46cbcc)
---
 Documentation/Upgrade/ceph-upgrade.md | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/Documentation/Upgrade/ceph-upgrade.md b/Documentation/Upgrade/ceph-upgrade.md
index f60f793f5..a302940b3 100644
--- a/Documentation/Upgrade/ceph-upgrade.md
+++ b/Documentation/Upgrade/ceph-upgrade.md
@@ -85,7 +85,18 @@ NEW_CEPH_IMAGE='quay.io/ceph/ceph:v17.2.6-20230410'
 kubectl -n $ROOK_CLUSTER_NAMESPACE patch CephCluster $ROOK_CLUSTER_NAMESPACE --type=merge -p "{\"spec\": {\"cephVersion\": {\"image\": \"$NEW_CEPH_IMAGE\"}}}"
 ```
 
-#### **2. Wait for the pod updates**
+#### **2. Update the toolbox image**
+
+Since the [Rook toolbox](https://rook.io/docs/rook/latest/Troubleshooting/ceph-toolbox/) is not controlled by
+the Rook operator, users must perform a manual upgrade by modifying the `image` to match the ceph version
+employed by the new Rook operator release. Employing an outdated Ceph version within the toolbox may result
+in unexpected behaviour.
+
+```console
+kubectl -n rook-ceph set image deploy/rook-ceph-tools rook-ceph-tools=quay.io/ceph/ceph:v17.2.6-20230410
+```
+
+#### **3. Wait for the pod updates**
 
 As with upgrading Rook, now wait for the upgrade to complete. Status can be determined in a similar
 way to the Rook upgrade as well.
@@ -105,6 +116,6 @@ This cluster is finished:
     ceph-version=v17.2.6-0
 ```
 
-#### **3. Verify cluster health**
+#### **4. Verify cluster health**
 
 Verify the Ceph cluster's health using the [health verification](health-verification.md).