Starting the Frontend with a Remote Connection

MERLIC enables you to start a Frontend without starting a locally installed MERLIC core The processing unit of a running MERLIC Vision App.. This is especially useful if you want to access the MERLIC server from a remote computer. The MERLIC server is part of the core that was started on a host machine. To enable a remote connection, you need to specify the MERLIC server to which the Frontend should connect to, i.e., the provided channels and the host machine of the MERLIC server.

You can specify the MERLIC server by setting the connection settings either in the .ini file ("MERLIC5.ini" by default) or as command line option.

Connection Settings in the .ini File
Connection Settings as Command Line Option

See the chapters Frontend Configuration and Server Configuration for more information about the configuration settings.

Prerequisites

MERLIC must be installed on the server as well as the client.
To establish a connection, the server must already be running.

Compatibility of remote Frontend connections between MERLIC 5.6.2 and older version:

When connecting the Frontend of a MERLIC 5.6.2 installation remotely to an instance of the MERLIC Creator or MERLIC RTE of a MERLIC 5.1 installation (or older), the connection succeeds but the Frontend window remains blank. Vice versa, the Frontend of a MERLIC 5.1 (or older) installation fails to display the Frontend served up by an instance of MERLIC Creator or MERLIC RTE of a MERLIC 5.6.2 installation.

Connection Settings in the .ini File

The Frontend connection settings in the .ini configuration file are defined by the settings for "Host" and "Port". Both have a predefined default value which is used if no value is specified in the .ini file or as command line argument:

Property	Default value
Host	127.0.0.1
Port	9090

You may adjust the settings in the default MERLIC5.ini file or define your own .ini configuration file. An example configuration of the connection settings within the .ini file might be the following:

Copy

[Frontend]
Host=localhost
Port=9090

See the chapter Frontend Configuration for more information about the configuration settings.

Starting a Remote Frontend Using Connection Settings Defined in the .ini File

If you have adjusted the connection settings in your .ini file, you may start a Frontend with a remote connection.

On the computer where the Frontend should be started, connect to the remote computer on which MERLIC is installed.
Open a command prompt and change to the "bin\x64-win64" directory within the MERLIC installation path, for example, "%PROGRAMFILES%\MVTec\MERLIC-5.6\bin\x64-win64".
Start a remote Frontend:

Use settings of the default MERLIC5.ini file:
Copy
```
merlic_frontend.exe
```

Use the command line option --ini to open the Frontend with the settings of a specified .ini file:
Copy
```
merlic_frontend.exe --ini <FILENAME>.ini
```

If no connection settings have been defined in the respective .ini file, the default values will be used.

Connection Settings as Command Line Options

You may also define the connection settings for the Frontend as command line argument when starting the remote Frontend. For this, you can use the command line option "--tcp <HOST:PORT>" as described in the section below. If any connection setting is specified in form of a command line option, the connection settings in the .ini file will be ignored even if an .ini file is specified in the call.

Starting a Remote Frontend Using Connection Settings Defined in Command Line Options

Connect to the remote computer on which MERLIC is installed.
Open a command prompt and change to the "bin\x64-win64" directory within the MERLIC installation path, for example, "%PROGRAMFILES%\MVTec\MERLIC-5.6\bin\x64-win64".
Start a remote Frontend using the call "merlic_frontend.exe" and use the command line option "--tcp" to connect the Frontend to the MERLIC server at <HOST:PORT>. HOST defines the name or IP of the host machine and PORT defines the port to which the server listens.
Copy
```
merlic_frontend.exe --tcp <HOST:PORT>
```

For a complete list of command line options for "merlic_frontend.exe" see Starting the Frontend with MERLIC. Furthermore, the options "-h" and "--help" display help for the available command line options.