Forge Home

beegfs

BeeGFS Puppet module

1,751 downloads

942 latest version

4.6 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.2.0 (latest)
  • 0.1.0
released Mar 7th 2021
This version is compatible with:
  • Puppet Enterprise 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x
  • Puppet >= 6.0.0 < 8.0.0
  • ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'treydock-beegfs', '0.2.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add treydock-beegfs
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install treydock-beegfs --version 0.2.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

treydock/beegfs — version 0.2.0 Mar 7th 2021

puppet-module-beegfs

Puppet Forge CI Status

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

http://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