lmremove (in Trusted Storage–Based Licensing)

The license administrator can use the lmremove utility to perform trusted storage borrow reclaim actions when these have been enabled by publisher. Note that lmadmin’s default setting disables lmremove. To enable lmremove, start lmadmin with the ‑allowLicenseReclaim argument.

Usage

Concurrent

lmremove [-c license_file_list] feature user user_host display

Activate or Borrow

lmremove <-c licfile> [-tsborrow <client_hostname>] | [-tsborrowstat]

where:

lmremove in Trusted Storage Argument Usage

Argument	Description
-c	Specifies both license file and port@host.
-tsborrow	Specifies trusted storage borrow reclaim, using this option along with client host name is mandatory.
client host name	The deduction record(s) associated with the hostname that could be reclaimed.
tsborrowstat	Specifies trusted storage borrow reclaim status. When this option is used, no borrow reclaim operation would be performed and borrow reclaim status would be displayed with the following information: • Number of licenses borrowed currently • Percentage borrow reclaim level • Count of reclaimed licenses • Number of borrow reclaims currently available

The lmremove utility allows the license administrator to perform borrow reclaim action by removing the deduction records from server trusted storage for the specified client host.

The publisher can enable this feature by setting appropriate values for the borrow reclaim percentage. By default, the reclaim percentage is set to 0 so the reclaim operation is not allowed.

The licenses activated or borrowed from the activatable and hybrid license group can be reclaimed.

The Concurrent feature served out from a TS location can also be reclaimed.

To be able to use the borrow reclaim feature, the lmremove utility should run on the same system as license server.

For example,

•

borrow reclaim percentage is 10%

•

total license count is 25

•

client "nirvana" borrowed a license from server trusted storage

•

client “cloud9” activated 2 licenses from server trusted storage

To view the borrow reclaim status on the license server, issue one of the following commands:

lmremove -c port@host –tsborrowstat

or

lmremove -c counted.lic -tsborrowstat

Output similar to following is displayed:

=== ACTIVATION BORROW RECLAIM STATUS ===

Number of licenses borrowed currently: 24

Percentage borrow reclaim level: 10%

Count of reclaimed licenses:0

Number of borrow reclaims currently available: 2

Number of borrow reclaims currently available = ((total number of deduction records * borrow reclaim percentage) – (count of reclaimed licenses) = (24 * 10%) – (0) = 2.4 rounded to 2.

Assume, the client host “nirvana” is lost or damaged.

To reclaim the borrow licenses issued for client host “nirvana”, issue one of the following commands:

lmremove –c port@host –tsborrow "nirvana"

or

lmremove –c counted.lic –tsborrow "nirvana"

Output similar to the following is displayed:

Lmremove: Sucessfully reclaimed (1) borrowed licenses(s) for the client "nirvana".

Now, view the borrow reclaim status, issue one of the following the commands:

lmremove -c port@host –tsborrowstat

or

lmremove -c counted.lic -tsborrowstat

Output similar to following is displayed:

=== ACTIVATION BORROW RECLAIM STATUS ===

Number of licenses borrowed currently: 23

Percentage borrow reclaim level: 10%

Count of reclaimed licenses:1

Number of borrow reclaims currently available: 1

Notice that, the count of reclaimed licenses is incremented by the number of deduction records that are reclaimed.

Note:When a reclaimed deduction record expires, the “Count of reclaimed licenses” is decremented by the one.

Assume, the client host “cloud9” is lost or damaged. To reclaim the borrow licenses issued for client host “cloud9”, issue one of the following commands,

lmremove –c port@host –tsborrow "cloud9"

or

lmremove –c counted.lic –tsborrow "cloud9"

Output similar to following is displayed:

lmremove: Failed to perform activation borrow reclaim operation. (-205, 14100)

Failure reason: The requested activation borrow reclaim count (2) for client "cloud9" is greater than available reclaim count (1).

Assume, two more licenses are activated or borrowed. So, the number of deducted records is 25. Now, to reclaim the licenses issued for client host “cloud9” issue one of the following commands,

lmremove –c port@host –tsborrowstat

or

lmremove -c counted.lic -tsborrowstat

Output similar to following is displayed:

Lmremove: Successfully reclaimed (2) borrowed licenses for the client "cloud9".

Now, to view the borrow reclaim status, issue one of the following commands,

lmremove –c port@host –tsborrowstat

or

lmremove -c counted.lic -tsborrowstat

Output similar to following is displayed:

=== ACTIVATION BORROW RECLAIM STATUS ===

Number of licenses borrowed currently: 23

Percentage borrow reclaim level: 10%

Count of reclaimed licenses: 3

Number of borrow reclaims currently available: 0

Now the borrowed reclaim level of 10% is reached so no more reclaims are allowed. To reclaim any more licenses, the license administrator creates an offline request to reset the reclaimed license count.

To reset the reclaimed license count, issue the following command and send the request.xml to publisher.

servercomptranutil –new request.xml reference=BorrowClaimReclaim

To process the reset response from publisher, issue the following command,

servercomptranutil -process response.xml

Now, view the borrow reclaim status, issue one of the following commands,

lmremove –c port@host –tsborrowstat

or

lmremove -c counted.lic -tsborrowstat

Output similar to following is displayed:

=== ACTIVATION BORROW RECLAIM STATUS ===

Number of licenses borrowed currently: 23

Percentage borrow reclaim level: 10%

Count of reclaimed licenses: 0

Number of borrow reclaims currently available: 2

Notice that, the count of reclaimed licenses is reset to 0 and the number of borrow reclaims currently available are two.

See Also

Installing lmadmin

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