'\" t
.\"     Title: mfsmaster
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 06/17/2017
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "MFSMASTER" "8" "06/17/2017" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * 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"
mfsmaster \- start, restart or stop Lizard File System metadata server process
.SH "SYNOPSIS"
.sp
.nf
mfsmaster [\fB\-f\fR] [\fB\-c\fR \fICFGFILE\fR] [\fB\-u\fR] [\fB\-d\fR] [\fB\-t\fR \fILOCKTIMEOUT\fR] [\fIACTION\fR]
.fi
.sp
.nf
\fBmfsmaster \-s\fR [\fB\-c\fR \fICFGFILE\fR]
.fi
.sp
.nf
\fBmfsmaster \-v\fR
.fi
.sp
.nf
\fBmfsmaster \-h\fR
.fi
.SH "DESCRIPTION"
.sp
\fBmfsmaster\fR is the metadata server program of Lizard File System\&. Depending on parameters it can start, restart or stop LizardFS metadata server process\&. Without any options it starts LizardFS metadata server, killing previously run process if lock file exists\&.
.sp
Metadata server can work in one of two modes (personalities):
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
master
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
shadow
.RE
.sp
If metadata server works with \fImaster\fR personality it acts as main metadata server govering all file system metadata modifications\&. If metadata server works with \fIshadow\fR personality it acts as backup metadata server ready for immediate deployment as new \fImaster\fR in case of current \fImaster\fR failure\&. Shadow only accepts connections from lizardfs\-admin, i\&.e\&. mfschunkserver, mfsmetalogger and mfsmount (the client) are not allowed to connect to \fIshadow\fR instance\&.
.sp
Current metadata server personality is defined in metadata server configuration file and can be changed on the fly from \fIshadow\fR to \fImaster\fR by proper modification and reloading of its configuration file\&.
.sp
\fIMaster\fR and \fIshadow\fR are designed to run simultaneously in sync forever\&. It is very unlikely but still (due to a memory corruption or a bug) possible that after some time their metadata will somehow differ\&. Since version 2\&.5\&.2 metadata checksum is maintained both by \fImaster\fR and \fIshadow\fR, in order to detect and fix possible metadata corruptions\&. In case mismatch is detected \fIshadow\fR asks \fImaster\fR to double check its metadata and dump its current snapshot\&. After the metadata is dumped and the checksum in \fImaster\fR is recalculated shadow downloads the new metadata snapshot, which should ensure that master and all shadows have exactly the same metadata\&.
.sp
SIGHUP (or \fIreload\fR \fIACTION\fR) forces \fBmfsmaster\fR to reload all configuration files\&.
.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 master process, without trying to kill previous instance (this option allows to run LizardFS master if stale PID file exists)
.RE
.PP
\fB\-s\fR
.RS 4
(deprecated, use
\fBstop\fR
action instead) stop LizardFS master process
.RE
.PP
\fB\-c\fR \fICFGFILE\fR
.RS 4
specify alternative path of configuration file (default is
\fBmfsmaster\&.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
.PP
\fIACTION\fR
.RS 4
is the one of
\fBstart\fR,
\fBstop\fR,
\fBrestart\fR,
\fBreload\fR,
\fBtest\fR,
\fBisalive\fR
or
\fBkill\fR\&. Default action is
\fBrestart\fR\&.
.RE
.SH "FILES"
.PP
\fBmfsmaster\&.cfg\fR
.RS 4
configuration file for LizardFS master process (see
\fBmfsmaster\&.cfg\fR(5) manual)
.RE
.PP
\fBmfsexports\&.cfg\fR
.RS 4
LizardFS access control file (used with
\fBmfsmount\fRs
1\&.6\&.0 or later, see
\fBmfsexports\&.cfg\fR(5) manual)
.RE
.PP
\fBmfstopology\&.cfg\fR
.RS 4
Network topology definitions (see
\fBmfstopology\&.cfg\fR(5) manual)
.RE
.PP
\fBmfsmaster\&.lock\fR
.RS 4
PID file of running LizardFS master process
.RE
.PP
\fB\&.mfsmaster\&.lock\fR
.RS 4
lock file of running LizardFS master process (created in data directory)
.RE
.PP
\fBmetadata\&.mfs\fR, \fBmetadata\&.mfs\&.back\fR
.RS 4
LizardFS filesystem metadata image
.RE
.PP
\fBchangelog\&.*\&.mfs\fR
.RS 4
LizardFS filesystem metadata change logs (merged into
\fBmetadata\&.mfs\fR
once per hour)
.RE
.PP
\fBdata\&.stats\fR
.RS 4
LizardFS master 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
mfsmetarestore(8), mfschunkserver(8), mfsmount(1), mfsmaster\&.cfg(5), mfsexports\&.cfg(5), mfstopology\&.cfg(5), moosefs(7)