puppet-module-pcp

1. Overview
2. Usage - Configuration options
3. Reference - Parameter and detailed reference to all options
   • Public Classes
   • Public Defines
4. Compatibility
5. Development - Guide for contributing to the module

Overview

This module manages Performance Co-Pilot (PCP)

Only PCP >= 3.11.3 is supported

Usage

To install PCP to log locally

class { 'pcp': }

Example of using PCP without default logger and pmie as well as disabling pmlogger log archival

class { '::pcp':
  include_default_pmlogger => false,
  include_default_pmie     => false,
  pmlogger_daily_args      => '-M -k forever',
}

Define a new primary logger that logs to a shared location

pcp::pmlogger { 'supremm':
  ensure         => 'present',
  hostname       => 'LOCALHOSTNAME',
  primary        => true,
  socks          => false,
  log_dir        => '/data/supremm/pmlogger/LOCALHOSTNAME',
  args           => '-r -c config.default',
}

Install and enable a PMDA

pcp::pmda { 'slurm': }

Reference

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

Compatibility

This module only works with PCP >= 3.11.3

Tested using

• CentOS 6
• CentOS 7

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

Reference

Table of Contents

Classes

Public Classes

• pcp: Manage PCP

Private Classes

• pcp::config:
• pcp::install:
• pcp::repo:
• pcp::resources:
• pcp::service:
• pcp::user:

Defined types

• pcp::pmda: Install, enable and optionally configure a PMDA
• pcp::pmie: Configure a pmie
• pcp::pmlogger: Configure a pmlogger

Classes

pcp

Manage PCP

Examples

include ::pcp

Parameters

The following parameters are available in the pcp class.

ensure

Data type: Enum['running', 'stopped', 'absent']

Defines state of PCP. Valid values are running, stopped, or absent. Default is running.

Default value: 'running'

manage_repo

Data type: Boolean

Determines if PCP repo should be managed. Default is true.

Default value: true

repo_baseurl

Data type: Optional[String]

Base URL to pcp yum repo. Default is https://dl.bintray.com/pcp/el%{::operatingsystemmajrelease}.

Default value: undef

repo_exclude

Data type: Optional[String]

Packages to exclude from PCP repo

Default value: undef

package_ensure

Data type: String

Package ensure property. Value is set to absent if ensure is absent. Default is present.

Default value: 'present'

package_name

Data type: String

Name of PCP package. Default is pcp.

Default value: 'pcp'

extra_packages

Data type: Array

Array of extra packages to install for PCP

Default value: []

service_ensure

Data type: Optional[String]

Set service ensure property for pmcd, pmie and pmlogger services. Default is based on ensure parameter.

Default value: undef

service_enable

Data type: Optional[Boolean]

Set service enable property for pmcd, pmie and pmlogger services. Default is based on ensure parameter.

Default value: undef

enable_pmproxy

Data type: Boolean

Boolean that determines if pmproxy service is running/enabled. Default is false.

Default value: false

manage_user

Data type: Boolean

Boolean that sets if pcp user / group is managed. Default is true.

Default value: true

pcp_group_gid

Data type: Optional[Integer]

pcp group GID. Default is undef.

Default value: undef

pcp_user_uid

Data type: Optional[Integer]

pcp user UID. Default is undef.

Default value: undef

cron_ensure

Data type: Optional[String]

Ensure passed to cron files. Default based on value of ensure.

Default value: undef

pmlogger_cron_template

Data type: String

Template used for pmlogger cron. Default is pcp/pcp-pmlogger.cron.erb.

Default value: 'pcp/pcp-pmlogger.cron.erb'

pmie_cron_template

Data type: String

Template used for pmie cron. Default is pcp/pcp-pmie.cron.erb.

Default value: 'pcp/pcp-pmie.cron.erb'

include_default_pmlogger

Data type: Boolean

Boolean that determines if default install pmlogger is installed. Default is true.

Default value: true

include_default_pmie

Data type: Boolean

Boolean that determines if default install pmie is installed. Default is true.

Default value: true

pmlogger_daily_args

Data type: String

Arguments given to pmlogger_daily that is executed via cron. Default is '-X xz -x 3'.

Default value: '-X xz -x 3'

pcp_conf_configs

Data type: Hash

Hash of configs to manage in /etc/pcp.conf.

Default value: {}

pmdas

Data type: Hash

Hash that defines pcp::pmda resources.

Default value: {}

Defined types

pcp::pmda

Install, enable and optionally configure a PMDA

Examples

pcp::pmda { 'nfsclient':
  ensure => 'present',
}

Parameters

The following parameters are available in the pcp::pmda defined type.

ensure

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

Ensure property for the PMDA. Valid values are 'present' and 'absent'. Default is 'present'.

Default value: 'present'

has_package

Data type: Boolean

Boolean that determines of a package is associated with the PMDA. Default is true.

Default value: true

package_name

Data type: Optional[String]

Package name of PMDA. Default is pcp-pmda-$name.

Default value: undef

remove_package

Data type: Boolean

Boolean that determines if the package should be removed when ensure is absent. Default is false.

Default value: false

config_path

Data type: Optional[Stdlib::Absolutepath]

Configuration file path for this PMDA. Default is /var/lib/pcp/config/${name}/${name}.conf.

