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

FreeBSD Manual Pages

  
 
  

home | help
mfssupervisor(8)	     This is part of MooseFS		mfssupervisor(8)

NAME
     mfssupervisor - tool for controlling the work of MooseFS master process

SYNOPSIS
     mfssupervisor  [-xdfrc] [-l new leader ip] [-s mode] [-B local address] [-H
     master host name] [-P master supervising port]

     mfssupervisor -v

     mfssupervisor -h

DESCRIPTION
     mfssupervisor is the supervisor program of MooseFS. It can be used to force
     certain actions of MooseFS master(s),  like  saving  metadata  or	changing
     leadership. When no action (options -r, -l or -s) is defined, the tool will
     just display info about the master(s) current state(s).

OPTIONS
     -v     print version information and exit

     -h     print usage information and exit

     -x     produce more verbose output

     -d     (pro only) dry run (print info, but do not change anything)

     -f     (pro only) force electing not synchronized follower; see NOTES

     -r     (pro  only)  try to resolve the master states situation; usually se-
	    lects one of the followers and sets its state to ELECT if no  elects
	    or leaders are present

     -l     (pro  only)  try  to  change the role of the master with given IP to
	    leader;

     -c     (pro only) run configuration consistency check; if any  inconsisten-
	    cies are present, they will be reported via syslog

     -s     force  metadata  store  or (pro only) metadata check on given master
	    group (pro version requires specifying a mode, possible values: L  -
	    LEADER only, F - FOLLOWERS only, A - all servers with CRC check, C -
	    all servers CRC check only, no metadata is stored on disk)

     -B     local  address  to	use for master connections (default: *, i.e. de-
	    fault local address)

     -H     use given host to find your master server(s) (default: mfsmaster)

     -P     use given port to connect to your master server(s) (default: 9419)

NOTES
     Options -s,-r and -l are mutually exclusive

     Option -f can be used only with option -r

     Option -d can be used only with option -r or -l

     Option -f shouldn't be used unless it is necessary in situations  when  not
     all  master  servers  defined in DNS are connected (i.e. after a crash when
     one of the master machines is offline). In an environment where all  master
     machines are present, the leader should be picked automatically.

REPORTING BUGS
     Report bugs to <bugs@moosefs.com>.

COPYRIGHT
     Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA

     This file is part of MooseFS.

     MooseFS  is  free	software; you can redistribute it and/or modify it under
     the terms of the GNU General Public License as published by the Free  Soft-
     ware Foundation, version 2 (only).

     MooseFS  is distributed in the hope that it will be useful, but WITHOUT ANY
     WARRANTY; without even the implied warranty of MERCHANTABILITY  or  FITNESS
     FOR  A  PARTICULAR PURPOSE. See the GNU General Public License for more de-
     tails.

     You should have received a copy of the GNU  General  Public  License  along
     with this program; if not, see <https://www.gnu.org/licenses/>.

SEE ALSO
     mfsmaster(8)

MooseFS 4.59.1-1		    May 2026			mfssupervisor(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mfssupervisor&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help