cookbook 'snmp', '= 0.0.9'
snmp (16) Versions 0.0.9 Follow25
Installs/Configures snmp on redhat, centos, ubuntu, debian
cookbook 'snmp', '= 0.0.9', :supermarket
knife supermarket install snmp
knife supermarket download snmp
= DESCRIPTION:
Installs and configures snmpd. Optionally install SNMP utilities,
such as snmpwalk.
The SNMP multiplex (smuxpeer) line will be set for Dell OpenManage, if Dell
manufactured hardware is detected by Ohai.
= DEPENDS:
This cookbook provides an SNMP Extend example to collect DNS RNDC statistics.
The Extend script is written in Perl and depends on the CPAN module "version".
There is a loose dependency recommending the "perl" cookbook.
If you have no need for the SNMP Extend example included, remove the
"depends perl" line from metadata.rb. Then run 'knife cookbook metadata snmp'
before uploading to the Chef server.
= ATTRIBUTES:
Notable overridable attributes are as follows. It is recommended to override
these following attributes to best suit your own environment.
* snmp[:community]
- SNMP Community String, default is "public".
* snmp[:trapcommunity]
- SNMP Community Trap String, default is "public".
* snmp[:trapsinks]
- Array of trapsink hosts, and optional Community Trap strings.
This is an empty array by default.
* snmp[:install_optional]
- Boolean to install optional SNMP utilities, default is false.
* snmp[:syscontact]
- String to set a name, and e-mail address for systems.
Default is "Root <root@localhost>"
* snmp[:syslocationPhysical]
- String to set the location for physical systems.
Default is "Server Room".
* snmp[:syslocationVirtual]
- String to set the location for Virtual Machines.
Default is "Virtual Server".
* snmp[:full_systemview]
- Boolean to include the full systemview.
This defaults to "false" as many distributions ship this way to speed up
snmpwalk. However, if you're running SNMP Network Management System,
you'll want to override this as "true" on your systems.
* snmp[:is_dnsserver]
- Boolean to use the RNDC stat Extend example included.
This defaults to "false"
= USAGE:
Here is a full example featuring all the overridable attributes.
You can apply these override attributes in a role, or node context.
override_attributes "snmp" => {
"community" => "secret",
"full_systemview" => true,
"install_optional" => true,
"trapsinks" => [ "zenoss.example.com", "nagios.example.com" ],
"syslocationPhysical" => "Server Room",
"syslocationVirtual" => "Cloud - Virtual Pool",
"syscontact" => "sysadmin@example.com"
}
= ACKNOWLEDGEMENTS
Thanks to Sami Haahtinen <zanaga> on Freenode/#chef for testing,
and feedback pertinent to the Debian/Ubuntu platforms.
= AUTHOR AND LICENSE:
Author:: Eric G. Wolfe (<wolfe21@marshall.edu>)
Copyright 2010
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.