SERVER Lines

The SERVER line specifies the host name and hostid of the license server and the TCP/IP port number of the license server manager (lmadmin or lmgrd). It can also optionally include the host environment restriction, which defines the types of environments where the license server manager (lmgrd only) is permitted to run. Normally a license file has one SERVER line. Three SERVER lines mean that you are using license servers configured for three-server redundancy. The absence of a SERVER line means that every feature definition line in the license file is uncounted.

The hostids from the SERVER lines are computed into the license key or signature on every feature definition line. For this reason, make sure you keep SERVER lines together with any feature definition lines as they were sent from the software publisher.

The format of the SERVER line is as follows:

SERVER host hostid [port] [PRIMARY_IS_MASTER] [HEARTBEAT_INTERVAL=seconds] [PLAT=n]

The following table describes the attributes on this line.

SERVER Line Format

Field

Description

host

The system host name or IP address. String returned by the UNIX hostname or uname -n command.

hostid

Usually the string returned by the lmhostid command. This is changed only by your publisher.

port

TCP/IP port number to use. You can edit this value either directly in the license file or using lmadmin. In the latter case, the port number specified in lmadmin takes precedence over any port set in the license file, either before or after the port is specified using lmadmin. Therefore, editing the port number using lmadmin is only recommended if no port number is specified in the license file. If a port number is already specified in the license file and the port is subsequently changed in lmadmin, during the next restart the vendor daemon will exit with a “port mismatch” error.

A valid number is any unused port number in the range 1 to 65535. On UNIX, choose a port >1024, since those <1024 are privileged port numbers.

If you specify a port number greater than 65535, the client fails to establish a connection with the license server manager (lmgrd or lmadmin).

If no port number is specified, one of the default ports in the range 27000 to 27009 is used.

You must specify a port number when the SERVER line defines license servers configured for three-server redundancy.

Note:Those producers concerned about potential DoS attacks based on knowledge of common license server ports may want to consider specifying a server port outside the range 27000 to 27009.

PRIMARY_IS_MASTER

Used with license servers configured for three-server redundancy to indicate how master control is transferred between the primary and secondary servers.

•

If this is set and the primary server goes down, when the primary server comes back up again, it will always become the master.

•

If this is not set and the primary server goes down, the secondary server becomes the master and remains the master even when the primary server comes back up. The primary can only become the master again when the secondary license server fails.

If both primary and secondary go down, licenses are no longer served. The tertiary server never becomes the master.

This parameter is optional and is placed on the first SERVER line in the license file. You must be running a version 10.8 or later vendor daemon to use this parameter.

HEARTBEAT_INTERVAL=
seconds

Used with license servers configured for three-server redundancy to indicate how long a license server waits to receive a heartbeat from another license server in the triad before shutting itself down. The seconds value is used in the following equation to calculate the timeout:

•

timeout = (3 x seconds) + (seconds - 1)

Valid timeout value is 0-120. If not specified, the default value for seconds is 20, equating to an actual timeout value of 79 seconds. Valid values for the seconds value are 0–30.

Note:When the seconds value exceeds 30, lmadmin displays the Heartbeat Interval value as -1 along with the an error message "Invalid three server redundancy configuration, valid timeout values are 0 - 120".

This parameter is optional and is placed on the first SERVER line in the license file. You must be running a version 10.8 or later vendor daemon to use this parameter.

PLAT=n

Restricts the license server manager (lmgrd only) operation to specific host environments—physical, virtual, or container. This host environment enforcement is based on the defined value of n parameter. For more information, see SERVER Lines Enforcement

The following examples demonstrating different configurations:

•

A single SERVER line including host, hostid, port, and PLAT=n:

SERVER my_server 17007ea8 21987 PLAT=4

•

Configuration with three SERVER lines, including the PRIMARY_IS_MASTER and PLAT=n in the first line:

SERVER my_server1 ANY 21987 PRIMARY_IS_MASTER PLAT=1

SERVER my_server2 ANY 21987

SERVER my_server3 ANY 2198