LEIL-CHUNKSERVER(8)

📦 version 5.12.0, in nixpkgs unstable

💅 LEIL-CHUNKSERVER, but make it make sense 💅

okay so bestie, this is the manual page for leil-chunkserver, section 8 of the man pages, and it's literally the whole vibe of how to run the chunkserver process for the Leil File System. pull up a chair, grab a boba, and let's get into it 🧋✨

🌸 NAME 🌸

leil-chunkserver — start, restart or stop the Leil File System chunkserver process. that's it, that's the whole job, and it does it slayfully 💅

✨ SYNOPSIS ✨

leil-chunkserver [-c CFGFILE] [-u] [-d] [-t LOCKTIMEOUT] [ACTION]

leil-chunkserver -v

leil-chunkserver -h

like, you can run it with options and an action, or you can just ask for the version or the help text. simple as that, no cap 🫶

💖 DESCRIPTION 💖

leil-chunkserver is the data server of the Leil File System. depending on the parameters you give it, it can start, restart or stop the LeilFS chunkserver process. it's giving "one binary, many moods" ✨

without any options, it just starts the LeilFS chunkserver — and if a lock file already exists, it kills the previously running process first. so it's not shy about clearing the runway, periodt 💅

SIGHUP (or the reload ACTION) forces leil-chunkserver to reload all of its configuration files. like a little refresh, but for daemons 🔄

the chunkserver also periodically tests stored chunks — check the HDD_TEST_FREQ option in the leil-chunkserver.cfg manual for the deets on that one 🩺

also important: the LeilFS master doesn't send metadata change logs to the chunkserver, and it expects at least one leil-metalogger daemon to connect. so don't forget your metalogger bestie, fr fr 😤

and the chunkserver scans its attached disks in the background, just quietly doing its thing. main character energy that doesn't need to announce itself 🌈

🎀 OPTIONS 🎀

  • -v — prints version information and exits. short, sweet, iconic 👑
  • -h — prints usage information and exits. your little helper bestie 🫶
  • -c CFGFILE — specifies an alternative path for the configuration file. the default is leil-chunkserver.cfg in the system configuration directory 📁
  • -u — logs undefined configuration values, i.e. when a default is being assumed. lowkey useful for debugging your config vibes 🔍
  • -d — runs in the foreground and does not daemonize. perfect if you want to watch it live like a reality show 👀
  • -t LOCKTIMEOUT — how long to wait for the lockfile, in seconds. the default is 60 seconds ⏳

now, ACTION is one of start, stop, restart, reload, test, isalive or kill. the default action is restart. so if you don't say anything, it restarts. no thoughts, just restart energy 💀

🦋 FILES 🦋

  • leil-chunkserver.cfg — the configuration file for the LeilFS chunkserver process. refer to the leil-chunkserver.cfg(5) manual for all the details 📝
  • leil-hdd.cfg — the list of directories (mountpoints) used for LeilFS storage, one per line. plot twist: if a directory is prefixed by a * character, that directory gets freed by replicating all the data already stored there to other locations. so that little star is doing a LOT of work ⭐
  • sfschunkserver.lock — the PID file of the running LeilFS chunkserver process 🪪
  • .sfschunkserver.lock — the lock file of the running LeilFS chunkserver process, created in the data directory 🔒
  • data.csstats — the chunkserver charts state 📊

🙈 REPORTING BUGS 🙈

found a bug? don't suffer in silence, bestie. report it to the GitHub repository at https://github.com/leil-io/leilfs as an issue. we love a paper trail 🐛💖

Copyright 2008-2009 Gemius SA

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

Copyright 2023-2024 Leil Storage OÜ

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

LeilFS 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. like, it's free, but it's also "you're on your own" free, yk? 😭

You should have received a copy of the GNU General Public License along with LeilFS. if not, see http://www.gnu.org/licenses/ 📜

🌈 SEE ALSO 🌈

leil-master(8), leil-mount(1), leil-chunkserver.cfg(5), leil-hdd.cfg(5), leilfs(7)

and that's the whole page, bestie 🎀 this lovely little manual page is dated 1980-01-01 and comes to you from LEIL-CHUNKSERVER(8). go forth and chunk responsibly 💅✨

📦 where this page comes from