Zum Hauptinhalt springen

Installations-Routine

Auf unterstützten Betriebssytemen wird die Installation von SNAG-View 4 über eine Setup-Routine durchgeführt. Die Setup-Routine wird durch den Aufruf von ./setup.sh gestartet. Für mehr Informationen über den Setup-Prozess kann der Parameter -v / --verbose verwendet werden.

Folgende Zeichen dürfen nicht für Kennwörter beim Durchführen der Installation über die Setup-Routine nicht verwendet werden:

  • "
  • !
  • %

Nach Abschluss der Installation können alle Kennwörter geändert werden. Es sind jedoch mögliche Einschränkungen für Kennwörter, z.B. bei Mariadb zu beachten.

Benutzernamen dürfen grundsätzlich keine Sonderzeichen enthalten.

Abhängig von der Art und Größe der Umgebung sind InfluxDB und MariaDB lokal oder extern zu betreiben:

  • Soll SNAG-View 4 nur als Testumgebung installiert werden, können sowohl InfluxDB als auch MariaDB lokal laufen.
  • In kleinen bis mittelgroßen Produktivumgebungen sollte die InfluxDB extern installiert werden, die MariaDB kann lokal laufen.
  • In sehr großen Produktivumgebungen sollten sowohl InfluxDB als auch MariaDB extern laufen.

Um die InfluxDB für den externen Betrieb zu konfigurieren, müssen folgende Schritte durchgeführt werden:

  • Kopieren von prepare.tar.gz und dem Skript source/prepare-influxdb-remote.sh auf den InfluxDB-Server
  • Ausführen des Skripts prepare-influxdb-remote.sh mit den Parametern --user und –-password. Das Skript muss sich im selben Verzeichnis wie prepare.tar.gz befinden.
    • Beispiel: ./prepare-influxdb-remote.sh --user influxdbUSER --password INFLUXDPASSWORD

Hinweis: Es wird dringend empfohlen, TLS für den Zugriff auf die InfluxDB zu verwenden. Das Aktivieren von HTTPs ist in der InfluxDB-Dokumentation beschrieben.

Um die MariaDB für den externen Betrieb zu konfigurieren, müssen folgende Schritte ausgeführt werden:

skip-networking=0
skip-bind-address
  • Kopieren der Datei 'zzz-snagview.conf' in dasselbe Verzeichnis wie die Option-Files (standardmäßig '/etc/my.cnf.d/')
  • Neustart des MariaDB Dienst
  • Anmeldung mit Remote-Benutzer auf MariaDB (benötigt Root-Berechtigung)
    • Ein neuer Remote-Benutzer kann in MariaDB mit dem folgendem Befehl angelegt werden:
GRANT ALL PRIVILEGES ON *.* TO 'root'@'<IP-ADDRESS-SV4-SERVER>' IDENTIFIED BY '<PASSWORD>' WITH GRANT OPTION;
  • Ausführen des folgenden Befehls, um Zeitzonen auf dem remote MariaDB-Server zu installieren. Dies ist zwingend erforderlich:
mariadb-tzinfo-to-sql /usr/share/zoneinfo | mariadb -u root mysql -p

Schlägt die Installation von SNAG-View 4 fehl, bevor alle Abhängigkeiten installiert worden sind, erfolgt ein Rollback. Die Installationsroutine kann nach Behebung der Fehler über den Aufruf von ./setup.sh neu gestartet werden. Tritt der Fehler auf, nachdem sämtliche Abhängigkeiten installiert wurden, kann nach Beheben des Fehlers die Konfiguration über den Aufruf von ./reconfigure.sh gestartet werden. Hierbei werden auch die lokalen InfluxDB und MariaDB zurückgesetzt.

Nach der erfolgreichen Installation wird die Datei sv4-credentials im root-Verzeichnis erstellt. Diese Datei enthält alle Anmeldedaten für SNAG-View 4, URLs und Pfade zu Zertifikaten. Es wird dringend empfohlen, diese Datei an einem sicheren Ort zu speichern.