SFSCHUNKSERVER(8)

📦
version 5.8.0 · 4 versions
, in ubuntu stonking

👑 SFSCHUNKSERVER — the Sauna File System chunkserver, bestie edition 💅

okay so this is the manual page for sfschunkserver, section 8 of the manual (that's the sysadmin one, iykyk). It's giving "I run the actual data around here" energy and honestly? She does. Let's get into it 🌸

✨ NAME ✨

sfschunkserver — start, restart or stop the Sauna File System chunkserver process 🫶

🌈 SYNOPSIS 🌈

sfschunkserver [-c CFGFILE] [-u] [-d] [-t LOCKTIMEOUT] [ACTION]

sfschunkserver -v

sfschunkserver -h

fr fr that's the whole shape of it. Options, then optionally one ACTION, and two little solo modes for -v and -h 💖

🦋 DESCRIPTION 🦋

So sfschunkserver is the data server of Sauna File System. She's the one holding your actual chunks, the main character of storage, no cap. Depending on what parameters you hand her, she can start, restart or stop the SaunaFS chunkserver process.

With zero options? She just starts the SaunaFS chunkserver. And the way she does that — if a lock file already exists, she kills the previously run process first. Like, respectfully, out with the old 👋

SIGHUP (or the reload ACTION, same vibe) forces sfschunkserver to reload all configuration files. Fresh config, who dis ✨

Your chunkserver periodically tests the chunks she's storing — the deets live in the HDD_TEST_FREQ option in the sfschunkserver.cfg manual. She's checking her own homework, we love a self-aware queen 🎀

Also important, bestie: the SaunaFS master doesn't send metadata change logs to the chunkserver. She instead expects at least one sfsmetalogger daemon to connect. So yeah, that's a whole dependency situation, don't forget it 💀

And chunkserver scans attached disks in the background. Quietly. Diligently. Not making it anyone's problem 🌸

💅 OPTIONS 💅

  • -v — print version information and exit. Short and sweet, just the version, bye 👑
  • -h — print usage information and exit. She'll tell you how to use her, then dip 🫶
  • -c CFGFILE — specify an alternative path for the configuration file. The default is sfschunkserver.cfg, chillin' in the system configuration directory 📁
  • -u — log undefined configuration values, i.e. the ones where a default is being assumed. Not me assuming things, I'm logging them ✨
  • -d — run in foreground, don't daemonize. She stays right there with you, holding your hand, printing to your terminal 💖
  • -t LOCKTIMEOUT — how long to wait for the lockfile. Default is 60 seconds. Patience is a virtue but it is not infinite, babe ⏳

And then there's ACTION, which is exactly one of:

  • start
  • stop
  • restart
  • reload
  • test
  • isalive
  • kill

The default action is restart. Periodt. 💅

🎀 FILES 🎀

  • sfschunkserver.cfg — the configuration file for the SaunaFS chunkserver process. Peep the sfschunkserver.cfg(5) manual for all the details, she's thorough 👑
  • sfshdd.cfg — the list of directories (mountpoints) used for SaunaFS storage, one per line. Here's the spicy bit: if a directory is prefixed with the * character, that directory gets freed by replicating all the data already stored there to other locations. Liberation via replication, iconic 🌈
  • sfschunkserver.lock — the PID file of the running SaunaFS chunkserver process. That's her little name tag 🏷️
  • .sfschunkserver.lock — the lock file of the running SaunaFS chunkserver process. This one gets created in the data directory 💜
  • data.csstats — Chunkserver charts state 📊

😭 REPORTING BUGS 😭

Found a bug? Do not suffer in silence bestie. Report bugs to the GitHub repository https://github.com/leil-io/saunafs as an issue. Be brave, file the issue 🫶

Copyright 2008-2009 Gemius SA

Copyright 2013-2019 Skytechnology sp. z o.o.

Copyright 2023-2024 Leil Storage OÜ

SaunaFS 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 3.

SaunaFS 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 SaunaFS. If not, see http://www.gnu.org/licenses/.

🔥 SEE ALSO 🔥

okay that's the whole lore dump — this was the SFSCHUNKSERVER(8) page, dated 2026-07-29, and honestly she ate and left no crumbs 💅✨ go run her, bestie 💖

📦 where this page comes from