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
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Icinga-Schnellstart mit IDOUtils</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-icinga-freebsd.html" title="Icinga-Schnellstart auf FreeBSD">
<link rel="next" href="upgrading.html" title="Icinga aktualisieren">
</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 mit IDOUtils</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="quickstart-icinga-freebsd.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="upgrading.html">Weiter</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="section" title="Icinga-Schnellstart mit IDOUtils">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="quickstart-idoutils"></a>Icinga-Schnellstart mit IDOUtils</h2></div></div></div>
<p><span class="bold"><strong><a name="introduction_idoutils"></a>Einführung</strong></span></p>
<p>Diese Schnellstartanleitung ist dazu gedacht, Ihnen einfache Anweisungen zu liefern, wie Sie Icinga innerhalb von 30 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 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> und <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, Icinga OHNE IDOUtils zu nutzen, dann lesen Sie statt dessen <a class="xref" href="quickstart-icinga.html" title="Icinga-Schnellstart auf Linux">„Icinga-Schnellstart auf Linux“</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 http://localhost/icinga/</p>
</li>
<li class="listitem">
<p>Eine Datenbank, die von Icinga mit Hilfe von IDOUtils gefüllt wird</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>IDOUtils benutzt die <a class="link" href="http://libdbi.sourceforge.net" target="_top">libdbi</a> und die libdbi-Treiber für verschiedene
Datenbanken. Die Development-Libraries werden ebenfalls benötigt. Die folgenden Beispiele zeigen, wie die IDOUtils mit libdbi für
MySQL oder PostgreSQL installiert werden.</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>
<li class="listitem">
<p>libdbi/libdbi-Treiber, eine Datenbank wie z.B. MySQL oder PostgreSQL</p>
</li>
</ul></div>
<p><span class="bold"><strong>Neue Features für die IDOUtils:</strong></span></p>
<p><span class="bold"><strong>SSL-Verschlüsselung zwischen idomod und ido2db</strong></span></p>
<p>Wenn Sie <span class="bold"><strong>SSL-Verschlüsselung </strong></span>verwenden möchten, werden zusätzlich die Pakete openssl und
openssl-devel/libssl-dev benötigt!</p>
<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>SSL muss auch bei allen idomod-Clients aktiviert werden, sonst gehen Daten verloren!!!</p>
</td></tr>
</table></div>
<p><span class="bold"><strong>Oracle-Datenbankunterstützung</strong></span></p>
<p>Wenn Sie Oracle als RDBMS einsetzen möchten, müssen Sie installieren:</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p>die Oracle Libraries und SDK (zum Beispiel den Oracle Instantclient)</p>
</li>
<li class="listitem">
<p>installieren Sie statt des libdbi-Treibers den ocilib-Treiber</p>
</li>
</ul></div>
<p>Stellen Sie sicher, dass die Libraries in der Path-Variablen enthalten sind. Oder setzen Sie die den Oracle Library Path mit
--with-oracle-lib=/path/to/instantclient</p>
<p>Download des ocilib-Treiber von http://orclib.sourceforge.net/ und verweisen Sie beim configure auf Ihre Oracle-Libraries und die Header-Files, z.B.
die des Oracle Instant-Client:</p>
<pre class="programlisting"> #> ./configure --with-oracle-headers-path=/path/to/instantclient/sdk/include --with-oracle-lib-path=/path/to/instantclient/
#> make
#> make install</pre>
<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="bold"><strong>Fedora / RedHat / CentOS:</strong></span></p>
<pre class="programlisting"> #> yum install httpd gcc glibc glibc-common gd gd-devel
#> yum install libjpeg libjpeg-devel libpng libpng-devel</pre>
<p><span class="bold"><strong>MySQL:</strong></span></p>
<pre class="programlisting"> #> yum install mysql mysql-server libdbi libdbi-devel libdbi-drivers libdbi-dbd-mysql</pre>
<p><span class="bold"><strong>PostgreSQL:</strong></span></p>
<pre class="programlisting"> #> yum install postgresql postgresql-server libdbi libdbi-devel libdbi-drivers libdbi-dbd-pgsql</pre>
<p><span class="bold"><strong>Debian / Ubuntu:</strong></span></p>
<pre class="programlisting"> #> apt-get install apache2 build-essential libgd2-xpm-dev
#> apt-get install libjpeg62 libjpeg62-dev libpng12 libpng12-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="bold"><strong>MySQL:</strong></span></p>
<pre class="programlisting"> #> apt-get install mysql-server mysql-client libdbi0 libdbi0-dev libdbd-mysql</pre>
<p><span class="bold"><strong>PostgreSQL:</strong></span></p>
<pre class="programlisting"> #> apt-get install postgresql libdbi0 libdbi0-dev libdbd-pgsql</pre>
<p><span class="bold"><strong>openSuSE:</strong></span></p>
<p>Benutzen Sie yast zur Installation der Pakete für das RDBMS, das Sie verwenden möchten, also "mysql", "mysql-devel" und
"mysql-client" bzw. "postgresql", "postgresql-devel" und "postgresql-server". Bei OpenSuSE 11 (SLES 11) lautet der Name des Packages statt
"mysql-devel" nun "libmysqlclient-devel".</p>
<p>Es ist ziemlich wahrscheinlich, dass es keine libdbi-Packages gibt, so dass Sie die Sourcen herunterladen und kompilieren müssen.
Ersetzen Sie dabei <rdbm> durch Ihr RDBM wie mysql oder pgsql. Bitte beachten Sie, dass der Oracle-Treiber noch nicht funktioniert.
Lesen Sie daher den entsprechenden Abschnitt zu ocilib (anstatt libdbi).</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
<p>Laden Sie die tar.gz-Dateien herunter und entpacken Sie diese</p>
<p><a class="link" href="http://libdbi.sourceforge.net/download.html" target="_top">http://libdbi.sourceforge.net/download.html</a></p>
<p><a class="link" href="http://libdbi-drivers.sourceforge.net/download.html" target="_top">http://libdbi-drivers.sourceforge.net/download.html</a></p>
<pre class="programlisting"> #> tar xvzf libdbi-0.8.3.tar.gz
#> tar xvzf libdbi-drivers-0.8.3-1.tar.gz</pre>
</li>
<li class="listitem">
<p>Installieren Sie die libdbi. Möglicherweise brauchen Sie beim configure weitere Optionen (set --prefix=/usr ... )</p>
<pre class="programlisting"> #> cd libdbi-0.8.3
#> ./configure --disable-docs
#> make
#> make install</pre>
</li>
<li class="listitem">
<p>Installieren Sie die libdbi-Treiber</p>
<pre class="programlisting"> #> cd libdbi-drivers-0.8.3-1
#> ./configure --with-<rdbm> --disable-docs
#> make
#> make install</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 den 64-bit-Versionen müssen Sie die Pfade zu den include- und lib-dir-Verzeichnissen explizit angeben:</p>
<pre class="programlisting"> #> ./configure --with-<rdbm> --with-<rdbm>-incdir=/usr/include/<rdbm>/ --with-<rdbm>-libdir=/usr/lib64/ --disable-docs</pre>
</td></tr>
</table></div>
</li>
</ol></div>
<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. 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 und die IDOUtils kompilieren und installieren</strong></span></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 --enable-idoutils</pre>
<div class="caution" title="Achtung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Caution">
<tr>
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Achtung]" src="../images/caution.png"></td>
<th align="left">Achtung</th>
</tr>
<tr><td align="left" valign="top">
<p>Das Kompilieren auf Solaris kann wegen unerfüllten Bibliotheksabhängigkeiten von gethostbyname fehlschlagen. Wenn dies der Fall
ist, führen Sie folgenden Befehl vor configure aus:</p>
<pre class="programlisting"> #> export LIBS=-lsocket -lnsl</pre>
</td></tr>
</table></div>
<p><span class="bold"><strong>Mit <span class="bold"><strong>SSL</strong></span>-Verschlüsselung:</strong></span></p>
<pre class="programlisting"> #> ./configure --with-command-group=icinga-cmd --enable-idoutils --enable-ssl</pre>
<p><span class="bold"><strong>Mit Oracle-Datenbankunterstützung:</strong></span></p>
<pre class="programlisting"> #> ./configure --with-command-group=icinga-cmd --enable-idoutils --enable-oracle</pre>
<p> Wenn Ihre
Oracle Libraries nicht in der Path-Variablen enthalten sind, können Sie sie im configure angeben: </p>
<pre class="programlisting"> #> ./configure --with-command-group=icinga-cmd --enable-idoutils --enable-oracle \
--with-oracle-lib=/path/to/instantclient</pre>
<p> Wenn Sie die ocilib nicht im Standardpfad (/usr/local) installiert haben, können
Sie configure die lib/inc Verzeichnisse angeben:</p>
<pre class="programlisting"> #> ./configure --with-command-group=icinga-cmd --enable-idoutils --enable-oracle \
--with-ocilib-lib=/path/to/ocilib/lib --with-ocilib-inc=/path/to/ocilib/include</pre>
<p> </p>
<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>Wenn Sie von einer Oracle-Datenbank auf ein anderes RDBMS wechseln möchten, dann müssen Sie die IDOUtils erneut
kompilieren und installieren!</p>
</td></tr>
</table></div>
<p> </p>
<pre class="programlisting"> #> make distclean
#> ./configure --enable-idoutils</pre>
<p> Kompilieren Sie den Icinga-Source-Code. Es gibt auch eine extra Option für
IDOUtils (<span class="emphasis"><em>make idoutils</em></span>), wenn Sie nur dieses Module erneut kompilieren möchten. 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
# make install-idoutils</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.</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>
<pre class="programlisting"> #> cd /usr/local/icinga/etc
#> mv idomod.cfg-sample idomod.cfg
#> mv ido2db.cfg-sample ido2db.cfg</pre>
<p>Wenn Sie die IDOUtils mit ssl kompiliert haben, aktivieren Sie ssl in der idomod.cfg mit</p>
<pre class="programlisting"> use_ssl=1
output_type=tcpsocket
output=127.0.0.1</pre>
<p>(Passen Sie die IP-Adresse an, wenn sich Ihre Datenbank nicht auf localhost befindet!) und der ido2db.cfg mit</p>
<pre class="programlisting"> use_ssl=1
socket_type=tcp </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>Vergessen Sie nicht, alle anderen idomod-Clients auch neu zu kompilieren und auf ssl umzustellen, <span class="bold"><strong>anderenfalls werden Sie Daten verlieren</strong></span>!!!</p>
</td></tr>
</table></div>
<p>Aktivieren Sie das idomod-Eventbroker-Modul. Editieren Sie /usr/local/icinga/etc/icinga.cfg und suchen Sie nach "broker_module" und aktivieren Sie
diese Zeile bzw. fügen Sie die folgende Zeile hinzu (passen Sie die Namen an, falls nötig).</p>
<pre class="programlisting"> broker_module=/usr/local/icinga/bin/idomod.o config_file=/usr/local/icinga/etc/idomod.cfg</pre>
<p><span class="bold"><strong>Konfigurieren von Datenbank und IDOUtils</strong></span></p>
<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>Wenn Sie wie weiter oben beschrieben das Datenbanksystem neu installiert haben, dann müssen Sie den Datenbank-Server starten,
bevor Sie eine Datenbank anlegen können. Im Falle von MySQL erfolgt der Start z.B. mit <code class="code">/etc/init.d/mysql start</code>.</p>
</td></tr>
</table></div>
<p><span class="bold"><strong>MySQL:</strong></span></p>
<p><span class="emphasis"><em>Anlegen von Datenbank, Benutzer und Berechtigungen</em></span></p>
<pre class="programlisting"> #> mysql -u root -p
mysql> CREATE DATABASE icinga;
GRANT USAGE ON *.* TO 'icinga'@'localhost' IDENTIFIED BY 'icinga' WITH MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0;
GRANT SELECT , INSERT , UPDATE , DELETE ON icinga.* TO 'icinga'@'localhost';
FLUSH PRIVILEGES ;
quit</pre>
<pre class="programlisting"> #> cd /path/to/icinga-src/module/idoutils/db/mysql
#> mysql -u root -p icinga < mysql.sql</pre>
<pre class="programlisting"> #> vi /usr/local/icinga/etc/ido2db.cfg
db_servertype=mysql
db_port=3306
db_user=icinga
db_pass=icinga</pre>
<p><span class="bold"><strong>PostgreSQL:</strong></span></p>
<p><span class="emphasis"><em>Anlegen von Datenbank und Benutzer</em></span></p>
<pre class="programlisting"> #> su - postgres
$psql
postgres=# CREATE USER icinga;
postgres=# ALTER USER icinga WITH PASSWORD 'icinga';
postgres=# CREATE DATABASE icinga;</pre>
<p><span class="bold"><strong>Debian:</strong></span></p>
<pre class="programlisting"> #> vi /etc/postgresql/8.x/main/pg_hba.conf</pre>
<p><span class="bold"><strong>Fedora / RedHat / CentOS:</strong></span></p>
<pre class="programlisting"> #> vi /var/lib/pgsql/data/pg_hba.conf</pre>
<p>Editieren Sie die Konfiguration z.B. wie folgt (dem lokalen Benutzer muss vertraut werden)</p>
<pre class="programlisting"> # database administrative login by UNIX sockets
local all postgres ident
# TYPE DATABASE USER CIDR-ADDRESS METHOD
#icinga
local icinga icinga trust
# "local" is for Unix domain socket connections only
local all all trust
# IPv4 local connections
local all all 127.0.0.1/32 trust
# IPV6 local connections
local all all ::1/128 trust</pre>
<p>Neuladen und konfigurieren des Datenbankschemas</p>
<pre class="programlisting"> #> /etc/init.d/postgresql-8.x reload</pre>
<pre class="programlisting"> #> cd /path/to/icinga-src/module/idoutils/db/pgsql/
#> psql -U icinga -d icinga < pgsql.sql</pre>
<p>Editieren der DB-Konfigurationsdatei, um die IDOUtils anzupassen</p>
<pre class="programlisting"> #> vi /usr/local/icinga/etc/ido2db.cfg
db_servertype=pgsql
db_port=5432
db_user=icinga
db_pass=icinga</pre>
<p><span class="bold"><strong>Oracle:</strong></span></p>
<p>Erstellen Sie ein Datenbank-Schema und eine username/password-Kombination (lesen Sie dazu die Oracle-Dokumentation unter
http://www.oracle.com oder fragen Sie Ihren DBA). Importieren Sie das Datenbank-Schema mit sqlplus (oder Ihrer bevorzugten Methode). Kopieren Sie
module/idoutils/db/oracle/oracle.sql nach $ORACLE_HOME</p>
<pre class="programlisting"> #> su - oracle
$ sqlplus dbuser/dbpass
SQL> @oracle.sql</pre>
<p>Editieren Sie das DB-Config-File, um die IDOUtils anzupassen. Denken Sie daran, dass Oracle den DB-Host ignoriert, nutzen Sie
statt dessen db_name, um auf //DBSERVER/DBNAME zu verweisen</p>
<pre class="programlisting"> #> vi /usr/local/icinga/etc/ido2db.cfg
db_servertype=oracle
db_port=1521
db_user=icinga
db_pass=icinga</pre>
<p><span class="bold"><strong>Installieren und konfigurieren des klassischen Web-Interface</strong></span></p>
<p>Icinga stellt das klassische Web-Interface 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="screen"> #> cd /path/to/icinga-src
#> 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="screen"> #> 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="bold"><strong>Fedora / RHEL / CentOS</strong></span>:</p>
<pre class="programlisting"> #> service httpd restart</pre>
<p><span class="bold"><strong>Ubuntu / openSuSE:</strong></span></p>
<pre class="programlisting"> #> service apache2 restart</pre>
<p><span class="bold"><strong>Debian:</strong></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="screen"> #> 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="screen"> #> ./configure --prefix=/usr/local/icinga --with-nagios-user=icinga
#> make
#> make install</pre>
<p><span class="bold"><strong>IDOUtils und Icinga starten</strong></span></p>
<p>IDOUtils muss vor Icinga gestartet werden</p>
<p><span class="bold"><strong>IDOUtils starten</strong></span></p>
<p><span class="bold"><strong>Fedora / openSuSE/Ubuntu:</strong></span></p>
<pre class="programlisting"> #> service ido2db start</pre>
<p><span class="bold"><strong>Debian:</strong></span></p>
<pre class="programlisting"> #> /etc/init.d/ido2db start </pre>
<p><span class="bold"><strong>IDOUtils beenden</strong></span></p>
<p><span class="bold"><strong>Fedora / openSuSE/Ubuntu:</strong></span></p>
<pre class="programlisting"> #> service ido2db stop</pre>
<p><span class="bold"><strong>Debian:</strong></span></p>
<pre class="programlisting"> #> /etc/init.d/ido2db stop</pre>
<p><span class="bold"><strong>Automatischer Start von IDOUtils</strong></span></p>
<p>Fügen Sie IDOUtils 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="bold"><strong>Fedora / openSuSE:</strong></span></p>
<pre class="programlisting"> #> chkconfig --add ido2db
#> chkconfig ido2db on </pre>
<p><span class="bold"><strong>Debian / Ubuntu:</strong></span> </p>
<pre class="programlisting"> #> update-rc.d ido2db defaults</pre>
<p>
<span class="bold"><strong>Icinga starten:</strong></span></p>
<p><span class="bold"><strong>Start von Icinga</strong></span></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="bold"><strong>Fedora / openSuSE/Ubuntu:</strong></span></p>
<pre class="programlisting"> #> service icinga start</pre>
<p><span class="bold"><strong>Debian:</strong></span></p>
<pre class="programlisting"> #> /etc/init.d/icinga start</pre>
<p><span class="bold"><strong>Automatischer Start von Icinga</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="bold"><strong>Fedora / openSuSE:</strong></span></p>
<pre class="programlisting"> #> chkconfig --add icinga
#> chkconfig icinga on </pre>
<p><span class="bold"><strong>Debian / Ubuntu:</strong></span></p>
<pre class="programlisting"> #> update-rc.d icinga defaults</pre>
<p><span class="bold"><strong>Anpassen der SELinux-Einstellungen</strong></span></p>
<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="screen"> #> 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>nagiosadmin</em></span>) und Passwort gefragt, das Sie vorhin angegeben haben.</p>
<pre class="screen"> 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">
NagiosCommunity.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="id5526489"></a>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="quickstart-icinga-freebsd.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="upgrading.html">Weiter</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Icinga-Schnellstart auf FreeBSD </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td>
<td width="40%" align="right" valign="top"> Icinga aktualisieren</td>
</tr>
</table>
</div>
<P class="copyright">© 2009-2010 Icinga Development Team, http://www.icinga.org</P>
</body>
</html>
|
