===

This module allows you to manage NRPE and its plugins. It does not name any of the plugins, so you can use whatever you like by specifying a hash of plugins and their associated parameters.

===

This module supports Puppet v3 (with and without the future parser), v4, v5 and v6 with Ruby versions 1.8.7, 1.9.3, 2.0.0, 2.1.9, 2.4.1 and 2.5.1. See .travis.yml for an exact matrix.

It is tested on the following platforms.

• Debian 6
• Debian 8
• EL 6
• Suse 11
• Solaris 10
• Solaris 11
• Ubuntu 12

===

Name of package(s) for NRPE.

• Default: based on OS platform.

String to pass to ensure attribute for the NRPE package.

• Default: 'present'

Path to admin file for NRPE package.

• Default: based on OS platform. (used on Solaris)

Source to NRPE package.

• Default: based on OS platform. (used on Solaris)

Name of the package provider for the NRPE package.

• Default: undef.

Name of package(s) for nagios-plugins.

• Default: based on OS platform.

String to pass to ensure attribute for the nagios plugins package.

• Default: 'present'

Path to admin file for nagios-plugins package.

• Default: based on OS platform. (used on Solaris)

Source to nagios-plugins package.

• Default: based on OS platform. (used on Solaris)

Path to nrpe.cfg file.

• Default: based on OS platform.

Owner of nrpe.cfg file.

• Default: 'root'

Group of nrpe.cfg file.

• Default: 'root'

Mode of nrpe.cfg file.

• Default: '0644'

Directory in which nrpe plugins are stored.

• Default: based on OS platform.

The syslog facility that should be used for logging purposes.

• Default: 'daemon'

File in which the NRPE daemon should write it's process ID number. To disable the use of the pid_file parameter, specify the value as 'absent'.

• Default: based on OS platform.

Integer port number for nrpe between 0 and 65535, inclusive.

• Default: 5666

Boolean to include server_address in nrpe.cfg.

• Default: false

Address that nrpe should bind to in case there are more than one interface and you do not want nrpe to bind on all interfaces.

• Default: '127.0.0.1'

This determines the effective user that the NRPE daemon should run as.

• Default: based on OS platform

This determines the effective group that the NRPE daemon should run as.

• Default: based on OS platform

Array of IP address or hostnames that are allowed to talk to the NRPE daemon.

• Default: ['127.0.0.1']

This option determines whether or not the NRPE daemon will allow clients to specify arguments to commands that are executed. 0=do not allow arguments, 1=allow command arguments.

• Default: '0'

Determines whether or not the NRPE daemon will allow clients to specify arguments that contain bash command substitutions. 0=do not allow, 1=allow. Allowing is a HIGH SECURITY RISK.

• Default: '0'

Boolean to include command_prefix in nrpe.cfg.

• Default: false

Prefix all commands with a user-defined string. Must be a fully qualified path.

• Default: '/usr/bin/sudo'

If debugging messages are logged to the syslog facility. Values: 0=debugging off, 1=debugging on

• Default: '0'

Maximum number of seconds that the NRPE daemon will allow plugins to finish executing before killing them off.

• Default: '60'

Maximum number of seconds that the NRPE daemon will wait for a connection to be established before exiting.

• Default: '300'

Allows SSL even if your system does not have a /dev/random or /dev/urandom. Values: 0=only seed from /dev/[u]random, 1=also seed from weak randomness

• Default: '0'

Include definitions from config files (with a .cfg extension) recursively from specified directory.

• Default: based on OS platform.

Value of ensure parameter for nrpe service. Valid values are 'running' and 'stopped'.

• Default: 'running'

Value of name parameter for nrpe service.

• Default: based on OS platform.

Boolean value of enable parameter for nrpe service.

• Default: true

Boolean to control merges of all found instances of nrpe::plugins in Hiera. This is useful for specifying file resources at different levels of the hierarchy and having them all included in the catalog.

This will default to 'true' in future versions.

• Default: false

Hash of plugins to be passed to nrpe::plugin with create_resources().

• Default: undef

Boolean to purge the nrpe.d directory of entries not managed by Puppet.

• Default: false

===

Creates a fragment in the sudoers.d directory with $name.cfg. Each matches the following layout, where $args are optional.

command[$name]=${libexecdir}/${plugin} $args

You can optionally specify a hash of nrpe plugins in Hiera.

---
nrpe::plugins:
  check_root_partition:
    plugin: 'check_disk'
    libexecdir: '/usr/lib64/nagios/plugins'
    args: '-w 20% -c 10% -p /'
  check_load:
    args: '-w 10,8,8 -c 12,10,9'
  check_myapp:

Ensure the plugin exists. Valid values are present and absent.

• Default: present

Arguments to pass to the plugin.

• Default: undef

Directory in which nrpe plugin is stored.

• Default: $nrpe::libexecdir, which is based on OS platform.

Prefix an individual plugin command with a user-defined string. Must be a fully qualified path. Set to USE_DEFAULTS to use the value from $nrpe::command_prefix (defaults to /usr/bin/sudo).

Please be careful when enabling $nrpe::command_prefix_enable and also setting nrpe::plugin::command_prefix.

• Default: undef

Name of the plugin to be executed.

• Default: $name