TURNKEYGNU / LINUX
Deutsch

Dokumentation

Observatorium

Diese Dokumentationsseite enthält Informationen im Zusammenhang mit dem TurnKey Linux Observium ApplianceDie aktuelle Version dieses Dokuments wurde speziell mit TurnKey Version 18.x geschrieben, sollte aber mit neueren Versionen kompatibel bleiben.

Bitte geben Sie Feedback und/oder Probleme bezüglich dieser Dokumentseite über die TurnKey Foren (erfordert kostenloses TurnKey Lnux Website Benutzerkonto) Alternativ können Dokumentationsfehler über unsere gemeldet werden konsolidierter TurnKey Linux Issue Tracker.

Bekanntes Problem: "Gerät kann nicht manuell über das Web hinzugefügt werden, konnte nicht ping <hostname>"

Wie bereits erwähnt, auf der TurnKey Linux konsolidiert Issue Tracker, kann dieses Problem gelöst werden, wenn gewünscht, aber wie auch erwähnt (in einem Kommentar In der Ausgabe empfehlen die Upstream-Observium-Dokumente, dass Sie das wegen der Sicherheitsbedenken nicht tun; und stattdessen das CLI verwenden, um Geräte hinzuzufügen.

Aktualisierung des Observiums

Alle diese Update-Anweisungen basieren auf dem offiziellen Obervium Update DokumentationHier sind zusätzliche Einzelheiten zu den TurnKey Observium Appliance. Unabhängig davon können Sie auch die offizielle Dokumentationsseite konsultieren - insbesondere wenn Sie Upgrade auf eine Subscription Edition.

Inhalt:

Bevor Sie anfangen: Backup!

Ein automatisiertes Backup-Regime (z. B. unter Verwendung von Daten) TKLBAMDer Verlust von Systemdaten ist immer eine Frage des Wann, nicht des Wenn. Der Observium-Upgrade-Prozess wird voraussichtlich reibungslos verlaufen, so dass ein aktuelles Backup ein ausreichender Verstand sein kann. Unabhängig davon wird ein manuelles Backup unmittelbar vor einem Software-Upgrade immer empfohlen.

Der (die) unten dokumentierte(n) Observium-Upgrade-Prozess(e) bewahrt eine Kopie Ihrer alten Observium-Dateien auf, jedoch keine Kopie Ihrer ursprünglichen Datenbank. Ohne ein richtiges Backup können Sie möglicherweise nicht auf eine frühere Version zurückgreifen, wenn etwas schief geht. Das einzige Szenario, in dem ein Backup nicht so wichtig ist, ist, wenn Sie gerade erst Ihren Observium-Server eingestellt haben und keine vorhandenen Daten haben. Selbst dann kann ein Backup Ihnen immer noch Zeit sparen, wenn etwas schief geht und Sie zurückrollen müssen.

Eine wichtige Anmerkung für AWS Marketplace-Benutzer

Die meisten TurnKey-Server verwenden standardmäßig den "root"-Benutzer. Wenn Sie das sind, lesen Sie weiter. Für diejenigen, die TurnKey verwenden, das vom AWS Marketplace gestartet wurde, ist es standardmäßig ein "admin"-Benutzer. Du musst also zum "root"-Benutzer wechseln, bevor diese Anweisungen funktionieren. Du könntest jedem Befehl "sudo" voranstellen, aber das ist ein Schmerz. Stattdessen empfehle ich, den "root"-Benutzer für diesen Prozess zu entziehen.

sudo su -

Wenn Sie fertig sind, wechseln Sie zum "Admin" -Benutzer zurück, indem Sie den Befehl "Exit" ausgeben.

Aktualisieren des Observium CE mit Update-Skript

Backup Ihres Systems

Führen Sie ein Handbuch Backup wie oben erwähnt.

Aktualisieren über das Skript 'turnkey-update-observium' - inkludiert im TurnKey Observium Appliance

Dieses Skript automatisiert die manuellen Update-Anweisungen und erstellt ein lokales Backup der Observium-Dateien (/opt/observium).) Das Skript ist in BASH geschrieben und die Quelle der Version, die mit Ihrem Server enthalten ist, kann unter /usr/local/bin/turnkey-update-observium oder dem Neueste Quellcode auf GitHub.

Um das Skript aus dem CLI auszuführen:

turnkey-update-observium

Bis heute gab es nur begrenztes Feedback zu diesem Update-Skript, obwohl es keine Berichte über Fehler oder Probleme gab. Aufgrund der begrenzten Rückmeldung beim Ausführen des Skripts meldet es jedoch, dass es "experimentell" ist, obwohl es dennoch zuverlässig funktionieren sollte (siehe unten). Wie bei jedem Update oder signifikanten Konfigurationsänderungen wird immer empfohlen, ein Backup zu haben (z.B. TKLBAM) für den Fall, dass etwas schief geht.

