6.2.3 License Administration Tools

The rlm server is delivered with an embedded Web Server to perform normal administration tasks. For more information on the web server interface, see The RLM Web Server.

In addition, the RLM kit is delivered with several command-line administration tools to perform various administration tasks on the license servers as well as to retrieve information about licensing parameters. While the RLM web interface is the preferred method to administer RLM license servers, the command-line tools are provided as a convenience for use in administration scripts and programs. License Administrators can manage rlm by using the administration tools, as described in detail below: rlmdebug, rlmdown, rlmhostid, rlmnewlog, rlmremove, rlmreread, rlmstat, rlmswitch, and rlmswitchr. On UNIX platforms, rlmutil is an all-in-one utility which is installed with hard links to all the utility program names. On Windows, separate .exe files are provided for each utility.

RLM has the ability to restrict usage of the remove, reread, shutdown, status and option editing requests. All restrictions are done via the RLM Options File. For a description of how to restrict command usage, see The RLM Options File.

All utilities take the following options:

OptionMeaning
-c license_specuse 'license_spec' instead of the current directory to find license files. 'license_spec' can be either a license file or a port@host specification. The -c option overrides RLM_LICENSE.
-datuse *.dat as the license file instead of *.lic
-hprint usage information and exit
-qdon't prompt/quiet (for rlmdown/rlmremove/rlmswitch/rlmhostid). -q also turns off the verification of license checksums and corresponding error messages for all commands.
-vprint version number and exit
-z passworduse password as license password for command (enclose in quotes if password contains white space