From ae3f9c815c5a4aaac764799e670dbceaf4bf4a05 Mon Sep 17 00:00:00 2001 From: Zac Dover Date: Tue, 10 Jun 2025 20:38:54 +1000 Subject: [PATCH] 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 (cherry picked from commit 83345afa898ebc2daf9a18d725447aa0c738af57) --- doc/rados/operations/pools.rst | 2 ++ doc/rbd/rbd-mirroring.rst | 3 +++ 2 files changed, 5 insertions(+) diff --git a/doc/rados/operations/pools.rst b/doc/rados/operations/pools.rst index 4bbb458950897..c2a581acfacc6 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. -- 2.39.5