Installing Movicon™ WebHMI Deploy Server on Linux

Introduction

Hello and welcome to the new Movicon.NExT™ tutorial.
in this tutorial we are going to see how to install the WebHMI Deploy Server in the Linux environment. This procedure is key for the correct use of the software.

Procedure

The Movicon WebHMI Deploy Server can be installed on different type of Linux systems, such as:

• Linux ARM64
• Linux ARM32
• Ubuntu 22.04 with Docker
• Ubuntu 16.04
• Ubuntu 18.04
• Ubuntu 20.04

Deploy Server installation on ARM64 Linux device

We will now go through the installation procedure for the Linux ARM64 environment. This procedure is like the one used in the Linux ARM32 environment. For further information about this, please refer to the chapter on Deploy Server Installation in the Movicon.NExT Installation guide.
In this scenario, you must:

• Download the script file using the following command:
  sudo wget https://support.movicon.com/download/Movicon_DeployServer/linux/arm64/deployServerInstaller
• Install the Deploy Server to make the downloaded file executable with this command line:
  sudo chmod +x deployServerInstaller
• Run the installer with this command line:
  sudo ./deployServerInstaller

To start the Deploy Server manually, you must run the start.sh file which is created once the deployServerInstaller file has been launched. To do this, run the following command line:

cd /moviconData/
sudo ./start.sh
 
 If you wish to start the Deploy Server automatically when the operating system starts up, you must:

• Create the service using the following command:
  sudo nano /etc/system/system/DeployServer.service
• Check if you need to amend the “WorkingDirectory” and “ExecStart” folders, unless you are using those for default, and copy and paste the following code in the test editor:
  [Unit]
  Description=Movicon NExT DeployServer
  [Service]
  WorkingDirectory=/moviconData
  ExecStart=/moviconData/start.sh
  Restart=always
  RestartSec=2
  SyslogIdentifier=DeployServer
  User=root
  Environment=ASPNETCORE_ENVIRONMENT=Production
  [Install]
  WantedBy=multi-user.target
• Save and exist from the test editor
• Reload the system manager configuration with this command line
  sudo systemctl daemon-reload
• Enable the service that has just been created
  sudo systemctl enable DeployServer.service
• Run the service
  sudo systemctl start DeployServer.service
• Check the status of the service you have just started running
  sudo systemctl status DeployServer.service

This procedure terminates here. Congratulations! You have now completed installing the Movicon Deploy Server on your Linux ARM64. You can now connect to the Deploy Server using the following credentials:

Username: MoviconUser@emerson.com
Password: MyPwd123!

Please remember that these credentials are provisional, and we strongly recommend that you change them to improve the security of your Linux environment.
 

Deploy Server INstallation on Ubuntu 22.04 device with Docker

Let’s continue with installing the Deploy Server on the Linux Ubuntu 22.04 system. If you have not yet installed the Docker Engine on your Ubuntu system, please follow this next procedure. Otherwise, skip this part and go to the procedure used to install the Movicon Deploy Server.
To install the Docker Engine on your Ubuntu system, you will need to use the repository. To do this:

• Update the apt package index and installed the packages that allow the apt package manager to use a repository with the HTTPS protocol using Ubuntu’s "Terminal" window:
  sudo apt-get update
  sudo apt-get install ca-certificates curl gnupg lsb-release -y
• Add the Docker’s GPG key by using the following command line:
  sudo mkdir -p /etc/apt/keyrings
  curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
• Use the following command for the repository’s setup:
• echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

We can now continue with installing the Docker Engine.

• Update the apt package index
  sudo apt-get update
• Install the Docker Engine, Containerd and Docker Compose
  sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin -y
• Check that the Docker Engine installation has terminated successfully with the following “hello-world” image
• sudo docker run hello-world

Last step: Installing the Movicon Deploy Server.

• First of all, create a new empty folder and call it “dockerFiles” and then select it
  sudo mkdir dockerFiles
  cd dockerFiles
• Download the “dockerfile” in the new folder:
  sudo wget http://support.progea.com/download/Movicon_DeployServer/latest/dockerfile
• Install the Deploy Server creating an image by using the dockerfile’s instruction:
• sudo docker build -t webhmi
• At this point, simply run the Deploy Server Container by publishing the TCP ports and making sure that it is always run after the system has started up:
• sudo docker run -d --name MoviconWebHMI -p 5000:5000 -p 5001:5001 -p 5002:5002 -p 62841:62841 --restart always webhmi

This procedure is now completed. Congratulations! You have installed the Movicon Deploy Server within your Ubuntu environment successfully using the Docker. You can now connect to the Deploy Server using the following credentials:

Username: MoviconUser@emerson.com
Password: MyPwd123!

Please remember that these credentials are provisional, and we strongly recommend that you change them to improve the security of your Ubuntu environment.

Deploy Server installation on Ubuntu 20.04 LTS device

Let’s see how to install Movicon Deploy Server in the Ubuntu 20.04 LTS operating system. This procedure is like the one used for Ubuntu 16.04 and Ubuntu 18.04. For further information, please consult the Deploy Server’s installation guide found in the Movicon.NExT manual’s topic on installation.

• Download the script file
  sudo wget https://support.movicon.com/download/Movicon_DeployServer/ubuntu/20.04/deployServerInstaller
•  Install the Deploy Server making the newly downloaded file executable:
  sudo chmod +x deplyServerInstaller
• Run the installer file
• sudo ./deployServerInstaller

To start the Deploy Server manually, you must run the start.sh. file which is created once the deployServerInstaller has been launched. To do this, run the following command line:

cd /moviconData/
sudo ./start.sh

If you wish to start the Deploy Server automatically when the operating system starts up, you must:

• Create the service using this command
  sudo nano /etc/system/system/DeployServer.service
• Check to see if you need to amend the “WorkingDirectory” and “ExecStart” folders, unless you’re using those for default, and copy and paste the following code in the test editor:
  [Unit]
  Description=Movicon NExT DeployServer
  [Service]
  WorkingDirectory=/moviconData
  ExecStart=/moviconData/start.sh
  Restart=always
  RestartSec=2
  SyslogIdentifier=DeployServer
  User=root
  Environment=ASPNETCORE_ENVIRONMENT=Production
  [Install]
  WantedBy=multi-user.target
• Save and exist from the test editor
• Reload the system manager configuration with the command line:
• sudo systemctl daemon-reload
•  Enable the service that has just been created
•  sudo systemctl enable DeployServer.service
• Run the service:
•  sudo systemctl start DeployServer.service
• Check the status of the service:
•  sudo systemctl status DeployServer.service

This procedure has now finished. Congratulations! You have successfully installed the Movicon Deploy Server on your Ubuntu 20.04. device. You can now connect to the Deploy Server using the following credentials:

Nome utente: MoviconUser@emerson.com
Password: MyPwd123!

Please remember that these credentials are provisional, and we strongly recommend that you change them to improve the security of your Ubuntu device’s environment.