rlftool - Manage Redundant License File

rlftool is a command line utility for Windows and UNIX. On a Windows computer, use rlftool from the command prompt. However, you may find it more convenient to use the WRlfTool program that has a GUI like Windows rather than using the rlftool command-line utility.

To use rlftool in menu mode to create a new redundant license file, from DOS type:

NOTE   Make sure that the full path you specify for the redundant license file does not include any of the Sentinel RMS-reserved characters. These are: <> angle brackets, [] square brackets, # hash sign, @ at sign, and ? the question mark. Using these characters may result into uncertain outcomes.

rlftool

Or, to modify an existing redundant license file, type:

rlftool -l redundant-license-file

You then see a menu that lists the rlftool options. Type the number of the option you want to use and press Return. (At a minimum, you will want to use option 1 to create a new file, option 2 to add License Managers to the pool, and then option 7 to add license codes.) To exit and save the file, type 12 and press Return.

Two options available when using rlftool in menu mode that are not available as command-line options are:

>Preference Order - The first redundant License Manager in the pool to be started is by default the leader. However, by setting the preference order, you can set the order in which the leader servers will be elected. If the License Manager having first preference goes down, the License Manager with second preference will be elected as the leader, and so on.

>View/Edit License - You can select an existing license to view its token allocations.

To use rlftool's tool command-line option, type rlftool followed by any of the desired options except -l (which will take you to the menu).

The rlftool options are:

Options Description

-h

(Help.) Displays list of rlftool options.

-l filename

Load or create a redundant license file.

-a <server name> <ip address>

Add the License Manager specified by the host name and IP address given to the redundant License Manager pool.

NOTE   Starting version 9.1.0, you can use both static and dynamic IP addresses to add a License Manager to the Redundant License Manager pool. This option supports both Internet Protocol version 4 (IPv4) or 6 (IPv6) based dynamic IP addresses. To use a dynamic IP with this option:

>Enter Dyn_IPv4 as the IP address to use an Internet Protocol version 4 (IPv4) based IP addresses.

>Enter Dyn_IPv6 as the IP address to use an Internet Protocol version 6 (IPv6) based IP addresses.

-d <server name>

Delete the License Manager specified by the host name from the redundant License Manager pool.

-A <license code>

Add the specified license code to the redundant license file. Enclose the license code in quotation marks.

-F < license filename>

Add the license codes contained in the specified text file to the redundant license file.

-D <feature name> <feature version>

Delete a license code from the redundant license file for the specified feature name and version.

-p <pool name>

Change the redundant License Manager pool name to the one specified. May be 8 characters.

-s <sequence number>

Change the sequence number of the redundant license file. (A mismatch in sequence numbers triggers transmission of the redundant license file to the other redundant License Managers when the License Manager on which this change is being made is stopped and restarted. Not necessary except in extraordinary circumstances, because this is handled for you automatically.)

-t <time stamp>

Change the time-date stamp of the redundant license file. (A mismatch in time-date stamps triggers transmission of the redundant license file to the other redundant License Managers when the License Manager on which this change is being made is stopped and restarted if the sequence number is the same in all of the redundant license files. Not necessary except in extraordinary circumstances, because this is handled for you automatically.)

-R <report filename>

Write the redundant license file contents to the specified file.

-C <conflict report filename>

Write any conflicts between token allocation and License Managers to the specified file.