2013-12-07 21:07:38 +00:00
|
|
|
.\" Man page generated from reStructuredText.
|
|
|
|
.
|
|
|
|
.TH "MONMAPTOOL" "8" "December 09, 2013" "dev" "Ceph"
|
2009-03-11 04:20:43 +00:00
|
|
|
.SH NAME
|
2010-08-05 08:16:23 +00:00
|
|
|
monmaptool \- ceph monitor cluster map manipulation tool
|
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
|
|
|
|
..
|
|
|
|
.
|
2013-12-07 21:07:38 +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
|
|
|
|
..
|
2009-03-11 04:20:43 +00:00
|
|
|
.SH SYNOPSIS
|
2011-09-09 23:25:14 +00:00
|
|
|
.nf
|
|
|
|
\fBmonmaptool\fP \fImapfilename\fP [ \-\-clobber ] [ \-\-print ] [ \-\-create ]
|
2013-12-07 21:07:38 +00:00
|
|
|
[ \-\-add \fIip\fP:\fIport\fP \fI\&...\fP ] [ \-\-rm \fIip\fP:\fIport\fP \fI\&...\fP ]
|
2011-09-09 23:25:14 +00:00
|
|
|
.fi
|
|
|
|
.sp
|
2009-03-11 04:20:43 +00:00
|
|
|
.SH DESCRIPTION
|
2011-09-09 23:25:14 +00:00
|
|
|
.sp
|
|
|
|
\fBmonmaptool\fP is a utility to create, view, and modify a monitor
|
2013-12-07 21:07:38 +00:00
|
|
|
cluster map for the Ceph distributed storage system. The monitor map
|
2011-09-09 23:25:14 +00:00
|
|
|
specifies the only fixed addresses in the Ceph distributed system.
|
|
|
|
All other daemons bind to arbitrary addresses and register themselves
|
|
|
|
with the monitors.
|
|
|
|
.sp
|
|
|
|
When creating a map with \-\-create, a new monitor map with a new,
|
|
|
|
random UUID will be created. It should be followed by one or more
|
|
|
|
monitor addresses.
|
|
|
|
.sp
|
|
|
|
The default Ceph monitor port is 6789.
|
2009-03-11 04:20:43 +00:00
|
|
|
.SH OPTIONS
|
2011-09-09 23:25:14 +00:00
|
|
|
.INDENT 0.0
|
2009-03-11 04:20:43 +00:00
|
|
|
.TP
|
2011-09-09 23:25:14 +00:00
|
|
|
.B \-\-print
|
|
|
|
will print a plaintext dump of the map, after any modifications are
|
|
|
|
made.
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2009-03-11 04:20:43 +00:00
|
|
|
.TP
|
2011-09-09 23:25:14 +00:00
|
|
|
.B \-\-clobber
|
|
|
|
will allow monmaptool to overwrite mapfilename if changes are made.
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2009-03-11 04:20:43 +00:00
|
|
|
.TP
|
2011-09-09 23:25:14 +00:00
|
|
|
.B \-\-create
|
|
|
|
will create a new monitor map with a new UUID (and with it, a new,
|
|
|
|
empty Ceph file system).
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2009-03-11 04:20:43 +00:00
|
|
|
.TP
|
2012-09-27 21:23:42 +00:00
|
|
|
.B \-\-generate
|
|
|
|
generate a new monmap based on the values on the command line or specified
|
|
|
|
in the ceph configuration. This is, in order of preference,
|
|
|
|
.INDENT 7.0
|
|
|
|
.INDENT 3.5
|
|
|
|
.INDENT 0.0
|
|
|
|
.IP 1. 3
|
|
|
|
\fB\-\-monmap filename\fP to specify a monmap to load
|
|
|
|
.IP 2. 3
|
|
|
|
\fB\-\-mon\-host \(aqhost1,ip2\(aq\fP to specify a list of hosts or ip addresses
|
|
|
|
.IP 3. 3
|
|
|
|
\fB[mon.foo]\fP sections containing \fBmon addr\fP settings in the config
|
|
|
|
.UNINDENT
|
|
|
|
.UNINDENT
|
|
|
|
.UNINDENT
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
|
|
|
.B \-\-filter\-initial\-members
|
|
|
|
filter the initial monmap by applying the \fBmon initial members\fP
|
|
|
|
setting. Monitors not present in that list will be removed, and
|
|
|
|
initial members not present in the map will be added with dummy
|
|
|
|
addresses.
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
2011-09-09 23:25:14 +00:00
|
|
|
.B \-\-add name ip:port
|
|
|
|
will add a monitor with the specified ip:port to the map.
|
|
|
|
.UNINDENT
|
|
|
|
.INDENT 0.0
|
2009-03-11 04:20:43 +00:00
|
|
|
.TP
|
2011-09-09 23:25:14 +00:00
|
|
|
.B \-\-rm name
|
|
|
|
will remove the monitor with the specified ip:port from the map.
|
|
|
|
.UNINDENT
|
2012-02-17 22:11:18 +00:00
|
|
|
.INDENT 0.0
|
|
|
|
.TP
|
|
|
|
.B \-\-fsid uuid
|
|
|
|
will set the fsid to the given uuid. If not specified with \-\-create, a random fsid will be generated.
|
|
|
|
.UNINDENT
|
2009-03-11 04:20:43 +00:00
|
|
|
.SH EXAMPLE
|
2011-09-09 23:25:14 +00:00
|
|
|
.sp
|
2009-03-11 04:20:43 +00:00
|
|
|
To create a new map with three monitors (for a fresh Ceph file system):
|
2013-12-07 21:07:38 +00:00
|
|
|
.INDENT 0.0
|
|
|
|
.INDENT 3.5
|
2011-09-09 23:25:14 +00:00
|
|
|
.sp
|
|
|
|
.nf
|
|
|
|
.ft C
|
|
|
|
monmaptool \-\-create \-\-add mon.a 192.168.0.10:6789 \-\-add mon.b 192.168.0.11:6789 \e
|
|
|
|
\-\-add mon.c 192.168.0.12:6789 \-\-clobber monmap
|
|
|
|
.ft P
|
|
|
|
.fi
|
2013-12-07 21:07:38 +00:00
|
|
|
.UNINDENT
|
|
|
|
.UNINDENT
|
2011-09-09 23:25:14 +00:00
|
|
|
.sp
|
2009-03-11 04:20:43 +00:00
|
|
|
To display the contents of the map:
|
2013-12-07 21:07:38 +00:00
|
|
|
.INDENT 0.0
|
|
|
|
.INDENT 3.5
|
2011-09-09 23:25:14 +00:00
|
|
|
.sp
|
|
|
|
.nf
|
|
|
|
.ft C
|
2013-11-19 02:05:18 +00:00
|
|
|
monmaptool \-\-print monmap
|
2011-09-09 23:25:14 +00:00
|
|
|
.ft P
|
|
|
|
.fi
|
2013-12-07 21:07:38 +00:00
|
|
|
.UNINDENT
|
|
|
|
.UNINDENT
|
2011-09-09 23:25:14 +00:00
|
|
|
.sp
|
2009-03-11 04:20:43 +00:00
|
|
|
To replace one monitor:
|
2013-12-07 21:07:38 +00:00
|
|
|
.INDENT 0.0
|
|
|
|
.INDENT 3.5
|
2011-09-09 23:25:14 +00:00
|
|
|
.sp
|
|
|
|
.nf
|
|
|
|
.ft C
|
|
|
|
monmaptool \-\-rm mon.a \-\-add mon.a 192.168.0.9:6789 \-\-clobber monmap
|
|
|
|
.ft P
|
|
|
|
.fi
|
2013-12-07 21:07:38 +00:00
|
|
|
.UNINDENT
|
|
|
|
.UNINDENT
|
2009-03-11 04:20:43 +00:00
|
|
|
.SH AVAILABILITY
|
2011-09-09 23:25:14 +00:00
|
|
|
.sp
|
2013-12-07 21:07:38 +00:00
|
|
|
\fBmonmaptool\fP is part of the Ceph distributed storage system. Please
|
2012-09-27 21:23:42 +00:00
|
|
|
refer to the Ceph documentation at \fI\%http://ceph.com/docs\fP for more
|
2011-09-09 23:25:14 +00:00
|
|
|
information.
|
2009-03-11 04:20:43 +00:00
|
|
|
.SH SEE ALSO
|
2011-09-09 23:25:14 +00:00
|
|
|
.sp
|
|
|
|
\fBceph\fP(8),
|
|
|
|
\fBcrushtool\fP(8),
|
|
|
|
.SH COPYRIGHT
|
2013-04-29 23:01:38 +00:00
|
|
|
2010-2013, Inktank Storage, Inc. and contributors. Licensed under Creative Commons BY-SA
|
2011-09-09 23:25:14 +00:00
|
|
|
.\" Generated by docutils manpage writer.
|
|
|
|
.
|