Server Configuration

To configure the server you have to edit the respective INI file. You can find the default "MERLIC5.ini" file in the directory %AppData%\MVTec.

Activating the Server

For the activation or deactivation of the server, there is a setting in the INI file in the section [General]

Copy
[General]
StartServer=true

Specifying Properties

In case of an activated server, the properties for the server must be added to the section with the label [Server]. If the INI file does not contain the [Server] label yet, you may add it to the file and define the settings for the Server below the new label.

For example, the maximum number of simultaneous connected Frontend is set like this:

Copy
[Server]
MaxConnections=5
WriteLockTimeout=10000
TcpHost=localhost
TcpPortMin=9090
TcpPortMax=9099

First, the [Server] label indicates that the following properties configure the server. In the second line the property is defined. In our case, the property "MaxConnections" is set to 5. If you want to configure further properties of the server, you may add each property setting in a new line.

The properties for the Frontend must be added to the [Frontend] section, e.g.,

Copy
[Frontend]
Port=9090

See the chapter The MERLIC INI File for more details.

Available Properties

Currently the following properties can be set for the configuration of the server:

Properties of the Section [General]

Property

Default

Description

StartServer

true

This property defines if the server start up is omitted during the initialization of MERLIC.

Properties of the Section [Server]

Property

Default

Description

AnonymizeFrontendLog

false

This property can be used to define if the logged data are stored together with the corresponding user who made the changes. If it is set to "false", the user name is also stored with the logging data. If it is set to "true", the data are logged without any user information.

MaxConnections

10

This property sets the maximum number of allowed simultaneous connected Frontends.

TcpHost

 

This property defines the local IP address on which the MERLIC Server listens for Frontends to connect. By default, no value is set and the server listens on all network interfaces for IPv4 and IPv6 connections.

If the host is set to 0.0.0.0, only IPv4 is available. If it is set to localhost or 127.0.0.1, the server only listens for locally running Frontends to connect.

TcpPortMax

9099

This property determines the maximum port of a range of ports the server should listen for Frontends to connect. Normally the server listens on "TcpPortMin". In case this port is already used by another application, MERLIC server uses the next available port within the defined range up to "TcpPortMax".
If ports should not be adapted automatically, "TcpPortMax" can be set equal to "TcpPortMin". In case the single port is not available, no TCP connection is possible.

TcpPortMin

9090

This property determines the minimum port of a range of ports the server should listen for Frontends to connect.

Normally the server listens on "TcpPortMin". In case this port is already used by another application, the MERLIC Server uses the next available port within the defined range up to "TcpPortMax".

WriteLockTimeout

10000 [ms]

This property sets the duration for the write lock of a Frontend if the user interaction in a concurrent Frontend has been finished.
If multiple Frontends are used simultaneously and a user performs any interaction within a Frontend, all other Frontends will be locked. When the user stops interacting in the Frontend, the counter of the "WriteLockTimeout" starts. In case of another user interaction, the write-permission is automatically renewed. If no further user interaction takes place during this time, the permission for modifying parameters can again be requested by any other connected Frontend.