From 169b93a31dd88e3edb4f82c271110c8b41428d7d Mon Sep 17 00:00:00 2001
From: "Dr. Martin Goik" <goik@hdm-stuttgart.de>
Date: Tue, 18 Dec 2018 10:10:33 +0100
Subject: [PATCH] E-Mail setting advice

---
 Doc/Sdi/icinga.xml | 32 ++++++++++++++++++++++++++++++--
 1 file changed, 30 insertions(+), 2 deletions(-)

diff --git a/Doc/Sdi/icinga.xml b/Doc/Sdi/icinga.xml
index 4c57f644a..95b4c0aa8 100644
--- a/Doc/Sdi/icinga.xml
+++ b/Doc/Sdi/icinga.xml
@@ -11,8 +11,8 @@
          xmlns:db="http://docbook.org/ns/docbook">
   <title>Icinga 2</title>
 
-  <para>With respect to newer modules you may want to install newer icinga2
-  packages provided by the <link
+  <para>With respect to more current modules you may want to install newer
+  icinga2 packages provided by the <link
   xlink:href="https://packages.icinga.com/debian/#indexlist">Icinga Debian
   package repository</link>.</para>
 
@@ -21,6 +21,34 @@
       <para><link
       xlink:href="https://www.howtoforge.com/tutorial/how-to-install-icinga2-on-debian-9">How
       to Install Icinga 2 Monitoring Tool on Debian 9.2</link></para>
+
+      <caution>
+        <para>Fix <code>admin</code> email in
+        <filename>/etc/icinga/conf.d/users.conf</filename> prior to starting
+        **any** <productname>Icinga</productname> related service:</para>
+
+        <informaltable border="0">
+          <tr>
+            <td valign="top"><programlisting language="none">object User "icingaadmin" {
+  import "generic-user"
+
+  display_name = "Icinga 2 Admin"
+  groups = [ "icingaadmins" ]
+
+  email = "<emphasis role="red">root@localhost</emphasis>"
+}</programlisting></td>
+
+            <td valign="top"><programlisting language="none">object User "icingaadmin" {
+  import "generic-user"
+
+  display_name = "Icinga 2 Admin"
+  groups = [ "icingaadmins" ]
+
+  email = "<emphasis role="red">yourEmail@whatsoever.org</emphasis>"
+}</programlisting></td>
+          </tr>
+        </informaltable>
+      </caution>
     </listitem>
 
     <listitem>
-- 
GitLab