Man Linux: Main Page and Category List


       monmaptool - ceph monutir 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 file 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

       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

       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

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

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

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


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

              monmaptool     --create     --add    --add
     --add --clobber monmap

       To display the contents of the map:

              monmaptool --print onmap

       To replace one monitor:

              monmaptool   --rm   --add
              --clobber monmap


       monmaptool  is  part of the Ceph distributed file system.  Please refer
       to the Ceph wiki at for more information.


       ceph(8), crushtool(8), mkcephfs(8)