ceph/man/ceph-mon.8

111 lines
3.2 KiB
Groff

.TH "CEPH-MON" "8" "September 27, 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 reStructuredText.
.
.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 documentation at \fI\%http://ceph.com/docs\fP for more
information.
.SH SEE ALSO
.sp
\fBceph\fP(8),
\fBceph\-mds\fP(8),
\fBceph\-osd\fP(8)
.SH COPYRIGHT
2012, Inktank Storage, Inc.
.\" Generated by docutils manpage writer.
.