Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
mfsmaster(8)		     This is part of MooseFS		    mfsmaster(8)

NAME
     mfsmaster - start, restart or stop MooseFS master process

SYNOPSIS
     mfsmaster [-c CFGFILE] [-f] [-d] [-u] [-n] [-i] [-a] [-e] [-x[x]] [-t LOCK-
     TIMEOUT] [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 mfsmas-
	    ter.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 signal 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 re-
		     turn 1).

	    kill     Send termination signal to master process.

	    restore  Restore  current  metadata  file  using backup metadata and
		     changelog 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  mfsmas-
	    ter.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  direc-
	    tory)

     .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
     Copyright (C) 2026 Jakub Kruszona-Zawadzki, Saglabs SA

     This file is part of MooseFS.

     MooseFS  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  Soft-
     ware Foundation, version 2 (only).

     MooseFS  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 de-
     tails.

     You should have received a copy of the GNU  General  Public  License  along
     with this program; if not, see <https://www.gnu.org/licenses/>.

SEE ALSO
     mfschunkserver(8),  mfsmount(8),  mfsmaster.cfg(5),  mfsexports.cfg(5), mf-
     stopology.cfg(5)

MooseFS 4.59.1-1		    May 2026			    mfsmaster(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=mfsmaster&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help