summaryrefslogtreecommitdiffstats
path: root/doc/man/8/rbd-mirror.rst
blob: b35787fbfac9f8940fd14c46077f47c904d4a331 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
:orphan:

===================================================
 rbd-mirror -- Ceph daemon for mirroring RBD images
===================================================

.. program:: rbd-mirror

Synopsis
========

| **rbd-mirror**


Description
===========

:program:`rbd-mirror` is a daemon for asynchronous mirroring of RADOS
block device (rbd) images among Ceph clusters. It replays changes to
images in remote clusters in a local cluster, for disaster recovery.

It connects to remote clusters via the RADOS protocol, relying on
default search paths to find ceph.conf files, monitor addresses and
authentication information for them, i.e. ``/etc/ceph/$cluster.conf``,
``/etc/ceph/$cluster.keyring``, and
``/etc/ceph/$cluster.$name.keyring``, where ``$cluster`` is the
human-friendly name of the cluster, and ``$name`` is the rados user to
connect as, e.g. ``client.rbd-mirror``.


Options
=======

.. option:: -c ceph.conf, --conf=ceph.conf

   Use ``ceph.conf`` configuration file instead of the default
   ``/etc/ceph/ceph.conf`` to determine monitor addresses during startup.

.. option:: -m monaddress[:port]

   Connect to specified monitor (instead of looking through ``ceph.conf``).

.. option:: -i ID, --id ID

   Set the ID portion of name for rbd-mirror

.. option:: -n TYPE.ID, --name TYPE.ID

   Set the rados user name for the gateway (eg. client.rbd-mirror)

.. option:: --cluster NAME

   Set the cluster name (default: ceph)

.. option:: -d

   Run in foreground, log to stderr

.. option:: -f

   Run in foreground, log to usual location


Availability
============

:program:`rbd-mirror` is part of Ceph, a massively scalable, open-source, distributed
storage system. Please refer to the Ceph documentation at http://ceph.com/docs for
more information.


See also
========

:doc:`rbd <rbd>`\(8)