Basic Configuration and Service Startup

Before you run the BeeGFS services for the first time, a few configuration parameters have to be set.

Table of Contents (Page)

  1. Basic Configuration
  2. Start BeeGFS Services
  3. Server Tuning
  4. Next Step: Installation Commands Walk-Through Example

Basic Configuration

There are three configuration settings that are mandatory to be set for a specific environment. The following table shows the three settings and the config files, in which they will be applied:

SettingConfiguration File (in /etc/beegfs)
Storage Pathsbeegfs-mgmtd.conf,
Management Hostbeegfs-meta.conf,
Client Mount Directorybeegfs-mounts.conf
Table: Basic settings and corresponding configuration files

The info box below contains descriptions of the three options that need to be set before you can run the services:

  • Storage Paths:
Set the value of the storeMgmtDirectory/storeMetaDirectory/storeStorageDirectory option to configure where BeeGFS should store its internal data. BeeGFS stores all data in a subdirectory of an existing partition that has been formatted with any of the standard local Linux file systems (typically XFS for storage servers and ext4 for metadata servers).
Note that different services on the same machine cannot share the same storage directory, so different directories have to be used, e.g. /data/beegfs-meta for metadata servers and /data/beegfs-storage for storage servers.
  • Management Host:
Set the value of the sysMgmtdHost option in the configuration files of the metadata servers, storage servers, clients, and the optional Admon to the IP address or hostname of the management daemon. This will enable automatic server discovery for the clients.
  • Client Mount Directory:
The client mount file consists of two space-separated values. The first value is the directory where you want to mount the file system, the second value is the client configuration file for this mount point. You will typically have a line like this in the beegfs-mounts.conf file:

/mnt/beegfs /etc/beegfs/beegfs-client.conf

It is also possible to specify multiple mount/config entries in this file (one mount/config pair per line) if you need to mount different BeeGFS instances on the same client. Optionally, you can also inform mount options for each mount/config entry. In the example below, the first line mounts a writable BeeGFS FS on /mnt/scratch and a read-only BeeGFS FS on /mnt/software.

/mnt/scratch /etc/beegfs/beegfs-client-scratch.conf beegfs rw
/mnt/software /etc/beegfs/beegfs-client-software.conf beegfs ro

Basic settings description

When you have made the changes to the configuration files, it is time to start the BeeGFS services.

Start BeeGFS Services

The services will register themselves at the management server, so clients will automatically know about all available servers.
The instructions below are for single instances. If you want to run multiple instances of one service on the same machine, please refer to multi mode.

Note: BeeGFS clients have a mount sanity check and cancel a mount operation if servers are unreachable. If you want to mount even with unreachable servers, set sysMountSanityCheckMS=0 in the file beegfs-client.conf.

If your system uses systemd, you can start the services using the systemctl start beegfs-<service> command. If not, you can still use the init script as described below.
You can to start all BeeGFS services in arbitrary order by using the corresponding init scripts (/etc/init.d/beegfs-...).

Server Tuning

Please make sure to read the chapters about Server Tuning to configure your system for optimal performance.

Next Step: Installation Commands Walk-Through Example

Now that you have a general understanding of the installation procedure, you are probably interested in a walk-through with example commands for installation.

Back to table of contents
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki