WebHMI Runtime Linux (x64)

WebHMI is the ideal solution for creating stand-alone applications in HMI with Windows or Linux operating systems.

The HMI can be managed by remote by predisposing the Deploy Server on the device and using the Deploy Project window and HMI Control directly from the Movicon.NExT development environment.

 

 

 

Preparing HMI with Linux (x64) operating systems

WebHMI allows stand-alone applications to be created on HMI systems with Linux (64) operating systems compatible with .NET Core such as UBuntu and Debian distributions.

 

 

The used Linux distribution must be compatible with .NET Core in order for the WebHMI to function.

 

Some components that consent the I/O Data Server and WebHMI to run within the Linux environment need to be installed manually as indicated below.

 

 

up to Ubuntu 20.04 the following procedure will be correct.

 

.NET Core Installation

  1. Download and install the .NET Core SDK 2.1 on the HMI

Go to this page: https://dotnet.microsoft.com/download/dotnet-core/2.1 and choose which packets to install: Binaries or Installers.

As an example, below are the commands to use in an Ubuntu 20.04 distribution to install .NET Core SDK 2.1:

 

wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb

sudo dpkg -i packages-microsoft-prod.deb

 

and subsequently:

 

sudo apt-get update; \

sudo apt-get install -y apt-transport-https && \

sudo apt-get update && \

sudo apt-get install -y dotnet-sdk-2.1

 

 

  1. Download and install the .NET Core SDK 6.0 on the HMI

Go to this page: https://dotnet.microsoft.com/download/dotnet-core/6.0  and choose which packets to install: Binaries or Installers.

As an example, below are the commands to use in an Ubuntu 20.04 distribution to install .NET Core SDK 6.0:

 

sudo apt-get update; \

sudo apt-get install -y apt-transport-https && \

sudo apt-get update && \

sudo apt-get install -y dotnet-sdk-6.0

 

Database Management System Installation

  1. The developer is free to choose which Database Management System (DBMS) they wish to install.
    However, the Microsoft SQL Server can be installed following the instructions at: https://docs.microsoft.com/it-it/sql/linux/quickstart-install-connect-ubuntu?view=sql-server-linux-ver15

 

Deploy Server Installation

The Deploy Server allows you to download the project and manage the device by remote.

Follow these steps below to install it:

 

  1. Copy the contents of the "DeployServer-Files" folder from the Movicon.NExT installation folder (e.g,. path "C:\Program Files\Progea\Movicon.NExT 4.0\DeployServer-Files") to the HMI.

  2. Modify the "appsettings.json" file from the "DeployServer-Files" folder specifying:

     

 

The username should be an existing or non existing email address, such as progea@progea.com

 

The password must be the minimum of 7 characters in length and must include a special character, an uppercase character and a number.

 

 

  1. Change the rights to the copied folder by giving full rights to the user who is using it (this step is optional and can be omitted by using the sudo command before all the following terminal commands).

  2. Open a terminal window in the copied folder and run the "sudo dotnet dev-certs https" command to generate the certificate from the Deploy Server.

  3. The Deploy Server can be started up manually with the "sudo dotnet DeployServer.dll" command or it can be configured to launch at the HMI startup as service.

 

    1. When using the “sudo nano /etc/systemd/system/DeployServer.service” command it will create a .service file in the “/etc/systemd/system/” folder and it will open it directly with the text editor from the nano terminal.

    2. Insert the following contents in the file by paying attention to the WorkingDirectory and ExecStart fields concerning the path where the Deploy Server was copied:

 

[Unit]

Description=Movicon NExT DeployServer

 

[Service]

WorkingDirectory=/home/pi/Documents/DeployServer-Files

ExecStart=dotnet /home/pi/Documents/DeployServer-Files/DeployServer.dll

Restart=always

RestartSec=2

SyslogIdentifier=DeployServer

User=root

Environment=ASPNETCORE_ENVIRONMENT=Production

 

[Install]

WantedBy=multi-user.target

 

 

    1. Use the “sudo systemctl daemon-reload” command (loads any service modifications)

    2. Use the “sudo systemctl enable DeployServer.service” command (enables the service just created)

    3. Use the “sudo systemctl start DeployServer.service” command (starts up service)

    4. Now if you use the “sudo systemctl status DeployServer.service” command, it will be active and running (checks the service status)

 

 

In order to install the license correctly, the Deploy Server must be started up with administration rights.

 

 

The Deploy Server listens on the 5002 (TCP) port.  Therefore, you will need to check that the firewall permits communications on this port.

 

 

Deploying Projects in HMI

For further information on deploying projects in remote devices, please refer to "Deploying Projects in HMI"