Troubleshooting
Problem
When using Floating licenses on the IBM Rational License Key Server a checked out license can be returned prematurely by using the FlexNet application lmutil and the lmremove command. This command has two usages and for some licenses this will fail using one of the syntaxes.
Symptom
In a situation where a license is no longer used but still being checked out from a license server, it might be convenient to force a return of the license. This is possible if the license server has been started.
To return the license, use the FlexNet lmutil application and the lmremove command.
lmutil lmremove [-c license_file_list] feature user user_host display
or
lmutil lmremove [-c license_file_list] -h feature server_host port handle
The needed parameter values can be obtained from a license listing by using
lmutil lmstat -c license_file_list -a
For some licenses when using the first syntax form the lmremove will fail with the error:
lmremove: feature/user/host/display not found
When using the second syntax form the lmremove works as expected.
Licenses that are affected are token licenses, like TLSTOK license features, and some of the licenses checked out by server applications, for example licenses for IBM Rational Synergy and IBM Rational
Change.
Cause
This is caused by a FlexNet limitation and it is currently not being documented in the FlexNet License Administration Guide.
Resolving The Problem
When using the lmremove command be sure to use the second syntax variant to force a license return.
As an example if the resulting lmstat listing for the TLSTOK license is
userABC hostDEF displayGHI (v1.0) (lichost/27000 103), start Mon 5/21 9:23
then the lmremove command should be
lmutil lmremove -c 27000@lichost -h TLSTOK lichost 27000 103
Note that if a license is returned by lmremove and the licensed application is still running that license will be reclaimed after a short while and the licensed application may fail to work. Thus this
functionality cannot be used to increase the number of available licenses.
For a detailed description of the FlexNet applications and the lmremove command consult the FlexNet License Administration Guide available at www.flexera.com
Was this topic helpful?
Document Information
Modified date:
16 June 2018
UID
swg21596282