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 ... ] [ --addv [protocol: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. Note that this method is not recommended and  sup‐
51                    port will be removed in a future release.
52
53       --filter-initial-members
54              filter  the  initial  monmap by applying the mon initial members
55              setting.  Monitors not present in that list will be removed, and
56              initial  members not present in the map will be added with dummy
57              addresses.
58
59       --add name ip:port
60              will add a monitor with the specified ip:port to the map.
61
62       --addv name [protocol:ip:port[,...]]
63              will add a monitor with the  specified  version:ip:port  to  the
64              map.
65
66       --rm name
67              will remove the monitor with the specified ip:port from the map.
68
69       --fsid uuid
70              will  set  the  fsid  to  the given uuid.  If not specified with
71              --create, a random fsid will be generated.
72

EXAMPLE

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

AVAILABILITY

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

SEE ALSO

93       ceph(8), crushtool(8),
94

96       2010-2021, Inktank Storage, Inc. and contributors. Licensed under  Cre‐
97       ative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
98
99
100
101
102dev                              Mar 18, 2021                    MONMAPTOOL(8)
Impressum