From b7ba3f68c3baf5ad8b0b307afcf2bfbfa18d597c Mon Sep 17 00:00:00 2001 From: Jason Dillaman Date: Tue, 8 Aug 2017 12:43:32 -0400 Subject: [PATCH] doc: updated rbd-mirror daemon instructions Fixes: http://tracker.ceph.com/issues/20701 Signed-off-by: Jason Dillaman --- doc/rbd/rbd-mirroring.rst | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/doc/rbd/rbd-mirroring.rst b/doc/rbd/rbd-mirroring.rst index 5f1c1148907d0..e4db92832768a 100644 --- a/doc/rbd/rbd-mirroring.rst +++ b/doc/rbd/rbd-mirroring.rst @@ -288,13 +288,24 @@ distribution package. .. important:: Each ``rbd-mirror`` daemon requires the ability to connect to both clusters simultaneously. -.. warning:: Only run a single ``rbd-mirror`` daemon per Ceph cluster. A - future Ceph release will add support for horizontal scale-out of the - ``rbd-mirror`` daemon. +.. warning:: Pre-Luminous releases: only run a single ``rbd-mirror`` daemon per + Ceph cluster. + +Each ``rbd-mirror`` daemon should use a unique Ceph user ID. To +`create a Ceph user`_, with ``ceph`` specify the ``auth get-or-create`` +command, user name, monitor caps, and OSD caps:: + + ceph auth get-or-create client.rbd-mirror.{unique id} mon 'profile rbd' osd 'profile rbd' + +The ``rbd-mirror`` daemon can be managed by ``systemd`` by specifying the user +ID as the daemon instance:: + + systemctl enable ceph-rbd-mirror@rbd-mirror.{unique id} .. _rbd: ../../man/8/rbd .. _ceph-conf: ../../rados/configuration/ceph-conf/#running-multiple-clusters .. _explicitly enabled: #enable-image-mirroring .. _force resync command: #force-image-resync .. _demote the image: #image-promotion-and-demotion +.. _create a Ceph user: ../../rados/operations/user-management#add-a-user -- 2.39.5