Inhalt
Aktualisierung einer RPM-Installation
Sobald neuere Alpha-, Beta- oder stabile 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. Hier der Aktualisierungsprozess...
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.
Werden Sie der icinga-Benutzer. Debian/Ubuntu-Benutzer sollten sudo -s icinga benutzen.
su -l icinga
Holen Sie sich das Quellcode-Archiv der letzten Icinga-Version (besuchen Sie http://www.icinga.org/ für den Verweis auf die letzte Version).
wget http://osdn.dl.sourceforge.net/sourceforge/icinga/icinga-1.0.tar.gz
Entpacken Sie das Quellcode-Archiv.
tar xzf icinga-1.0.tar.gz cd icinga-1.0
Starten Sie das Icinga-configure-Script mit den gleichen Optionen wie bei der letzten Installation, z.B. so:
./configure --with-command-group=nagcmd
Kompilieren Sie den Icinga-Quellcode.
make all
Installieren Sie aktualisierte Programme, Dokumentation und Web-Interface. Ihre vorhandenen Konfigurationsdaten werden in diesem Schritt nicht überschrieben.
make install
Überprüfen Sie Ihre Konfigurationsdateien und starten Sie Icinga erneut.
/usr/local/icinga/bin/icinga -v /usr/local/icinga/etc/icinga.cfg /etc/init.d/icinga restart
Das war's - Sie sind fertig!
Icinga ist aus Nagios 3.x hervorgegangen, so dass die Aktualisierung problemlos sein sollte.
Falls Sie einen Upgrade von Nagios-Version 3.0.x durchführen, dann fehlt Ihnen ggf. PHP.
Debian / Ubuntu
apt-get install php5 libapache2-mod-php5
Fedora / RedHat
yum install php mod_php
openSuSE / SLES: Nutzen Sie yast zur Installation der Pakete php5 und apache2-mod_php5.
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.
Werden Sie der nagios-Benutzer. Debian/Ubuntu-Benutzer sollten sudo -s nagios benutzen.
su -l nagios
Holen Sie sich das Quellcode-Archiv der letzten Icinga-Version (besuchen Sie http://www.icinga.org/ für den Verweis auf die letzte Version).
wget http://osdn.dl.sourceforge.net/sourceforge/icinga/icinga-1.0.tar.gz
Entpacken Sie das Quellcode-Archiv.
tar xzf icinga-1.0.tar.gz cd icinga-1.0
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:
./configure --with-command-group=nagcmd
Kompilieren Sie den Icinga-Quellcode.
make all
Installieren Sie aktualisierte Programme, Dokumentation, Web-Interface und das Init-Script. Ihre vorhandenen Konfigurationsdaten werden in diesem Schritt nicht überschrieben.
make install make install-init
Kopieren Sie Ihre Konfigurationsdateien nach /usr/local/icinga/etc bzw. /usr/local/icinga/etc/object. Benennen Sie die Hauptkonfigurationsdatei nagios.conf in icinga.conf 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".
Überprüfen Sie Ihre Konfigurationsdateien und starten Sie Icinga.
/usr/local/icinga/bin/icinga -v /usr/local/icinga/etc/icinga.cfg /etc/init.d/icinga start
Das war's - Sie sind fertig!
Es sollte nicht allzu schwierig sein, von Nagios 2.x auf Icinga 1.0 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 funktionieren:
Die alte service_reaper_frequency-Variable in der Hauptkonfigurationsdatei wurde umbenannt in check_result_reaper_frequency.
Das alte $NOTIFICATIONNUMBER$-Makro entfällt zugunsten der $HOSTNOTIFICATIONNUMBER$- und $SERVICENOTIFICATIONNUMBER$-Makros.
Die alte parallelize-Direktive in Service-Definitionen ist veraltet und wird nicht länger benutzt, weil alle Service-Prüfungen parallel ablaufen.
Die alte aggregate_status_updates-Option wurde entfernt. Alle Statusdatei-Aktualisierungen werden nun mit einem minimalen Intervall von einer Sekunde zusammengefasst.
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.
Die alte downtime_file-Dateivariable in der Hauptkonfigurationsdatei wird nicht länger unterstützt, weil Einträge von geplanten Ausfallzeiten (downtimes) nun in der Aufbewahrungsdatei (retention file) gespeichert werden. Um bestehende Einträge zu erhalten, stoppen Sie Icinga 2.x und hängen Sie den Inhalt Ihrer alten Downtime-Datei an das "retention file".
Die alte comment_file-Dateivariable in der Hauptkonfigurationsdatei wird nicht länger unterstützt, weil Kommentare nun in der Aufbewahrungsdatei (retention file) gespeichert werden. Um bestehende Einträge zu erhalten, stoppen Sie Icinga 2.x und hängen Sie den Inhalt Ihrer alten Kommentar-Datei an die "Aufbewahrungsdatei" (retention file).
Die Hauptkonfigurationsdatei heißt nun icinga.cfg. Innerhalb der Datei ist "nagios_user" gegen "icinga_user" und nagios_group" gegen "icinga_group" auszutauschen.
Stellen Sie außerdem sicher, dass Sie den "Was gibt's Neues"-Abschnitt in der Dokumentation lesen. Er beschreibt all die Änderungen am Icinga-Code.
Aktualisierung einer RPM-Installation
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:
Sichern Sie Ihre existierende Nagios-Installation
Konfigurationsdateien
Hauptkonfigurationsdatei (normalerweise nagios.cfg)
Ressource-Konfigurationsdatei (normalerweise resource.cfg)
CGI-Konfigurationsdatei (normalerweise cgi.cfg)
all Ihre Objektdefinitionsdateien
Aufbewahrungsdatei (normalerweise retention.dat)
die aktuelle Nagios-Protokolldatei (normalerweise nagios.log)
archivierte Nagios-Protokolldateien
Deinstallieren Sie die originalen RPM- oder APT-Pakete
Installieren Sie Icinga aus dem Quellcode, indem Sie der Schnellstartanleitung folgen
Sichern Sie Ihre Original-Nagios-Konfigurationsdateien, Aufbewahrungs- und Protokolldateien wieder zurück
Benennen Sie die Hauptkonfigurationsdatei nagios.conf in icinga.conf 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".
Überprüfen Sie Ihre Konfiguration und starten Sie Icinga
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.
© 2009 Icinga Development Team, http://www.icinga.org