6.2.2.4 ISV Line

ISV isvname [isv-binary-pathname [options-file-filename [port-number]]] [binary=isv- binary-pathname] [options=options-file-filename] [port=port-number] [password=password-text]

The ISV line specifies an ISV's license server. There is one ISV line in the license file for every isvname which has licenses in that file. Note that if a license file contains only nodelocked- uncounted licenses for a particular isv, an ISV line is not required for that isv.

The isvname is the name assigned by Reprise Software to the ISV and does not change.

The ISV server can be delivered as either an executable (as in all older versions of RLM) or as a small, platform-independent ISV server settings file (named isvname.set by default).

The isv-binary-pathname is the filesystem location of the ISVs license server binary. This can be any accessible location. The isv-binary-pathname is not an input to the license key signature algorithm, so you can change it to relocate the ISV server at any time. The ISV pathname can be omitted if the isv server is located in the same directory as the rlm binary. If omitted, RLM will first attempt to open an ISV server settings file (isvname.set), and if that fails, will attempt to open a license server binary (isvname.exe on windows, or isvname on UNIX.

The third (optional) parameter specifies whether an options file is to be used for this license server. If you would like to specify options (see The ISV Options File), either specify the location of the file containing these options here, or name the ISV options file isvname.opt and place it in the directory which contains the license file which the server reads.

The fourth (optional) parameter specifies the port # which the ISV server will use. This should normally be omitted, but can be used if you need to access the ISV server across a firewall and the firewall needs to be configured to allow access to the port. Note that you must specify an options file if you want to specify an ISV server port number.

The fifth (optional) parameter specifies a license password to be applied to all LICENSE or FEATURE lines which follow the ISV line in the license file. If an individual LICENSE line has a password, the password from the LICENSE line is used.

In the old format, the parameters are strictly positional, and, for example, to specify a port #, the ISV server binary and options file must both be specified. However, in the new format, any of the optional parameters can be specified by themselves. Also note that any number of the positional parameters can be specified, and optional parameters can be added after the positional parameters.

Note that, in the new format, if you specify the same parameter both as a positional parameter and as a keyword=value parameter, the value of the keyword=value parameter will be used.

Examples:

ISV reprise /home/reprise/reprise /home/reprise/reprise.opt (old format)
ISV reprise options=/home/reprise/reprise.opt binary=/home/reprise/reprise (new format) ISV reprise /home/reprise/reprise port=8765 (new format)
ISV reprise /home/reprise/reprise binary=/a/b/reprise

In these examples, the license server for ISV reprise is located at /home/reprise/reprise and (in the first 2 examples) an options file is located at /home/reprise/reprise.opt. In the 3rd example an ISV server port # is specified. In the fourth example, the ISV server binary name /a/b/reprise will be used instead of /home/reprise/reprise.