mfssupervisor(8)

📦
version 4.59.2 · 3 versions
, in arch rolling, nixos 26.05, nixpkgs unstable, ubuntu stonking

✨ mfssupervisor(8) ✨

okay bestie, welcome to the MooseFS manual, this one's part of MooseFS obviously, and it's about the supervisor 💅

🌸 NAME 🌸

mfssupervisor — the lil tool that controls how the MooseFS master process does its thing 👑

🦋 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 💖

So mfssupervisor is literally the supervisor program of MooseFS. It's giving manager energy — you use it to force certain actions on the MooseFS master(s), like saving metadata or switching up the leadership. Very main character of it.

And here's the cute part: when you don't define any action (so, no -r, no -l, no -s), the tool just vibes and displays info about the master(s) current state(s). No cap, it just tells you what's up. 👀

✨ OPTIONS ✨

  • -v — print version information and exit. bye 💨
  • -h — print usage information and exit. also bye 💨
  • -x — produce more verbose output, aka it yaps more (affectionately) 🗣️
  • -d — (pro only) dry run: print info, but do not change anything. Look with your eyes, not your hands 🙈
  • -f — (pro only) force electing not synchronized follower. see NOTES below, it's important fr fr
  • -r — (pro only) try to resolve the master states situation; usually it 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 (the pro version requires you to specify 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 ⚠️

Bestie, listen up, these rules are not optional:

  • Options -s, -r and -l are mutually exclusive. Pick one. One. Not two. Not three. ✋
  • 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. So like, hands off the -f unless things are genuinely dire, okay?? 😭
Real talk: -f is the emergency option, not the everyday option. If everybody's online, the leader gets picked automatically and you should let it do its thing. Periodt. 💅

🐛 REPORTING BUGS 🐛

Found a bug? Report bugs to <bugs@moosefs.com>. They wanna know 🫶

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) — go read that one next bestie, it's iconic

and that's the whole page!! mwah 💜

MooseFS 4.59.2-1 · May 2026 · mfssupervisor(8) — ok that's the version, the date, and the manual, all wrapped up with a bow 🎀 slay, go supervise something 🦋

📦 where this page comes from