NAME

       mfsmaster - start, restart or stop Moose File System master process

SYNOPSIS

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

       mfsmaster -v

       mfsmaster -h

DESCRIPTION

       mfsmaster is the master program of Moose File System.

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)

       -u     log undefined configuration values (when default is assumed)

       -f     run in foreground, don't daemonize

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

       -i     ignore some metadata structure errors (attach orphans to root, ignore names without
              inode,  etc.).  DO  NOT  use  unless  you  are  ready  to  pick  up the pieces. See
              https://github.com/moosefs/moosefs/issues/151 for discussion.

       -a     automatically restore metadata from change logs

       -e     start without metadata (usable only in pro  version  -  used  to  start  additional
              masters)

       -x     produce more verbose output

       -xx    even more verbose output

       ACTION is  the one of start, stop, restart, reload, test, restore or kill.  Default action
              is restart. The test action will yield one of two responses: "mfsmaster  pid:  PID"
              or "mfsmaster is not running". The kill action will send a SIGKILL to the currently
              running master process. SIGHUP or reload action  forces  mfsmaster  to  reload  all
              configuration  files.  restore tries to restore metadata file using backup metadata
              files and changelogs; if successful it will store recovered metadata file end stop,
              it will never start master process.

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

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

       metadata.mfs, metadata.mfs.back
              MooseFS filesystem metadata image (created in data directory)

       changelog.*.mfs
              MooseFS filesystem metadata change logs (created in  data  directory;  merged  into
              metadata.mfs once per hour)

       data.stats
              MooseFS master charts state (created in data directory)

REPORTING BUGS

       Report bugs to <bugs@moosefs.com>.

COPYRIGHT

       Copyright (C) 2023 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 Software 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 details.

       You should have received a copy of the GNU General Public License along with  MooseFS;  if
       not,  write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
       02111-1301, USA or visit http://www.gnu.org/licenses/gpl-2.0.html

SEE ALSO

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