Scroll to navigation

mfschunkserver.cfg(5) This is part of MooseFS mfschunkserver.cfg(5)


mfschunkserver.cfg - main configuration file for mfschunkserver


The file mfschunkserver.cfg contains configuration of MooseFS chunkserver process.


Syntax is:

Lines starting with # character are ignored as comments.


Configuration options:

user to run daemon as
group to run daemon as; optional value - if empty then default user group will be used
name of process to place in syslog messages; default is mfschunkserver
whether to perform mlockall() to avoid swapping out mfschunkserver process; default is 0, i.e. no
limit malloc arenas to given value - prevents server from using huge amount of virtual memory (Linux onty, default is 4)
disable out of memory killer (Linux only, default is 1)
nice level to run daemon with; default is -19; note: process must be started as root to increase priority, if setting of priority fails, process retains the nice level it started with
set default umask for group and others (user has always 0); default is 027 - block write for group and block all for others
where to store daemon lock file
alternate location/name of mfshdd.cfg file
This option is deprecated. Please define HDD_TEST_SPEED instead. If HDD_TEST_SPEED is not defined then system will try to use HDD_TEST_FREQ but will convert it to HDD_TEST_SPEED using formula: HDD_TEST_SPEED = 10 / HDD_TEST_FREQ
Speed of background chunk tests in MB/s per disk (formally entry defined in mfshdd.cfg). Value can be given as a decimal number; default is 1.0
prevents from testing chunk integrity when last I/O (including test) was performed less than HDD_MIN_TEST_INTERVAL seconds ago; default is 86400
If possible use posix_fadvise(POSIX_DONTNEED) after each chunk test (but only if last I/O operation was performed more than HDD_FADVISE_MIN_TIME seconds ago). Using zero will always perform posix_fadvise (flush cache) and using negative value will never flush cache after tests. This setting is valid only for system s that support posix_fadivise; default value is 86400
how much space should be left unused on each hard drive; number format: [0-9]*(.[0-9]*)?([kMGTPE]|[KMGTPE]i)?B? ; default is 256MiB; examples: 0.5GB, .5G, 2.56GiB, 1256M etc.
percent of total work time the chunkserver is allowed to spend on hdd space rebalancing; default is 20
maximum simultaneous writes per disk in high speed disk rebalance (0 means use standard rebalance; default is 0)
how many i/o errors (COUNT) to tolerate in given amount of seconds (PERIOD) on a single hard drive; if the number of errors exceeds this setting, the offending hard drive will be marked as damaged; defaults are 2 and 600
enables/disables fsync before chunk closing; default is 0 (off)
enables/disables sparsification (skip leading and trailing zeroz) during writing new block; default is 1 (on)
how many chunks should be created in one directory before moving to the next one; higher values are better with most OSes caching algorithms, low values lead to more even chunk distribution; default is 10000 which works best in most cases
how many hours duplicate chunks should be kept before deleting (default is 168 - one week); changign this value and reloading will reset the counter
when set to one chunkserver will not abort start even when incorrect entries are found in 'mfshdd.cfg' file; default is 0 (do not start with invalid entries)
maximum number of active workers and maximum number of idle workers; defaults are 250 and 40
labels string defined as a set of letters (case insensitive) separated by coma or semicolon; default is empty - no labels
local address to use for master connections; default is *, i.e. default local address
MooseFS master host, IP is allowed only in single-master installations; default is mfsmaster
MooseFS master command port; default is 9420
MooseFS master control port; default is 9419
timeout in seconds for master connections (if not 0); If this value is zero then chunkserver sets it initially to 10 and asks master for this value. default is 0 (ask master).
delay in seconds before trying to reconnect to master after disconnection (default is 5)
authentication string (used only when master requires authorization)
local address to use for connecting with master (default is *, i.e. default local address)
maximum number of chunks system will try to put in a single register message (default is 10000, limits 1000-100000)
IP address to listen on for client (mount) connections (* means any)
port to listen on for client (mount) connections (default is 9422)


Copyright (C) 2021 Jakub Kruszona-Zawadzki, Core Technology Sp. z o.o.

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 MooseFS; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02111-1301, USA or visit


mfschunkserver(8), mfshdd.cfg(5)

August 2021 MooseFS 3.0.116-1