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). 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:

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

For example:

SERVER my_server 17007ea8 21987

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.

See Also

Ensuring License Availability