diff --git a/Doc/Sdi/surveillance.xml b/Doc/Sdi/surveillance.xml index a3de0ad4f4230ba413b257d91be062ff1b32d9f3..da7a86617937111b42d6e1dd0d8d08dbcc4220ce 100644 --- a/Doc/Sdi/surveillance.xml +++ b/Doc/Sdi/surveillance.xml @@ -7,7 +7,7 @@ xmlns:m="http://www.w3.org/1998/Math/MathML" xmlns:html="http://www.w3.org/1999/xhtml" xmlns:db="http://docbook.org/ns/docbook"> - <title> Systems surveillance</title> + <title>Systems surveillance</title> <section xml:id="sdiSectNagios"> <title>Working with <productname>Nagios</productname></title> @@ -46,7 +46,8 @@ <para>Configure your first VM as a host to be monitored according to <link xlink:href="http://nagios.sourceforge.net/docs/nagioscore/3/en/objectdefinitions.html#host">Host - Definition</link>.</para> + Definition</link>. Start with <quote>host is alive</quote> not yet + requiring any service definition.</para> <para>You may want to choose low values for <option>check_interval</option>, <option>retry_interval</option>, and @@ -58,25 +59,76 @@ <para>Configure a service testing for <xref linkend="glo_HTTP"/> reachability. Then shut down your Apache Process and consult your <quote>tactical overview</quote>.</para> + + <orderedlist> + <listitem> + <para>Configure a service testing for <xref linkend="glo_HTTP"/> + reachability.</para> + </listitem> + + <listitem> + <para>consult your <quote>tactical overview</quote>. Your new + check should transition from <quote>pending</quote> state to + <quote>O.K</quote>.</para> + </listitem> + + <listitem> + <para>Shut down the apache 2 service on your remote host and watch + the state transition from <quote>O.K</quote> to .</para> + </listitem> + </orderedlist> + + <tip> + <itemizedlist> + <listitem> + <para><filename>/usr/share/nagios-plugins/templates-basic/http.cfg</filename> + belonging to the package <package>nagios-plugins-basic</package> + defines a suitable <command>check_http</command> command.</para> + </listitem> + + <listitem> + <para>The current and subsequent service definitions may be + added to the host configuration file.</para> + </listitem> + </itemizedlist> + </tip> </listitem> <listitem> - <para>Configure service testing for <xref linkend="glo_LDAP"/> based - authenticated <code>https</code> access. </para> + <para>Check the remote machine's internal parameters (disk usage, + system load,..) using the <productname + xlink:href="http://nagios.sourceforge.net/docs/nagioscore/3/en/addons.html#nrpe">Nrpe</productname> + plugin. This essential means defining your + <productname>Nagios</productname> server's <code>localhost</code> + checks for your remote machine as well.</para> </listitem> <listitem> - <para>Check the remote <xref linkend="glo_HTTP"/> service by using a - <productname - xlink:href="http://nagios.sourceforge.net/docs/nagioscore/3/en/addons.html#nrpe">Nrpe</productname> - plugin.</para> + <para>Configure service testing for (<xref linkend="glo_LDAP"/> based) + authenticated <code>https</code> access.</para> + + <tip> + <para><command>/usr/lib/nagios/plugins/check_http</command> + <option>--help</option> will show you <option>-a</option> / + <option>--authorization</option> option requiring appropriate + parameters. This is being used in the + <command>check_https_auth</command> definition being part of + <filename>/usr/share/nagios-plugins/templates-basic/http.cfg</filename>. + </para> + </tip> + </listitem> + + <listitem> + <para>Check the remote machine's internally accessible <xref + linkend="glo_LDAP"/> Server using <productname + xlink:href="http://nagios.sourceforge.net/docs/nagioscore/3/en/addons.html#nrpe">Nrpe</productname>.</para> </listitem> <listitem> <para>Authentication will not work when the host's <xref - linkend="glo_LDAP"/> server is down. So checking for authentication - should be deferred if <xref linkend="glo_LDAP"/> is not available. - Configure an appropriate <link + linkend="glo_LDAP"/> server is down. So authentication related + warnings should be deferred until <xref linkend="glo_LDAP"/> becomes + available. Configure an appropriate <link xlink:href="http://nagios.sourceforge.net/docs/nagioscore/3/en/dependencies.html"><productname>Nagios</productname> dependency</link>.</para> </listitem>