cookbook 'nagios-xinetd', '= 0.0.4', :supermarket
nagios-xinetd (2) Versions 0.0.4 Follow1
Installs and configures nagios client and runs under xinetd
cookbook 'nagios-xinetd', '= 0.0.4'
knife supermarket install nagios-xinetd
knife supermarket download nagios-xinetd
Installs and configures Nagios 3 for a server and for clients using Chef search capabilities.
- Use Chef 0.10's
- source installation support on both client and server sides
- initial RHEL/CentOS/Fedora support
Chef version 0.10.0+ is required for chef environment usage. See Environments under Usage below.
A data bag named 'users' should exist, see Data Bag below.
The monitoring server that uses this recipe should have a role named 'monitoring' or similar, this is settable via an attribute. See Attributes below.
Because of the heavy use of search, this recipe will not work with Chef Solo, as it cannot do any searches without a server.
- RHEL, CentOS, Fedora
Tested on RHEL 5.5 and 6.1
The following attributes are used by both client and server recipes.
node['nagios']['user']- nagios user, default 'nagios'.
node['nagios']['group']- nagios group, default 'nagios'.
node['nagios']['plugin_dir']- location where nagios plugins go,
- default '/usr/lib/nagios/plugins'.
This recipe uses the xinet daemon to run the nagios client instead of the nagios nrpe daemon. This provides for better logging opportunities as the nrpe daemon is otherwise difficult to log.
This recipe depends on the xinetd cookbook
The client_xinetd uses the following attributes
node['nagios']['client']['install_method']- whether to install from package or source. Default chosen by platform based on known packages available for Nagios 3: debian/ubuntu 'package', redhat/centos/fedora/scientific: source
node['nagios']['plugins']['url']- url to retrieve the plugins source
node['nagios']['plugins']['version']- version of the plugins
node['nagios']['plugins']['checksum']- checksum of the plugins source tarball
node['nagios']['nrpe']['home']- home directory of nrpe, default /usr/lib/nagios
node['nagios']['nrpe']['conf_dir']- location of the nrpe configuration, default /etc/nagios
node['nagios']['nrpe']['url']- url to retrieve nrpe source
node['nagios']['nrpe']['version']- version of nrpe to download
node['nagios']['nrpe']['checksum']- checksum of the nrpe source tarball
- node['nagios_server'] - the ip address of the nagios server in case there isn't a server with nagios_server in it run list, as some setups may not use chef to configure their server
The library included with the cookbook provides some helper methods used in templates.
- nagios_interval - calculates interval based on interval length and a given number of seconds.
- nagios_attr - retrieves a nagios attribute from the node.
See below under Environments for how to set up Chef 0.10 environment for use with this cookbook.
For a Nagios server, create a role named 'monitoring', and add the following recipe to the run_list:
This will allow client nodes to search for the server by this role and add its IP address to the allowed list for NRPE.
To install Nagios and NRPE on a client node:
This is a fairly complicated cookbook. For a walkthrough and example usage please see Opscode's Nagios Quick Start.
The searches used are confined to the node's
chef_environment. If you do not use any environments (Chef 0.10+ feature) the
_default environment is used, which is applied to all nodes in the Chef Server that are not in another defined role. To use environments, create them as files in your chef-repo, then upload them to the Chef Server.
% cat environments/production.rb name "production" description "Systems in the Production Environment" % knife environment from file production.rb
License and Author
Author:: Joshua Sierles email@example.com Author:: Nathan Haneysmith firstname.lastname@example.org Author:: Joshua Timberman email@example.com Author:: Seth Chisamore firstname.lastname@example.org Author:: Bryan W. Berry email@example.com
Copyright 2009, 37signals Copyright 2009-2011, Opscode, Inc copyright 2011, Bryan W. Berry
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
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.
|build-essential >= 0.0.0|
|xinetd >= 0.0.0|
There are no cookbooks that are contingent upon this one.