Skip to content

Commit ae3f9c8

Browse files
committed
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 <[email protected]> (cherry picked from commit 83345af)
1 parent f9a0960 commit ae3f9c8

File tree

2 files changed

+5
-0
lines changed

2 files changed

+5
-0
lines changed

doc/rados/operations/pools.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -306,6 +306,8 @@ following forms:
306306
ceph auth del {user}
307307

308308

309+
.. _rados_renaming_a_pool:
310+
309311
Renaming a Pool
310312
===============
311313

doc/rbd/rbd-mirroring.rst

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,9 @@ These pool configuration steps should be performed on both peer clusters. These
6666
procedures assume that both clusters, named "site-a" and "site-b", are accessible
6767
from a single host for clarity.
6868

69+
The pool must have the same name on both peer clusters. See :ref:`Renaming a
70+
Pool<rados_renaming_a_pool>` for instructions on renaming pools.
71+
6972
See the `rbd`_ manpage for additional details of how to connect to different
7073
Ceph clusters.
7174

0 commit comments

Comments
 (0)