Installing MERLIC Under Linux

On Linux systems, MERLIC needs to be installed via the command line. The respective archives for the installation can be downloaded from the MVTec website. In addition, some manual configuration is required after the installation such as providing the MERLIC5.ini file and checking the firewall settings.

For Linux systems, only selected components of MERLIC are available: MERLIC RTE, MERLIC Frontend, MERLIC tools, MVApp examples, communication plugins, and the SDK for the development of communication plugins. For the creation of the MERLIC Vision Apps, you still need to use the MERLIC Creator on a Windows system and create a recipe for your application. The MVApp and recipe can then be used with MERLIC RTE on Linux systems.

Downloading MERLIC

Keep in mind that you must be logged in with your MVLogin to access the download area. If you have no MVLogin account, you have to register first.

Log in to MVTec's download area: https://www.mvtec.com/downloads.
Click on the MERLIC icon to access the MERLIC packages. You can use the filter options to show only the packages for Linux systems and the desired architecture.
Download the required packages. In section Available Packages for Linux, you can find an overview of the packages and which ones are mandatory for your purposes.
Optionally, download the add-on packages for the examples and the SDK for the plugin development.

Available Packages for Linux

The following archives are available for download for the respective architectures. Depending on your purpose and which component of MERLIC you want to use on your system, different packages might be mandatory.

Package	Description	Mandatory for RTE	Mandatory for Frontend
Runtime Version	Contains the archive including the components for MERLIC RTE and the standard communication plugins: merlic-26.10.0-aarch64-linux_merlic_rte-dl.tar.gz (aarch64-linux) merlic-26.10.0-x64-linux_merlic_rte-dl.tar.gz (x64-linux)	✔
Frontend	Contains the archive for the MERLIC Frontend merlic-26.10.0-aarch64-linux_merlic-frontend.tar.gz (aarch64-linux) merlic-26.10.0-x64-linux_merlic-frontend.tar.gz (x64-linux)		✔
Add-on to Full / Runtime Version - Tools	Contains the archive with all MERLIC tools: merlic-26.10.0-tools_all.tar.gz	✔
Add-on to Full / Runtime Version - Examples	Contains the archive with all examples such as MVApp examples and all files required for the examples: merlic-26.10.0-examples.tar.gz
Add-on to Full / Runtime Version - Communicator SDK	Contains the archive with the SDK required for the implementation of custom communication plugins: merlic-26.10.0-aarch64-linux_communicator-sdk.tar.gz (aarch64-linux) merlic-26.10.0-x64-linux_communicator-sdk.tar.gz (x64-linux)

If you want to use MERLIC RTE on your system, you have to download and install the packages for the Runtime Environment and the MERLIC tools. All other packages are optional.

If you only want to use the MERLIC Frontend on your system, you only have to download and install the "Frontend" package. No other package is required in this case.

License-Free Components

The MERLIC Frontend requires no license. It can be used without activating a license.

Installing MERLIC RTE

For the installation, unpack the downloaded archives:

Change to the directory in which you want to install MERLIC RTE. You can choose any directory of your choice, for example, "/opt/projects/MVTec".

Unpack the downloaded archive for MERLIC RTE:

Linux on PC

Copy

tar xf merlic-26.10.0-x64-linux_merlic_rte-dl.tar.gz

Linux on Arm^®-based platform

Copy

tar xf merlic-26.10.0-aarch64-linux_merlic_rte-dl.tar.gz

A new directory "merlic-26.10.0" will be created. If you already installed MERLIC Frontend in the same directory, the files will be installed in the existing MERLIC installation directory.
Unpack the archive for the MERLIC tools into the directory "merlic-26.10.0".
Copy
```
tar xf merlic-26.10.0-tools_all.tar.gz
```
If you downloaded further optional archives, unpack each archive into the new directory in the same way as the other packages.

MERLIC is now installed on your Linux system. No further installation steps are necessary. All unpacked archives are now located in the sub-directory "merlic-26.10.0".

Before using MERLIC, please activate your license. For more information, see Activating a MERLIC License.

Installing MERLIC Frontend

For the installation, unpack the downloaded archives:

Change to the directory in which you want to install MERLIC Frontend. You can choose any directory of your choice, for example, "/opt/projects/MVTec".

Unpack the downloaded archive for MERLIC Frontend:

Linux on PC

Copy

tar xf merlic-26.10.0-x64-linux_merlic-frontend.tar.gz

Linux on Arm^®-based platform

Copy

tar xf merlic-26.10.0-aarch64-linux_merlic-frontend.tar.gz

A new directory "merlic-26.10.0" will be created. If you already installed MERLIC RTE in the same directory, the files will be installed in the existing MERLIC installation directory.

MERLIC Frontend is now installed on your Linux system. No further installation steps are necessary. All unpacked archives are now located in the sub-directory "merlic-26.10.0".

Providing the "MERLIC5.ini" File

For MERLIC RTE on Linux systems, an INI configuration file is required. The default configuration file is named "MERLIC5.ini" and is expected in the directory "~/.config/MVTec/".

The archives for the installation of MERLIC RTE on Linux systems come without any INI file. Therefore, you have to add the file manually after the installation.

There are different ways to add the configuration file:

Copy an existing INI file from a different installation. For example, if you have a MERLIC installation on your Windows system, we recommend using the INI file that was used when creating your MVApps.
Create a new INI file.

If you want to use the default INI file, make sure to name the file "MERLIC5.ini" and to save the file in the correct directory.

Example INI File

Copy

[Logging]
LogFilePath=/opt/projects/MVTec/merlic/mvapp/logs/
LogFileSizeInBytes=5242880
LogFilesCount=10
Threshold=info
UseShortFilenames=true

[ProcessIntegration]
Recipe0=/opt/projects/MVTec/merlic/mvapp/merlic_rte.mrcp
DefaultRecipe=0

[Frontend]
GuiLanguage=en_US

Location of the INI File

The default INI file "MERLIC5.ini" is expected in a specific directory: "~/.config/MVTec/". It will be used by default, when starting MERLIC RTE on Linux without specifying an INI file.

If you want to use a different configuration file, you can save the INI file in any directory and with any name of your choice. You can also add multiple configuration files for different use cases. When starting MERLIC RTE, you have to specify the path and name of configuration file that shall be used. This can be done with the command line option "--ini". The INI file must be given with the relative path to the current directory in which MERLIC RTE is started.

Keep in mind that you have to adjust the paths in the INI file to the new paths on your Linux system as described in Additional Setup Steps for Linux.

Checking the Firewall Settings

If you are using a firewall, you have to make sure that your firewall settings allow the remote connection between your Linux system and the respective MERLIC components on the Windows system that is used for the remote configuration.

None of the MERLIC processes and components use any default port. Therefore, it might be necessary to adjust your firewall settings when you have finished setting up MERLIC for your testing or productive environment. You may then allow all ports that you have defined in your setup.

Possible port settings may be the following:

The port for remote connections defined in the configuration file of the MERLIC Directory Agent. For more information, see Configuring the Directory Agent for Remote Connections.
All ports for communication plugins that are used as server, for example, the OPC UA, REST, and TCP Socket plugins. If you are using such a plugin, the respective ports need to be allowed for "merlic_communication_plugin_host".

Further Information

When using MERLIC on a Linux system, some additional setup steps need to be considered when setting up the application for MERLIC RTE or when starting MERLIC RTE on Linux. You can find more information in the following pages: