1MFSMASTER(8)                                                      MFSMASTER(8)
2
3
4

NAME

6       mfsmaster - start, restart or stop Lizard File System metadata server
7       process
8

SYNOPSIS

10       mfsmaster [-f] [-c CFGFILE] [-u] [-d] [-t LOCKTIMEOUT] [ACTION]
11
12       mfsmaster -s [-c CFGFILE]
13
14       mfsmaster -v
15
16       mfsmaster -h
17

DESCRIPTION

19       mfsmaster is the metadata server program of Lizard File System.
20       Depending on parameters it can start, restart or stop LizardFS metadata
21       server process. Without any options it starts LizardFS metadata server,
22       killing previously run process if lock file exists.
23
24       Metadata server can work in one of two modes (personalities):
25
26        1. master
27
28        2. shadow
29
30       If metadata server works with master personality it acts as main
31       metadata server govering all file system metadata modifications. If
32       metadata server works with shadow personality it acts as backup
33       metadata server ready for immediate deployment as new master in case of
34       current master failure. Shadow only accepts connections from
35       lizardfs-admin, i.e. mfschunkserver, mfsmetalogger and mfsmount (the
36       client) are not allowed to connect to shadow instance.
37
38       Current metadata server personality is defined in metadata server
39       configuration file and can be changed on the fly from shadow to master
40       by proper modification and reloading of its configuration file.
41
42       Master and shadow are designed to run simultaneously in sync forever.
43       It is very unlikely but still (due to a memory corruption or a bug)
44       possible that after some time their metadata will somehow differ. Since
45       version 2.5.2 metadata checksum is maintained both by master and
46       shadow, in order to detect and fix possible metadata corruptions. In
47       case mismatch is detected shadow asks master to double check its
48       metadata and dump its current snapshot. After the metadata is dumped
49       and the checksum in master is recalculated shadow downloads the new
50       metadata snapshot, which should ensure that master and all shadows have
51       exactly the same metadata.
52
53       SIGHUP (or reload ACTION) forces mfsmaster to reload all configuration
54       files.
55
56       -v
57           print version information and exit
58
59       -h
60           print usage information and exit
61
62       -f
63           (deprecated, use start action instead) forcily run LizardFS master
64           process, without trying to kill previous instance (this option
65           allows to run LizardFS master if stale PID file exists)
66
67       -s
68           (deprecated, use stop action instead) stop LizardFS master process
69
70       -c CFGFILE
71           specify alternative path of configuration file (default is
72           mfsmaster.cfg in system configuration directory)
73
74       -u
75           log undefined configuration values (when default is assumed)
76
77       -d
78           run in foreground, don’t daemonize
79
80       -t LOCKTIMEOUT
81           how long to wait for lockfile (default is 60 seconds)
82
83       ACTION
84           is the one of start, stop, restart, reload, test, isalive or kill.
85           Default action is restart.
86

FILES

88       mfsmaster.cfg
89           configuration file for LizardFS master process (see
90           mfsmaster.cfg(5) manual)
91
92       mfsexports.cfg
93           LizardFS access control file (used with mfsmounts 1.6.0 or later,
94           see mfsexports.cfg(5) manual)
95
96       mfstopology.cfg
97           Network topology definitions (see mfstopology.cfg(5) manual)
98
99       mfsmaster.lock
100           PID file of running LizardFS master process
101
102       .mfsmaster.lock
103           lock file of running LizardFS master process (created in data
104           directory)
105
106       metadata.mfs, metadata.mfs.back
107           LizardFS filesystem metadata image
108
109       changelog.*.mfs
110           LizardFS filesystem metadata change logs (merged into metadata.mfs
111           once per hour)
112
113       data.stats
114           LizardFS master charts state
115

REPORTING BUGS

117       Report bugs to <contact@lizardfs.org>.
118
120       Copyright 2008-2009 Gemius SA, 2013-2015 Skytechnology sp. z o.o.
121
122       LizardFS is free software: you can redistribute it and/or modify it
123       under the terms of the GNU General Public License as published by the
124       Free Software Foundation, version 3.
125
126       LizardFS is distributed in the hope that it will be useful, but WITHOUT
127       ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
128       FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
129       for more details.
130
131       You should have received a copy of the GNU General Public License along
132       with LizardFS. If not, see http://www.gnu.org/licenses/.
133

SEE ALSO

135       mfsmetarestore(8), mfschunkserver(8), mfsmount(1), mfsmaster.cfg(5),
136       mfsexports.cfg(5), mfstopology.cfg(5), moosefs(7)
137
138
139
140                                  01/29/2020                      MFSMASTER(8)
Impressum