Default value: undef

config_content

Data type: Optional[String]

Configuration file content for the PMDA. Default is undef.

Default value: undef

config_source

Data type: Optional[String]

Configuration file source for the PMDA. Default is undef.

Default value: undef

args

Data type: Optional[String]

Arguments that will be added to pmcd.conf for this PMDA

Default value: undef

pcp::pmie

Configure a pmie

Parameters

The following parameters are available in the pcp::pmie defined type.

ensure

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

The pmie ensure property. Valid values are present and absent. Default is present.

Default value: 'present'

hostname

Data type: String

Hostname associated with the pmie. Default is 'LOCALHOSTNAME'.

Default value: 'LOCALHOSTNAME'

primary

Data type: Boolean

Boolean that sets if this pmie is primary. Default is false.

Default value: false

socks

Data type: Boolean

Boolean that sets if this pmie uses pmsocks. Default is false.

Default value: false

log_file

Data type: String

The pmie control log file. Default is PCP_LOG_DIR/pmie/LOCALHOSTNAME/pmie.log

Default value: 'PCP_LOG_DIR/pmie/LOCALHOSTNAME/pmie.log'

args

Data type: String

Args passed to pmie. Default is an empty string.

Default value: ''

config_path

Data type: Optional[Stdlib::Absolutepath]

Config path for the pmie. If defined the value is passed as -c value to the pmie arguments. Default is undef.

Default value: undef

config_content

Data type: Optional[String]

The pmie config contents. Default is undef.

Default value: undef

config_source

Data type: Optional[String]

The pmie config source. Default is undef.

Default value: undef

pcp::pmlogger

Configure a pmlogger

Parameters

The following parameters are available in the pcp::pmlogger defined type.

ensure

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

The pmlogger ensure property. Valid values are present and absent. Default is present.

Default value: 'present'

hostname

Data type: String

Hostname associated with the pmlogger. Default is 'LOCALHOSTNAME'.

Default value: 'LOCALHOSTNAME'

primary

Data type: Boolean

Boolean that sets if this pmlogger is primary. Default is false.

Default value: false

socks

Data type: Boolean

Boolean that sets if this pmlogger uses pmsocks. Default is false.

Default value: false

log_dir

Data type: String

Log directory for this pmlogger. Default is PCP_LOG_DIR/pmlogger/LOCALHOSTNAME.

Default value: 'PCP_LOG_DIR/pmlogger/LOCALHOSTNAME'

args

Data type: String

Arguments passed to pmlogger. Default is an empty string.

Default value: ''

config_path

Data type: Optional[Stdlib::Absolutepath]

Config path for the pmlogger. If defined the value is passed as -c value to the pmlogger arguments. Default is undef.

Default value: undef

config_content

Data type: Optional[String]

The pmlogger config contents. Default is undef.

Default value: undef

config_source

Data type: Optional[String]

The pmlogger config source. Default is undef.

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.8.0 (2019-10-28)

Full Changelog

Added

• Increase stdlib supported versions #20 (treydock)
• Use module Hiera data #19 (treydock)
• Support managing /etc/pcp.conf #18 (treydock)

v1.7.0 (2019-07-11)

Full Changelog

Added

• Support excluding packages from PCP repos #17 (treydock)

v1.6.0 (2019-05-09)

Full Changelog

Added

• Simplify package removal when absent set #16 (treydock)

v1.5.0 (2019-05-08)

Full Changelog

Added

• Use pdk #15 (treydock)

1.4.3 (2019-05-08)

Full Changelog

Fixed

• Remove pcp-selinux when ensure is absent #14 (treydock)

1.4.2 (2019-05-07)

Full Changelog

Fixed

• Remove repo when ensure is absent #13 (treydock)

1.4.1 (2018-12-18)

Full Changelog

Fixed

• Fix removal of pmda config directory #12 (treydock)

1.4.0 (2018-12-04)

Full Changelog

Added

• Support puppet 6 and drop puppet 4 #11 (treydock)
• Support setting pmda arguments #9 (treydock)
• Document with puppet-strings #8 (treydock)

Fixed

• Use beaker 4.x #10 (treydock)

1.3.1 (2018-06-29)

Full Changelog

Fixed

• Fix service start order for pmcd and pmlogger #7 (treydock)

1.3.0 (2018-05-24)

Full Changelog

Added

• Quota pmlogger log directory path #6 (treydock)

1.2.0 (2018-05-18)

Full Changelog

Added

• Add service_ensure and service_enable parameters. #5 (treydock)
• BREAKING: pmie now has concept of primary. Requires pcp >= 3.11.3 #2 (treydock)

1.1.1 (2018-05-17)

Full Changelog

Added

• Update README #4 (treydock)

1.1.0 (2018-05-17)

Full Changelog

Added

• Add cron_ensure parameter and allow cron templates to be overridden #3 (treydock)

1.0.0 (2017-11-13)

Full Changelog

Changed

• BREAKING: Use data types for parameters, drop support for Puppet 3 #1 (treydock)

0.0.3 (2017-11-12)

Full Changelog

0.0.2 (2016-01-05)

Full Changelog

0.0.1 (2016-01-02)

Full Changelog

* This Changelog was automatically generated by github_changelog_generator