1OSDMAPTOOL(8)               System Manager's Manual              OSDMAPTOOL(8)
2
3
4

NAME

6       osdmaptool - ceph osd cluster map manipulation tool
7

SYNOPSIS

9       osdmaptool   mapfilename  [--print]  [--createsimple  numosd  [--pgbits
10       bitsperosd]] [--clobber]
11

DESCRIPTION

13       osdmaptool is a utility that lets you create, view, and manipulate  OSD
14       cluster  maps  from the Ceph distributed file system.  Notably, it lets
15       you extract the embedded CRUSH map or import a new CRUSH map.
16

OPTIONS

18       --print
19              will simply make the tool print a plaintext  dump  of  the  map,
20              after any modifications are made.
21
22       --clobber
23              will  allow  osdmaptool  to overwrite mapfilename if changes are
24              made.
25
26       --import-crush mapfile
27              will load the CRUSH map from mapfile and embed  it  in  the  OSD
28              map.
29
30       --export-crush mapfile
31              will extract the CRUSH map from the OSD map and write it to map‐
32              file.
33
34       --createsimple numosd [--pgbits bitsperosd]
35              will create  a  relatively  generic  OSD  map  with  the  numosd
36              devices.   If --pgbits is specified, the initial placement group
37              counts will be set with bitsperosd bits per OSD.  That  is,  the
38              pg_num  map  attribute will be set to numosd shifted by bitsper‐
39              osd.
40

EXAMPLE

42       To create a simple map with 16 devices:
43
44              osdmaptool --createsimple 16 osdmap --clobber
45
46       To view the result:
47
48              osdmaptool --print osdmap
49

AVAILABILITY

51       osdmaptool is part of the Ceph distributed file system.   Please  refer
52       to the Ceph wiki at http://ceph.newdream.net/wiki for more information.
53

SEE ALSO

55       ceph(8), crushtool(8), mkcephfs(8)
56
57
58
59                                                                 OSDMAPTOOL(8)