Version information
This module has been deprecated by its author since Dec 10th 2018.
The author has suggested puppet-snmp as its replacement.
Start using this module
Documentation
Net-SNMP installation.
master branch: develop branch:
Introduction
This module manages the installation of Net-SNMP client, server, and trap server. It also can create a SNMPv3 user with authentication and privacy passwords.
Actions:
- Installs the SNMP client package and configuration.
- Installs the SNMP daemon package, service, and configuration.
- Installs the SNMP trap daemon service and configuration.
- Creates a SNMPv3 user with authentication and encryption paswords.
OS Support:
- RedHat family - tested on CentOS 5.8 and CentOS 6.2
- SuSE family - presently unsupported (patches welcome)
- Debian family - initial Debian & Ubuntu suport (patches welcome)
- Solaris family - presently unsupported (patches welcome)
Class documentation is available via puppetdoc.
Examples
class { 'snmp': }
class { 'snmp::server':
ro_community => 'notpublic',
ro_network => '10.20.30.40/32',
contact => 'root@yourdomain.org',
location => 'Phoenix, AZ',
}
class { 'snmp::trapd':
ro_community => 'public',
}
snmp::snmpv3_user { 'myuser':
authpass => '1234auth',
privpass => '5678priv',
}
Notes
- Only tested on CentOS 5.8, CentOS 6.2 x86_64, and Debian squeeze.
- SNMPv3 user auth is not tested on Debian.
- There is a bug on Debian squeeze of net-snmp's status script. If snmptrapd is
not running the status script returns 'not running' so puppet restarts the
snmpd service. The following is a workaround:
class { 'snmp::server': service_hasstatus => false, }
Issues
- Debian will not support the use of non-numeric OIDs. Something about rabid freedom.
- On osfamily Debian, starting the snmptrap service does not work. This will be fixed in the upcomming refactor of this module.
Deprecation Warning
The classes snmp::server
and snmp::trapd
will be merged into class snmp
.
All of their class parameters will be made available in the snmp
class.
License
Please see LICENSE file.
Copyright
Copyright (C) 2012 Mike Arnold mike@razorsedge.org
2013-06-22 Michael Arnold github@razorsedge.org - 2.0.1-1-g76fd99d
2013-06-22 Michael Arnold github@razorsedge.org - 2.0.0
Michael Arnold github@razorsedge.org (20):
-
Fix Ubuntu support to pass lint
-
Update Travis-CI config file to test 2.7.18
-
Update rspec tests for new rspec version.
-
Initial Ubuntu support rspec tests
-
Converted to puppetlabs_spec_helper.
-
Updated .travis.yml and .gemfile.
-
Add CHANGELOG generation during module build.
-
Lint: fix variable not enclosed in {}.
-
Fix Ubuntu support to pass lint
-
Initial Ubuntu support rspec tests
-
Do not install File['snmptrapd.sysconfig'] on Debian.
-
Add files/snmpd.sysconfig-Debian-12.
-
Initial Debian support rspec tests.
-
Clean up Notes section of README.md.
-
Use ::osfamily instead of ::operatingsystem.
-
Convert template variables to be local.
-
Added deprecation warnings in README.md.
-
Fix support for snmptrapd on Debian.
-
Update README.md.
-
Update versions for 2.0.0 release.
Endre Karlson endre.karlson@gmail.com (2):
-
Add Ubuntu support and fix indent
-
Add Ubuntu support and fix indent
Jonathan Owens jonathan@newrelic.com (2):
-
Allow overriding the list of views and accesses.
-
Allow specifying traphandlers for trapd.
Santiago Piccinini spiccinini@codigosur.org (1):
-
Added initial support for Debian
2012-07-15 Michael Arnold github@razorsedge.org - 1.0.2
Michael Arnold github@razorsedge.org (1):
-
Bump module version for Puppet Forge release
Steve Huff shuff@vecna.org (1):
-
modified templates to dereference class parameters
2012-05-26 Michael Arnold github@razorsedge.org - 1.0.1
Michael Arnold github@razorsedge.org (1):
- Change github account to razorsedge
2012-05-06 Michael Arnold github@razorsedge.org - 1.0.0
Dependencies
- puppetlabs/stdlib (>=2.3.0)
- razorsedge/lsb (>=1.0.0)
Copyright (C) 2012 Mike Arnold <mike@razorsedge.org> Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.