1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Icinga-Schnellstart auf Linux</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
<meta name="keywords" content="Supervision, Icinga, Icinga, Linux">
<link rel="home" href="index.html" title="Icinga Version 1.0.2 Dokumentation">
<link rel="up" href="ch02.html" title="Kapitel 2. Los geht's">
<link rel="prev" href="quickstart.html" title="Schnellstart-Installationsanleitungen">
<link rel="next" href="quickstart-icinga-freebsd.html" title="Icinga-Schnellstart auf FreeBSD">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<CENTER><IMG src="../images/logofullsize.png" border="0" alt="Icinga" title="Icinga"></CENTER>
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center">Icinga-Schnellstart auf Linux</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="quickstart.html">Zurück</a> </td>
<th width="60%" align="center">Kapitel 2. Los geht's</th>
<td width="20%" align="right"> <a accesskey="n" href="quickstart-icinga-freebsd.html">Weiter</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="section" title="Icinga-Schnellstart auf Linux">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="quickstart-icinga"></a>Icinga-Schnellstart auf Linux</h2></div></div></div>
<p><span class="bold"><strong><a name="introduction_icinga"></a>Einführung</strong></span></p>
<p>Diese Schnellstartanleitung ist dazu gedacht, Ihnen einfache Anweisungen zu liefern, wie Sie Icinga innerhalb von 20 Minuten
aus dem Quellcode installieren und Ihren lokalen Rechner damit überwachen.</p>
<p>Hier werden keine fortgeschrittenen Installationsoptionen vorgestellt - lediglich die Grundlagen, die für 95% aller Benutzer
funktionieren, die anfangen wollen.</p>
<p>Diese Anleitung enthält momentan Anweisungen für drei verschiedene Linux-Distributionen: <a class="link" href="http://fedoraproject.org/" target="_top">Fedora</a>, <a class="link" href="http://www.ubuntu.com/" target="_top">Ubuntu</a> and <a class="link" href="http://www.opensuse.org/" target="_top">openSuSE</a>. Ähnliche Distributionen werden wahrscheinlich auch funktionieren, darunter
<a class="link" href="http://www.redhat.com/" target="_top">RedHat</a>, <a class="link" href="http://www.centos.org/" target="_top">CentOS</a>, <a class="link" href="http://www.debian.org/" target="_top">Debian</a> und <a class="link" href="http://www.novell.com/products/server/" target="_top">SLES</a>.</p>
<p><span class="bold"><strong>Wenn Sie planen, eine Datenbank zusammen mit IDOUtils zu nutzen, dann lesen Sie statt dessen <a class="xref" href="quickstart-idoutils.html" title="Icinga-Schnellstart mit IDOUtils">„Icinga-Schnellstart mit IDOUtils“</a>!</strong></span></p>
<p><span class="bold"><strong>Was dabei herauskommt</strong></span></p>
<p>Wenn Sie diesen Anweisungen folgen, werden Sie am Ende folgendes haben:</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p>Icinga und die Plugins werden unterhalb von /usr/local/icinga installiert sein</p>
</li>
<li class="listitem">
<p>Icinga wird so konfiguriert sein, dass es einige Dinge auf Ihrem lokalen System überwacht (CPU-Auslastung,
Plattenbelegung, usw.)</p>
</li>
<li class="listitem">
<p>das klassische Icinga-Web-Interface ist erreichbar unter <code class="uri">http://localhost/nagios/</code> oder
<code class="uri">http://yourdomain.com/icinga/</code></p>
</li>
</ul></div>
<p><span class="bold"><strong>Voraussetzungen</strong></span></p>
<p>Während einiger Teile der Installation benötigen Sie <span class="bold"><strong>root</strong></span>-Zugang zu Ihrer Maschine.</p>
<p>Stellen Sie sicher, dass die folgenden Pakete installiert sind, bevor Sie fortfahren.</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p>Apache</p>
</li>
<li class="listitem">
<p>GCC-Compiler</p>
</li>
<li class="listitem">
<p>C/C++ development libraries</p>
</li>
<li class="listitem">
<p><a class="link" href="http://www.boutell.com/gd/" target="_top">GD</a> -Development-Libraries</p>
</li>
</ul></div>
<p><span class="bold"><strong>Optional</strong></span></p>
<p>Zu irgendeiner Zeit möchten Sie wahrscheinlich SNMP-basierte Prüfungen verwenden, so dass es eine gute Idee ist, die benötigten
Pakete gleich zu installieren. Anderenfalls werden die Plugins nicht kompiliert und sind nicht verfügbar, wenn Sie diese brauchen.</p>
<p><span class="bold"><strong>Installation der Pakete</strong></span></p>
<p>Sie können diese Pakete mit Hilfe der folgenden Befehle installieren (als root oder mit sudo):</p>
<p><span class="emphasis"><em>Fedora / RedHat / CentOS</em></span></p>
<pre class="programlisting"> #> yum install httpd gcc glibc glibc-common gd gd-devel
#> yum install libjpeg libjpeg-devel libpng libpng-devel
#> yum install net-snmp net-snmp-devel</pre>
<p><span class="emphasis"><em>Debian / Ubuntu</em></span></p>
<pre class="programlisting"> #> apt-get install apache2 build-essential libgd2-xpm-dev
#> apt-get install libjpeg62 libjpeg62-dev libpng12 libpng12-dev
#> apt-get install snmp libsnmp5-dev</pre>
<div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="../images/note.png"></td>
<th align="left">Anmerkung</th>
</tr>
<tr><td align="left" valign="top">
<p>Die Zahlen <62/12> können je nach Distribution abweichen</p>
</td></tr>
</table></div>
<p><span class="emphasis"><em>openSuSE</em></span></p>
<p>Bitte nutzen Sie yast für die Installation der Pakete</p>
<p><span class="bold"><strong>Benutzerinformationen erstellen</strong></span></p>
<p>Werden Sie zum root-Benutzer.</p>
<pre class="programlisting"> $> su -l</pre>
<p>Erstellen Sie ein neues Benutzerkonto <span class="emphasis"><em>icinga</em></span> und vergeben Sie ein Passwort:</p>
<pre class="programlisting"> #> /usr/sbin/useradd -m icinga
#> passwd icinga </pre>
<p>Bei einigen Distributionen müssen Sie die Gruppe in einem gesonderten Schritt anlegen:</p>
<pre class="programlisting"> #> /usr/sbin/groupadd icinga</pre>
<p>Damit Sie über das klassische Web-Interface Befehle an Icinga senden können, legen Sie noch eine neue Gruppe icinga-cmd an
und fügen Sie den Webbenutzer und den Icingabenutzer dieser Gruppe hinzu.</p>
<pre class="programlisting"> #> /usr/sbin/groupadd icinga-cmd
#> /usr/sbin/usermod -a -G icinga-cmd icinga
#> /usr/sbin/usermod -a -G icinga-cmd www-data (oder www, wwwrun, apache je nach Distribution)</pre>
<div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="../images/note.png"></td>
<th align="left">Anmerkung</th>
</tr>
<tr><td align="left" valign="top">
<p>Bei einigen usermod-Versionen (z.B. bei OpenSuSE 11 bzw. SLES 11) fehlt die Option -a. In diesen Fällen kann sie entfallen.</p>
</td></tr>
</table></div>
<p><span class="bold"><strong>Icinga und die Plugins herunterladen</strong></span></p>
<p>Wechseln Sie in Ihr lokales Source-Verzeichnis, z.B. /usr/src</p>
<pre class="programlisting"> #> cd /usr/src</pre>
<p>Holen Sie den aktuellen icinga-core-Snapshot aus dem Icinga GIT </p>
<pre class="programlisting"> #> git clone git://git.icinga.org/icinga-core.git</pre>
<p>
oder von der <a class="link" href="http://www.icinga.org/" target="_top">Icinga Website</a> .</p>
<p>Vergessen Sie nicht die <a class="link" href="http://www.nagiosplugins.org/" target="_top">Nagios-Plugins</a>.</p>
<p><span class="bold"><strong>Icinga</strong></span> kompilieren und installieren</p>
<p>Entpacken Sie das Icinga-Archiv (oder wechseln Sie in den GIT Snapshot)</p>
<pre class="programlisting"> #> cd /usr/src/
#> tar xvzf icinga-1.0.2.tar.gz
#> cd icinga-1.0.2</pre>
<p>Führen Sie das Icinga-configure-Script aus. Durch die Nutzung des --help-Flags erhalten Sie Hilfe zu den Optionen.</p>
<pre class="programlisting"> #> ./configure --with-command-group=icinga-cmd</pre>
<p>Kompilieren Sie den Icinga-Source-Code. Um mögliche Optionen zu sehen, rufen Sie lediglich "make" auf.</p>
<pre class="programlisting"> #> make all</pre>
<p>Installieren Sie die Binaries, das Init-Script, Beispiel-Konfigurationsdateien und setzen Sie die Berechtigungen für das
External-Command-Verzeichnis. </p>
<pre class="programlisting"> #> make install
#> make install-init
#> make install-config
#> make install-commandmode </pre>
<p> oder kürzer </p>
<pre class="programlisting"> #> make fullinstall</pre>
<p>Die Icinga-API wird beim Aufruf von "make install" installiert, wenn Sie nur die Icinga-Api (nach)installieren möchten, nutzen Sie: </p>
<pre class="programlisting"> # make install-api</pre>
<p>
Die Icinga-API ist Voraussetzung für das Icinga-Web-Interface (nicht für die klassische Ansicht!).</p>
<p>Bitte starten Sie Icinga noch nicht - es gibt noch ein paar Dinge zu tun...</p>
<p><span class="bold"><strong>Anpassen der Konfiguration</strong></span></p>
<p>Beispiel-Konfigurationsdateien werden durch </p>
<pre class="programlisting"> #> make install-config</pre>
<p>in /usr/local/icinga/etc/
installiert. Nun fehlt nur noch eine Änderung, bevor Sie fortfahren können...</p>
<p>Ändern Sie die <span class="emphasis"><em>/usr/local/icinga/etc/objects/contacts.cfg</em></span>-Konfigurationsdatei mit Ihrem bevorzugten Editor und
passen die e-Mail-Adresse in der <span class="emphasis"><em>icingaadmin</em></span>-Kontaktdefinition an, so dass sie die Adresse enthält, die im Falle von
Alarmen benachrichtigt werden soll.</p>
<pre class="programlisting"> #> vi /usr/local/icinga/etc/objects/contacts.cfg</pre>
<p><span class="bold"><strong>Installieren und konfigurieren des klassischen Web-Interface</strong></span></p>
<p>Icinga stellt das klassische Webinterface zur Verfügung ("Classic Web", "die CGIs"). Sie können dieses wie folgt
installieren:</p>
<pre class="programlisting"> #> make cgis
#> make install-cgis</pre>
<p>Wenn Sie stattdessen das neue Icinga Web installieren wollen, lesen Sie bitte <a class="link" href="icinga-web-scratch.html" title="Installation des neuen Icinga Web Frontend">Installation des
Web-Interface</a>.</p>
<p>Installieren Sie die Icinga-Web-Konfigurationsdatei im Apache conf.d-Verzeichnis.</p>
<pre class="programlisting"> #> make install-webconf</pre>
<p>Legen Sie ein <span class="emphasis"><em>icingaadmin</em></span>-Konto an, um sich am klassischen Web-Interface anmelden zu können. Merken Sie sich
das Passwort, das Sie diesem Konto geben - Sie brauchen es später.</p>
<pre class="programlisting"> #> htpasswd -c /usr/local/icinga/etc/htpasswd.users icingaadmin</pre>
<div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="../images/note.png"></td>
<th align="left">Anmerkung</th>
</tr>
<tr><td align="left" valign="top">
<p>Abhängig von der Apache-Version müssen Sie ggf. <span class="emphasis"><em>htpasswd2 verwenden.</em></span></p>
</td></tr>
</table></div>
<p>Wenn Sie das Passwort später ändern oder einen weiteren Benutzer hinzufügen möchten, verwenden Sie den folgenden Befehl:</p>
<pre class="programlisting"> #> htpasswd /usr/local/icinga/etc/htpasswd.users <USERNAME></pre>
<p>Starten Sie Apache neu, damit die Änderungen wirksam werden.</p>
<p><span class="emphasis"><em>Fedora/RedHat/CentOS</em></span></p>
<pre class="programlisting"> #> service httpd restart</pre>
<p><span class="emphasis"><em>Debian / Ubuntu / openSuSE</em></span></p>
<pre class="programlisting"> #> /etc/init.d/apache2 reload</pre>
<div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="../images/note.png"></td>
<th align="left">Anmerkung</th>
</tr>
<tr><td align="left" valign="top">
<p>Prüfen Sie die Implementierung der verbesserten CGI-Sicherheitsmaßnahmen wie <a class="link" href="cgisecurity.html" title="Verbesserte CGI-Sicherheit und Authentifizierung">hier</a> beschrieben,
um sicherzustellen, dass Ihre Web-Authentifizierungsinformationen nicht kompromittiert werden.</p>
</td></tr>
</table></div>
<p><span class="bold"><strong>Kompilieren und installieren der Nagios-Plugins</strong></span></p>
<p>Entpacken Sie die Nagios-Plugins-Quellcode-Archivdatei.</p>
<pre class="programlisting"> #> cd /usr/src
#> tar xzf nagios-plugins-1.4.14.tar.gz
#> cd nagios-plugins-1.4.14</pre>
<p>Kompilieren und installieren Sie die Plugins.</p>
<pre class="programlisting"> #> ./configure --prefix=/usr/local/icinga --with-nagios-user=icinga
#> make
#> make install</pre>
<p><span class="bold"><strong> Icinga starten</strong></span></p>
<p>Fügen Sie Icinga zu der Liste der System-Services hinzu und sorgen Sie für einen automatischen Start, wenn das System
hochfährt (stellen Sie sicher, dass Sie vorher das Init-Script installiert haben).</p>
<p><span class="emphasis"><em>Fedora / RedHat / CentOS / openSuSE</em></span></p>
<pre class="programlisting"> #> chkconfig --add icinga
#> chkconfig icinga on </pre>
<p><span class="emphasis"><em>Debian / Ubuntu</em></span></p>
<pre class="programlisting"> #> update-rc.d icinga defaults</pre>
<p>Überprüfen Sie die Icinga-Beispielkonfigurationsdateien.</p>
<pre class="programlisting"> #> /usr/local/icinga/bin/icinga -v /usr/local/icinga/etc/icinga.cfg</pre>
<p>Wenn keine Fehler auftreten, starten Sie Icinga.</p>
<pre class="screen"> #> service icinga start</pre>
<p><span class="bold"><strong> 8) Anpassen der SELinux-Einstellungen</strong></span></p>
<p><span class="bold"><strong>Start Icinga</strong></span></p>
<p>Fügen Sie Icinga zur Liste der System-Services hinzu, damit es automatisch beim Start des Systems gestartet wird (stellen Sie
sicher, dass Sie das Init-Script vorher installiert haben).</p>
<p>Überprüfen Sie die Icinga-Beispielkonfigurationsdateien.</p>
<pre class="programlisting"> #> /usr/local/icinga/bin/icinga -v /usr/local/icinga/etc/icinga.cfg</pre>
<p>Wenn es dabei keine Fehler gibt, starten Sie Icinga.</p>
<p><span class="emphasis"><em>Fedora / openSuSE</em></span></p>
<pre class="programlisting"> #> service icinga start</pre>
<p><span class="emphasis"><em>Debian / Ubuntu</em></span></p>
<pre class="programlisting"> #> /etc/init.d/icinga start</pre>
<p>Fedora wird mit installiertem SELinux (Security Enhanced Linux) ausgeliefert und läuft im "Enforcing"-Modus.
Dies kann zu "Internal Server Error"-Fehlern führen, wenn Sie versuchen, die Icinga-CGIs aufzurufen.</p>
<p>Schauen Sie, ob SELinux im Enforcing-Modus läuft.</p>
<pre class="screen"> #> getenforce</pre>
<p>Setzen Sie SELinux in den "Permissive"-Modus.</p>
<pre class="screen"> #> setenforce 0</pre>
<p>Damit diese Änderung dauerhaft wird, müssen Sie diese Einstellung in <span class="emphasis"><em>/etc/selinux/config</em></span> anpassen und das
System neustarten.</p>
<p>Statt SELinux zu deaktivieren oder es in den Permissive-Modus zu versetzen, können Sie den folgenden Befehl benutzen, um die
CGIs im Enforcing/Targeted-Modus laufen zu lassen:</p>
<pre class="programlisting"> #> chcon -R -t httpd_sys_content_t /usr/local/icinga/sbin/
#> chcon -R -t httpd_sys_content_t /usr/local/icinga/share/</pre>
<p>Besuchen Sie das NagiosCommunity.org-Wiki unter <a class="link" href="http://www.nagioscommunity.org/wiki" target="_top">http://www.nagioscommunity.org/wiki</a>, um Informationen darüber zu erhalten, wie die
Icinga-CGIs im Enforcing-Modus mit einer Targeted-Richtlinie ausgeführt werden.</p>
<p><span class="bold"><strong>Anmelden am klassischen Web-Interface</strong></span></p>
<p>Sie sollten nun auf das klassische Icinga-Web-Interface zugreifen können. Sie werden nach dem Benutzernamen
(<span class="emphasis"><em>icingaadmin</em></span>) und Passwort gefragt, das Sie vorhin angegeben haben.</p>
<pre class="programlisting"> http://localhost/icinga/</pre>
<p>oder</p>
<pre class="programlisting"> http://yourdomain.com/icinga/</pre>
<p>Klicken Sie auf den "Service Detail"-Verweis in der Navigationsleiste, um Details darüber zu erhalten, was auf Ihrer lokalen
Maschine überwacht wird. Es wird ein paar Minuten dauern, bis Icinga alle mit Ihrer Maschine verbundenen Services geprüft hat, weil
die Prüfungen über eine gewisse Zeit verteilt werden.</p>
<p><span class="bold"><strong>Andere Anpassungen</strong></span></p>
<p>Stellen Sie sicher, dass die Firewall-Einstellungen Ihrer Maschine einen Zugriff auf das klassische Web-Interface ermöglichen, wenn
Sie von anderen Rechnern darauf zugreifen wollen.</p>
<pre class="programlisting"> #> iptables -A INPUT -p tcp -m tcp --dport 80 -j ACCEPT</pre>
<p>Die Konfiguration von e-Mail-Benachrichtigungen ist nicht Gegenstand dieser Anleitung. Icinga ist konfiguriert, um
e-Mail-Benachrichtigungen zu versenden, aber möglicherweise ist auf Ihrem System noch kein Mail-Programm installiert bzw. konfiguriert.
Schauen Sie in Ihre Systemdokumentation, suchen Sie im Web oder gucken Sie im <a class="link" href="http://www.nagioscommunity.org/wiki" target="_top">IcingaCommunity.org-Wiki</a> nach genauen Anweisungen, wie Ihr System
konfiguriert werden muss, damit es e-Mail-Mitteilungen an externe Adressen versendet. Mehr Informationen zu Benachrichtigungen finden Sie
<a class="link" href="notifications.html" title="Benachrichtigungen">hier</a>.</p>
<p><span class="bold"><strong>Fertig</strong></span></p>
<p>Glückwunsch! Sie haben erfolgreich Icinga installiert. Ihre Reise in die Überwachung hat gerade begonnen. Sie werden ohne
Zweifel mehr als nur Ihre lokale Maschine überwachen wollen, so dass Sie u.a. das folgende <a class="link" href="ch02.html" title="Kapitel 2. Los geht's">Kapitel</a> lesen
sollten...</p>
<a class="indexterm" name="id5524427"></a>
<a class="indexterm" name="id5524446"></a>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="quickstart.html">Zurück</a> </td>
<td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td>
<td width="40%" align="right"> <a accesskey="n" href="quickstart-icinga-freebsd.html">Weiter</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Schnellstart-Installationsanleitungen </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td>
<td width="40%" align="right" valign="top"> Icinga-Schnellstart auf FreeBSD</td>
</tr>
</table>
</div>
<P class="copyright">© 2009-2010 Icinga Development Team, http://www.icinga.org</P>
</body>
</html>
|
