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
beegfs



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