Wie bereits beim Ausführen des Skripts erwähnt:

Beachten Sie, dass dieses Skript die aktuelle Version von Daten überprüft, die zur TurnKey Appliance-Buildzeit erstellt wurden. Wenn Observium über eine alternative Methode aktualisiert wurde (oder die Datei nicht existiert), wird es immer auf das neueste Observium CE (Community Edition) heruntergeladen und "aktualisiert". Dies wird auch dann der Fall sein, wenn Sie bereits die neueste CE-Version verwenden; oder über einen alternativen Kanal installiert haben!

Manuelle Aktualisierung des Observium CE

Diese Anweisungen basieren auf der Offizielles Observium CE update docs - mit einigen zusätzlichen Details speziell in Bezug auf die TurnKey Linux Observium ApplianceAlle Befehle sollten von der Kommandozeile als Root-Benutzer ausgeführt werden.

Backup Ihres Systems

Führen Sie ein Handbuch Backup wie oben erwähnt.

Observium Cronjobs deaktivieren (fakultativ)

Cron-Jobs sind automatisierte Aufgaben, die nach einem Zeitplan laufen. cron-Jobs beziehen sich im Allgemeinen auf Observium "Haushaltung" . Das Deaktivieren der Cron-Jobs ist optional. Wenn Sie diesen Schritt jedoch nicht ausführen, werden möglicherweise einige Cron-Fehler in Ihren Protokollen vermerkt. wieder aktiviert sie nach dem Update (Cron-Jobs, die später in diesen Anweisungen behandelt werden, neu ausrichten).

So deaktivieren Sie Observium cron Jobs:

Bearbeiten Sie entweder manuell die Cron-Datei - /etc/cron.d/observium - und kommentieren Sie alle aktiven Cron-Zeilen, d.h. fügen Sie jeder Zeile, die nicht bereits mit einem "#" beginnt, ein "#"-Zeichen hinzu. Wenn Sie mit diesem Prozess nicht vertraut sind, wird empfohlen, dass Sie jeder Zeile ein "#" hinzufügen (damit allen vorhandenen Kommentaren "##" vorangestellt wird).

Alternativ führen Sie den Befehl sed direkt unten aus der Kommandozeile aus. Bitte beachten Sie, dass dieser Befehl jeder Zeile in der cron-Datei ein '#' hinzufügt (wie oben angegeben). NOT Wenn Sie es tun, müssen Sie die Cron-Datei manuell bearbeiten, um die Cron-Zeilen zu dekommentieren und die eigentlichen Kommentare mit einem "#" -Präfix zu hinterlassen.

sed -i "s|^|#|" /etc/cron.d/observium

Ersetzen Sie alte Dateien durch die neue Version

Die folgenden Befehle verschieben die aktuellen Observium-Dateien aus dem Weg, laden die neueste Version herunter und kopieren dann die erforderlichen Dateien (Config-Datei und rdd & logs-Verzeichnisse) zurück. von Ihrer ursprünglichen Observium-Installation.

Führen Sie die folgenden Befehle aus (als root):

cd /opt
mv observium observium_old
wget -Oobservium-community-latest.tar.gz https://www.observium.org/observium-community-latest.tar.gz
tar zxvf observium-community-latest.tar.gz
mv /opt/observium_old/rrd observium/
mv /opt/observium_old/logs observium/
mv /opt/observium_old/config.php observium/

DB-Schema aktualisieren

Aktualisieren Sie das DB-Schema für die neue Version:

/opt/observium/discovery.php -u

Wiederentdeckung von Gewalt (fakultativ)

Wenn es eine sehr lange Zeit her ist, seit Sie aktualisiert haben (12 Monate oder mehr), möchten Sie möglicherweise eine sofortige Wiederentdeckung aller Geräte erzwingen, um sicherzustellen, dass die Dinge auf dem neuesten Stand sind:

/opt/observium/discovery.php -h all

Re-enable Observium Cronjobs (optional)

Cron-Jobs erneut aktivieren ist nur erforderlich, wenn Sie sie vor dem Observium-Update deaktiviert haben. NOT Gehe lieber direkt zum nächsten Abschnitt.

Um die Cron-Jobs manuell wieder zu aktivieren, kehren Sie den Vorgang um, der im Abschnitt "Cron-Jobs deaktivieren" oben durchgeführt wurde. Dekommentieren Sie die cron-Befehlszeilen in der Observium cron-Datei - /etc/cron.d/observium .

