General Settings

Top  Previous  Next

This group defines LinkServer global parameters that do not belong to any subcategory.

Preferred language

Key name in the configuration file: locale

Value type: String

Possible values: all two-letter ISO country (language) codes

Default value: English ("en" in the configuration file)

Defines the language used by LinkServer. If localization resources are not available for this language, LinkServer will use English resources even when another language is selected as preferred.

Server Time Zone

Key name in the configuration file: timezone

Value type: String

Possible values: A list of time zones supported by Java VM

Default value: Time zone set up in the operating system under which LinkServer is launched, or GMT if the OS time zone can't be detected. See Dealing with Time Zones for more info.

Server IP Address

Key name in the configuration file: serverIp

Value type: String

Possible values: Any valid IP address or empty string

Default value: "" (empty)

If this setting is set to a valid IP address, LinkServer listens for incoming connections of Device Servers, AggreGate Clients and Web Admin users only on this IP address. This setting may be useful to run multiple instances of LinkServer on a single hardware server that has several IP addresses. In this case, every instance of LinkServer will accept incoming connections on the same ports, but on different IP addresses.

This IP address is also written as a Destination IP to the External Device Servers that are being connected to the LinkServer.

Server Host Name

Key name in the configuration file: serverHostName

Value type: String

Possible values: any valid network host name or empty string

Default value: "" (empty)

If this setting has a value, it is used as an additional alias by the embedded web server. Also, it is used to access Device Servers that work through HTTP Proxy.

Port number to listen for normal Device Server connections (0 to disable)

Key name in the configuration file: deviceServerPort

Value type: Integer

Possible values: 0-65535

Default value: 6450

This option defines the port number for Device Server logins, i.e. the port to which Device Servers should establish connections. If set to zero, non-secure Device Server connections are not allowed.

Port number to listen for secure Device Server connections (0 to disable)

Key name in the configuration file: deviceServerSslPort

Value type: Integer

Possible values: 0-65535

Default value: 6455

This option defines the port that is used to accept secure connections of Device Servers.  If set to zero, secure Device Server connections are not allowed.

Enable users self-registration

Key name in the configuration file: usersSelfRegistration

Value type: Boolean

Possible values: true or false

Default value: true

When enabled, anyone who can access Web Admin or an AggreGate Client installation can register a user account, log in and use LinkServer. When this option is disabled only registered users with corresponding permissions can add new user accounts.

Enable GUI mode (yes, no, or auto)

Key name in the configuration file: configGuiMode

Value type: String

Possible values: yes, no, auto

Default value: auto

This option defines whether the LinkServer will make any output to the GUI (Graphical User Interface) of the server. GUI output used includes: Splash Screen at startup, icon in the System Tray, and error message boxes. When this option is disabled, no output to the GUI will be made.

Enable Net Admin feature

Key name in the configuration file: netAdminEnabled

Value type: Boolean

Possible values: true or false

Default value: true

This option enables or disables local Telnet access to the Net Admin interface. It is recommended to turn this option off if untrusted users have local (physical or shell) access to the host running LinkServer.

Net Admin port number

Key name in the configuration file: netAdminPort

Value type: Integer

Possible values: 1-65535

Default value: 6440

This option defines the port on which local Net Admin connections will be accepted.

Default Data Transfer/Device Plugin

Key name in the configuration file: defaultDevicePlugin

Value type: String

Possible values: Auto Detect or any Data Transfer/Device Plugin available for LinkServer

Default value: "" (empty, corresponds to Auto Detect)

This options defines which Data Transfer/Device Plugin is used for processing data by a newly created Device Server context. This is the ID of the default plugin, not its name. This option is normally edited through a GUI (such as AggreGate Client), which includes all needed IDs. Finding the correct plugin ID for manually entering it in the configuration file is beyond the scope of this manual. This option defaults to a Dynamic DNS plugin.

If this options is set to Auto Detect, LinkServer will set Data Transfer/Device Plugin option in the settings of newly created Device Server account to Auto Detect. The actual plugin to be used will be provided by the Device Server during its first login and stored in the settings of Device Server account.