3 ===================================================
4 rbd-mirror -- Ceph daemon for mirroring RBD images
5 ===================================================
7 .. program:: rbd-mirror
18 :program:`rbd-mirror` is a daemon for asynchronous mirroring of RADOS
19 block device (rbd) images among Ceph clusters. It replays changes to
20 images in remote clusters in a local cluster, for disaster recovery.
22 It connects to remote clusters via the RADOS protocol, relying on
23 default search paths to find ceph.conf files, monitor addresses and
24 authentication information for them, i.e. ``/etc/ceph/$cluster.conf``,
25 ``/etc/ceph/$cluster.keyring``, and
26 ``/etc/ceph/$cluster.$name.keyring``, where ``$cluster`` is the
27 human-friendly name of the cluster, and ``$name`` is the rados user to
28 connect as, e.g. ``client.rbd-mirror``.
34 .. option:: -c ceph.conf, --conf=ceph.conf
36 Use ``ceph.conf`` configuration file instead of the default
37 ``/etc/ceph/ceph.conf`` to determine monitor addresses during startup.
39 .. option:: -m monaddress[:port]
41 Connect to specified monitor (instead of looking through ``ceph.conf``).
43 .. option:: -i ID, --id ID
45 Set the ID portion of name for rbd-mirror
47 .. option:: -n TYPE.ID, --name TYPE.ID
49 Set the rados user name for the gateway (eg. client.rbd-mirror)
51 .. option:: --cluster NAME
53 Set the cluster name (default: ceph)
57 Run in foreground, log to stderr
61 Run in foreground, log to usual location
67 :program:`rbd-mirror` is part of Ceph, a massively scalable, open-source, distributed
68 storage system. Please refer to the Ceph documentation at http://ceph.com/docs for