Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
MONMAPTOOL(8)			     Ceph			 MONMAPTOOL(8)

NAME
       monmaptool - ceph monitor cluster map manipulation tool

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

DESCRIPTION
       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  ad-
       dresses.

       The default Ceph	monitor	port is	6789.

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

       --clobber
	      will allow monmaptool to overwrite mapfilename  if  changes  are
	      made.

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

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

		 1. --monmap filename 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  mon  addr settings	in the
		    config. Note that this method is not recommended and  sup-
		    port will be removed in a future release.

       --filter-initial-members
	      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.

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

	  monmaptool  --create	--add  mon.a 192.168.0.10:6789 --add mon.b 192.168.0.11:6789 \
	    --add mon.c	192.168.0.12:6789 --clobber monmap

       To display the contents of the map:

	  monmaptool --print monmap

       To replace one monitor:

	  monmaptool --rm mon.a	--add mon.a 192.168.0.9:6789 --clobber monmap

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

SEE ALSO
       ceph(8),	crushtool(8),

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

dev				 Mar 01, 2021			 MONMAPTOOL(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLE | AVAILABILITY | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=monmaptool&sektion=8&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help