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>

diff --git a/doc/cephadm/services/osd.rst b/doc/cephadm/services/osd.rst
index 65e94e29326a422ccf64104441ac9318a1919ff2..88401a87b0c8f1534882042cf4d5ec4b7fd64145 100644 (file)
--- a/doc/cephadm/services/osd.rst
+++ b/doc/cephadm/services/osd.rst
@@ -310,6 +310,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