1MONMAPTOOL(8) Ceph MONMAPTOOL(8)
2
3
4
6 monmaptool - ceph monitor cluster map manipulation tool
7
9 monmaptool mapfilename [ --clobber ] [ --print ] [ --create ]
10 [ --add ip:port ... ] [ --rm ip:port ... ]
11
12
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
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
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
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
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)