BeeGFS DKMS Client Setup

Starting with BeeGFS 7.1.4, a new BeeGFS client package is provided alongside the traditional one. Called beegfs-client-dkms, it relies on the DKMS insfrastructure to build the client kernel module instead of the custom scripts that have been used up to that point.

To avoid breaking existing workflows and deployment tools that may be in use on some sites, both beegfs-client and beegfs-client-dkms packages are provided in BeeGFS 7. They are mutually exclusive and only one of them can be installed on a system at any given time.

Note: All the examples below were tested on a CentOS 7 machine. They may need to be adapted to other versions of CentOS or other distributions.

Changes Introduced in the DKMS Client Package

The DKMS variant of the BeeGFS client introduces some important changes:

DKMS Client Installation

Installing the Package

Installing the package is done easily:

sudo yum install beegfs-client-dkms

And so is replacing the traditional client package with the DKMS one:

sudo yum swap -- remove beegfs-client -- install beegfs-client-dkms

DKMS will build the kernel module automatically during installation. The log file for the build is available there:

/var/lib/dkms/beegfs/<BeeGFS version>/$(uname -r)/x86_64/log/make.log

Note: The module is not loaded automatically by DKMS after build.

Loading the Kernel Module

Once built with DKMS, the kernel module can be loaded like any other:

sudo modprobe beegfs

This can also be done automatically at boot via an entry in /etc/modules-load.d/. For example:

$ cat /etc/modules-load.d/beegfs-client-dkms.conf 
# Load the BeeGFS client module at boot

Mounting the Filesystem

Mounting a BeeGFS filesystem is now done via an entry in /etc/fstab.

A typical entry would look like this:

beegfs_nodev  /mnt/beegfs  beegfs  rw,relatime,cfgFile=/etc/beegfs/beegfs-client.conf,_netdev  0 0

This will mount the filesystem automatically at boot, after the network devices have come up. Add noauto to the mount options to prevent that:

beegfs_nodev  /mnt/beegfs  beegfs  noauto,rw,relatime,cfgFile=/etc/beegfs/beegfs-client.conf,_netdev  0 0

In those entries:
Finally mount the BeeGFS filesystem like any other filesystem:

sudo mount /mnt/beegfs

Known Limitations

BeeOND is currently incompatible with the BeeGFS DKMS client package, as it calls the traditional startup scripts.
Valid XHTML :: Valid CSS: :: Powered by WikkaWiki