Changes between Version 22 and Version 23 of Doc/Monitoring/Nagios

Timestamp:

Jul 22, 2011, 4:24:05 PM (13 years ago)

Author:

/DC=org/DC=terena/DC=tcs/C=NL/O=Nikhef/CN=Ronald Starink ronalds@…

Comment:

--

Doc/Monitoring/Nagios

@@ -146 +146 @@
  * `NSCA_DAEMON_TEMPLATE`: required for a Nagios server that must accept passive check results and for a Nagios master server when using a hierarchy.
 
+The NSCA configuration uses the following variables:
+ * `NSCA_PORT`: port at which the server listens (and to which the client send the results), defaulting to 5667.
+ * `NSCA_ENCRYPTION_METHOD`: encryption scheme used by send_nsca, defaulting to 1.
+ * `NSCA_DECRYPTION_METHOD`: decryption scheme used by the daemon, should be (and is by default) identical to the encryption.
+ * `NSCA_PASSWORD`: password used for encrypting and decrypting connection. This variable must be set and there is no default value.
+
 
 == Hierarchy of servers ==
 
 Nagios servers can be used in a hierarchy, where there is 1 master server and 2 or more slave servers. The master server runs the web interface, handles notifications, performance data etc. The slave servers schedule and execute checks and submit the check results (via NSCA) to the master server. Each slave server runs (a subset of the) checks against (a subset of the) nodes. The master server receives the results for all services and all hosts.
+
+The QWG tenplates contains some generic templates for Nagios master and slave servers. However, much of the configuration is site-specific. An example setup is provided under directory `sites/example/site/nagios`. This setup must be modified to match the desired configuration of your site.
+
+The generic setup consists of the following templates (under `standard/`):
+ * `monitoring/nagios/master`:  template containing specific settings for the Nagios master server, such as accepting passive checks, running the web interface, collecting performance data etc. Service templates must be included as '''passive''' checks, therefore variable `NAGIOS_DEFAULT_SERVICE_TEMPLATE` is forced to `monitoring/nagios/services/passive-service`.
+ * `monitoring/nagios/slave`: template defining specific Nagios settings for a slave server, such as suppressing notifications, submission of check results, disabling performance data.
+
+The site-specific setup consists of the following templates (under `sites/example`):
+ * `site/nagios/master`: contains specific settings for the Nagios master for this cluster; specifically, it includes all host, hostgroup and service templates. 
+ * `site/nagios/slave-A`: contains specific settings for a Nagios slave server that monitors a subset of the hosts. Only the hosts, hostgroups and services that are monitored by this server must be included.
+ * `site/nagios/slave-B`: this templates is very similar to the one for `slave-A`, except that is uses a different subset of hosts, hostgroups and services.
+ * `site/nagios/common`: site-specific configuration that is common to all servers (master and all slaves).
+ * `site/nagios/hosts/`: this directory contains the list of hosts per monitoring slave server (templates `cluster-A` and `cluster-B`) as well as a template aggregating all hosts for the master server (`all`).
+ * `site/nagios/hostsgroups/`: this directory contains the list of hostgroups per monitoring slave server and an aggregating template
+ * `site/nagios/nsca`: various variables for NSCA.
+