Skip to main content

Master Servers

This chapter describes how to install and configure the MooseFS Pro Master Server.
The Master Server is the central metadata component of the MooseFS cluster, so correct installation and configuration are essential.
In MooseFS Pro, every Master Server must also have access to a valid mfslicence.bin file.

Installing the MooseFS Pro Master Package​

Install the moosefs-pro-master package using your system’s package manager.

Debian/Ubuntu (APT-based systems)​

apt-get install moosefs-pro-master

RedHat/CentOS (YUM-based systems)​

yum install moosefs-pro-master

Preparing configuration files​

After installation, sample configuration files will be placed in:

/etc/mfs

Depending on MooseFS version, the templates will have extensions:

*.sample (MooseFS 3.0 and newer)

*.dist (MooseFS 2.0)

You must copy these sample files to their actual configuration names:

cd /etc/mfs
cp mfsmaster.cfg.sample mfsmaster.cfg
cp mfsexports.cfg.sample mfsexports.cfg

Customize the configuration files according to your needs and cluster setup. The configuration files are described in a separate chapter.

Adding a License File (MooseFS Pro Only)​

MooseFS Pro requires a valid mfslicence.bin license file.

Place your license file into:

/etc/mfs/mfslicence.bin

This file must be present on every Master Server in a multi-master deployment.

Starting the MooseFS Master Server​

Once configuration is prepared, you can start the Master Server.

Using MooseFS built-in control script​

mfsmaster start

Using SysV init (Debian, Ubuntu, RedHat 6 and similar systems)​

service moosefs-pro-master start

Using systemd (RedHat 7+, CentOS 7+, most modern Linux distributions)​

systemctl start moosefs-pro-master.service

To enable automatic start on boot:

systemctl enable moosefs-pro-master.service