501
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − − − {{Note box| <b> − − I am currently working on a new contrib based on Nagios 3. − − Please wait a short time and do not use this Nagios 2 based contrib. − </b> − − Thanks, − − Michael − − }} − − − − − − − ---- − − − − − − − − − − − − Line 44:
Line 11: − Also available as a contrib is the addon [[Nagios Grapher]] that collects performance data and represents these as graphs. − + − + Line 57:
Line 23: − + − + + + + + − + − + − + − |- − | nagios-plugins-temptrax || 1.0.1 || 01 Nov 2007 || Plugins for the Sensatronics Ethernet Temperature Devices E4/E16/F Line 81:
Line 49: − |- − | nagios-plugins-esx3i || 1.0.2-0 || 22 Oct 2008 || Plugins to monitor ESXi servers that support the "Common Information Model (CIM)" protocol like Dell PowerEdge 29xx. [http://cars.lostroncos.org/2008/03/07/updated-esx-3i-scripts-for-nagios/ Read more...] − + + − === Installation ===+ Line 97:
Line 64: + + + + + + Line 104:
Line 77: + − + − /usr/bin/yum --enablerepo=dag install \ + − nagios-plugins \+ − nagios-plugins-nrpe \+ − nagios-plugins-setuid \ − perl-Config-Tiny \ − perl-Class-Accessor − − Configure global access with password required − + − + + − /usr/bin/yum install openssl-devel+ − /usr/bin/yum --enable=dag install perl-XML-SAX+ Line 135:
Line 105: − Run + − to get some configuration hints. Line 160:
Line 129: − + − /usr/bin/yum --enablerepo=dag localinstall \+ − smeserver-nagios-nrpe-*.noarch.rpm \ − smeserver-nagios-backup-*.noarch.rpm \ − perl-Nagios-Plugin-*.noarch.rpm \ − smeserver-nagios-plugins-mysql-*.noarch.rpm \ − nagios-plugins-generic-*.noarch.rpm \ − nagios-of-plugins-*.noarch.rpm − − /usr/bin/yum --enablerepo=dag install \ − nagios-plugins \ − nagios-plugins-setuid \ − perl-Config-Tiny \ − perl-Class-Accessor − − − ===== NRPE configuration ===== − Create a the NRPE configuration file /etc/nagios/nrpe.cfg. Use the nrpe.cfg provided by this conrib as a starting point. − Add the IP address of your central Nagios server to the variable ''allowed_hosts''. Use the local IP of the central Nagios server if you check the server over the local network or over a VPN, otherwise use the WAN IP. − − Restart the service − service nrpe restart − − ===== Allow the central Nagios server to access the NRPE service ===== − Add the IP address of the your central Nagios to ''Local Networks'' in the server-manager. − − Configure the TCP wrapper. This is required for SSL connections to the NRPE. − config setprop nrpe HostsAllow "127.0.0.1 NAGIOS_CENTRAL_SERVER_IP" − expand-template /etc/hosts.allow − − ===== Allow the Nagios plugins to be executed as root (optional) ===== − A few plugins only work when they are executed as root. This configures the ''sudoers'' configuration. − config setprop nrpe sudoPlugins yes − expand-template /etc/sudoers − − If the NRPE SME server is behind a firewall, you must forward port 5666/tcp to the server.<br> − Test the installation by running this command on the central Nagios server:<br> − /usr/lib/nagios/plugins/check_nrpe -H IPADDRESS − Expected result: − NRPE v2.5.1 − − ==== NSCA installation (Distributed Monitoring) ==== − {{Warning box|This is untested and may not work as expected}} − {{Incomplete}} − ===== Installation of a distributed server ===== − /usr/bin/yum --enablerepo=dag localinstall \ − smeserver-nagios-nsca-*.noarch.rpm \ − smeserver-nagios-backup-*.noarch.rpm \ − perl-Nagios-Plugin-*.noarch.rpm \ − smeserver-nagios-plugins-*.noarch.rpm \ − nagios-plugins-generic-*.noarch.rpm \ − nagios-of-plugins-*.noarch.rpm − − /usr/bin/yum --enablerepo=dag install \ − nagios-plugins \ − nagios-plugins-nrpe \ − nagios-plugins-setuid \ − perl-Config-Tiny − − ===== Configuration of a distributed server ===== − Configure the distributed server by editing the client config file ''/etc/nagios/send_nsca.cfg''. Read more [http://nagios.sourceforge.net/docs/2_0/distributed.html here]. − − − ===== Additonal installation on the central Nagios server ===== − /usr/bin/yum --enablerepo=dag localinstall \ − smeserver-nagios-nsca-*.noarch.rpm − − ===== NSCA configuration on the central Nagios server===== − Configure the TCP wrapper. − config setprop nsca HostsAllow "127.0.0.1 DISTRIBUTED_SERVER_IP" − expand-template /etc/hosts.allow − Configure the NSCA service by editing the config file ''/etc/nagios/nsca.cfg''. Read more [http://nagios.sourceforge.net/docs/2_0/distributed.html here]. − Restart the service to make the configuration effective: − service nsca restart − === Nagios configuration ===+ − It is strongly recommended to read the [http://www.nagios.org/docs/ Nagios and NRPE documentation] to understand the principles of operation before you start to configure Nagios.+ − + − When changes to the nagios configuration were made, the service must be restarted:+ − service nagios restart+ − When nrpe.cfg was changed the nrpe service must be restarted:+ − service nrpe restart − − ==== Hints ==== − * Place all your configuration files in /etc/nagios/, the Logfile /var/log/nagios/nagios.log, the Log-Archives in /var/log/nagios/archives/ and the status file in /var/log/nagios/status.dat. These are the default settings. Leave them unchanged. The ''smeserver-nagios-backup'' RPM requires these settings to work properly. − − use_authentication=1 Line 254:
Line 145: + + − * It is a good idea to make your Nagios server as independent as possible from the infrastructure it monitors, i.e., use a dedicated hardware, network, mail- and pager system, firewall and internet connection if possible. + − + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + − + − + − + − − /usr/bin/yum erase \ + + + Line 281:
Line 229: + + Line 287:
Line 237: − + − +
Updated to Nagios 3
{{Languages}}
{{Languages}}
{{Needs review}}
{{Needs review}}
{{Note box|This contrib was only applied and used on fresh SME (server only mode) install. Conflicts with other installed packages were not examined. The author strongly recommend to install this monitoring system on a dedicated server. It is entirely possible to run it on a virtualized system, which monitors the host itself. In this case you should set up a second Nagios server (acting as a watchdog) on an independent hardware (physically or virtualized) to monitor the main Nagios system}}
{{Note box|This contrib was only applied and used on fresh SME (server only mode) install. Conflicts with other installed packages were not examined. The author strongly recommend to install this monitoring system on a dedicated server. It is entirely possible to run it on a virtualized system, which monitors the host itself. In this case you should set up a second Nagios server (acting as a watchdog) on an independent hardware (physically or virtualized) to monitor the main Nagios system}}
=== Introduction ===
=== Introduction ===
Nagios is a host and service monitor designed to inform you of network problems before your clients, end-users or managers do. [http://www.nagios.org/about/ Read more...]
Nagios is a host and service monitor designed to inform you of network problems before your clients, end-users or managers do. [http://www.nagios.org/about/ Read more...]
This [[Nagios]] contrib installs Nagios Version 2.9 and was tested on SME Releases 7.1.2, 7.1.3 and 7.2.
This [[Nagios]] contrib installs Nagios Version 3 and was tested on fresh installed SME Server 7.3
It provides all packages needed to setup a SME Server as a central Nagios monitoring server and all packages needed to monitor SME Servers via the NRPE (Nagios Remote Plugin Executer).
It provides all packages needed to setup a SME Server as a central Nagios monitoring server including the graphical performance data analyser [http://www.pnp4nagios.org/start PNP4Nagios].
{|
{|
These packages are provided by the contrib. All other dependend packages will be installed via yum from the Centos and DAG repostitories.
These packages are provided by the contrib. All other dependend packages will be installed via yum from the Centos and DAG repostitories.
{| border="1" cellpadding="3" cellspacing=0
{| style='white-space:nowrap' border="1" cellpadding="3" cellspacing=0
! Package !! Version !! Build date !! Purpose
! Package !! Version !! Build date !! Purpose
|-
|-
| smeserver-nagios || 1.0.5 || 14 Nov 2007 || Integrates Nagios service into the SME Server
| smeserver-nagios || 2.0.0-1 || 17 Nov 2008 || Integrates Nagios service into the SME Server
|-
| smeserver-nagios-nrpe || 2.0.0-1 || 17 Nov 2008 || Integrates NRPE service into the SME Server
|-
| smeserver-nagios-nsca || 2.0.0-1 || 17 Nov 2008 || Integrates NSCA service into the SME Server (needed in a Distributed Installation)
|-
|-
| smeserver-nagios-nrpe || 1.0.3 || 03 Dec 2007 || Integrates NRPE service into the SME Server
| smeserver-nagios-backup || 2.0.0-1 || 17 Nov 2008 || Nagios backup integration. Includes Nagios configuration and status data into the SME standard backup
|-
|-
| smeserver-nagios-nsca || 1.0.1 || 26 Oct 2007 || Integrates NSCA service into the SME Server (needed in a Distributed Installation)
| nagios-plugins-temptrax || 2.0.0-1 || 17 Nov 2008 || Plugins for the Sensatronics Ethernet Temperature Devices E4/E16/F
|-
|-
| smeserver-nagios-backup || 1.0.3 || 03 Dec 2007 || Nagios backup integration. Includes Nagios configuration and status data into the SME standard backup
| nagios-plugins-esx3i || 1.0.3-0 || 16 Nov 2008 || Plugins to monitor ESXi servers that support the "Common Information Model (CIM)" protocol like Dell PowerEdge 29xx. [http://cars.lostroncos.org/2008/03/07/updated-esx-3i-scripts-for-nagios/ Read more...]
|-
|-
| perl-Nagios-Plugin || 0.17-1 || 19 Oct 2007 || A family of perl modules to streamline writing Nagios plugins
| perl-Nagios-Plugin || 0.17-1 || 19 Oct 2007 || A family of perl modules to streamline writing Nagios plugins
|-
|-
| smeserver-nagios-plugins-mysql || 1.0.2 || 24 Nov 2007 || Plugin that checks the mysqld service on a SME Server
| smeserver-nagios-plugins-mysql || 1.0.2 || 24 Nov 2007 || Plugin that checks the mysqld service on a SME Server
|-
|-
| nagios-icons-nx-1.0.0.tar.gz || 1.0.0 || 04 Nov 2007 || Additional useful icons, including the SME logo
| nagios-icons-nx-1.0.0.tar.gz || 1.0.0 || 04 Nov 2007 || Additional useful icons, including the SME logo
|}
|}
=== Download ===
=== Download ===
Download the packages and files from http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/nagios/packages/ manually or run the the script [http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/nagios/packages/wgetall wgetall] to download all in one go.
Download the packages and files from http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/Nagios3/packages/ manually or run the the script [http://mirror.contribs.org/smeserver/contribs/michaelw/sme7/Nagios3/packages/wgetall wgetall] to download all in one go.
bash < wgetall
bash < wgetall
=== Installation ===
{{Note box|If you have the Nagios 2 contrib installed, follow the update instructions below}}
==== Configure the dag repositoy ====
==== Configure the dag repositoy ====
==== Installation of a central Nagios server ====
==== Installation of a central Nagios server ====
Intstalling the packages
/usr/bin/yum --enablerepo=dag install \
nagios-plugins-setuid \
perl-Config-Tiny
/usr/bin/yum --enablerepo=dag localinstall \
/usr/bin/yum --enablerepo=dag localinstall \
smeserver-nagios-*.noarch.rpm \
smeserver-nagios-*.noarch.rpm \
pnp-*.i386.rpm \
smeserver-nagios-backup-*.noarch.rpm \
smeserver-nagios-backup-*.noarch.rpm \
perl-Nagios-Plugin-*.noarch.rpm \
perl-Nagios-Plugin-*.noarch.rpm \
nagios-plugins-generic-*.noarch.rpm \
nagios-plugins-generic-*.noarch.rpm \
nagios-of-plugins-*.noarch.rpm \
nagios-of-plugins-*.noarch.rpm \
nagios-plugins-temptrax-*.el4.rf.i386.rpm \
nagios-plugins-esx3i-*.el4.noarch.rpm
nagios-plugins-esx3i-*.el4.noarch.rpm
Use the configuration files from the smeserver-nagios package as a starting point. This provides a working configuration.
/bin/cp -ba /etc/nagios/nagios.cfg-smeserver /etc/nagios/nagios.cfg
/bin/cp -ba /etc/nagios/cgi.cfg-smeserver /etc/nagios/cgi.cfg
Configuring global access with password required
config set nagios service Name Nagios PublicAccess global-pw
config set nagios service Name Nagios PublicAccess global-pw
expand-template /etc/httpd/conf/httpd.conf
expand-template /etc/httpd/conf/httpd.conf
service httpd-e-smith restart
service httpd-e-smith restart
service nagios restart
Test the installation by pointing your browser to ''<nowiki>https://nagios_central_server_ip/nagios/</nowiki>''
Test the installation by pointing your browser to ''<nowiki>https://IPADDRESS/nagios/</nowiki>''
Browser login in as admin.
Browser login in as admin.
After 10 minutes the performance data graphes are available. Click on on the 'star' icon next to the service name to view the graphes on a new page.
===== Install the VMware ESXi Server CIM Hardware Monitoring (optional) =====
===== Install the VMware ESXi Server CIM Hardware Monitoring (optional) =====
If you plan to monitor an ESx3i server with CIM compliant hardware, you can configure the ESXi plugin
/usr/bin/yum --enable=dag install openssl-devel perl-XML-SAX
Download and install the [http://www.vmware.com/support/developer/viperltoolkit/ VMware Infrastructure (VI) Perl Toolkit]
Download and install the [http://www.vmware.com/support/developer/viperltoolkit/ VMware Infrastructure (VI) Perl Toolkit]
It does not affect the proper function of the nagios plugins.
It does not affect the proper function of the nagios plugins.
To get some configuration hints run
rpm -qi nagios-plugins-esx3i
rpm -qi nagios-plugins-esx3i
===== Install the Nuvola theme (optional) =====
===== Install the Nuvola theme (optional) =====
chmod 644 /usr/share/nagios/images/logos/*
chmod 644 /usr/share/nagios/images/logos/*
==== NRPE installation on the SME servers to be monitored by the central Nagios server====
==== Hints ====
* Place all your configuration files in /etc/nagios/ in the sub-directories templates, host, services, etc.
* Do not change the default pathes of log files, rrd files, etc.. The ''smeserver-nagios-backup'' RPM requires these settings to work properly.
* Nagios 3 runs host checks that provides performance data. Add this action_url option to each host definiton:
action_url /nagios/pnp/index.php?host=$HOSTNAME$
* Add this action_url option to service checks with performance data output
action_url /nagios/pnp/index.php?host=$HOSTNAME$&srv=$SERVICEDESC$
* You can permit other users to access Nagios. Add them separated by a comma to the lines
* Set the following in /etc/nagios/cgi.cfg to grant full accces to the user admin:
authorized_for_system_information=admin
authorized_for_system_information=admin
authorized_for_system_commands=admin
authorized_for_system_commands=admin
authorized_for_all_services=admin
authorized_for_all_services=admin
authorized_for_all_service_commands=admin
authorized_for_all_service_commands=admin
* It is a good idea to make your Nagios server as independent as possible from the infrastructure it monitors, i.e., use a dedicated hardware, network, mail- and pager system, firewall and internet connection if possible.
* Consider to setup a second Nagios somewhere on your network, which monitors your central Nagios server. Then you need to install the NRPE also on the central server.
==== Update from Nagios 2 to Nagios 3 ====
* Consider to setup a second Nagios somewhere on your network, which monitors your central Nagios server. Then you need to install the NRPE also on the central server.
Before installing this contrib based on Nagios 3, remove all packages of the previous Nagios 2 installation
service nagios stop
service nagiosgrapher stop
/usr/bin/yum erase \
nagios-plugins-esx3i \
nagios-nrpe \
nagios-plugins-temptrax \
nagios-plugins \
nagios-of-plugins \
nagios-plugins-generic \
nagios smeserver-nagios-nrpe \
smeserver-nagios \
smeserver-nagios-plugins-mysql \
nagios-plugins-nrpe \
nagios-plugins-setuid \
smeserver-nagiosgrapher \
smeserver-nagios-backup
Remove all NagiosGrapher rrd data. It is not possible to tranfer the existing NagiosGrapher data to PNP.
rm -rf /var/lib/nagios/*
Backup your Nagios configuration data
cp -a /etc/nagios /etc/nagios.v2
Delete Nagios configuration data
rm -rf /etc/nagios
Move the retention data to the new Nagios 3 loaction
mkdir -p /var/nagios/
mv /var/log/nagios/retention.dat /var/nagios/
'''Now install this contrib following the instructions in chapter 'Installation'
'''
service nagios stop
Delete the default configuration files
cd /etc/nagios
rm -rf commands/default.cfg \
objects
contacts/contacts.cfg \
hostgroups/default.cfg \
hosts/localhost.cfg \
servicegroups/default.cfg \
services/localhost.cfg \
templates/default.cfg \
timeperiods/default.cfg
Copy your saved configuration files to /etc/nagios. When you place them into the pre-defined directories contacts, services, hostgroups, templates, commands, hosts, servicegroups, and timeperiods you don't need to adjust nagios.cfg.
Review your config files and do the following
* add <tt>'''use host-pnp'''</tt> to your generic host definition to add an action url for PNP to all hosts.
* for all services that output performance data add <tt>'''action_url /nagios/pnp/index.php?host=$HOSTNAME$&srv=$SERVICEDESC$'''</tt> to your service template definitions
* move all options from <tt>'''hostextinfo'''</tt> definition (except <tt>'''host_name'''</tt> and <tt>'''action_url'''</tt>) to <tt>'''host'''</tt> definition. Delete the <tt>'''hostextinfo'''</tt> definition.
* do the same for <tt>'''serviceextinfo'''</tt> definitons
When done check your config
nagios -v /etc/nagios/nagios.cfg
and finally start the service
service nagios start
==== Backup and Restore ====
==== Backup and Restore ====
With the the smeserver-nagios-backup RPM installed all [[Nagios]] and [[Nagios Grapher]] configuration data, status data and archives are included in the SME Server standard backup. In the pre-backup event those data are copied to the <tt>/home/e-smith/db/nagios/</tt> directory. As the nagios service is stopped during copying it is recommended to configure Nagios to save its scheduling info (next check time) for hosts and services in a file and use this at startup. Otherwise Nagios would re-schedule all checks spreaded over the timeframe defined by <tt>max_service_check_spread</tt> and <tt>max_host_check_spread</tt> (default 30 min). As a result you would have gaps in checking and visible gaps in the graphs of [[Nagios Grapher]].
With the smeserver-nagios-backup RPM installed all Nagios and PNP configuration data, status data and archives are included in the SME Server standard backup. In the pre-backup event those data are copied to the <tt>/home/e-smith/db/nagios/</tt> directory. As the nagios service is stopped during copying it is recommended to configure Nagios to save its scheduling info (next check time) for hosts and services in a file and use this at startup. Otherwise Nagios would re-schedule all checks spreaded over the timeframe defined by <tt>max_service_check_spread</tt> and <tt>max_host_check_spread</tt> (default 30 min). As a result you would have gaps in checking and visible gaps in the PNP graphes.
in <tt>/etc/nagios/nagios.conf</tt> add/edit:
in <tt>/etc/nagios/nagios.cfg</tt> set:
retain_state_information=1
retain_state_information=1
state_retention_file=/var/log/nagios/retention.dat
state_retention_file=/var/nagios/retention.dat
use_retained_program_state=1
use_retained_program_state=1
use_retained_scheduling_info=1
use_retained_scheduling_info=1
When doing a restore, the data from <tt>/home/e-smith/db/nagios/</tt> are copied back to their original locations in the bootstrap-console-save event.
When doing a restore, the data from <tt>/home/e-smith/db/nagios/</tt> are copied back to their original locations in the bootstrap-console-save event.
=== Uninstall ===
=== Uninstall ===
This removes the installed Nagios packages.
This removes the installed Nagios packages.
service nagios stop
rpm -e \
nagios \
nagios \
nagios-of-plugins \
nagios-of-plugins \
smeserver-nagios-plugins-mysql
smeserver-nagios-plugins-mysql
expand-template /etc/httpd/conf/httpd.conf
service httpd-e-smith restart
=== References ===
=== References ===
* nagios-of-plugins: http://www.nagiosexchange.org/Plugin_Packages.52.0.html?&tx_netnagext_pi1%5Bp_view%5D=323
* nagios-of-plugins: http://www.nagiosexchange.org/Plugin_Packages.52.0.html?&tx_netnagext_pi1%5Bp_view%5D=323
* Nuvola theme: http://www.nagiosexchange.org/Image_Packs.75.0.html?&tx_netnagext_pi1%5Bp_view%5D=252&tx_netnagext_pi1%5Bpage%5D=10%3A10
* Nuvola theme: http://www.nagiosexchange.org/Image_Packs.75.0.html?&tx_netnagext_pi1%5Bp_view%5D=252&tx_netnagext_pi1%5Bpage%5D=10%3A10
* Temptrax Plugin: http://www.nagiosexchange.org/Environmental.60.0.html?&tx_netnagext_pi1%5Bp_view%5D=246&tx_netnagext_pi1%5Bpage%5D=20%3A10
* Temptrax Plugin: http://www.nagiosexchange.org/cgi-bin/page.cgi?g=1716.html
* Nagios books: ''"Nagios : system and network monitoring / Wolfgang Barth / ISBN 1-59327-070-4"'', ''"Building a Monitoring Infrastructure with Nagios / David Josephsen / ISBN 0-13-223693-1"''
* Nagios books: ''"Nagios : system and network monitoring / Wolfgang Barth / ISBN 1-59327-070-4"'', ''"Building a Monitoring Infrastructure with Nagios / David Josephsen / ISBN 0-13-223693-1"''
* Nagios in a German Computer Magazine: http://www.heise.de/netze/artikel/81238
* Nagios in a German Computer Magazine: http://www.heise.de/netze/artikel/81238
* SME Server Contrib [[Nagios Grapher]]
* PNP4Nagios: http://www.pnp4nagios.org/pnp/start
----
----
[[Category: Contrib]]
[[Category: Contrib]]
[[Category: Webapps]]
[[Category: Webapps]]
[[Category: Administration]]
[[Category: Administration]]