From 32b804b8e2ba29901c3b22b4da857665d0540ca1 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 7ee51c1eff623..91f77e2535785 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 2c9cc1b66bf82..26a6e9412bd37 100644 --- a/doc/rbd/rbd-mirroring.rst +++ b/doc/rbd/rbd-mirroring.rst @@ -63,6 +63,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