winsnmp
Table of Contents
- Overview
- Module Description - What the module does and why it is useful
- Setup - The basics of getting started with winsnmp
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
Overview
Manages SNMP configuration under Windows.
Module Description
This module installs the SNMP service and manages its configuration. This includes setting community strings and the standard RFC1156 objects.
Setup
What winsnmp affects
- The
SNMP
feature and the corresponding service. - Registry keys managing configuration of the above.
Setup Requirements
The following third party modules must be installed:
- puppetlabs/dism
- puppetlabs/registry
- puppetlabs/stdlib
Beginning with winsnmp
To use the module with its defaults, simply include the winsnmp
class.
include winsnmp
Usage
A more advanced configuration, with community strings and standard RFC1156 objects looks something like the below.
class { 'winsnmp':
communities => ['public','private'],
managers => ['192.168.1.1','fqdn.foo']
contact => 'admin@example.com',
location => 'Data Center 1',
services => 72,
}
Reference
winsnmp
Class Installs and configures SNMP.
Parameters
communities
Array of valid SNMP Community strings. Defaults to none.
managers
Array of valid SNMP Managers. FQDN or IP address. Defaults to none.
contact
The value of the RFC1156 sysContact
object. Defaults to none.
location
The value of the RFC1156 sysLocation
object. Defaults to none.
services
The value of the RFC1156 sysServices
object. Defaults to 76, which is also
the default as installed by the Windows feature.
winsnmp::community
Define Manages a single SNMP community string. This is usually done via the main
winsnmp
class.
Parameters
community
The SNMP community string. Defaults to the resource title.
winsnmp::managers
Define The SNMP Permitted Managers strings. Defaults to resource title.
winsnmp::object
Define Manages a single RFC1156 object. The standard objects sysContact
,
sysLocation
and sysServices
may be managed via the main winsnmp
class.
Parameters
object
The name of the object. Defaults to resource title.
type
The data type of the object. This value is passed as the type
parameter
of a registry_value
resource. The default is string
. See documentation
at http://forge.puppetlabs.com/puppetlabs/registry for details.
value
The value the object should contain (required).
Limitations
This module has been tested on Windows 2008 R2 and 2012 R2, but may well work on other versions.
Development
For fixes, improvements, etc, please see our project page: https://github.com/michmich9337/puppet-winsnmp
Release Notes/Contributors/Etc
This space intentionally left blank.