mfschunkserver(8)

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

💖 mfschunkserver(8) — this is part of MooseFS 💖

okay bestie, pull up a chair, we're doing the MooseFS chunkserver manual and honestly? it's giving infrastructure main character. this page is mfschunkserver(8), section 8, and it's your whole guide to starting, restarting and stopping the chunkserver process. let's go 🦋

✨ NAME ✨

mfschunkserver — start, restart or stop the MooseFS chunkserver process 🌸

✨ SYNOPSIS ✨

mfschunkserver [-c CFGFILE] [-f] [-d] [-u] [-n] [-t LOCKTIMEOUT]
[ACTION]

mfschunkserver -v

mfschunkserver -h

✨ DESCRIPTION ✨

so <rainbow>mfschunkserver</rainbow> is literally the data server of MooseFS. that's it, that's the whole vibe — it holds your data, it's the backbone, it's the moment. 💅

✨ OPTIONS ✨

  • -v — prints the version info and dips. one and done, no notes. 👑
  • -h — prints the usage info and dips. your lil help menu bestie. 🫶
  • -c CFGFILE — lets you point at a totally different config file path instead of the usual one (default is mfschunkserver.cfg in the system configuration directory). pick your own adventure ✨
  • -f — run in the foreground, do not daemonize. she stays right there in your terminal, watching. 👀
  • -d — run with the dangerous options (they're the ones named DANGEROUS_*). yes bestie, "dangerous" is right there in the name, so like… be mindful. 💀
  • -u — log the undefined configuration values, i.e. whenever a default is assumed. transparency, we love to see it 🎀
  • -n — do not attempt to increase the limit of core dump size. she's not touching that limit, periodt.
  • -t LOCKTIMEOUT — how long to wait for the lockfile, in seconds (default is 60 seconds). patience is a virtue but only for a minute ⏳

🪩 ACTION

ACTION tells the chunkserver to perform one of these lil tasks:

  1. start — start the chunkserver process if it isn't already running; if it is already running, it just shows an error message. no double-dipping 🚫
  2. stop — stop the chunkserver process if it's running; if it's not running, it shows an error message instead. sorry girly, nothing to stop 💀
  3. restart — this is the default action. if the chunkserver process is running it restarts it; if it's not running, it starts it. either way she's gonna be running, iconic behavior ✨
  4. reload — sends a signal to the chunkserver process so it reloads the config files. glow-up via signal 🌸
  5. info — sends a signal to the chunkserver process to dump a debug information file in the working directory. receipts, collected 📄
  6. test — prints "mfschunkserver pid: PID" when the chunkserver is running (and returns 0), or "mfschunkserver is not running" otherwise (and returns 1). a little wellness check 🩺
  7. kill — sends the termination signal to the chunkserver process. bye bestie 👋
  8. restore — Not implemented. that's it, that's the whole thing, don't come for me 🙈

✨ FILES ✨

  • mfschunkserver.cfg — the configuration file for the MooseFS chunkserver process; go read the mfschunkserver.cfg(5) manual for all the details 🎀
  • mfshdd.cfg — the list of directories (mountpoints) used for MooseFS storage; the mfshdd.cfg(5) manual has the deets 💾
  • .mfschunkserver.lock — the lock file of the running MooseFS chunkserver process (created in the data directory) 🔒
  • chunkserverid.mfs — the chunkserver ID, assigned by the MooseFS master during the first connection (created in the data directory). your official birth certificate fr fr 🪪
  • csstats.mfs — the chunkserver charts stats (created in the data directory) 📊
  • .mfschunkserver_info.txt — the chunkserver info file, created by sending the process the INFO signal, containing work parameters that can be used for debugging/support purposes (created in the data directory) 🧚

✨ REPORTING BUGS ✨

found a bug? spill it to <bugs@moosefs.com>. 🐛

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), mfsmount(8), mfschunkserver.cfg(5), mfshdd.cfg(5) 🌈

okay that's the whole page bestie, you ate it 💅 this was MooseFS 4.59.2-1 and the date on it is May 2026 — go start that chunkserver, you got this, mwah 🎀💖✨

📦 where this page comes from