mfsmaster

NAME

mfsmaster - start, restart or stop MooseFS master process

SYNOPSIS

mfsmaster [-c CFGFILE] [-f] [-d] [-u] [-n] [-i] [-a] [-e] [-x[x]] [-t LOCKTIMEOUT] [ACTION]

mfsmaster -v

mfsmaster -h

DESCRIPTION

mfsmaster is the master program of MooseFS.

OPTIONS

-v

print version information and exit

-h

print usage information and exit

-c CFGFILE

specify alternative path of configuration file (default is mfsmaster.cfg in system configuration directory)

-f

run in foreground, don't daemonize

-d

run with dangerous options (names: DANGEROUS_*)

-u

log undefined configuration values (when default is assumed)

-n

do not attempt to increase limit of core dump size

-i

ignore some metadata structure errors

-a

automatically restore metadata from change logs

-e

(pro only) start without metadata (used to start additional masters)

-x

produce more verbose output

-xx

even more verbose output

-t LOCKTIMEOUT

how long to wait for lockfile (in seconds; default is 1800 seconds)

ACTION

tells master to perform one of the following actions:

start

Start master process if the process is not already running, otherwise display error message.

stop

Stop master process if the process is running, otherwise display error message.

restart

(default action) If the master process is running, restart it, if it's not running, start it.

reload

Send a signal to master process to reload config files.

info

Send a singal to master process to dump debug information file in working directory.

test

Displays "mfsmaster pid: PID" if the master is running (and return 0) or "mfsmaster is not running" otherwise (and return 1).

kill

Send termination signal to master process.

restore

Restore current metadata file using backup metadata and changlog files (if possible, i.e. if correct files exist), write it to working directory and exit.

FILES

mfsmaster.cfg

configuration file for MooseFS master process; refer to mfsmaster.cfg (5) manual for details

mfsexports.cfg

MooseFS access control file; refer to mfsexports.cfg (5) manual for details

mfstopology.cfg

Network topology definitions; refer to mfstopology.cfg (5) manual for details

mfsipmap.cfg

Chunkservers IP mapping definitions; refer to mfsipmap.cfg (5) manual for details

.mfsmaster.lock

lock file of running MooseFS master process (created in data directory)

.bgwriter.lock

lock file of running MooseFS master subprocess for storing metadata (created in data directory)

metadata.mfs, metadata.mfs.back

MooseFS filesystem metadata image (created in data directory)

metadata.crc

CRC of metadata.mfs file (created in data directory)

metadata.mfs.empty

An empty metadata file, to be used when starting up a fresh MooseFS instance (created in data directory)

changelog.*.mfs

MooseFS filesystem metadata change logs (created in data directory)

stats.mfs

master charts stats (created in data directory)

.mfsmaster_info.txt

master info file, created by sending the process INFO signal, with work parameters that can be used for debugging/support purposes (created in data directory)

REPORTING BUGS

Report bugs to bugs@moosefs.com

Copyright Jakub Kruszona-Zawadzki, Saglabs SA

This file is part of MooseFS.

READ THIS BEFORE INSTALLING THE SOFTWARE. BY INSTALLING, ACTIVATING OR USING THE SOFTWARE, YOU ARE AGREEING TO BE BOUND BY THE TERMS AND CONDITIONS OF MooseFS LICENSE AGREEMENT FOR VERSION 1.7 AND HIGHER IN A SEPARATE FILE. THIS SOFTWARE IS LICENSED AS PROPRIETARY SOFTWARE. YOU DO NOT ACQUIRE ANY OWNERSHIP RIGHT, TITLE OR INTEREST IN OR TO ANY INTELLECTUAL PROPERTY OR OTHER PROPRIETARY RIGHTS.

SEE ALSO

mfschunkserver(8), mfsmount(8), mfsmaster.cfg(5), mfsexports.cfg(5), mfstopology.cfg(5)