Software-Update

SKOOR 9.0: Da SKOOR 9.0 PostgreSQL von 13 auf 17 aktualisiert, sind einige zusätzliche Schritte erforderlich, wie hier beschrieben.

SKOOR 8.1: Selenium Jobs mit Python müssen überprüft werden. Um ein Ressourcenleck zu vermeiden, wird die Operation driver.quit() in jedem Fall ausgeführt, wie hier beschrieben

Bitte befolgen Sie vor der Durchführung eines Updates sämtliche Anweisungen des SKOOR-Supports. Es kann zwingend erforderliche Vorbereitungsschritte geben, deren Missachtung zu Fehlern führen kann

Im Allgemeinen ist das Update bereits installierter SKOOR Engine- und/oder Kollektor-Pakete aus dem Repository sehr einfach:

Update des SKOOR-Repositorys

Dieser Schritt ist erforderlich, um die aktuellsten Repository-Konfigurationen zu erhalten.

dnf clean all
dnf update skoor-repo
dnf clean all

Update aller SKOOR-Komponenten

Wenn Sie nur auf das neueste Patch-Release einer bestimmten Major-Version (z. B. 8) aktualisieren möchten, verwenden Sie

dnf update "eranger-*-8.*"

Verwenden Sie andernfalls

dnf update "eranger-*"

Empfohlene Vorgehensweise

Die folgende Vorgehensweise kann als Checkliste für ein Standard-Update der Software verwendet werden:

  1. Überprüfen Sie die erforderlichen RPM-Repositories und Red-Hat-Subskriptionen

  2. Prüfen Sie, ob vollständige Backups und Konfigurations-Backups verfügbar sind. Es ist jedoch immer ratsam, vor einem Update ein vollständiges Backup zu erstellen

  3. Notieren Sie den Gesamtzustand des Systems oder erstellen Sie einen Screenshot der Statusleiste am unteren Rand der SKOOR Engine-Benutzeroberfläche

  4. Aktivieren Sie die Gesamtwartung für alle vom Update betroffenen Kollektoren (externe Kollektoren können unverändert bleiben oder später aktualisiert werden)

  5. Auf replizierten Systemen (Primary/Standby):

    1. Überprüfen Sie den Replikationsstatus und ergreifen Sie Maßnahmen, falls der Status nicht OK ist

    2. Stoppen Sie die Replikation

    3. Führen Sie das Update des Standby-Servers durch

  6. Führen Sie das Update des (Primary-)Servers durch

  7. Starten Sie die Replikation, falls sie nicht läuft

  8. Aktualisieren Sie externe Kollektoren, falls konfiguriert

  9. Aktualisieren Sie den Dashboard Viewer, falls konfiguriert

  10. Prüfen Sie auf neue Konfigurationsdateien mit der Endung .rpmnew und führen Sie den Inhalt bei Bedarf mit den Originaldateien zusammen
    Dies kann durchgeführt werden mit:
    rpmconf -a

  11. Überprüfung

    1. Der Gesamtzustand des Systems ist derselbe wie zuvor oder Unterschiede können erklärt werden

    2. Die Replikation funktioniert wie zuvor

    3. Dashboards / Dashboard Viewer sind erreichbar

    4. Alarme werden gesendet (E-Mail, SMS usw.)

  12. Beenden Sie die Wartung

  13. Erstellen Sie ein neues vollständiges Backup

Vorsichtsmaßnahmen

Die folgenden Informationen gelten für eine Standard-SKOOR-Installation. Angepasste Setups müssen berücksichtigt werden

Standardpfad zu Backups:

/opt/eranger/server/backups

Vollständiges Backup ausführen:

cd /var/lib/pgsql
sudo -u postgres /opt/eranger/bin/eranger-server-backup.sh full

Gesamtwartung für alle vom Update betroffenen Kollektoren in /root /Collectors aktivieren

Replikationsstatus prüfen und Standby stoppen:

/opt/eranger/bin/eranger-server-replication.pl status
<standby-ip>
<standby-ip> checking ssh for user reranger
<primary-ip> is running
Last read on master(<primary-ip>) 0 seconds ago
/opt/eranger/bin/eranger-server-replication.pl stopstandby

GPG-Fingerabdrücke:

RPM-GPG-KEY-SKOOR:

0C18 95B8 11D4 71E5 D043 EFA3 69E1 147C 2CB4 0F3A

RPM-GPG-KEY-PGDG:

68c9 e2b9 1a37 d136 fe74 d176 1f16 d2e1 442d f0f8

