puppet-lmod

Overview

The lmod module handles the configuration of a system to use Lmod. Additional details regarding Lmod can be found at http://lmod.readthedocs.io/en/latest/index.html.

Usage

lmod

The default parameter values are suitable for compute nodes using Lmod.

class { 'lmod': }

This is an example of how to configure package building nodes to use Lmod.

class { 'lmod':
  manage_build_packages => true,
}

To customize the avail layout (since Lmod 5.7.5)

class { 'lmod':
  avail_style => ['grouped', 'system'],
}

To install Lmod from existing package repositories

class { 'lmod':
  lmod_package_from_repo => true,
}

Below is an example that adds several paths to default MODULEPATH, sets a default module, sets LMOD_PACKAGE_PATH and sets LMOD_SYSTEM_NAME.

class { 'lmod':
  lmod_package_from_repo => true,
  modulepaths            => ['$LMOD_sys', 'Core'],
  set_lmod_package_path  => true,
  set_default_module     => true,
  default_module         => 'mycluster',
}

Reference

http://treydock.github.io/puppet-lmod/

Compatibility

Tested using

• CentOS/RedHat 6, 7
• Ubuntu 14.04, 16.04

Development

Testing

Testing requires the following dependencies:

• rake
• bundler

Install gem dependencies

bundle install

Run unit tests

bundle exec rake test

If you have Vagrant >= 1.2.0 installed you can run system tests

bundle exec rake beaker

TODO

Reference

Table of Contents

Classes

Public Classes

• lmod: Manage Lmod

Private Classes

• lmod::install: Install Lmod package and dependencies
• lmod::load: Manage Lmod load config files

Classes

lmod

Manage Lmod

Examples

To install Lmod from existing package repositories

class { 'lmod':
   lmod_package_from_repo => true,
 }

Parameters

The following parameters are available in the lmod class.

ensure

Data type: Enum['present','absent']

The ensure parameter for this module. If set to 'absent', managed files are removed. If lmod_package_from_repo is true and ensure is 'absent', then the lmod package is also removed.

Default value: 'present'

package_ensure

Data type: String

The ensure value for Lmod package. Only applies when lmod_package_from_repo is true.

Default value: 'present'

prefix

Data type: Stdlib::Absolutepath

The prefix used when lmod was compiled.

Default value: '/opt/apps'

lmod_package_from_repo

Data type: Boolean

Should the lmod package be installed from a apt/yum repository, or is it installed separately with only dependencies installed from package repos?

Default value: false

manage_epel

Data type: Boolean

Boolean that determines if EPEL should be mananged by this module for systems installing Lmod via yum.

Default value: true

package_name

Data type: String

Lmod package name if lmod_package_from_repo is true.

Default value: 'Lmod'

base_packages

Data type: Array

Packages necessary to build and use Lmod, only installed if lmod_package_from_repo is false

Default value: []

runtime_packages

Data type: Array

Lmod runtime package dependencies, only installed if lmod_package_from_repo is false

Default value: []

build_packages

Data type: Array

Lmod runtime devel package dependencies, only installed if manage_build_packages is true

Default value: []

modulepath_root

Data type: Optional[Stdlib::Absolutepath]

The modulepath for your lmod installation. Default is 'UNSET'. If the value is 'UNSET' then the path $prefix/modulefiles is used.

Default value: undef

modulepaths

Data type: Array

An Array of modulepaths to be defined in the module.sh and module.csh.

Default value: ['$LMOD_sys', 'Core']

set_lmod_package_path

Data type: Boolean

Boolean that determines if the LMOD_PACKAGE_PATH environment variable should be set in modules.sh and modules.csh.

Default value: true

lmod_package_path

Data type: String

Value given to the LMOD_PACKAGE_PATH environment variable in modules.sh and modules.csh.

Default value: '$MODULEPATH_ROOT/Site'

set_default_module

Data type: Boolean

Boolean will disable the management of the files that define the default module.

Default value: true

default_module

Data type: String

The name of the default module to be loaded when users login. This will not be set if set_default_module is false.

Default value: 'StdEnv'

avail_styles

Data type: Array

An Array used to set the LMOD_AVAIL_STYLES environment variable. An empty Array prevents this environment variable from being set.

Default value: ['system']

lmod_admin_file

Data type: Optional[Stdlib::Absolutepath]

Defines path used for LMOD_ADMIN_FILE.

Default value: undef

system_name

Data type: Optional[String]

Value used for LMOD_SYSTEM_NAME.

Default value: undef

site_name

Data type: Optional[String]

Value used for LMOD_SITE_NAME.

Default value: undef

cached_loads

Data type: Optional[Boolean]

Value used for LMOD_CACHED_LOADS.

Default value: undef

manage_build_packages

Data type: Boolean

Boolean that determines if the packages necessary to build lmod should be managed.

Default value: false

modules_bash_path

Data type: Stdlib::Absolutepath

Default value: '/etc/profile.d/modules.sh'

modules_bash_template

Data type: String

Default value: 'lmod/modules.sh.erb'

modules_bash_source

Data type: Optional[String]

Default value: undef

modules_csh_path

Data type: Stdlib::Absolutepath

Default value: '/etc/profile.d/modules.csh'

modules_csh_template

Data type: String

Default value: 'lmod/modules.csh.erb'

modules_csh_source

Data type: Optional[String]

Default value: undef

stdenv_bash_template

Data type: String

Default value: 'lmod/z00_StdEnv.sh.erb'

stdenv_bash_source

Data type: Optional[String]

Default value: undef

stdenv_csh_path

Data type: Stdlib::Absolutepath

Default value: '/etc/profile.d/z00_StdEnv.csh'

stdenv_csh_template

Data type: String

Default value: 'lmod/z00_StdEnv.csh.erb'

stdenv_csh_source

Data type: Optional[String]

Default value: undef

Change log

All notable changes to this project will be documented in this file. The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

v1.3.0 (2019-05-10)

Full Changelog

Added

• Use puppet strings #22 (treydock)
• Use Hiera v5 data #21 (treydock)
• Support Debian 8 and 9 and Ubuntu 18.04 #20 (treydock)
• Use PDK #19 (treydock)
• Support Puppet 5 and 6 and use Beaker 4 #18 (treydock)
• Make EPEL optional #17 (treydock)

1.2.0 (2018-06-25)

Full Changelog

Added

• Allow LMOD_SITE_NAME to be set #16 (treydock)

1.1.0 (2018-04-18)

Full Changelog

Added

• Support setting LMOD_CACHED_LOADS via cached_loads parameter #15 (treydock)

1.0.2 (2017-11-09)

Full Changelog

Fixed

• Fix bash module load file syntax error #14 (treydock)

1.0.1 (2017-10-28)

Full Changelog

1.0.0 (2017-10-28)

Full Changelog

Added

• Add package_ensure parameter. Only used when lmod_package_from_repo=true #11 (treydock)
• Remove EL5 package list #10 (treydock)
• Update bash init script to check for various commands in multiple locations #9 (treydock)
• BREAKING: Drop support for Puppet 3 and use Puppet datatypes #8 (treydock)

0.0.1 (2017-10-19)

Full Changelog

Added

• Drop puppet 2.7 testing, sync test matrix #6 (jabl)
• Support Ubuntu 16.04 LTS #3 (jabl)
• Support Ubuntu, and allow lmod package to be installed from repo #1 (jabl)

Fixed

• Use correct default tcsh paths on Ubuntu #5 (jabl)

* This Changelog was automatically generated by github_changelog_generator