Übersicht der Installations-Routine 'setup.sh'

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.

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. Für mehr Informationen zum Aktivieren von HTTPs siehe InfluxDB-Dokumentation.

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

• Aktivieren des Fernzugriffs auf MariaDB (https://MariaDB.com/kb/en/configuring-MariaDB-for-remote-client-access/).
• Einfügen der folgenden Zeilen unter [mysqld] in der Datei '/etc/my.cnf.d/server.cnf':

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, so werden diese auf ihren Zustand vor der Installation zurückgesetzt. Tritt der Fehler auf, nachdem sämtliche Abhängigkeiten installiert wurden, kann nach Beheben des Fehlers die Installation mit dem Parameter --reconfigure bzw. -r neu 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, in der die gewählten Anmeldedaten festgehalten sind. Diese Datei muss an einem sicheren Ort verwahrt werden, um Sicherheitsrisiken zu vermeiden.