monmaptool - ceph monitor cluster map manipulation tool

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

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

dev                                               May 22, 2025                                     MONMAPTOOL(8)

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 for messenger protocol v1 is 6789, and 3300 for protocol v2.

       Multiple actions can be performed per invocation.

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

          monmaptool --create --add nodeA 192.168.0.10 --add nodeB 192.168.0.11 \
            --add nodeC 192.168.0.12 --enable-all-features --clobber monmap

       To display the contents of the map:

          monmaptool --print monmap

       To replace one monitor:

          monmaptool --rm nodeA monmap
          monmaptool --add nodeA 192.168.0.9 monmap

       monmaptool - ceph monitor cluster map manipulation tool

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

       --feature-list[plain|parseable]
              list the enabled features as well as the available ones.

              By default, a human readable output is produced.

       --create
              create a new monitor map with a new UUID (and with it, a new, empty Ceph cluster).

       --clobber
              allow monmaptool to create a new mapfilename in place of an existing map.

              Only useful when --create is used.

       --generate
              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. --monmapfilename to specify a monmap to load

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

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

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

       --addnameip[:port]
              add a monitor with the specified ip:port to the map.

              If the nautilus feature is set, and the port is not, the monitor will be added for both  messenger
              protocols.

       --addvname[protocol:ip:port[,...]]
              add a monitor with the specified version:ip:port to the map.

       --rmname
              remove the monitor with the specified name from the map.

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

       --feature-setvalue[--optional|--persistent]
              enable a feature.

       --feature-unsetvalue[--optional|--persistent]
              disable a feature.

       --enable-all-features
              enable all supported features.

       --set-min-mon-releaserelease
              set the min_mon_release.

ceph(8), crushtool(8),

monmaptool <action> [options] mapfilename