carta
mfssupervisor(8)

mfssupervisor8

Tool for controlling the work of moosefs master process

Usage

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

mfssupervisor -v

mfssupervisor -h

Overview

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 selects 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 inconsistencies 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. default 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.

History

  • Arch Linux 2026-11-01: the text shown here
  • Debian 13 (Trixie)

Reporting bugs

Report bugs to <[email protected]>.

From moosefs 4.59.2-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.