puppet-module-beegfs

Table of Contents

  1. Overview

  2. Usage - Configuration options

  3. Reference - Parameter and detailed reference to all options

  4. Limitations - OS compatibility, etc.

  5. TODO

  6. Additional Information

Overview

This module manages BeeGFS servers and clients.

BeeGFS Compatibility

This module is only supported on the following releases of BeeGFS:

  • 7.1.x

Usage

beegfs

The following examples are done using Hiera. The basic usage for a profile class would be the following:

include beegfs

The majority of configurations to BeeGFS module can be done in a file like common.yaml with only the role Boolean values being changed for specific hosts.

The following example defines to isntall BeeGFS release 7.1 as well necessary flags to use Mellanox OFED.

beegfs::release: '7.1'
beegfs::version: present
beegfs::mgmtd_host: beegfs-mds1.infra.osc.edu
beegfs::client_build_args: '-j8 BEEGFS_OPENTK_IBVERBS=1 OFED_INCLUDE_PATH=/usr/src/ofa_kernel/default/include/'
beegfs::mgmtd_store_directory: /data/beegfs/mgmtd
beegfs::meta_store_directory: /data/beegfs/meta
beegfs::storage_store_directory: /data/beegfs/storage
beegfs::client_mount_path: /mnt/beegfs

The following example is a host running Mgmtd, Metadata and Admon daemons:

beegfs::admon: true
beegfs::mgmtd: true
beegfs::meta: true

The following example is a host running Storage daemon:

beegfs::storage: true

Each BeeGFS role supports defining additional configurations for their respective config files:

beegfs::mgmtd_config_overrides:
  storeAllowFirstRunInit: 'false'
beegfs::meta_config_overrides:
  storeAllowFirstRunInit: 'false'
beegfs::storage_config_overrides:
  storeAllowFirstRunInit: 'false'

Reference

treydock.github.io/puppet-module-beegfs/

Facts

beegfs_version

This Facter fact can be used to determine the installed version of the BeeGFS components.

This fact gets the version by querying the beegfs-common package which is installed by all the BeeGFS roles.

Limitations

This module has been tested on:

  • RedHat/CentOS 7 x86_64

TODO

  • Refacter the roles to use a shared defined resource to reduce on the amount of duplicate module code

  • Add support for BeeGFS Multi-mode

Additional Information