Installing the QuickHMI Runtime on Linux-Systems

The installation of the QuickHMI Server on a Linux distribution is always done via the terminal. Please note the system requirements for Linux!

Open a terminal or connect via SSH access to your Linux system.


This will be used to download the installation scripts below.


This is done via the following command:


wget https://www.quickhmi.com/linux/falcon/qhmi_linux_falcon.tar




After confirming the entry, the archive of the installation scripts is downloaded from the Internet and must then be unpacked.


To unzip, enter the following command:


tar -xvf qhmi_Linux.tar




This command unzips the scripts into the current directory.


If the prerequisite packages for using the QuickHMI Server are not installed on your system,

first execute the script for setting up the requirements (hereinafter called "Requirements").


The requirements for the QuickHMI Server are the following:


  • OpenJDK 12 Open JFX
  • Curl
  • DirMngr


To execute the requirements, enter the following command:


bash qhmi_Linux_requirements.sh




If you do not have admin permission, you will be notified, and you will need to log in as root.




To run the command as root, assume the “sudo” command.

Or change the user inside the terminal.


sudo bash qhmi_Linux_requirements.sh




Subsequently, the password is requested. Enter this and confirm with ENTER.


The missing requirements are installed and configured on your system. During the installation, you will be asked to confirm the license terms of Java Oracle 8.


After successful installation, you will be asked if you want to proceed directly to the QuickHMI Server installation.

This can be confirmed with "Y" followed by ENTER, or simply with ENTER. The installation is started manually.


The manually entered command for the QuickHMI installation would be:


sudo bash qhmi_Linux_install.sh




The files relevant to the QuickHMI Server are downloaded and installed. After successful installation, you can configure your QuickHMI project on the server.

For the import of a project and the start of the server, an overview with the possible commands and options can be called, which serves as help.


To call the overview, enter the following command:


sudo bash qhmiRM --help




Subsequently, the password is requested. Enter this and confirm with ENTER.


The following overview of the commands and options appears:


====================================================================================================================

qhmiRM -> QuickHMI Runtime Manager

-r | --run        QuickHMI console runtime manager will be started.

-rg| --rungui        QuickHMI runtime manager GUI will be started.

-c | --check        check QuickHMI Server status

-rd| --rundaemon        will start the QuickHMI Server

-sd| --stopdaemon        will shutdown the QuickHMI Server

-u | --update        check and install QuickHMI Server updates

-i | --import        direct import a QuickHMI Export File (Project) into the server.

       --> Example: qhmiRM --import /path/to/file.qexp

-f | --force        forces to import new project file / update the QuickHMI Server (will        shutdown the QuickHMI Server if running)

-s | --start        start the server after importing the project file


====================================================================================================================



From the above commands and options, you can combine a command chain. You can enter either the long

form (--run) or the short form (-r) of the relevant commands.


For example, to import a project and start the server, enter the following command:


sudo bash qhmiRM --import /path/to/file.qexp --start


or


sudo bash qhmiRM -i / path/to/file.qexp -s




"Import successful" -> This successfully publishes the project and makes it accessible.


To stop the server, enter the following command:


sudo bash qhmiRM --stopdaemon


or


sudo bash qhmiRM -sd