lmremove (in License File–Based Licensing)

The lmremove utility enables you to remove a single user’s license for a specified feature. If the application is active, it rechecks out the license shortly after it is freed by lmremove. Note that lmadmin’s default setting disables lmremove. To enable lmremove, start lmadmin with the -allowLicenseReclaim argument.

Usage

lmremove [-c license_file_list] feature user user_host display

or

lmremove [-c license_file_list] -h feature server_host port handle

 

lmremove in License File–Based Licensing Argument Usage

Argument	Description
-c license_file_list	Specify license files.
-h	Specify the license by its handle. Include feature, server_host, port, and handle with this argument.
feature	Name of the feature or component checked out by the user whose license is to be removed. Important:Do specify a package name instead of a feature name.
user	Name of the user whose license you are removing, as reported by lmstat -a.
user_host	Name of the host the user is logged into, as reported by lmstat -a.
display	Name of the display where the user is working, as reported by lmstat -a.
server_host	Name of the host on which the license server is running.
port	TCP/IP port number where the license server is running, as reported by lmstat -a.
handle	License handle, as reported by lmstat -a.

The user, user_host, display, server_host, port, and handle information must be obtained from the output of lmstat ‑a.

lmremove removes all instances of user on user_host and display from usage of feature. If the optional -c license_file_list is specified, the indicated files are used as the license file.

The -h variation uses the server_host, port, and license handle, as reported by lmstat -a. Consider this example lmstat ‑a output:

joe nirvana /dev/ttyp5 (v1.000) (cloud9/7654 102), start Fri 10/29 18:40

In this example, the user is joe, the user host is nirvana, the display is /dev/typp5, the server host is cloud9, the TCP/IP port is 7654, and the license handle is 102.

To remove this license, issue one of the following commands:

lmremove f1 joe nirvana /dev/ttyp5

or

lmremove -h f1 cloud9 7654 102

When removing by handle, if licenses are grouped as duplicates, all duplicate licenses are also removed. If license lingering is set and lmremove is used to reclaim the license, lmremove starts, but does not override, the license’s linger time.

You can protect the unauthorized execution of lmremove when you start up lmgrd. The default for lmadmin is to disable lmremove because removing a user’s license is disruptive.

See Also

Installing lmadmin

lmgrd Command-Line Syntax for details about securing access to lmremove