Provided by: ceph-base_14.2.2-0ubuntu3_amd64 bug


       monmaptool - ceph monitor cluster map manipulation tool


       monmaptool mapfilename [ --clobber ] [ --print ] [ --create ]
       [ --add ip:port ... ] [ --rm ip:port ... ]


       monmaptool  is  a  utility  to create, view, and modify a monitor cluster map for the Ceph
       distributed storage system. The monitor map specifies the only fixed addresses in the Ceph
       distributed system.  All other daemons bind to arbitrary addresses and register themselves
       with the monitors.

       When creating a map with --create, a new monitor map with  a  new,  random  UUID  will  be
       created. It should be followed by one or more monitor addresses.

       The default Ceph monitor port is 6789.


              will print a plaintext dump of the map, after any modifications are made.

              will allow monmaptool to overwrite mapfilename if changes are made.

              will  create a new monitor map with a new UUID (and with it, a new, empty Ceph file

              generate a new monmap based on the values on the command line or specified  in  the
              ceph configuration.  This is, in order of preference,

                 1. --monmap filename to specify a monmap to load

                 2. --mon-host 'host1,ip2' to specify a list of hosts or ip addresses

                 3. [] sections containing mon addr settings in the config. Note that this
                    method is not recommended and support will be removed in a future release.

              filter the initial monmap by applying the mon initial  members  setting.   Monitors
              not  present  in  that list will be removed, and initial members not present in the
              map will be added with dummy addresses.

       --add name ip:port
              will add a monitor with the specified ip:port to the map.

       --rm name
              will remove the monitor with the specified ip:port from the map.

       --fsid uuid
              will set the fsid to the given uuid.  If not specified with --create, a random fsid
              will be generated.


       To create a new map with three monitors (for a fresh Ceph file system):

          monmaptool  --create  --add  mon.a --add mon.b \
            --add mon.c --clobber monmap

       To display the contents of the map:

          monmaptool --print monmap

       To replace one monitor:

          monmaptool --rm mon.a --add mon.a --clobber monmap


       monmaptool is part of Ceph, a massively scalable, open-source, distributed storage system.
       Please refer to the Ceph documentation at for more information.


       ceph(8), crushtool(8),


       2010-2019, Inktank  Storage,  Inc.  and  contributors.  Licensed  under  Creative  Commons
       Attribution Share Alike 3.0 (CC-BY-SA-3.0)