LEIL-METALOGGER.CFG(5)

📦 version 5.12.0, in nixpkgs unstable

💖 leil-metalogger.cfg — the config file for leil-metalogger (section 5 of the manual, bestie) 💖

Okay so picture this: it's giving "one little text file runs the whole metalogger situation." This is the manpage for leil-metalogger.cfg, and it's literally just the config file for the LeilFS metalogger process. That's it, that's the vibe. 🫶

✨ DESCRIPTION ✨

The file leil-metalogger.cfg contains the configuration of the LeilFS metalogger process. One file, all the settings, main character energy. 👑

🌸 SYNTAX 🌸

The syntax is, and I cannot stress this enough, extremely simple:

OPTION = VALUE

And listen: lines starting with the # character are ignored. So go ahead, leave yourself little love notes in there, they don't count. 💅

🎀 OPTIONS 🎀

Here's the configuration option lineup, no skips, no cuts:

  • DATA_PATH — where to store metadata files 📁
  • WORKING_USER — the user to run the daemon as
  • WORKING_GROUP — the group to run the daemon as. This one's optional — if it's empty, the default user group gets used instead. ✨
  • SYSLOG_IDENT — the name of the process that shows up in syslog messages (default is leil-metalogger)
  • LOCK_MEMORY — whether to perform mlockall() so the leil-metalogger process doesn't get swapped out (default is 0, i.e. no) 🔒
  • LIMIT_GLIBC_MALLOC_ARENAS — Linux only! Limits glibc malloc arenas to the given value — prevents it from using a huge amount of virtual memory. Heads up though, this can influence performance: it reduces memory fragmentation and improves cache locality, but it can also lead to contention and reduced parallelism in multi-threaded applications. Use it in constrained memory environments; recommended values are 4 or 8. (Default is 0: disabled, or let glibc decide.) 🧠
  • NICE_LEVEL — the nice level to run the daemon with (default is -19 if possible — note: the process must be started as root to increase priority) 🔥
  • BACK_LOGS — number of metadata change log files (default is 50)
  • BACK_META_KEEP_PREVIOUS — number of previous metadata files to be kept (default is 3)
  • META_DOWNLOAD_FREQ — metadata download frequency in hours (default is 24, at most BACK_LOGS/2)
  • MASTER_HOST — address of the LeilFS master host to connect with (default is sfsmaster)
  • MASTER_PORT — number of the LeilFS master port to connect with (default is 9419)
  • MASTER_RECONNECTION_DELAY — delay in seconds before trying to reconnect to the master after a disconnection (default is 30) ⏳
  • MASTER_TIMEOUT — timeout (in seconds) for master connections (default is 60)
  • LOG_LEVEL — sets up logging. It uses the environment variable SAUNAFS_LOG_LEVEL or the config value LOG_LEVEL to determine the logging level. Valid log levels are:
    • trace
    • debug
    • info
    • warn or warning
    • err or error
    • crit or critical
    • off
  • TLS_CERT_FILE (EXPERIMENTAL) — path to the TLS certificate file the metalogger will use for TLS connections (there is no default value) 🔐
  • TLS_KEY_FILE (EXPERIMENTAL) — path to the TLS private key file the metalogger will use for TLS connections (there is no default value) 🗝️
  • TLS_CA_CERT_FILE (EXPERIMENTAL) — path to the trusted CA certificate which is used to authenticate the TLS connection (there is no default value) 🛡️

🐛 REPORTING BUGS 🐛

Found a bug? Report it to the GitHub repository at https://github.com/leil-io/leilfs as an issue. Be a good citizen, file the issue, we love that for you. 💖

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.

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-metalogger(8) — the actual daemon this whole config file is for, go read it next bestie 💜

And that's the whole page! This one's dated 1980-01-01 (yes, iconic, timeless, literally a legend) and it's part of the LEIL-METALOGGER.CFG(5) manual section — mwah, go configure something gorgeous. 🎀🌈⭐

📦 where this page comes from