Linux

Ablauf der Installation

1) Server bzw. PC Parameter prüfen

Weitere Informationen sind hier zu finden: Systemvoraussetzungen. Wir empfehlen Linux mit 64-Bit: Ubuntu Jammy 22.04 (LTS).

Prüfen des eingesetzten Prozessors auf Quad-Core und Hyper-Threading Funktion

Beispiel: Intel Core i5-8250U Prozessor

https://ark.intel.com/content/www/de/de/ark/products/124967/intel-core-i5-8250u-processor-6m-cache-up-to-3-40-ghz.html

2) JUMO Installer Zip entpacken

Aktuelle Version JUMO Installer

JUMO_Installer_20231030.zip

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.

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. Mit diesem Befehl werden die notwendigen Rechte auf den SCADA Installationsordner vergeben.

chown -R 2000:2000 /opt/jumo_scada

• Anschließend folgendes Kommando eingeben, um in den entsprechenden Ordner zu wechseln.

cd /opt/jumo_scada

• 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. Je nachdem wie die Installation erfolgt ist, muss hier die IP-Adresse des Servers oder der vergebene DNS Name eingegeben werden.

http://localhost

• Anschließend öffnet sich der JUMO-Installer. Sie müssen nun der Installationsanweisung folgen.

Nach jedem Menüpunkt im JUMO-Installer, kann über “Nächster Schritt” in den nächsten gewechselt werden.

Normaler Modus	Nacht Modus

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 folgende Befehle ein. POWERSHELL docker-compose kill docker-compose down docker-compose up -d
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 oder den entsprechend zugewiesenen DNS Namen der IT) den Namen des Servers/Systems auf dem Sie die JUMO smartWARE SCADA installieren und klicken Sie auf “absenden”. Überprüfen Sie anschließend ob der DNS Name im Netzwerk und der hier vergebene Name übereinstimmen. 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”). 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 (kann auch nachträglich geändert werden). Unter “Datenquellenname” wird der Name vergeben, den die erste Datenquelle erhält. Zu empfehlen ist: “Lokales Edge-Gateway” zu verwenden. Externe Edge Gateways müssen per Lizenz dazu erworben werden. Das interne Edge Gateway ist immer inkludiert.
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 oder Modul benötigt wird, kann hier entschieden werden, ob es zur Ausprägung kommt oder nicht. Bitte hier nach der erworbenen Lizensierung richten. Nicht benötigte Module verbrauchen unnötig Serverleistung. Ist eine Kamera gewünscht, dann “Ja” anklicken Wartung ist i.d.R. mit “Nein” anzuklicken, es sei denn es wurde explizit bestellt. Ist das Modul “Erweiterte Berichte” gekauft worden bzw. eine Chargenfunktionalität gewünscht, dann “Ja” anklicken. Ist es gewünscht mit Skripten zu arbeiten bzw. die Runtime Skript zu verwenden, dann “Ja” anklicken.
Abschluss	Im Fenster Abschluss wird eine Übersicht über alle Benutzernamen und Passwörter gezeigt, die ausgedruckt oder als PDF gespeichert werden sollten. Vor allem das root Passwort ist besonders wichtig.

• Nachdem der "Absenden" Button im Menüpunkt “Abschluss” beim JUMO-Installer gedrückt wurde, müssen folgende Befehle in der Shell 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. Alternativ kann auch ein (Wildcard) CA-Zertifikat hinterlegt werden. Anschließend ist die Anwendung unter https:// erreichbar.

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 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.