---
name: "mfssupervisor"
section: "8"
platform: "linux"
package: "moosefs"
version: "4.59.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/mfssupervisor"
---

# mfssupervisor(8)

tool for controlling the work of MooseFS master process

## 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 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.

## 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 Software 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 details.

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)](/mfsmaster/8.md)