< Back

Reprise License Manager rlmremove utility and how to use it


Problem:

How can I remove a specific license from being borrowed?

Solution:

You can use the rlmremove utility from the command line on your RLM host machine to release a hung license back to the servers pool of free licenses (see pages 16-17 of the RLM Users Manual rlm_install.pdf). That is with this command you can stop a checked-out license from being used. This is useful if you wish to shorten a borrowing period or if the license becomes hung and cannot be used or returned according to the normal methods.

To use the rlmremove utility start by running rlmutil from the command line by following these platform-specific instructions.Windows Platforms: Use the command line to navigate to the RLM installation folder. Once in the installation folder type rlmutil into the command window (without the quotation marks) and press Enter/Return.Linux/Mac Platforms: Use the terminal window to navigate to the RLM installation folder and run rlmutil from a system startup script (by typing ./rlmutil into the terminal window without quotation marks and pressing Enter/Return).

After you have done this the rlmutil executable will display additional instructions for using the rlmutil commands (including rlmremove) in the terminal/command window.

Syntax:

rlmremove [-q] host port isv handle

Definitions:

-q  An optional flag that will cause the license to be removed without a confirming prompt

host  Use the name of your machine hosting RLM

port  Use the port number of your machine hosting RLM

isv  Use the word reprise handle Use the handle of the machine whose license you wish to remove given by the rlmstat utility (explained following)

How to determine the handle:

To determine the handle of the machine whose license you wish to remove after running rlmutil through your terminal/command window type rlmstat -a (without quotation marks) to print a list of the status of all machines using the RLM host.

Consider this example of rlmstat -a output:

reprise license usage status on melody (port 1215)test3 v1.000: tom@sun1(v1.0) (809f418) 1/0 at 02/06 09:59

In this example the host is melody the port is 1215 the handle is 809f418 and the isv is reprise. Therefore to remove the user tom on the machine sun1 issue this command:

rlmremove melody 1215 reprise 809f418