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
|
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Icinga aktualisieren</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-idoutils.html" title="Icinga-Schnellstart mit IDOUtils">
<link rel="next" href="upgrading_idoutils.html" title="IDOUtils-Datenbank 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 aktualisieren</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="quickstart-idoutils.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_idoutils.html">Weiter</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="section" title="Icinga aktualisieren">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="upgrading"></a>Icinga aktualisieren</h2></div></div></div>
<p><span class="bold"><strong>Inhalt</strong></span></p>
<p><a class="link" href="upgrading.html#upgrading-icinga">Aktualisierung von Icinga</a></p>
<p><a class="link" href="upgrading.html#upgrading-nagios3x">Upgrade von Nagios 3.x</a></p>
<p><a class="link" href="upgrading.html#upgrading-nagios2x">Upgrade von Nagios 2.x</a></p>
<p><a class="link" href="upgrading.html#upgrading-rpm">Aktualisierung einer RPM-Installation</a></p>
<p><a name="upgrading-icinga"></a> <span class="bold"><strong>Aktualisierung von Icinga</strong></span></p>
<p>Sobald neuere Versionen von Icinga herauskommen, sollten Sie dringend über eine Aktualisierung nachdenken. Neuere Ausgaben
enthalten Behebungen kritischer Fehler, so dass es wichtig ist, aktuell zu sein. Wenn Sie bereits Icinga, wie in den
Schnellstartanleitungen beschrieben, aus dem Quellcode installiert haben, dann können Sie einfach neuere Versionen installieren. Sie
müssen dazu noch nicht einmal root-Berechtigungen haben, weil bereits alles passiert ist, was als root-Benutzer getan werden muss. Das ist
allerdings abhängig davon, welche Präferenzen Sie diesbezüglich haben.</p>
<p>Stellen Sie sicher, dass Sie eine gute Datensicherung Ihrer bestehenden Icinga-Installation und der Konfigurationsdateien
haben. Wenn irgendetwas schief geht oder nicht funktioniert, dann können Sie auf diese Weise schnell Ihre alte Icinga-Version
wiederherstellen.</p>
<p>Werden Sie der icinga-Benutzer. Debian/Ubuntu-Benutzer sollten sudo -s icinga benutzen.</p>
<pre class="programlisting"> $> su -l icinga</pre>
<p>Holen Sie sich das Quellcode-Archiv der letzten Icinga-Version (besuchen Sie http://www.icinga.org/ für den Verweis auf die letzte
Version) und entpacken Sie das Quellcode-Archiv.</p>
<p>Starten Sie das Icinga-configure-Script mit den gleichen Optionen wie bei der letzten Installation, z.B. so:</p>
<pre class="programlisting"> #> ./configure --with-command-group=icinga-cmd --enable-idoutils</pre>
<p>Kompilieren Sie den Icinga-Quellcode.</p>
<pre class="programlisting"> #> make all</pre>
<p>Installieren Sie aktualisierte Programme, Dokumentation und Web-Interface. Ihre vorhandenen Konfigurationsdaten werden in diesem
Schritt nicht überschrieben.</p>
<pre class="programlisting"> #> make install install-base install-cgis install-html install-init install-commandmode install-idoutils</pre>
<p>Überprüfen Sie Ihre Konfigurationsdateien und starten Sie Icinga erneut.</p>
<pre class="programlisting"> #> /etc/init.d/icinga checkconfig
#> /etc/init.d/icinga restart</pre>
<p>Das war's - Sie sind fertig!</p>
<p><a name="upgrading-nagios3x"></a> <span class="bold"><strong>Upgrade von Nagios 3.x</strong></span></p>
<p>Icinga ist aus Nagios 3.x hervorgegangen, so dass die Aktualisierung problemlos sein sollte.</p>
<p>Falls Sie einen Upgrade von Nagios-Version 3.0.x durchführen, dann fehlt Ihnen ggf. PHP.</p>
<p><span class="emphasis"><em>Debian / Ubuntu</em></span> </p>
<pre class="screen"> #> apt-get install php5 libapache2-mod-php5</pre>
<p><span class="emphasis"><em>Fedora / RedHat</em></span></p>
<pre class="screen"> #> yum install php mod_php</pre>
<p><span class="emphasis"><em>openSuSE / SLES:</em></span> Nutzen Sie yast zur Installation der Pakete <span class="emphasis"><em>php5</em></span> und
<span class="emphasis"><em>apache2-mod_php5</em></span>.</p>
<p>Stellen Sie sicher, dass Sie eine gute Datensicherung Ihrer bestehenden Nagios-Installation und der Konfigurationsdateien
haben. Wenn irgendetwas schief geht oder nicht funktioniert, dann können Sie auf diese Weise schnell Ihre alte Nagios-Version
wiederherstellen.</p>
<p>Werden Sie der nagios-Benutzer. Debian/Ubuntu-Benutzer sollten <span class="emphasis"><em>sudo -s nagios</em></span> benutzen.</p>
<pre class="screen"> $ su -l nagios</pre>
<p>Holen Sie sich das Quellcode-Archiv der letzten Icinga-Version (besuchen Sie <a class="link" href="http://www.icinga.org//" target="_top">http://www.icinga.org/</a> für den Verweis auf die letzte Version).</p>
<pre class="screen"> #> wget http://osdn.dl.sourceforge.net/sourceforge/icinga/icinga-<span class="emphasis"><em>1.0.2</em></span>.tar.gz</pre>
<p>Entpacken Sie das Quellcode-Archiv.</p>
<pre class="screen"> #> tar xzf icinga-<span class="emphasis"><em>1.0.2</em></span>.tar.gz
#> cd icinga-<span class="emphasis"><em>1.0.2</em></span> </pre>
<p>Starten Sie das Icinga-configure-Script mit den Optionen, die Sie beim ./configure von Nagios benutzt haben. Den
Aufruf finden Sie in der Datei config.log. Beispiel:</p>
<pre class="screen"> #> ./configure --with-command-group=nagcmd</pre>
<p>Kompilieren Sie den Icinga-Quellcode.</p>
<pre class="screen"> #> make all</pre>
<p>Installieren Sie aktualisierte Programme, Dokumentation, Web-Interface und das Init-Script. Ihre vorhandenen Konfigurationsdaten
werden in diesem Schritt nicht überschrieben.</p>
<pre class="screen"> #> make install
#> make install-init</pre>
<p>Kopieren Sie Ihre Konfigurationsdateien nach /usr/local/icinga/etc bzw. /usr/local/icinga/etc/object. Benennen Sie die
Hauptkonfigurationsdatei <span class="emphasis"><em>nagios.cfg</em></span> in <span class="emphasis"><em>icinga.cfg</em></span> um und ändern Sie in /usr/local/icinga/etc/icinga.cfg die
Namen der Direktiven "nagios_user" in "icinga_user" und "nagios_group" in "icinga_group". Das betrifft ggf. auch die Pfade in der Datei.</p>
<pre class="programlisting"> #> sed -i 's/nagios/icinga/g' ./icinga.cfg/</pre>
<p>Ändern Sie in der CGI-Konfigurationsdatei <span class="emphasis"><em>cgi.cfg</em></span> die Pfad-Angaben.</p>
<pre class="programlisting"> #> sed -i 's/nagios/icinga/g' ./cgi.cfg/</pre>
<p>Überprüfen Sie Ihre Konfigurationsdateien und starten Sie Icinga.</p>
<pre class="screen"> #> /usr/local/icinga/bin/icinga -v /usr/local/icinga/etc/icinga.cfg
#> /etc/init.d/icinga start</pre>
<p>Das war's - Sie sind fertig!</p>
<p><a name="upgrading-nagios2x"></a> <span class="bold"><strong>Upgrade von Nagios 2.x</strong></span></p>
<p>Es sollte nicht allzu schwierig sein, von Nagios 2.x auf Icinga 1.0.2 zu aktualisieren. Die Aktualisierung ist
im Wesentlichen die gleiche wie die von bestehenden Nagios 3.x-Versionen. Allerdings müssen Sie Ihre Konfigurationsdateien ein
wenig ändern, damit sie mit Icinga 1.0.2 funktionieren:</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<p>Die alte <span class="emphasis"><em>service_reaper_frequency</em></span>-Variable in der Hauptkonfigurationsdatei wurde umbenannt in <a class="link" href="configmain.html#configmain-check_result_reaper_frequency">check_result_reaper_frequency</a>.</p>
</li>
<li class="listitem">
<p>Das alte <span class="emphasis"><em>$NOTIFICATIONNUMBER$</em></span>-Makro entfällt zugunsten der <a class="link" href="macrolist.html#macrolist-hostnotificationnumber">$HOSTNOTIFICATIONNUMBER$</a>- und <a class="link" href="macrolist.html#macrolist-servicenotificationnumber">$SERVICENOTIFICATIONNUMBER$</a>-Makros.</p>
</li>
<li class="listitem">
<p>Die alte <span class="emphasis"><em>parallelize</em></span>-Direktive in Service-Definitionen ist veraltet und wird nicht länger benutzt, weil
alle Service-Prüfungen parallel ablaufen.</p>
</li>
<li class="listitem">
<p>Die alte <span class="emphasis"><em>aggregate_status_updates</em></span>-Option wurde entfernt. Alle Statusdatei-Aktualisierungen werden nun mit
einem minimalen Intervall von einer Sekunde zusammengefasst.</p>
</li>
<li class="listitem">
<p>Erweiterte Host- und erweiterte Service-Definitionen sind veraltet. Sie werden noch von Icinga gelesen und verarbeitet,
aber es wird empfohlen, dass Sie diese Direktiven in die entsprechenden Host- und Service-Definitionen verschieben.</p>
</li>
<li class="listitem">
<p>Die alte <span class="emphasis"><em>downtime_file</em></span>-Dateivariable in der Hauptkonfigurationsdatei wird nicht länger unterstützt, weil
Einträge von geplanten Ausfallzeiten (downtimes) nun in der <a class="link" href="configmain.html#configmain-state_retention_file">Aufbewahrungsdatei</a>
(retention file) gespeichert werden. Um bestehende Einträge zu erhalten, stoppen Sie Nagios 2.x und hängen Sie den Inhalt Ihrer
alten Downtime-Datei an das "retention file".</p>
</li>
<li class="listitem">
<p>Die alte <span class="emphasis"><em>comment_file</em></span>-Dateivariable in der Hauptkonfigurationsdatei wird nicht länger unterstützt, weil
Kommentare nun in der <a class="link" href="configmain.html#configmain-state_retention_file">Aufbewahrungsdatei</a> (retention file) gespeichert werden.
Um bestehende Einträge zu erhalten, stoppen Sie Nagios 2.x und hängen Sie den Inhalt Ihrer alten Kommentar-Datei an die
"Aufbewahrungsdatei" (retention file).</p>
</li>
<li class="listitem">
<p>Die Hauptkonfigurationsdatei heißt nun icinga.cfg. Innerhalb der Datei ist "nagios_user" gegen "icinga_user" und nagios_group"
gegen "icinga_group" auszutauschen.</p>
</li>
</ul></div>
<p>Stellen Sie außerdem sicher, dass Sie den "<a class="link" href="whatsnew.html" title="Was gibt es Neues in Icinga Core 1.0.2 und Icinga Web 1.0.1">Was gibt's Neues</a>"-Abschnitt in der Dokumentation lesen.
Er beschreibt all die Änderungen am Icinga-Code.</p>
<p><a name="upgrading-rpm"></a> <span class="bold"><strong>Aktualisierung einer RPM-Installation</strong></span></p>
<p>Wenn Sie momentan eine RPM- oder Debian/Ubuntu-APT-paketbasierte Nagios-Installation haben und nun den Übergang
zu einer Installation aus dem offiziellen Quellcode machen wollen, dann sind hier die grundlegenden Schritte:</p>
<div class="orderedlist"><ol class="orderedlist" type="1">
<li class="listitem">
<p>Sichern Sie Ihre existierende Nagios-Installation</p>
</li>
<li class="listitem">
<p>Konfigurationsdateien</p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc">
<li class="listitem">
<div class="itemizedlist"><ul class="itemizedlist" type="circle">
<li class="listitem">
<p>Hauptkonfigurationsdatei (normalerweise <span class="emphasis"><em>nagios.cfg</em></span>)</p>
</li>
<li class="listitem">
<p>Ressource-Konfigurationsdatei (normalerweise <span class="emphasis"><em>resource.cfg</em></span>)</p>
</li>
<li class="listitem">
<p>CGI-Konfigurationsdatei (normalerweise <span class="emphasis"><em>cgi.cfg</em></span>)</p>
</li>
<li class="listitem">
<p>all Ihre Objektdefinitionsdateien</p>
</li>
</ul></div>
</li>
<li class="listitem">
<p>Aufbewahrungsdatei (normalerweise <span class="emphasis"><em>retention.dat</em></span>)</p>
</li>
<li class="listitem">
<p>die aktuelle Nagios-Protokolldatei (normalerweise <span class="emphasis"><em>nagios.log</em></span>)</p>
</li>
<li class="listitem">
<p>archivierte Nagios-Protokolldateien</p>
</li>
</ul></div>
</li>
<li class="listitem">
<p>Deinstallieren Sie die originalen RPM- oder APT-Pakete</p>
</li>
<li class="listitem">
<p>Installieren Sie Icinga aus dem Quellcode, indem Sie der <a class="link" href="quickstart.html" title="Schnellstart-Installationsanleitungen">Schnellstartanleitung</a>
folgen</p>
</li>
<li class="listitem">
<p>Sichern Sie Ihre Original-Nagios-Konfigurationsdateien, Aufbewahrungs- und Protokolldateien wieder zurück</p>
</li>
<li class="listitem">
<p>Benennen Sie die Hauptkonfigurationsdatei <span class="emphasis"><em>nagios.conf</em></span> in <span class="emphasis"><em>icinga.conf</em></span> um und ändern Sie
in /usr/local/icinga/etc/icinga.cfg die Namen der Direktiven "nagios_user" in "icinga_user" und "nagios_group" in "icinga_group".</p>
</li>
<li class="listitem">
<p><a class="link" href="verifyconfig.html" title="Überprüfen Ihrer Icinga-Konfiguration">Überprüfen</a> Sie Ihre Konfiguration und <a class="link" href="startstop.html" title="Icinga starten und stoppen">starten</a> Sie
Icinga</p>
</li>
</ol></div>
<p>Beachten Sie, dass verschiedene RPM- oder APT-Pakete Nagios auf verschiedene Weisen oder an verschiedenen Orten installieren.
Stellen Sie sicher, dass Sie all Ihre kritischen Nagios-Dateien gesichert haben, bevor Sie das Original-RPM- oder APT-Paket
entfernen, so dass Sie darauf zurückgreifen können, wenn Sie auf Probleme stoßen.</p>
<a class="indexterm" name="id5527108"></a>
<a class="indexterm" name="id5527138"></a>
<a class="indexterm" name="id5527152"></a>
<a class="indexterm" name="id5527164"></a>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="quickstart-idoutils.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_idoutils.html">Weiter</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">Icinga-Schnellstart mit IDOUtils </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td>
<td width="40%" align="right" valign="top"> IDOUtils-Datenbank aktualisieren</td>
</tr>
</table>
</div>
<P class="copyright">© 2009-2010 Icinga Development Team, http://www.icinga.org</P>
</body>
</html>
|
