Version information
This version is compatible with:
- Puppet Enterprise 2023.8.x, 2023.7.x, 2023.6.x, 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x
- Puppet >= 7.0.0 < 9.0.0
- , , ,
Start using this module
Add this module to your Puppetfile:
mod 'treydock-perfsonar', '5.0.0'
Learn more about managing modules with a PuppetfileDocumentation
puppet-module-perfsonar
Table of Contents
- Description
- Setup - The basics of getting started with perfsonar
- Usage - Configuration options and additional functionality
- 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.
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,
}
NOTE: On Puppet 8 the process to add the web admin password is not idempotent. Applying the web admin password on Puppet 8 requires 2 Puppet runs
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
Reference
Table of Contents
Classes
Public Classes
perfsonar
: Manage perfSONAR
Private Classes
perfsonar::config
: Manage perfSONAR configsperfsonar::firewall
: Manage perfSONAR firewall rulesperfsonar::install
: Manage perfsonar packagesperfsonar::lsregistrationdaemon
: Manage perfsonar-lsregistrationdaemon serviceperfsonar::pscheduler::agent
: Manage pschedular-agent serviceperfsonar::repo
: Manage perfsonar repo
Classes
perfsonar
Manage perfSONAR
Examples
include perfsonar
Parameters
The following parameters are available in the perfsonar
class:
manage_repo
manage_epel
release_url
bundle
optional_packages
manage_firewall
with_ipv6
web_admin_username
web_admin_password
remove_root_prompt
apache_group
manage_apache
ssl_cert
ssl_key
ssl_chain_file
apache_ssl_conf
apache_service
primary_interface
manage_pscheduler_agent
pscheduler_agent_config
manage_lsregistrationdaemon
lsregistrationdaemon_ensure
lsregistrationdaemon_enable
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
release_url
Data type: Variant[Stdlib::HTTPUrl,Stdlib::HTTPSUrl]
Release URL for adding GPG key
Default value: "https://software.internet2.edu/rpms/el${facts['os']['release']['major']}/x86_64/latest/packages/perfsonar-repo-0.11-1.noarch.rpm"
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: $facts.dig('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.
v5.0.0 (2024-10-14)
Changed
v4.1.0 (2024-06-12)
Added
v4.0.0 (2024-04-10)
Changed
v3.1.0 (2023-08-24)
Added
v3.0.0 (2023-08-23)
Changed
- Add EL8, EL9, Debian 10, Ubuntu 20.04, Drop Ubuntu 18.04 #22 (treydock)
- Drop Puppet 6 , Drop Debian 9 , update module dependencies #21 (treydock)
v2.0.0 (2022-04-13)
Changed
v1.1.0 (2022-04-13)
Added
v1.0.0 (2021-04-08)
Changed
v0.6.1 (2020-08-11)
Fixed
v0.6.0 (2020-08-11)
Added
- add lsregistrationdaemon daemon management #15 (jhoblitt)
- add pscheduler-agent management #14 (jhoblitt)
v0.5.0 (2019-08-20)
Changed
v0.4.3 (2019-08-20)
Fixed
v0.4.2 (2019-08-19)
Fixed
v0.4.1 (2019-08-14)
Fixed
v0.4.0 (2019-08-13)
Added
v0.3.1 (2019-08-12)
Fixed
v0.3.0 (2019-08-12)
Added
- Rely on httpauth to set permissions on psadmin.htpasswd #4 (treydock)
- Manage Apache SSL config #3 (treydock)
Fixed
v0.2.0 (2019-08-12)
Added
v0.1.0 (2019-08-09)
* This Changelog was automatically generated by github_changelog_generator
Dependencies
- puppetlabs/stdlib (>= 9.0.0 <10.0.0)
- puppetlabs/yumrepo_core (>= 1.0.0 <3.0.0)
- puppetlabs/apt (>= 6.0.0 <10.0.0)
- puppetlabs/firewall (>= 1.0.0 <7.0.0)
- puppet/epel (>= 3.0.0 <6.0.0)
- puppet/augeasproviders_apache (>= 3.2.0 <6.0.0)
- jamtur01/httpauth (>= 0.0.5 <1.0.0)