doc/rados: link to cephadm replacing osd section

Direct readers to the "Replacing an OSD" section in the cephadm
documentation, for cases in which the instructions in "Replacing an OSD"
in the RADOS documentation don't work.

https://tracker.ceph.com/issues/58401

Signed-off-by: Zac Dover <zac.dover@gmail.com>
(cherry picked from commit 7b8f75ebd7cd29faf2eec2fba1fefa17a390b92d)

diff --git a/doc/cephadm/services/osd.rst b/doc/cephadm/services/osd.rst
index ab62924a258f419dd37a0bcaf8c09b1c7459ec48..de0d4f82a330ea11abd076f34d609aa8dcacd17b 100644 (file)
--- a/doc/cephadm/services/osd.rst
+++ b/doc/cephadm/services/osd.rst
@@ -301,6 +301,7 @@ Expected output::
 
 This resets the initial state of the OSD and takes it off the removal queue.
 
+.. _cephadm-replacing-an-osd:
 
 Replacing an OSD
 ----------------

diff --git a/doc/rados/operations/add-or-rm-osds.rst b/doc/rados/operations/add-or-rm-osds.rst
index cb78693b406623b999169cec2b703f2865879abe..58c69086395b567a176b625ca827cbe022e3e75c 100644 (file)
--- a/doc/rados/operations/add-or-rm-osds.rst
+++ b/doc/rados/operations/add-or-rm-osds.rst
@@ -144,6 +144,9 @@ weight).
 Replacing an OSD
 ----------------
 
+.. note:: If the instructions in this section do not work for you, try the
+   instructions in the cephadm documentation ::ref:`cephadm-replacing-an-osd`.
+
 When disks fail, or if an administrator wants to reprovision OSDs with a new
 backend, for instance, for switching from FileStore to BlueStore, OSDs need to
 be replaced. Unlike `Removing the OSD`_, replaced OSD's id and CRUSH map entry