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. 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       --rm name
63              will remove the monitor with the specified ip:port from the map.
64
65       --fsid uuid
66              will set the fsid to the given  uuid.   If  not  specified  with
67              --create, a random fsid will be generated.
68

EXAMPLE

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

AVAILABILITY

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

SEE ALSO

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