Wenn Sie die Cron-Jobs über die oben genannte sed-Linie deaktiviert haben - im Abschnitt Cron-Jobs deaktivieren oben, können Sie sie mit der unten angegebenen sed-Linie wieder aktivieren. Es wird das (erste) führende "#" -Zeichen aus jeder Zeile entfernen. NOT Dies tun, es sei denn, Sie haben den vorherigen Befehl sed verwendet, um die Cron-Jobs zu deaktivieren. NOT Wenn Sie es tun, dann müssen Sie die Cron-Datei manuell bearbeiten, um die absichtlichen Kommentarzeilen im Cron-Job zu kommentieren (fügen Sie ein führendes '#' hinzu).

sed -i "s|^#||" /etc/cron.d/observium

Endgültige Bereinigung (fakultativ)

Sobald Sie bestätigt haben, dass das Update wie erwartet funktioniert hat, können Sie nun die alten Observium-Dateien löschen, die im oben genannten Dateiaktualisierungsprozess erstellt wurden. Entfernen des Verzeichnisses observium_old:

rm -rf /opt/observium_old

Aktualisieren des Observium CE auf Observium Pro/Enterprise Edition

Diese Anweisungen basieren auf der Observium CE -> Observium Pro docs - mit einigen zusätzlichen Details speziell in Bezug auf die TurnKey Linux Observium Appliance. Sie sind sowohl für Pro- als auch für Enterprise-Abonnements relevant. Alle Befehle sollten von der Kommandozeile als Root-Benutzer ausgeführt werden - so viele TurnKey-Benutzer sind gut zu gehen. AWS Marketplace-Benutzer müssen Wechseln Sie zum Root-Benutzer erstens:

sudo su -

Wie auf der entsprechenden Observium Doc Seite erwähnt:

Das Observium wurde mit einfacher Upgrade- und nahtloser Migration konzipiert, so dass Benutzer reibungslos von der Community Edition zum Professional oder Enterprise Edition.

Backup Ihres Systems

Führen Sie ein Handbuch Backup wie oben erwähnt.

Subversion installieren

Observium Subscription Editions liefern den ersten Installationscode und zukünftige Updates über das SVN (Subversion) Versionskontrollsystem. Das TurnKey Observium Appliance verfügt standardmäßig nicht über die erforderliche Subversionssoftware, kann aber über apt (als Root-Benutzer) einfach installiert werden:

apt update
apt install subversion

Observium Cron Jobs deaktivieren (empfohlen)

Cron-Jobs sind automatisierte Aufgaben, die nach einem Zeitplan laufen. Im Allgemeinen beziehen sich Cron-Jobs auf die "Haushaltung" von Observium, obwohl sie andere Funktionen enthalten. Das Deaktivieren der Cron-Jobs während des Upgrades wird empfohlen, obwohl es streng genommen optional ist. Jedoch Wenn der Observium Poller (ausgelöst durch einen Cron-Job) während des Code Checkout-Prozesses oder während des Verschiebens des rdd-Verzeichnisses ausgeführt wird, kann dies unbeabsichtigte Konsequenzen haben. Wenn Sie die Cron-Jobs deaktivieren, stellen Sie sicher, dass Sie auch wieder aktiviert Sie nach dem Update (das Wiederaktivieren von Cron-Jobs wird später in diesen Anweisungen behandelt).

So deaktivieren Sie Observium cron Jobs:

Bearbeiten Sie entweder manuell die Cron-Datei - /etc/cron.d/observium - und kommentieren Sie alle Cron-Jobzeilen, d.h. fügen Sie am Anfang jeder Cron-Jobzeile ein "#"-Zeichen hinzu. Es wird empfohlen, dass Sie zu jeder Zeile ein "#" hinzufügen. Das bedeutet, dass bereits vorhandene absichtliche Kommentare mit '##' vorangestellt werden und die Wiederermöglichung zuverlässiger und weniger anfällig für Fehler machen.

Alternativ können Sie den Befehl sed direkt unten über die Kommandozeile ausführen. Bitte beachten Sie, dass dieser Befehl jeder Zeile in der cron-Datei ein '#' hinzufügt (gemäß der Empfehlung in der manuellen Anleitung). Dieser Befehl sed ist nicht idempotent - was bedeutet, dass das erneute Ausführen dieses Skripts zusätzliche Änderungen verursacht. NOT Wenn Sie es tun, müssen Sie die Cron-Datei manuell reparieren / bearbeiten, um Cron-Jobs wieder zu aktivieren.

sed -i "s|^|#|" /etc/cron.d/observium

Migration zum SVN-Repository-Code - Ersetzen Sie alte Dateien durch die SVN-Version

Um zum SVN-Repository-zugestellten Code zu migrieren, müssen Sie eine neue Kopie des Codes auschecken und Ihr vorhandenes Verzeichnis config.php und rrd auf die neue Kopie übertragen.

Wenn Sie den rollenden Zug bevorzugen, ersetzen Sie Branchs/Stable im dritten Befehl durch Trunk. Siehe Observium Docs für mehr Details.

