1MONMAPTOOL(8)                        Ceph                        MONMAPTOOL(8)
2
3
4

NAME

6       monmaptool - ceph monitor cluster map manipulation tool
7

SYNOPSIS

9       monmaptool mapfilename [ --clobber ] [ --print ] [ --create ]
10       [ --add ip:port ... ] [ --rm ip:port ... ]
11
12

DESCRIPTION

14       monmaptool  is  a utility to create, view, and modify a monitor cluster
15       map for the Ceph distributed storage system. The monitor map  specifies
16       the  only  fixed  addresses  in the Ceph distributed system.  All other
17       daemons bind to arbitrary addresses and register  themselves  with  the
18       monitors.
19
20       When creating a map with --create, a new monitor map with a new, random
21       UUID will be created. It should be followed  by  one  or  more  monitor
22       addresses.
23
24       The default Ceph monitor port is 6789.
25

OPTIONS

27       --print
28              will  print a plaintext dump of the map, after any modifications
29              are made.
30
31       --clobber
32              will allow monmaptool to overwrite mapfilename  if  changes  are
33              made.
34
35       --create
36              will  create  a  new monitor map with a new UUID (and with it, a
37              new, empty Ceph file system).
38
39       --generate
40              generate a new monmap based on the values on the command line or
41              specified in the ceph configuration.  This is, in order of pref‐
42              erence,
43
44                 1. --monmap filename to specify a monmap to load
45
46                 2. --mon-host 'host1,ip2' to specify a list of  hosts  or  ip
47                    addresses
48
49                 3. [mon.foo]  sections  containing  mon  addr settings in the
50                    config
51
52       --filter-initial-members
53              filter the initial monmap by applying the  mon  initial  members
54              setting.  Monitors not present in that list will be removed, and
55              initial members not present in the map will be added with  dummy
56              addresses.
57
58       --add name ip:port
59              will add a monitor with the specified ip:port to the map.
60
61       --rm name
62              will remove the monitor with the specified ip:port from the map.
63
64       --fsid uuid
65              will  set  the  fsid  to  the given uuid.  If not specified with
66              --create, a random fsid will be generated.
67

EXAMPLE

69       To create a new map with three monitors (for a fresh Ceph file system):
70
71          monmaptool  --create  --add  mon.a 192.168.0.10:6789 --add mon.b 192.168.0.11:6789 \
72            --add mon.c 192.168.0.12:6789 --clobber monmap
73
74       To display the contents of the map:
75
76          monmaptool --print monmap
77
78       To replace one monitor:
79
80          monmaptool --rm mon.a --add mon.a 192.168.0.9:6789 --clobber monmap
81

AVAILABILITY

83       monmaptool is part of Ceph, a massively scalable, open-source, distrib‐
84       uted  storage  system.  Please  refer  to  the  Ceph  documentation  at
85       http://ceph.com/docs for more information.
86

SEE ALSO

88       ceph(8), crushtool(8),
89
91       2010-2014, Inktank Storage, Inc. and contributors. Licensed under  Cre‐
92       ative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
93
94
95
96
97dev                              Apr 14, 2019                    MONMAPTOOL(8)
Impressum