Linux
Ablauf der Installation
1) Server bzw. PC Parameter prüfen
Weitere Informationen sind hier zu finden: Systemvoraussetzungen
Prüfen des eingesetzten Prozessors auf Quad-Core und Hyper-Threading Funktion
Beispiel: Intel Core i5-8250U Prozessor
2) JUMO Installer Zip entpacken
Aktuelle Version JUMO Installer
Der JUMO Installer muss auf einem Laufwerk des jeweiligen Rechners/Servers entpackt werden.
3) Aktuelle Docker Anwendung runterladen und installieren
Docker Engine und Docker Compose werden benötigt.
Windows | Linux | macOS |
---|---|---|
4) JUMO smartWARE SCADA Image aus JUMO Registry laden und installieren
1. Linux Terminal öffnen
Eine Übersicht über alle hier verwendeten Terminal Befehle für Docker ist auf folgender Seite abgebildet: https://docs.docker.com/compose/reference/overview/
PowerShell öffnen und das folgende Kommando eingeben.
/opt/jumo_scada
“/opt/jumo_scada” ist in dieser Anleitung unser Beispielpfad. Ersetzen Sie ihn durch den Pfad, der zum entpackten JUMO Installer führt.
Nachdem “/opt/jumo_scada” nun in der nächsten Zeile vorne Anstelle des ursprünglichen Pfades erscheint, geben Sie den folgenden Befehl ein:
docker login registry.jumo.digital
Im Anschluss müssen Sie sich mit dem von JUMO zur Verfügung gestellten “Username” und “Password” anmelden. Diese Anmeldedaten erhalten Sie zusammen mit dem Lizenzschlüssel bei Kauf der JUMO smartWARE SCADA.
Nach der Anmeldung geben Sie den folgenden Befehl ein
docker-compose pull
Nach Betätigung der Enter-Taste werden die Daten aktualisiert, indem sich Docker die JUMO smartWARE SCADA Images aus dem vorher eingegebenen Pfad “zieht”. Die Container werden dadurch aber noch nicht aktiviert. Der Vorgang kann einige Sekunden in Anspruch nehmen.
Wenn der Download abgeschlossen ist, geben Sie den folgenden Befehl ein. Mit diesem Befehl werden die Container in Docker gestartet.
docker-compose up -d
Bei Fehlermeldungen können folgende Befehle verwendet werden:
docker ps -q | % { docker kill $_ }
docker-compose rm -f
docker-compose up -d
2. Es kann nun im Linux Terminal geprüft werden, ob alle Container laufen
docker ps
3. JUMO smartWARE SCADA - Installer durchgehen
Öffnen Sie Ihren Browser und geben Sie in der URL Zeile folgendes ein
http://localhost
Anschließend öffnet sich der JUMO-Installer. Sie müssen nun der Installationsanweisung folgen.
Normaler Modus | Nacht Modus |
---|---|
Nach jedem Menüpunkt im JUMO-Installer, kann über “Nächster Schritt” in den nächsten gewechselt werden.
Menüpunkt | Notiz |
---|---|
Voraussetzungen | Hier wird die Verbindung zu verschiedene Datenbanken und Servern geprüft. Die Prüfung kann einige Sekunden in Anspruch nehmen. Klicken sie bei jedem Reiter auf “Absenden”. Ist die Überprüfung gescheitert geben Sie in PowerShell folgende Befehle ein:
POWERSHELL
|
Bereitstellung | Im Bereich “Bereitstellung” ist ein Zertifikat zu signieren und ein Hostname zu vergeben. Wählen Sie hier "Selbst signiert" aus, um fortzufahren. Vergeben Sie als Hostnamen (z.B: smartware-scada) den Namen des Servers/Systems auf dem Sie die JUMO smartWARE SCADA installieren und klicken Sie auf “absenden”. Ändern Sie auf ihrem System anschließend den Host-Namen auf den im Installer vergebenen Hostnamen ab. Beispiel Host-Name, anschließend im Browser unter http://smartware-scada bzw. https://smartware-scada erreichbar smartware-scada |
Grundeinstellung | In den Grundeinstellungen werden Datenbanken und Server eingerichtet. Drücken Sie nun bei Datenbank einrichten auf den Button "Absenden". Anschließend legen Sie ein Passwort im Bereich “MQTT Broker einrichten” fest und bestätigen Ihr selbst festgelegtes oder generiertes Passwort über den Absenden Button. Passwörter lassen sich hier über das Fingerabdruck-Symbol zufällig generieren. Danach drücken Sie bei "Authentifizierungsserver einrichten" auf den Button "Absenden", um die Datenbank zu erstellen. |
Anlage | Hier muss ein Basismandant und ein Anlagenmandant festgelegt werden. Tipp: Nennen Sie den Basismandant nach Ihrer Firma und den Anlagenmandanten nach ihrem Themenbereich, in dem die SCADA einen Mehrwert generieren soll. |
Edge Gateway | Im Bereich “Edge Gateway” wird abgefragt ob ein lokales IoT-Edge Gateway angelegt werden soll oder nicht (i.d.R: “Ja”). Außerdem muss ein Datenquellenname eingegeben werden. Ebenso wird nach externen IoT-Edge Gateways gefragt. Soll neben dem SCADA Hauptserver (lokales IoT-Edge-Gateway) noch weitere Netzwerke oder JUMO variTRON Geräte (externe IoT-Edge-Gateways) über MQTTS angebunden werden, “Ja” klicken. Unter “Datenquellenname” wird der Name vergeben, den die erste Datenquelle erhält. Zu empfehlen ist: “Lokales Edge-Gateway” zu verwenden. |
Sicherheit | In den Sicherheitseinstellungen wird jeweils ein Passwort für Datenbank und Authentifizierungsserver festgelegt bzw. generiert. Passwörter lassen sich hier über das Fingerabdruck-Symbol zufällig generieren. Im Reiter “Redis” lediglich auf “Absenden” klicken. |
Features | Je nachdem welches Feature benötigt wird, kann hier entschieden werden, ob es zur Ausprägung kommt oder nicht. Bitte hier nach der erworbenen Lizensierung richten. |
Abschluss | Im Fenster Abschluss wird eine Übersicht über alle Benutzernamen und Passwörter gezeigt, die ausgedruckt oder als PDF gespeichert werden sollten. |
Nachdem der "Absenden" Button im Menüpunkt “Abschluss” beim JUMO-Installer gedrückt wurde, müssen folgende Befehle in PowerShell ausgeführt werden:
docker-compose down --remove-orphans
docker-compose pull
docker-compose up -d
Aktivierung JUMO smartWARE SCADA Lizenz
Über den Host-Namen kann die Startseite der JUMO smartWARE SCADA im Browser aufgerufen werden. Die Anmeldung funktioniert mit dem Nutzer “Root” und dem dazugehörigen Passwort aus der Passwortliste des letzten Schritts.
Siehe an dieser Stelle auch: SSL Zertifikat importieren.
Zur Anpassung der Anmeldethemen (SSO, Security, Registrierung, LDAP, usw) bitte das Kapitel Benutzerverwaltung Keycloak (IAM) anschauen
1) Lizenzeinstellungen öffnen
Sobald die JUMO Anwendung gestartet wurde, erscheint sofort ein Warn-Hinweis, dass keine gültige Lizenz gefunden wurde. Per Klick auf Lizenzeinstellung innerhalb dieses Warn-Fensters öffnen sich die Lizenzeinstellungen. Kopieren Sie hier die System-UID.
Die UID der jeweiligen SCADA Installation kann aus der Zentraladministration unter Einstellungen und Lizenzierung ausgelesen werden. Diese Einstellungsansicht kann nur im obersten Wurzel- Mandanten eingesehen werden.
2) Aktivierung SCADA Lizenz
Um die SCADA Anwendung benutzten zu können, muss in dem System eine gültige Lizenz hinterlegt werden. Ist keine gültige Lizenz hinterlegt kann nur auf die Zentraladministration zugegriffen werden.
Um eine Lizenz im System hinterlegen zu können, muss diese vorher über zugesendeten Lizenzschlüssel und der systemeigenen UID (Identifikationsnummer der SCADA Installation) im JUMO Lizenzportal unter https://portal.jumo.digital aktiviert werden. Den Lizenzschlüssel erhalten Sie, sobald Sie die JUMO smartWARE SCADA erworben haben per Mail.
Wenn Sie die Software offline aktivieren wollen, wenden Sie sich an JUMO.
JUMO smartWARE SCADA Lizenz Portal:
Nach dem Aktivieren/Erstellen der Lizenz kann diese als Datei heruntergeladen werden oder direkt kopiert werden.
Bevor Sie die Webseite verlassen, sollten Sie nach der Aktivierung der Lizenz unbedingt sichern (In eine Textdatei kopieren oder den Download-Button betätigen), da es sich um eine einmalige Aktivierung handelt. Der Lizenzschlüssel kann nicht für eine weitere Lizenz genutzt werden!
3) Freischalten der SCADA Software
Das Freischalten von SCADA mit der aktivierten Lizenz läuft über die Einstellungen zu Lizenzierung in der Zentraladministration. Die aktivierte Lizenz muss dort unter LicenseKey eingefügt und abgespeichert werden.
Herzlichen Glückwunsch! Sie haben Ihre SCADA erfolgreich in Betrieb genommen.
Möchten Sie neben dem root Benutzer nun weitere Nutzer hinzufügen, schauen Sie sich das Kapitel Benutzerverwaltung Keycloak (IAM) an.
Fehlerbehebung:
1) SCADA-Installer - Prüfung Verbindung zu MongoDB fehlgeschlagen
Problem
Prüfe Verbindung zu MongoDB fehlgeschlagen
Detailbeschreibung
Die MongoDB braucht unter Umständen etwas länger zum hochfahren. Der JUMO Installer fragt die Aktivität der MongoDB ab. Dabei kann es vorkommen, dass der JUMO Installer diese Anfrage aufgibt, wenn die MongoDB zu lange zum hochfahren braucht. In der Konsole erscheint der Fehler “410 Gone”.
Lösung
Leeren Sie den gesamten Cache des Browsers.