Installation der QuickHMI Runtime auf Linux-Systemen

Für die Verwendung auf einem Raspberry Pi steht ein fertiges Image (8GB) zum Download bereit. Dieses Image ist fertig eingerichtet mit der QuickHMI Runtime sowie Zugriffsmöglichkeiten über SSH und VNC.

Den Download für das Image finden Sie in unserer Download-Sektion. Das Image bitte herunterladen und auf eine mindestens 8GB große Mini SDKarte schreiben. Nach dem Einstecken der Karte in den Slot des Raspberry Pi diesen mit Strom versorgen und am besten für die Ersteinrichtung ein LAN-Kabel anschließen.

Das Image ist so konfiguriert, das der Raspberry Pi seine IP-Adresse über eine DHCP-Anfrage erhält. Die IP-Adresse können Sie über das Netzwerk-Tool „Advanced IP Scanner“ ermitteln oder einen Monitor anschließen.

Das Image wird ausgeliefert mit folgenden Standardzugangsdaten für den Benutzer „pi“:

Benutzer:        pi
Passwort:        raspberry

Sicherheitsrisiko: Bitte das Passwort bei der ersten Einrichtung ändern!

Die Installation des QuickHMI – Servers auf einer Linux-Distribution erfolgt über das Terminal. Bitte beachten Sie hierzu die Systemvoraussetzungen für Linux!

Öffnen Sie ein Terminal oder verbinden Sie sich über einen SSH – Zugriff auf Ihr Linux – System.

Auszuführende Befehle können sich von Distribution zu Distribution unterscheiden. Die Befehle in dieser Anleitung orientieren sich an Linux Ubuntu.

Installieren einer anderen Major-Version

Eine abweichende Major-Version von QuickHMI kann installiert werden, wenn in folgenden Skript-Ausschnitten alle vorkommen von „Lynx“ durch die entsprechende andere Version ersetzt werden.

Für ein manuelles Update innerhalb der gleichen Hauptversion, führen Sie lediglich die mit [U] gekennzeichneten Schritte aus. Dies setzt voraus, das die anderen Schritte in der Vergangenheit bereits ausgeführt wurden, oder Sie das von uns bereitgestellte Raspberry Image nutzen.

1. Installieren Sie eine openJDK Laufzeitumgebung. Unterstützt werden Laufzeitumgebungen ab Version 11. Sollte es keine aktuelle Paketquelle für die Version 11 des openjdk in der verwendeten Linuxdistribution geben, können Sie die Version 17 verwenden.
sudo apt-get install openjdk-11-jre
2. Falls Sie den grafischen RuntimeManager nutzen wollen, installieren Sie openjfx. Anderenfalls können Sie diesen Schritt überspringen.
sudo apt-get install openjfx
3. Legen Sie einen neuen Nutzer quickhmi mit dem Passwort indi an. Dieser Nutzer wird genutzt, um den QuickHMI Server zu starten.
username="quickhmi"
       password="indi"
       pass=$(perl -e 'print crypt($ARGV[0], "password")' $password)
       sudo useradd -m -p $pass $username
4. [U]* Wechseln Sie in den Ordner „/home/quickhmi“.
cd /home/quickhmi
5. [U]* Laden Sie das QuickHMI Server Paket herunter. Anstatt den wget Befehl zu nutzen, können Sie die Datei auch zuvor auf einem anderen Rechner herunterladen und dann in das aktuelle Verzeichnis (/home/quickhmi) kopieren.
sudo wget https://www.quickhmi.de/linux/lynx/QuickHMIServer.tar
6. [U]* Entpacken Sie das QuickHMI Server Paket nach /home/quickhmi.
sudo tar -xvf QuickHMIServer.tar

Sie sollten jetzt folgende Ordnerstruktur vorfinden: /home/quickhmi/QuickHMIServer Lynx
7. [U]* Löschen Sie das QuickHMI Server Paket.
sudo rm QuickHMIServer.tar
8. Setzen Sie den Benutzer quickhmi als Besitzer des Ordners QuickHMIServer.
sudo chown quickhmi "QuickHMIServer Lynx"
9. Erstellen Sie einen symbolischen Link zur Datei /home/quickhmi/QuickHMIServer/qhmiRM.sh nach /usr/bin/qhmiRM .
sudo ln -sf "/home/quickhmi/QuickHMIServer Lynx/qhmiRM.sh" /usr/bin/qhmiRM
10. [U]* Kopieren Sie den Ordner /home/quickhmi/QuickHMIServer Lynx/usr/ nach /usr/. Mit dem Befehl cp -a wird dabei der Ordner mit allen Inhalten kopiert. 

Wichtig bei diesem Befehl ist der / nach Angabe des Quellverzeichnisses!

sudo cp -a "QuickHMIServer Lynx/usr/." /usr/
11. [U]* Den Ordner /home/quickhmi/QuickHMIServer Lynx/usr können Sie nun löschen. Er wird hier nicht mehr benötigt.
sudo rm -rf "QuickHMIServer Lynx/usr"
12. [U]* Kopieren Sie den Ordner /home/quickhmi/QuickHMIServer Lynx/etc/ nach /etc/. Mit dem Befehl cp -a wird dabei der Ordner mit allen Inhalten kopiert. 

Wichtig bei diesem Befehl ist der / nach Angabe des Quellverzeichnisses!
sudo cp -a "QuickHMIServer Lynx/etc/." /etc/
13. [U]* Den Order /home/quickhmi/QuickHMIServer Lynx/etc können Sie nun löschen. Er wird hier nicht mehr benötigt.
sudo rm -rf "QuickHMIServer Lynx/etc"
* Falls eine ältere Version des Servers bereits installiert ist, reicht es für ein Update die mit [U] gekennzeichneten Schritt auszuführen.

Damit ist die Installation abgeschlossen.

Wechseln Sie jetzt in den Ordner für QHMI:

cd /home/quickhmi/QuickHMIServer Lynx

Eine Auflistung über alle möglichen Befehle bekommen Sie mit:

 sudo qhmiRM

Nachfolgend werden die möglichen Befehle aufgeführt:

CommandText
-rQuickHMI Konsolen runtime Manager wird gestartet
-rgQuickHMI runtime manager GUI wird gestartet
-rdstartet den QuickHMI Server
-sdstoppt den QuickHMI Server
-iDirekter Import einer QuickHMI ExportDatei in den Server. Kann zusammen mit dem -instance (instance_ID) argument verwendet werden
-vzeigt die aktuell installierte Version
-u Startet den Aktualisierungs-Prozess
-startStartet manuell eine Instanz. Muss zusammen mit dem Argument für die Instanz verwendet werden (-instance instance_ID)
-stopStoppt eine Instanz. Muss zusammen mit dem Argument für die Instanz verwendet werden (-instance instance_ID)

Die Beschreibung des grafischen Runtime-Managers erfolgt hier https://docs.quickhmi.com/wp-admin/post.php?post=2554&action=edit&lang=de

Im ersten Schritt sollte ein Projekt über die Export-Datei importiert werden.

sudo qhmiRM -i Testprojekt1.qexp

Nach Auswahl einer laufenden Instanz oder der Erstellung einer neuen Instanz wird das Projekt importiert.

Starten lässt sich die Laufzeit dann mit:

sudo qhmiRM -rd