'\" t
.\"     Title: mfschunkserver
.\"    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" "8" "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 \- start, restart or stop Lizard File System chunkserver process
.SH "SYNOPSIS"
.sp
.nf
\fBmfschunkserver\fR [\fB\-f\fR] [\fB\-c\fR \fICFGFILE\fR] [\fB\-u\fR] [\fB\-d\fR] [\fB\-t\fR \fILOCKTIMEOUT\fR] [\fIACTION\fR]
.fi
.sp
.nf
\fBmfschunkserver \-s\fR [\fB\-c\fR \fICFGFILE\fR]
.fi
.sp
.nf
\fBmfschunkserver \-v\fR
.fi
.sp
.nf
\fBmfschunkserver \-h\fR
.fi
.SH "DESCRIPTION"
.sp
\fBmfschunkserver\fR is the data server of Lizard File System\&. Depending on parameters it can start, restart or stop LizardFS chunkserver process\&. Without any options it starts LizardFS chunkserver, killing previously run process if lock file exists\&.
.sp
SIGHUP (or \fBreload\fR \fIACTION\fR) forces \fBmfschunkserver\fR to reload all configuration files\&.
.sp
Chunkserver periodically tests stored chunks (see \fBHDD_TEST_FREQ\fR option in \fBmfschunkserver\&.cfg\fR manual)\&.
.sp
LizardFS master doesn\(cqt send metadata change logs to chunkserver and expect at least one \fBmfsmetalogger\fR daemon to connect\&.
.sp
Chunkserver scans attached disks in background\&.
.SH "OPTIONS"
.PP
\fB\-v\fR
.RS 4
print version information and exit
.RE
.PP
\fB\-h\fR
.RS 4
print usage information and exit
.RE
.PP
\fB\-f\fR
.RS 4
(deprecated, use
\fBstart\fR
action instead) forcily run LizardFS chunkserver process, without trying to kill previous instance (this option allows to run LizardFS chunkserver if stale PID file exists)
.RE
.PP
\fB\-s\fR
.RS 4
(deprecated, use
\fBstop\fR
action instead) stop LizardFS chunkserver process
.RE
.PP
\fB\-c\fR \fICFGFILE\fR
.RS 4
specify alternative path of configuration file (default is
\fBmfschunkserver\&.cfg\fR
in system configuration directory)
.RE
.PP
\fB\-u\fR
.RS 4
log undefined configuration values (when default is assumed)
.RE
.PP
\fB\-d\fR
.RS 4
run in foreground, don\(cqt daemonize
.RE
.PP
\fB\-t\fR \fILOCKTIMEOUT\fR
.RS 4
how long to wait for lockfile (default is 60 seconds)
.RE
.sp
\fIACTION\fR is the one of \fBstart\fR, \fBstop\fR, \fBrestart\fR, \fBreload\fR, \fBtest\fR, \fBisalive\fR or \fBkill\fR\&. Default action is \fBrestart\fR\&.
.SH "FILES"
.PP
\fBmfschunkserver\&.cfg\fR
.RS 4
configuration file for LizardFS chunkserver process; refer to
\fBmfschunkserver\&.cfg\fR(5) manual for defails
.RE
.PP
\fBmfshdd\&.cfg\fR
.RS 4
list of directories (mountpoints) used for LizardFS storage (one per line; directory prefixed by
\fB*\fR
character causes given directory to be freed by replicating all data already stored there to another locations)
.RE
.PP
\fBmfschunkserver\&.lock\fR
.RS 4
PID file of running LizardFS chunkserver process
.RE
.PP
\fB\&.mfschunkserver\&.lock\fR
.RS 4
lock file of running LizardFS chunkserver process (created in data directory)
.RE
.PP
\fBdata\&.csstats\fR
.RS 4
Chunkserver charts state
.RE
.SH "REPORTING BUGS"
.sp
Report bugs to <contact@lizardfs\&.org>\&.
.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
mfsmaster(8), mfsmount(1), mfschunkserver\&.cfg(5), mfshdd\&.cfg(5), moosefs(7)