summaryrefslogtreecommitdiff
path: root/man/ceph-mon.8
blob: 605100c521bf99780981fb8d081a41387472c390 (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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
.TH "CEPH-MON" "8" "March 30, 2012" "dev" "Ceph"
.SH NAME
ceph-mon \- ceph monitor daemon
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.\" Man page generated from reStructeredText.
.
.SH SYNOPSIS
.nf
\fBceph\-mon\fP \-i \fImonid\fP [ \-\-mon\-data \fImondatapath\fP ]
.fi
.sp
.SH DESCRIPTION
.sp
\fBceph\-mon\fP is the cluster monitor daemon for the Ceph distributed
file system. One or more instances of \fBceph\-mon\fP form a Paxos
part\-time parliament cluster that provides extremely reliable and
durable storage of cluster membership, configuration, and state.
.sp
The \fImondatapath\fP refers to a directory on a local file system storing
monitor data. It is normally specified via the \fBmon data\fP option in
the configuration file.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-f, \-\-foreground
Foreground: do not daemonize after startup (run in foreground). Do
not generate a pid file. Useful when run via \fBceph\-run\fP(8).
.UNINDENT
.INDENT 0.0
.TP
.B \-d
Debug mode: like \fB\-f\fP, but also send all log output to stderr.
.UNINDENT
.INDENT 0.0
.TP
.B \-c ceph.conf, \-\-conf=ceph.conf
Use \fIceph.conf\fP configuration file instead of the default
\fB/etc/ceph/ceph.conf\fP to determine monitor addresses during
startup.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-mkfs
Initialize the \fBmon data\fP directory with seed information to form
and initial ceph file system or to join an existing monitor
cluster.  Three pieces of information must be provided:
.INDENT 7.0
.IP \(bu 2
The cluster fsid.  This can come from a monmap (\fB\-\-monmap <path>\fP) or
explicitly via \fB\-\-fsid <uuid>\fP.
.IP \(bu 2
A list of monitors and their addresses.  This list of monitors
can come from a monmap (\fB\-\-monmap <path>\fP), the \fBmon host\fP
configuration value (in \fIceph.conf\fP or via \fB\-m
host1,host2,...\fP), or \fBmon addr\fP lines in \fIceph.conf\fP.  If this
monitor is to be part of the initial monitor quorum for a new
Ceph cluster, then it must be included in the initial list,
matching either the name or address of a monitor in the list.
When matching by address, either the \fBpublic addr\fP or \fBpublic
subnet\fP options may be used.
.IP \(bu 2
The monitor secret key \fBmon.\fP.  This must be included in the
keyring provided via \fB\-\-keyring <path>\fP.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-keyring
Specify a keyring for use with \fB\-\-mkfs\fP.
.UNINDENT
.SH AVAILABILITY
.sp
\fBceph\-mon\fP is part of the Ceph distributed file system. Please refer
to the Ceph wiki at \fI\%http://ceph.newdream.net/wiki\fP for more
information.
.SH SEE ALSO
.sp
\fBceph\fP(8),
\fBceph\-mds\fP(8),
\fBceph\-osd\fP(8)
.SH COPYRIGHT
2011, New Dream Network
.\" Generated by docutils manpage writer.
.\" 
.