From c280d10ee7c2b84228dce7f1bb9b829499e0079d Mon Sep 17 00:00:00 2001
From: Martin Goik <goik@hdm-stuttgart.de>
Date: Thu, 11 Jun 2015 22:53:59 +0200
Subject: [PATCH] Nagios

---
 Doc/Sdi/surveillance.xml | 85 ++++++++++++++++++++++++++++++++++++++++
 Doc/lectures.xml         |  1 +
 2 files changed, 86 insertions(+)
 create mode 100644 Doc/Sdi/surveillance.xml

diff --git a/Doc/Sdi/surveillance.xml b/Doc/Sdi/surveillance.xml
new file mode 100644
index 000000000..a3de0ad4f
--- /dev/null
+++ b/Doc/Sdi/surveillance.xml
@@ -0,0 +1,85 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<chapter version="5.0" xml:id="sdiSystemSurveillance"
+         xmlns="http://docbook.org/ns/docbook"
+         xmlns:xlink="http://www.w3.org/1999/xlink"
+         xmlns:xi="http://www.w3.org/2001/XInclude"
+         xmlns:svg="http://www.w3.org/2000/svg"
+         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>
+
+  <section xml:id="sdiSectNagios">
+    <title>Working with <productname>Nagios</productname></title>
+
+    <orderedlist>
+      <listitem>
+        <para>Follow <link
+        xlink:href="https://help.ubuntu.com/lts/serverguide/nagios.html">https://help.ubuntu.com/lts/serverguide/nagios.html</link>
+        to install the <productname>Nagios</productname> server software.
+        Choose your <quote>second</quote> VM (the one not carrying <xref
+        linkend="glo_LDAP"/>, <productname>Apache</productname>,
+        <productname>Mysql</productname> and other services).</para>
+
+        <para>The idea is using this second VM guarding the first VM.</para>
+      </listitem>
+
+      <listitem>
+        <para>Check your installation's web interface
+        https://sdiXY.mi.hdm-stuttgart.de/nagios3. The <quote>Tactical
+        Overview</quote> is yet supposed to be empty.</para>
+      </listitem>
+
+      <listitem>
+        <para>The <productname>Nagios</productname> configuration files reside
+        both in and below of <filename>/etc/nagios3</filename>. Modify
+        <filename>/etc/nagios3/conf.d/contacts_nagios2.cfg</filename>
+        replacing contact <code>root</code> by yourself including a valid
+        E-Mail. <link
+        xlink:href="http://nagios.sourceforge.net/docs/nagioscore/3/en/objectdefinitions.html#contact">Contact
+        Definition</link> and <link
+        xlink:href="http://nagios.sourceforge.net/docs/nagioscore/3/en/objectdefinitions.html#contactgroup">Contact
+        Group Definition</link> are your friends!</para>
+      </listitem>
+
+      <listitem>
+        <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>
+
+        <para>You may want to choose low values for
+        <option>check_interval</option>, <option>retry_interval</option>, and
+        <option>notification_interval</option> in order to effect frequent
+        updates and notifications.</para>
+      </listitem>
+
+      <listitem>
+        <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>
+      </listitem>
+
+      <listitem>
+        <para>Configure service testing for <xref linkend="glo_LDAP"/> based
+        authenticated <code>https</code> access. </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>
+      </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
+        xlink:href="http://nagios.sourceforge.net/docs/nagioscore/3/en/dependencies.html"><productname>Nagios</productname>
+        dependency</link>.</para>
+      </listitem>
+    </orderedlist>
+  </section>
+</chapter>
diff --git a/Doc/lectures.xml b/Doc/lectures.xml
index 7462bc260..d4715f049 100644
--- a/Doc/lectures.xml
+++ b/Doc/lectures.xml
@@ -105,6 +105,7 @@
     <xi:include href="Sdi/apache.xml" xpointer="element(/1)"/>
 
     <xi:include href="Sdi/samba.xml" xpointer="element(/1)"/>
+    <xi:include href="Sdi/surveillance.xml" xpointer="element(/1)"/>
   </part>
 
   <xi:include href="Common/bibliography.xml" xpointer="element(/1)"/>
-- 
GitLab