← Back to branch summary

~ubuntu-branches/ubuntu/quantal/ceph/quantal

« back to all changes in this revision

Viewing changes to doc/man/8/ceph-mon.rst

  • Committer: Package Import Robot
  • Author(s): James Page
  • Date: 2012-07-16 09:56:24 UTC
  • mfrom: (0.3.11)
  • mto: This revision was merged to the branch mainline in revision 17.
  • Revision ID: package-import@ubuntu.com-20120716095624-azr2w4hbhei1rxmx
Tags: upstream-0.48
Import upstream version 0.48

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/man/8/ceph-mon.rst
 
1
=================================
 
2
 ceph-mon -- ceph monitor daemon
 
3
=================================
 
4
 
 
5
.. program:: ceph-mon
 
6
 
 
7
Synopsis
 
8
========
 
9
 
 
10
| **ceph-mon** -i *monid* [ --mon-data *mondatapath* ]
 
11
 
 
12
 
 
13
Description
 
14
===========
 
15
 
 
16
**ceph-mon** is the cluster monitor daemon for the Ceph distributed
 
17
file system. One or more instances of **ceph-mon** form a Paxos
 
18
part-time parliament cluster that provides extremely reliable and
 
19
durable storage of cluster membership, configuration, and state.
 
20
 
 
21
The *mondatapath* refers to a directory on a local file system storing
 
22
monitor data. It is normally specified via the ``mon data`` option in
 
23
the configuration file.
 
24
 
 
25
Options
 
26
=======
 
27
 
 
28
.. option:: -f, --foreground
 
29
 
 
30
   Foreground: do not daemonize after startup (run in foreground). Do
 
31
   not generate a pid file. Useful when run via :doc:`ceph-run <ceph-run>`\(8).
 
32
 
 
33
.. option:: -d
 
34
 
 
35
   Debug mode: like ``-f``, but also send all log output to stderr.
 
36
 
 
37
.. option:: -c ceph.conf, --conf=ceph.conf
 
38
 
 
39
   Use *ceph.conf* configuration file instead of the default
 
40
   ``/etc/ceph/ceph.conf`` to determine monitor addresses during
 
41
   startup.
 
42
 
 
43
.. option:: --mkfs
 
44
 
 
45
   Initialize the ``mon data`` directory with seed information to form
 
46
   and initial ceph file system or to join an existing monitor
 
47
   cluster.  Three pieces of information must be provided:
 
48
 
 
49
   - The cluster fsid.  This can come from a monmap (``--monmap <path>``) or
 
50
     explicitly via ``--fsid <uuid>``.
 
51
   - A list of monitors and their addresses.  This list of monitors
 
52
     can come from a monmap (``--monmap <path>``), the ``mon host``
 
53
     configuration value (in *ceph.conf* or via ``-m
 
54
     host1,host2,...``), or ``mon addr`` lines in *ceph.conf*.  If this
 
55
     monitor is to be part of the initial monitor quorum for a new
 
56
     Ceph cluster, then it must be included in the initial list,
 
57
     matching either the name or address of a monitor in the list.
 
58
     When matching by address, either the ``public addr`` or ``public
 
59
     subnet`` options may be used.
 
60
   - The monitor secret key ``mon.``.  This must be included in the
 
61
     keyring provided via ``--keyring <path>``.
 
62
 
 
63
.. option:: --keyring
 
64
 
 
65
   Specify a keyring for use with ``--mkfs``.
 
66
 
 
67
 
 
68
Availability
 
69
============
 
70
 
 
71
**ceph-mon** is part of the Ceph distributed file system. Please refer
 
72
to the Ceph wiki at http://ceph.newdream.net/wiki for more
 
73
information.
 
74
 
 
75
 
 
76
See also
 
77
========
 
78
 
 
79
:doc:`ceph <ceph>`\(8),
 
80
:doc:`ceph-mds <ceph-mds>`\(8),
 
81
:doc:`ceph-osd <ceph-osd>`\(8)