mirror of
https://github.com/ceph/ceph
synced 2024-12-11 22:18:18 +00:00
92fa2ff8fc
Keeping the generated files in version control lets us support builds from scratch without requiring the full documentation toolchain to be installed. The files were just copied over from build-doc/output/man, after a ./admin/build-doc call. When redoing this, also take care to remove any roff output if a file was removed from doc/man, and update Makefile.am. Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
107 lines
2.5 KiB
Groff
107 lines
2.5 KiB
Groff
.TH "OSDMAPTOOL" "8" "September 09, 2011" "dev" "Ceph"
|
|
.SH NAME
|
|
osdmaptool \- ceph osd cluster map manipulation tool
|
|
.
|
|
.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
|
|
\fBosdmaptool\fP \fImapfilename\fP [\-\-print] [\-\-createsimple \fInumosd\fP
|
|
[\-\-pgbits \fIbitsperosd\fP ] ] [\-\-clobber]
|
|
.fi
|
|
.sp
|
|
.SH DESCRIPTION
|
|
.sp
|
|
\fBosdmaptool\fP is a utility that lets you create, view, and manipulate
|
|
OSD cluster maps from the Ceph distributed file system. Notably, it
|
|
lets you extract the embedded CRUSH map or import a new CRUSH map.
|
|
.SH OPTIONS
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-print
|
|
will simply make the tool print a plaintext dump of the map, after
|
|
any modifications are made.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-clobber
|
|
will allow osdmaptool to overwrite mapfilename if changes are made.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-import\-crush mapfile
|
|
will load the CRUSH map from mapfile and embed it in the OSD map.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-export\-crush mapfile
|
|
will extract the CRUSH map from the OSD map and write it to
|
|
mapfile.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-createsimple numosd [\-\-pgbits bitsperosd]
|
|
will create a relatively generic OSD map with the numosd devices.
|
|
If \-\-pgbits is specified, the initial placement group counts will
|
|
be set with bitsperosd bits per OSD. That is, the pg_num map
|
|
attribute will be set to numosd shifted by bitsperosd.
|
|
.UNINDENT
|
|
.SH EXAMPLE
|
|
.sp
|
|
To create a simple map with 16 devices:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
osdmaptool \-\-createsimple 16 osdmap \-\-clobber
|
|
.ft P
|
|
.fi
|
|
.sp
|
|
To view the result:
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
osdmaptool \-\-print osdmap
|
|
.ft P
|
|
.fi
|
|
.SH AVAILABILITY
|
|
.sp
|
|
\fBosdmaptool\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),
|
|
\fBcrushtool\fP(8),
|
|
\fBmkcephfs\fP(8)
|
|
.SH COPYRIGHT
|
|
2011, New Dream Network
|
|
.\" Generated by docutils manpage writer.
|
|
.\"
|
|
.
|