'\" t
.\"     Title: mfschunkserver.cfg
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 01/28/2018
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "MFSCHUNKSERVER\&.CFG" "5" "01/28/2018" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
mfschunkserver.cfg \- main configuration file for *mfschunkserver*
.SH "DESCRIPTION"
.sp
The file \fBmfschunkserver\&.cfg\fR contains configuration of LizardFS chunkserver process\&.
.SH "SYNTAX"
.sp
Syntax is:
.PP
\fIOPTION\fR \fB=\fR \fIVALUE\fR
.RS 4
Lines starting with
\fB#\fR
character are ignored\&.
.RE
.SH "OPTIONS"
.sp
Configuration options:
.PP
\fBDATA_PATH\fR
.RS 4
where to store files with usage statistics and daemon lock file
.RE
.PP
\fBLABEL\fR
.RS 4
the label of this chunkserver (for tiering)
.RE
.PP
\fBWORKING_USER\fR
.RS 4
user to run daemon as
.RE
.PP
\fBWORKING_GROUP\fR
.RS 4
group to run daemon as (optional \- if empty then default user group will be used)
.RE
.PP
\fBSYSLOG_IDENT\fR
.RS 4
name of process to place in syslog messages (default is mfschunkserver)
.RE
.PP
\fBLOCK_MEMORY\fR
.RS 4
whether to perform mlockall() to avoid swapping out mfschunkserver process (default is 0, i\&.e\&. no)
.RE
.PP
\fBNICE_LEVEL\fR
.RS 4
nice level to run daemon with (default is \-19 if possible; note: process must be started as root to increase priority)
.RE
.PP
\fBMASTER_HOST\fR
.RS 4
address of LizardFS master host to connect with (default is mfsmaster)
.RE
.PP
\fBMASTER_PORT\fR
.RS 4
number of LizardFS master port to connect with (default is 9420)
.RE
.PP
\fBMASTER_RECONNECTION_DELAY\fR
.RS 4
delay in seconds before trying to reconnect to the master server after disconnection (default is 5)
.RE
.PP
\fBMASTER_TIMEOUT\fR
.RS 4
timeout (in seconds) for the master server connection (default is 60, minimum is 0\&.01)
.RE
.PP
\fBBIND_HOST\fR
.RS 4
local address to use for connecting with the master server (default is
\fB*\fR, i\&.e\&. default local address)
.RE
.PP
\fBCSSERV_LISTEN_HOST\fR
.RS 4
IP address to listen on for client (mount) connections (\fB*\fR
means any)
.RE
.PP
\fBCSSERV_LISTEN_PORT\fR
.RS 4
port to listen on for client (mount) connections (default is 9422)
.RE
.PP
\fBCSSERV_TIMEOUT\fR
.RS 4
timeout (in seconds) for client (mount) connections (default is 5)
.RE
.PP
\fBHDD_CONF_FILENAME\fR
.RS 4
alternative name of
\fBmfshdd\&.cfg\fR
file
.RE
.PP
\fBHDD_LEAVE_SPACE_DEFAULT\fR
.RS 4
free space threshold to set volume as 100% utilized when there is less than given amount of free space left (default is "4GiB")\&. This number is always added to the used disk space reported by chunkserver\&.
.RE
.PP
\fBHDD_TEST_FREQ\fR
.RS 4
chunk test period in seconds (default is 10)
.RE
.PP
\fBHDD_ADVISE_NO_CACHE\fR
.RS 4
whether to remove each chunk from page when closing it to reduce cache pressure generated by chunkserver (default is 1, i\&.e\&. yes)
.RE
.PP
\fBHDD_PUNCH_HOLES\fR
.RS 4
if enabled then chunkserver detects zero values in chunk data and frees corresponding file blocks (decreasing file system usage)\&. This option works only on Linux with file systems supporting punching holes (XFS, ext4, Btrfs, tmpfs) (default is 1, i\&.e\&. yes)
.RE
.PP
\fBENABLE_LOAD_FACTOR\fR
.RS 4
if enabled, chunkserver will send periodical reports of its I/O load to master, which will be taken into consideration when picking chunkservers for I/O operations\&.
.RE
.PP
\fBREPLICATION_BANDWIDTH_LIMIT_KBPS\fR
.RS 4
limit how many kilobytes can be replicated from other chunkservers to this chunkserver in every second (by default undefined, i\&.e\&. no limits)
.RE
.PP
\fBNR_OF_NETWORK_WORKERS\fR
.RS 4
number of threads which handle (in a round\-robin manner) connections with clients (default is 1); these threads are responsible for reading from sockets and coping data from internal buffers to sockets
.RE
.PP
\fBNR_OF_HDD_WORKERS_PER_NETWORK_WORKER\fR
.RS 4
number of threads that each network worker may use to do disk operations like opening chunks, reading or writing them (default is 2)
.RE
.PP
\fBREAD_AHEAD_KB\fR
.RS 4
additional number of kilobytes which should be passed to posix_fadvise(POSIX_FADV_WILLNEED) before reading data from a chunk (default is 0, i\&.e\&. use posix_fadvise only with the amount of data that is really needed; the value is aligned down to 64 KiB)
.RE
.PP
\fBMAX_READ_BEHIND_KB\fR
.RS 4
try to fix out\-of\-order read requests; the value tells how much of skipped data to read if an offset of some read operation is greater than the offset where the previos operation finished (default is 0, i\&.e\&. don\(cqt read any skipped data; the value is aligned down to 64 KiB)
.RE
.PP
\fBCREATE_NEW_CHUNKS_IN_MOOSEFS_FORMAT\fR
.RS 4
whether to create new chunks in the MooseFS format (signature + <checksum>* + <data block>*) or in the newer interleaved format ([<checksum> <data block>]*)\&. (Default is 1, i\&.e\&. new chunks are created in MooseFS format)
.RE
.PP
\fBPERFORM_FSYNC\fR
.RS 4
call fsync() after a chunk is modified (default is 1, i\&.e\&. enabled)
.RE
.SH "COPYRIGHT"
.sp
Copyright 2008\-2009 Gemius SA, 2013\-2015 Skytechnology sp\&. z o\&.o\&.
.sp
LizardFS 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\&.
.sp
LizardFS 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\&.
.sp
You should have received a copy of the GNU General Public License along with LizardFS\&. If not, see http://www\&.gnu\&.org/licenses/\&.
.SH "SEE ALSO"
.sp
mfschunkserver(8), mfshdd\&.cfg(5)