puppet-module-perfsonar

Table of Contents

1. Description
2. Setup - The basics of getting started with perfsonar
   • What perfsonar affects
   • Setup requirements
3. Usage - Configuration options and additional functionality
4. Reference - Module reference

Description

This module will manage perfSONAR

Setup

What perfsonar affects

At this time the module only adds the perfSONAR repo, installs packages and manages firewall rules.

Setup Requirements

For systems with yum package manager using Puppet >= 6.0 there is a dependency on puppetlabs/yumrepo_core.

Usage

To install perfSONAR:

include ::perfsonar

Set the web user's admin password and remove file that adds a prompt to root logins:

class { '::perfsonar':
  web_admin_password => 'changeme',
  remove_root_prompt => true,
}

Managing pscheduler-agent

One or more pscheduler-agent remotes may be configured.

(Hiera Example)

perfsonar::manage_pscheduler_agent: true
perfsonar::pscheduler_agent_config:
  remotes:
    - url: "https://foo.example.org/psconfig/bar.json"
      configure-archives: true

Disabling perfsonar-lsregistrationdaemon

The perfsonar-lsregistrationdaemon daemon is responsible for registering the perfsonar instance in the global registry.

(Hiera Example)

perfsonar::manage_lsregistrationdaemon: true
perfsonar::lsregistrationdaemon_ensure: 'stopped'
perfsonar::lsregistrationdaemon_enable: false

Reference

http://treydock.github.io/puppet-module-perfsonar/

Reference

Table of Contents

Classes

Public Classes

• perfsonar: Manage perfSONAR

Private Classes

• perfsonar::config: Manage perfSONAR configs
• perfsonar::firewall: Manage perfSONAR firewall rules
• perfsonar::install: Manage perfsonar packages
• perfsonar::lsregistrationdaemon: Manage perfsonar-lsregistrationdaemon service
• perfsonar::pscheduler::agent: Manage pschedular-agent service
• perfsonar::repo: Manage perfsonar repo

Classes

perfsonar

Manage perfSONAR

Examples

include perfsonar

Parameters

The following parameters are available in the perfsonar class.

manage_repo

Data type: Boolean

Boolean that determines if perfSONAR repos will be managed.

Default value: true

manage_epel

Data type: Boolean

Boolean that determines if EPEL repo is managed.

Default value: true

bundle

Data type: Enum['perfsonar-tools','perfsonar-testpoint','perfsonar-core','perfsonar-centralmanagement','perfsonar-toolkit']

The perfSONAR bundle package to install

Default value: 'perfsonar-toolkit'

optional_packages

Data type: Array

Array of optional packages to install

Default value: []

manage_firewall

Data type: Boolean

Boolean that determines if firewall rules are managed.

Default value: true

with_ipv6

Data type: Boolean

Boolean that determines if IPv6 support should be enabled

Default value: false

web_admin_username

Data type: String

User name used to log into perfSONAR web interface

Default value: 'admin'

web_admin_password

Data type: Optional[String]

Password for perfSONAR web login

Default value: undef

remove_root_prompt

Data type: Boolean

Boolean that determines if file should be removed that provides a prompt for setup when root logs in.

Default value: false

apache_group

Data type: String

Group used by Apache

Default value: 'apache'

manage_apache

Data type: Boolean

Boolean that sets if Apache should be managed

Default value: false

ssl_cert

Data type: Stdlib::Absolutepath

The path to Apache SSL certificate

Default value: '/etc/pki/tls/certs/localhost.crt'

ssl_key

Data type: Stdlib::Absolutepath

The path to Apache SSL private key

Default value: '/etc/pki/tls/private/localhost.key'

ssl_chain_file

Data type: Optional[Stdlib::Absolutepath]

The path to Apache SSL chain file

Default value: undef

apache_ssl_conf

Data type: Stdlib::Absolutepath

The path to Apache SSL configuration file

Default value: '/etc/httpd/conf.d/ssl.conf'

apache_service

Data type: String

The Apache service name

Default value: 'httpd'

primary_interface

Data type: Optional[String]

The primary interface of host

Default value: ('networking','primary')

manage_pscheduler_agent

Data type: Boolean

Weather or not the pscheduler-agent daemon should be managed

Default value: false

pscheduler_agent_config

Data type: Optional[Hash]

Configuration to convert to json and write to pscheduler-agent.json

Default value: undef

manage_lsregistrationdaemon

Data type: Boolean

Weather or not the perfsonar-lsregistrationdaemon daemon should be managed

Default value: false

lsregistrationdaemon_ensure

Data type: Stdlib::Ensure::Service

perfsonar-lsregistrationdaemon service ensure

Default value: 'running'

lsregistrationdaemon_enable

Data type: Boolean

perfsonar-lsregistrationdaemon service enable

Default value: true

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.

v0.6.1 (2020-08-11)

Full Changelog

Fixed

• s/perfsonare-centralmanagement/perfsonar-centralmanagement/ #16 (jhoblitt)

v0.6.0 (2020-08-11)

Full Changelog

Added

• add lsregistrationdaemon daemon management #15 (jhoblitt)
• add pscheduler-agent management #14 (jhoblitt)

v0.5.0 (2019-08-20)

Full Changelog

Changed

• Remove Ubuntu 14.04 support #10 (treydock)

v0.4.3 (2019-08-20)

Full Changelog

Fixed

• Fix README #9 (treydock)

v0.4.2 (2019-08-19)

Full Changelog

Fixed

• Fix firewall jump rule to work with UDP and TCP #8 (treydock)

v0.4.1 (2019-08-14)

Full Changelog

Fixed

• Fix README #7 (treydock)

v0.4.0 (2019-08-13)

Full Changelog

Added

• Initial work to set primary interface #6 (treydock)

v0.3.1 (2019-08-12)

Full Changelog

Fixed

• Fix Apache SSL management #5 (treydock)

v0.3.0 (2019-08-12)

Full Changelog

Added

• Rely on httpauth to set permissions on psadmin.htpasswd #4 (treydock)
• Manage Apache SSL config #3 (treydock)

Fixed

• Fix permissions for psadmin.htpasswd #2 (treydock)

v0.2.0 (2019-08-12)

Full Changelog

Added

• Manage httpauth and allow removing root login prompt #1 (treydock)

v0.1.0 (2019-08-09)

Full Changelog

* This Changelog was automatically generated by github_changelog_generator