RPM-GPG-KEY-TIMESCALEDB:

1005 fb68 604c e9b8 f687 9cf7 59f1 8edf 47f2 4417

Update auf SKOOR 9.0

Bitte stellen Sie sicher, dass es innerhalb von /var/lib/pgsql/13/data keine Links zu Speicherorten außerhalb von /var/lib/pgsql gibt, da dies beim Upgrade zu Problemen führen kann. Stellen Sie außerdem sicher, dass sich innerhalb von /var/lib/pgsql keine Mountpoints zu anderen Geräten befinden.

  • Eine aktualisierte Version von skoor-repo (9.0) ist erforderlich.
    Installieren Sie sie mit:

    dnf clean all
    dnf update skoor-repo
  • Falls eine Replikation eingerichtet ist, muss die Replikation vor der Durchführung des Upgrades gestoppt werden

    /opt/eranger/bin/eranger-server-replication.pl stopstandby

Aktualisieren Sie zuerst den Standby (ohne das Skript update-postgresql auszuführen), aktualisieren Sie dann den Primary und führen Sie ein createstandby aus.

  • Das Update muss als vollständiges Update durchgeführt werden, nicht nur mit dnf update “eranger-*” oder Ähnlichem.

    dnf clean all
    dnf update
  • Führen Sie nach dnf update den Befehl /opt/eranger/database-utils/bin/upgrade-postgresql aus.

    /opt/eranger/database-utils/bin/upgrade-postgresql

Dadurch wird der PostgreSQL-13-Cluster auf einen PostgreSQL-17-Cluster aktualisiert.

  • Nach /opt/eranger/database-utils/bin/upgrade-postgresql muss der neue Cluster analysiert werden mit

    su postgres -c "/usr/pgsql-17/bin/vacuumdb --all --analyze-in-stages"

Dieser Schritt ist sehr wichtig. Überspringen Sie ihn nicht. Das System kann bereits während der Ausführung verwendet werden.

  • Wenn alles wie erwartet funktioniert, kann der alte Cluster entfernt werden mit

     /var/lib/pgsql/delete_old_cluster.sh

Update auf SKOOR 8.1

Selenium Jobs müssen angepasst werden, wenn Python-Skripte verwendet werden. Es ist wichtig, dass die Operation driver.quit() in jedem Fall ausgeführt wird. Andernfalls kommt es zu einem Ressourcenleck!

Ein neues RPM-Paket eranger-python wird mit diesem Release hauptsächlich für Skripte im SKOOR Studio ausgeliefert. Es wird empfohlen, diese Python-Umgebung auch für Legacy-Import-Skripte zu verwenden.

Update auf SKOOR 7.2

Jeder SKOOR Kollektor verwendet mindestens ein Verzeichnis zur Speicherung temporärer Messdateien. Mit SKOOR 7.2 werden alle temporären Kollektor-Verzeichnisse regelmäßig bereinigt:

  • Dateien, die älter als 72 Stunden sind, werden gelöscht

  • Leere Verzeichnisse, die älter als 24 Stunden sind, werden gelöscht

Da der Kollektor nach jedem Job-Lauf alle Messdaten an den Server sendet, besteht kein Grund, diese Dateien länger im Verzeichnis für temporäre Dateien aufzubewahren. Wenn jedoch Dateien wie Skripte oder andere persistente Daten in einem dieser Verzeichnisse erstellt wurden, müssen diese vor dem Upgrade auf 7.2 an einen anderen Speicherort verschoben werden.

Verwenden Sie den folgenden Befehl, um eine Liste der temporären Verzeichnisse eines Kollektors zu erhalten (auszuführen sowohl auf dem lokalen als auch auf allen externen Kollektoren):

grep -oP "server\\d+_fetch_parse_dir\\s*=\\s*/var/opt/run/eranger/collector/.+" /etc/opt/eranger/eranger-collector.cfg | perl -pe 's/server\d+_fetch_parse_dir\s*=\s*//g'

Bitte stellen Sie sicher, dass alle Dateien in diesen Verzeichnissen bedenkenlos bereinigt werden können.

Update auf SKOOR 7.0

Das RPM-Paket sdaas-webservice wurde durch das neue Paket eranger-etl ersetzt, das ebenfalls im SKOOR-RPM-Repository verfügbar ist.

Bitte installieren Sie eranger-etl nach dem Upgrade auf Version 7.0 (das Entfernen von sdaas-webservice muss zugelassen werden, um einen Konflikt zu vermeiden):

yum remove sdaas-webservice && yum install eranger-etl