swift 08/07/07 20:02:46 Modified: nagios-guide.xml Log: Configuring nrpe
Revision Changes Path 1.4 xml/htdocs/doc/en/nagios-guide.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/nagios-guide.xml?rev=1.4&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/nagios-guide.xml?rev=1.4&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/nagios-guide.xml?r1=1.3&r2=1.4 Index: nagios-guide.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/nagios-guide.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- nagios-guide.xml 7 Jul 2008 19:04:38 -0000 1.3 +++ nagios-guide.xml 7 Jul 2008 20:02:46 -0000 1.4 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/nagios-guide.xml,v 1.3 2008/07/07 19:04:38 swift Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/nagios-guide.xml,v 1.4 2008/07/07 20:02:46 swift Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide disclaimer="draft"> @@ -216,8 +216,11 @@ </body> </section> -<section> +</chapter> +<chapter> <title>Installing Client Daemons</title> +<section> +<title>Introduction</title> <body> <p> @@ -239,6 +242,12 @@ We first focus on using the NRPE method as it is the most popular one. </p> +</body> +</section> +<section> +<title>Installing NRPE</title> +<body> + <p> With NRPE, each remote host runs a daemon (the NRPE deamon) which allows the main Nagios system to query for certain metrics. One can run the NRPE daemon by @@ -264,6 +273,81 @@ # <i>/etc/init.d/nrpe start</i> </pre> +<p> +Finally, we need to configure the main Nagios system to connect to this +particular NRPE instance and request the necessary metrics. To introduce you to +Nagios' object syntax, our next section will cover this a bit more throroughly. +</p> + +</body> +</section> +<section> +<title>Configuring a Remote Host</title> +<body> + +<note> +The following hands-on tutorial is an example, used to introduce the user to +Nagios' object model. Do not see this as the "Best Practice" for +configuring Nagios. +</note> + +<p> +First, edit <path>/etc/nagios/nagios.cfg</path> and place a <c>cfg_dir</c> +directive. This will tell Nagios to read in all object configuration files in +the said directory - in our example, the directory will contain the definitions +for remote systems. +</p> + +<pre caption="Editing /etc/nagios/nagios.cfg"> +cfg_dir=/etc/nagios/objects/remote +</pre> + +<p> +Create the directory and start with the first file, +<path>nrpe-command.cfg</path>. In this file, we configure a Nagios command +called <c>check_nrpe</c> which will be used to trigger a plugin (identified by +the placeholder <c>$ARG1$</c>) on the remote system (identified by the +placeholder <c>$HOSTADDRESS$</c>). The <c>$USER1$</c> variable is a default +pointer to the Nagios installation directory (for instance, +<path>/usr/nagios/libexec</path>). +</p> + +<pre caption="Defining the check_nrpe command"> +# <i>nano /etc/nagios/objects/remote/nrpe-command.cfg</i> + +define command { + command_name check_nrpe + command_line $USER1$/check_nrpe -H $HOSTADDRESS$ -c $ARG1$ +} +</pre> + +<p> +Next, create a file <path>nrpe-hosts.cfg</path> where we define the remote +host(s) to monitor. In this example, we define two remote systems: +</p> + +<pre caption="Defining two remote hosts"> +# <i>nano /etc/nagios/objects/remote/nrpe-hosts.cfg</i> + +define host { + use linux-server + host_name webber + alias Gentoo Linux Web Server + address 192.168.2.1 +} + +define host { + use linux-server + host_name isync + alias Gentoo Linux RSync server + address 192.168.2.2 +} +</pre> + +<p> +Finally, define the service(s) you want to check on these hosts. +</p> + </body> </section> </chapter> -- [email protected] mailing list