Während des untenstehenden Aktualisierungsprozesses werden Sie aufgefordert, einen Benutzernamen und ein Passwort zu erhalten. Observium Subscription Portal.

Die folgenden Befehle verschieben die aktuellen Observium-Dateien aus dem Weg, laden die neueste stabile Abonnementversion von Observium über die SVN-Version herunter und kopieren dann die erforderliche Dateien (Config-Datei und rdd & logs Verzeichnisse) aus der ursprünglichen Observium-Installation.

cd /opt
mv observium observium-old
svn co https://svn.observium.org/svn/observium/branches/stable observium
cp observium-old/config.php observium
mv observium-old/rrd observium-old/logs observium
cd observium
./discovery.php -u

Re-enable Observium cron jobs (empfohlen - erforderlich, wenn oben deaktiviert)

Cron-Jobs müssen neu aktiviert werden, wenn Sie sie vor dem Observium-Upgrade deaktiviert haben - wie empfohlen. NOT Gehe lieber direkt zum nächsten Abschnitt.

Um die Cron-Jobs manuell wieder zu aktivieren, kehren Sie den Vorgang um, der in den oben genannten Schritten zum Deaktivieren von Cron-Jobs durchgeführt wurde. Entfernen Sie das '#' vom Anfang jeder Zeile (außer den absichtlichen Kommentaren) in der Observium cron Datei - /etc/cron.d/observium .

Wenn Sie die Cron-Jobs über den Befehl sed deaktiviert haben, der in der oben genannten ersten Deaktivierung von Cron-Jobs angegeben wurde, können Sie sie mit der unten stehenden sed-Linie erneut aktivieren. Es wird das (erste) führende "#" -Zeichen aus jeder Zeile entfernen. NOT Dies tun nicht Sie haben den vorherigen Befehl sed benutzt, um die Cron-Jobs zu deaktivieren. So tun NOT Wenn Sie es tun, dann müssen Sie manuell bearbeiten / beheben Sie die cron-Datei, um zu folgen, dass die absichtlichen Kommentare mit '#' vorangestellt werden.

sed -i "s|^#||" /etc/cron.d/observium

Wenn es sein muss, ist die Standard TurnKey Observium cron Datei kann konsultiert werden, wenn Sie Ihre Cron-Datei reparieren müssen.

Endgültige Bereinigung (fakultativ)

Sobald Sie bestätigt haben, dass das Migrations-Upgrade wie erwartet funktioniert hat, können Sie nun die alten Observium-Dateien löschen, die im oben genannten Upgrade-Prozess erstellt wurden. Entfernen des Verzeichnisses observium_old:

rm -rf /opt/observium_old

Upgrade der Subscription Edition auf die neueste

Dieser Vorgang gilt nur, wenn Sie bereits ein Upgrade auf ein Observium durchgeführt haben Subscription Edition.

Backup Ihres Systems

Vor dem Starten führen Sie ein Handbuch Backup wie oben erwähnt.

Cron-Jobs deaktivieren (optional, aber empfohlen)

Observium Cron Jobs deaktivieren wie oben dokumentiert.

Update auf die neueste stabile Version

Die Aktualisierung der Abonnementeditionen von Observium mit SVN ist einfach.Um die Observium Subscription Edition auf die neueste stabile Version zu aktualisieren, verwenden Sie die folgenden Befehle:

cd /opt/observium
svn update
./discovery.php -u

Alternative/zusätzliche Observium Pro/Enterprise Upgrade-Optionen

Bitte beachten Sie, dass die Webapp-Software das Herabstufen auf eine frühere Version im Allgemeinen nicht unterstützt. Ich kann nicht bestätigen, dass das speziell für Observium gilt, aber wenn man sich an diese Faustregel hält, dann ist es weniger wahrscheinlich, dass man Probleme trifft. Backup wie oben erwähnt, wird immer empfohlen und als Best Practice betrachtet.

Observium Subscription Edition auf eine spezifische Revision aktualisieren

Anstatt auf den neuesten Stable zu aktualisieren, möchten Sie möglicherweise auf eine bestimmte Überarbeitung aktualisieren, d. H. An einem bestimmten Ort in der Stable-Release-Timeline. Das Upgrade des Observiums auf eine spezifische Revision ist dem Prozess und den Befehlen, die in der Aufrüstung Der Befehl 'svn update' wird jedoch mit '-r <revision number>' angehängt, d.h.:

svn update -r <revision number>

Nehmen wir zum Beispiel an, Sie möchten die Version 0.12.4.3049 installieren/upgradeen. Die SVN-Revision ist die letzte Nummer, also führen Sie Folgendes aus:

svn update -r 3049

Bitte sehen Sie sich das offizielle Observium Subscription Edition Upgrade Docs für weitere Optionen und Details.