2012-09-27 21:23:42 +00:00
|
|
|
.TH "CEPH-MON" "8" "September 27, 2012" "dev" "Ceph"
|
2009-03-10 22:00:46 +00:00
|
|
|
.SH NAME
|
2011-09-22 23:18:19 +00:00
|
|
|
ceph-mon \- ceph monitor daemon
|
2011-09-09 23:25:14 +00:00
|
|
|
.
|
|
|
|
.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
|
|
|
|
..
|
2012-09-27 21:23:42 +00:00
|
|
|
.\" Man page generated from reStructuredText.
|
2011-09-09 23:25:14 +00:00
|
|
|
.
|
2009-03-10 22:00:46 +00:00
|
|
|
.SH SYNOPSIS
|
2011-09-09 23:25:14 +00:00
|
|
|
.nf
|
2011-09-23 22:54:46 +00:00
|
|
|
\fBceph\-mon\fP \-i \fImonid\fP [ \-\-mon\-data \fImondatapath\fP ]
|
2011-09-09 23:25:14 +00:00
|
|
|
.fi
|
|
|
|
.sp
|
2009-03-10 22:00:46 +00:00
|
|
|
.SH DESCRIPTION
|
2011-09-09 23:25:14 +00:00
|
|
|
.sp
|
2011-09-23 22:54:46 +00:00
|
|
|
\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.
|
2011-09-09 23:25:14 +00:00
|
|
|
.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.
|
2009-03-10 22:00:46 +00:00
|
|
|
.SH OPTIONS
|
2011-09-09 23:25:14 +00:00
|
|
|
.INDENT 0.0
|
2009-03-10 22:00:46 +00:00
|
|
|
.TP
|
2011-09-09 23:25:14 +00:00
|
|
|
.B \-f, \-\-foreground
|
|
|
|
Foreground: do not daemonize after startup (run in foreground). Do
|
2011-09-22 23:18:19 +00:00
|
|
|
not generate a pid file. Useful when run via \fBceph\-run\fP(8).
|
2011-09-09 23:25:14 +00:00
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2009-03-10 22:00:46 +00:00
|
|
|
.TP
|
2011-09-09 23:25:14 +00:00
|
|
|
.B \-d
|
|
|
|
Debug mode: like \fB\-f\fP, but also send all log output to stderr.
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2009-03-10 22:00:46 +00:00
|
|
|
.TP
|
2011-09-09 23:25:14 +00:00
|
|
|
.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
|
2012-02-17 22:11:18 +00:00
|
|
|
.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
|
2012-03-30 18:27:47 +00:00
|
|
|
host1,host2,...\fP), or \fBmon addr\fP lines in \fIceph.conf\fP. If this
|
2012-02-17 22:11:18 +00:00
|
|
|
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
|
2009-03-10 22:00:46 +00:00
|
|
|
.SH AVAILABILITY
|
2011-09-09 23:25:14 +00:00
|
|
|
.sp
|
2011-09-23 22:54:46 +00:00
|
|
|
\fBceph\-mon\fP is part of the Ceph distributed file system. Please refer
|
2012-09-27 21:23:42 +00:00
|
|
|
to the Ceph documentation at \fI\%http://ceph.com/docs\fP for more
|
2011-09-23 22:54:46 +00:00
|
|
|
information.
|
2009-03-10 22:00:46 +00:00
|
|
|
.SH SEE ALSO
|
2011-09-09 23:25:14 +00:00
|
|
|
.sp
|
|
|
|
\fBceph\fP(8),
|
2011-09-22 23:18:19 +00:00
|
|
|
\fBceph\-mds\fP(8),
|
|
|
|
\fBceph\-osd\fP(8)
|
2011-09-09 23:25:14 +00:00
|
|
|
.SH COPYRIGHT
|
2012-09-27 21:23:42 +00:00
|
|
|
2012, Inktank Storage, Inc.
|
2011-09-09 23:25:14 +00:00
|
|
|
.\" Generated by docutils manpage writer.
|
|
|
|
.
|