Installation

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.

Wenn bereits eine andere QuickHMI Version installiert ist, muss diese zuvor deinstalliert werden. Die notwendigen Schritte dazu sind hier dokumentiert.

Neuinstallation *1Update *2Upgrade *3
X1. Deinstallation der Vorgängerversion.
Deinstallation
X1. 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
X2. Falls Sie den grafischen RuntimeManager nutzen wollen, installieren Sie openjfx. Anderenfalls können Sie diesen Schritt überspringen.
sudo apt-get install openjfx
X3. 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
XXX4. Wechseln Sie in den Ordner „/home/quickhmi“.
cd /home/quickhmi
XXX5. 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
XXX6. Entpacken Sie das QuickHMI Server Paket nach /home/quickhmi.
sudo tar -xvf QuickHMIServer.tar

Sie sollten jetzt folgende Ordnerstruktur vorfinden: /home/quickhmi/QuickHMIServer Lynx
XXX7. Löschen Sie das QuickHMI Server Paket.
sudo rm QuickHMIServer.tar
XX8. Setzen Sie den Benutzer quickhmi als Besitzer des Ordners QuickHMIServer.
sudo chown quickhmi "QuickHMIServer Lynx"
XX9. 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
XXX10. 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/
XXX11. 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"
XXX12. 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/
XXX13. 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"

*1 Neuinstallation: Erste Installation von QuickHMI.
*2 Update: Installation einer anderen Version innerhalb der gleichen Hauptversion.
*3 Upgrade: Installation einer neuen Hauptversion (z.B. Lynx) nachdem die zuvor installierte Hauptversion (z.B. Jellyfish) deinstalliert wurde.

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/dokumentation/runtime-manager/der-quickhmi-runtime-manager/

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