# NagVis Update-Hinweise

Wichtigste Regel: machen Sie immer ein Backup, bevor Sie eine existierende Installation aktualisieren.
Es gibt mehrere Fälle der Aktualisierung:

1. Aktualisierung einer sehr alten Hauptversion (1.1x, 1.2x, 1.3.x)
2. Aktualisierung der letzten Hauptversion (1.4x)
3. Aktualisierung der Sub-Version (1.5x auf 1.5x)

## Aktualisierung von NagVis 1.3 oder darunter

Es gab viele Änderungen an der inneren Struktur von NagVis und den Konfigurationswerten. Der beste Weg zur Aktualisierung auf die neueste NagVis-Version ist, die neue Version als Neuinstallation aufzusetzen und Ihre Maps/Icons/Konfigurationen usw. manuell zu migrieren.
Sie sollten einen Blick auf die folgenden Stellen werfen:

- Maps (etc/maps)
kopieren Sie einfach alle Map-Konfigurationsdateien

- Hintergrundbilder (nagvis/images/maps)
kopieren Sie einfach alle Hintergrundbilder

- Iconsets (nagvis/images/iconsets)
kopieren Sie einfach alles, was nicht "std_*" heißt

- Shapes (nagvis/images/shapes)
kopieren Sie einfach alles

- Templates (nagvis/templates/hover und nagvis/images/templates/header)
kopieren Sie einfach Ihre eigenen Templates. Achtung: Überschreiben Sie nicht die Default-Templates. Möglicherweise müssen Sie Ihre vor-1.3-Templates aktualisieren. Mehr Informationen finden Sie auf der Template download-Seite.

- Template-Bilder (nagvis/images/templates/hover und nagvis/images/templates/header)
kopieren Sie einfach alles.

- Hauptkonfiguration (etc/nagvis.inc.php)
Sie sollten diese Datei nicht kopieren. Der beste Weg ist, die Beispieldatei der neuen NagVis-Version nach etc/nagvis.inc.php zu kopieren und die Werte Ihrer alten Installation manuell in die neue Datei zu migrieren.

## Aktualisierung von NagVis 1.4x

Von NagVis 1.4x nach 1.5x wurde eine Menge an der Verzeichnisstruktur geändert. Das mitgelieferte Installations-Script kann NagVis 1.4x/1.5x auf das letzte 1.5x-Release aktualisieren. Daher wird empfohlen, dieses Script (`install.sh`) zur Aktualisierung zu nutzen.

Die Berechtigungskonfiguration hat sich in NagVis 1.5 geändert. Deshalb entfernt das Installationsscript die Direktiven allowed_for_config und allowed_users aus den Map-Konfigurationsdateien. Die Berechtigungen werden nicht automatisch in die Berechtigungsdatenbank geladen, sondern in die nagvis/etc/auth-backup-Datei geschrieben. Mit diesen Informationen können Sie die Berechtigungen für die Maps im neuen rollenbasierten Berechtigungssystem vergeben.

Es ist auch möglich, den Update von 1.4x auf 1.5x manuell durchzuführen, aber das wurde bisher weder getestet noch dokumentiert. Generell sollte es so funktionieren wie oben beschrieben (also kopieren der eigenen Dateien an die neuen Stellen und anpassen der nagvis.ini.php, nicht kopieren).
Wenn Sie also die Installation selbst erledigen möchten, dann werden Sie etwas probieren müssen. Bitte leiten Sie dann Ihre Erfahrungen an uns weiter, damit wir diese Dokumentation erweitern können.

## Aktualisierung von NagVis 1.5x

Solange Sie in Ihrer Installation nichts am NagVis-Code geändert haben, können Sie einfach den Inhalt des neuen Packages in die bestehende Installation kopieren.
Die Konfigurationsdateien werden durch die Packages nicht ersetzt.
Überprüfen Sie nach der Aktualisierung die Berechtigungen