From: Zac Dover Date: Tue, 10 Jun 2025 10:38:54 +0000 (+1000) Subject: doc/rbd: add mirroring troubleshooting info X-Git-Url: http://git.apps.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F63841%2Fhead;p=ceph.git doc/rbd: add mirroring troubleshooting info Add a note to doc/rbd/rbd-mirroring.rst that directs the reader to set both "site-a" and "site-b" to have the same pool names in the event that rbd throws the error message "failed to import peer bootstrap token". This information was reported to the Ceph upstream by Petr Tlapa in June of 2025, and credit for its development goes to Petr. Signed-off-by: Zac Dover --- diff --git a/doc/rados/operations/pools.rst b/doc/rados/operations/pools.rst index a5cce9fb09ea3..c2a69e8c1c983 100644 --- a/doc/rados/operations/pools.rst +++ b/doc/rados/operations/pools.rst @@ -306,6 +306,8 @@ following forms: ceph auth del {user} +.. _rados_renaming_a_pool: + Renaming a Pool =============== diff --git a/doc/rbd/rbd-mirroring.rst b/doc/rbd/rbd-mirroring.rst index eb94a3716d548..2f0ec7c622eef 100644 --- a/doc/rbd/rbd-mirroring.rst +++ b/doc/rbd/rbd-mirroring.rst @@ -66,6 +66,9 @@ These pool configuration steps should be performed on both peer clusters. These procedures assume that both clusters, named "site-a" and "site-b", are accessible from a single host for clarity. +The pool must have the same name on both peer clusters. See :ref:`Renaming a +Pool` for instructions on renaming pools. + See the `rbd`_ manpage for additional details of how to connect to different Ceph clusters.