mfsmetalogger

NAME

mfsmetalogger - start, restart or stop MooseFS metalogger process

SYNOPSIS

mfsmetalogger [-f] [-d] [-u] [-n] [-t LOCKTIMEOUT] [-c CFGFILE] [-o OPTIONOVERRIDE] [ACTION]

mfsmetalogger -v

mfsmetalogger -h

DESCRIPTION

mfsmetalogger is the metadata replication server of MooseFS.

OPTIONS

-v

print version information and exit

-h

print usage information and exit

-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

-t LOCKTIMEOUT

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

-c CFGFILE

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

-o OPTIONOVERRIDE

override a config option - see NOTES

ACTION

tells metalogger to perform one of the following actions:

start: Start metalogger process if the process is not already running, otherwise display error message.
stop: Stop metalogger process if the process is running, otherwise display error message.
restart: (default action) If the metalogger process is running, restart it, if it's not running, start it.
reload: Send a signal to metalogger process to reload config files.
info: Send a signal to metalogger process to dump debug information file in working directory.
test: Displays "mfsmetalogger pid: PID" if the metalogger is running (and return 0) or "mfsmetalogger is not running" otherwise (and return 1).
kill: Send termination signal to metalogger process.
restore: Not implemented.

FILES

mfsmetalogger.cfg: configuration file for MooseFS metalogger process; refer to mfsmetalogger.cfg (5) manual for details
.mfsmetalogger.lock: lock file of running MooseFS metalogger process (created in data directory)
changelog_ml.*.mfs: MooseFS filesystem metadata change logs (backup of master change log files, created in data directory)
metadata.ml.mfs.back: Latest copy of complete metadata.mfs.back file from MooseFS master (created in data directory)
.mfsmetalogger_info.txt: metalogger info file, created by sending the process INFO signal, with work parameters that can be used for debugging/support purposes (created in data directory)

NOTES

All MooseFS daemons, including mfsmetalogger, can read configuration options from 3 sources. These sources are, in order from the most important, to the least important:
- option overrides provided in commandline as arguments
- options defined in environment variables
- options defined in the daemon's main config file (mfsmetalogger.cfg for mfsmetalogger process).

All possible configuration options are described in the manpage for the mfsmetalogger.cfg(5) file. Options provided in commandline are the same as in the config file (e.g. running the mfsmetalogger with -o MASTER_TIMEOUT=15 will change the metalogger's timeout in the connection with master to 15 seconds). Options provided in environment must be prefixed with "MFSCFG_" (e.g setting MFSCFG_MASTER_TIMEOUT to 15 in environment will change the metalogger's timeout in the connection with master to 15 seconds if MASTER_TIMEOUT is not overriden in commandline).

REPORTING BUGS

Report bugs to bugs@moosefs.com

COPYRIGHT

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.