6.2.2.1 Comments in license files

Lines beginning with ‘#’ are treated as comments and not interpreted by RLM. Comments may be added to a license file without invalidating the signatures of licenses, but should not be added between the lines of a multiple-line license. Here is an example:

#
# Licenses served by host gt2
#
HOST gt2 0000a74f88ce 5053
ISV reprise
#
# Original license for v3.0 (10 seats)
#
LICENSE reprise joe 3.0 permanent 10 _ck=f81efcf79a
sig="60PG451KTXVQ0WYBX785XAKTDKUCHB7T683Y2MG22M088S8UAFR0VKPMFGPKH4XW4H5QQ8JSFFJG"
#
# v4.0 license (5 additional seats)
#
LICENSE reprise joe 4.0 permanent 5 _ck=3b1efcd48c
sig="60P045145JSKEJSR48V3GXCX29S8TM5TKE91TS022HW0XAEEWH82DRTCJB830AWEV62MUE2N7C"

Note: Prior to RLM v9.3, the comment character was not strictly required on comment lines. With improved error checking in 9.3 however, the comment character is required.

Special License Names

Any product name beginning with “rlm_” is reserved to Reprise Software.

The product name rlm_roam is treated specially by RLM. rlm_roam indicates that roaming has been enabled by an ISV. If an ISV issues an rlm_roam license, then roaming is enabled on any computer which is able to check out the rlm_roam license while in a disconnected state.

Legal characters in the license file

In general, all license file fields are white-space delimited, meaning that no data item can contain embedded spaces, tabs, newlines or carriage returns. In addition, the following six characters are illegal in data items in the license (and options) file except as noted below: “<”, “>”, “&”, single quote (‘), back-quote (`) and double-quote (“).

As of RLM v12.2, “<”, “>”, “&”, single quote (’) and back quote (`) are legal characters in the customer field.

ISV license names cannot begin with the characters “rlm_”.

Note: All lines in license files as well as option files (RLM or ISV) must be shorter than 1024 characters. Anything over 1024 characters will be truncated.

Everything in the license file is case-insensitive, with the following three exceptions:

isv-binary-pathname on ISV lines [Case-sensitive on Unix systems only]
options-file-filename on ISV lines [Case-sensitive on Unix systems only]
Short (~62-character) license keys (keys with bits/character of 6 - see creating-licenses)

Note:

Any time RLM processes a username, it will replace any white space in the name with the underscore ‘_’ character. This is true for usernames used as hostids, in server option files, or passed between client and server. Also note that usernames are case-insensitive – they are converted to all lowercase in the license server.

The following sections describe each of the three types of license file lines (6.2.2.3 HOST Line, 6.2.2.4 ISV Line, 6.2.2.5 LICENSE Line).