.\" Man page generated from reStructuredText.
.
.
.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
..
.TH "CEPH-MON" "8" "Mar 10, 2024" "dev" "Ceph"
.SH NAME
ceph-mon \- ceph monitor daemon
.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 \fI\%ceph\-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 \-\-setuser userorgid
Set uid after starting.  If a username is specified, the user
record is looked up to get a uid and a gid, and the gid is also set
as well, unless \-\-setgroup is also specified.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-setgroup grouporgid
Set gid after starting.  If a group name is specified the group
record is looked up to get a gid.
.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 (for backward compatibility) the deprecated \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
.INDENT 0.0
.TP
.B \-\-no\-config\-file
Signal that we don\(aqt want to rely on a \fIceph.conf\fP, either user provided
or the default, to run the daemon.  This will entail providing all
necessary options to the daemon as arguments.
.UNINDENT
.SH AVAILABILITY
.sp
\fBceph\-mon\fP is part of Ceph, a massively scalable, open\-source, distributed storage system. Please refer
to the Ceph documentation at \fI\%https://docs.ceph.com\fP for more
information.
.SH SEE ALSO
.sp
\fI\%ceph\fP(8),
\fI\%ceph\-mds\fP(8),
\fI\%ceph\-osd\fP(8)
.SH COPYRIGHT
2010-2024, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
.\" Generated by docutils manpage writer.
.