How Do I Release a Hung Network License?

« Go Back

Information

 
QuestionHow do I release a hung network license?
Answer
The situation is this: STK is no longer in use by a user, but the Ansys License Manager shows that it is. This may happen due to an interruption of network connectivity and/or an abnormal termination of the software.
 
If your network license is hung and restarting the server is not an option, follow these steps to run the FLEXlm tool LMREMOVE.
 
1. Open a Windows Command prompt and go to the STK license manager directory. 
cd "C:\Program Files\AGI\STK 12\licensingclient\winx64"
2. First, run the lmutil lmstat command. 
Example:  
.\lmutil.exe lmstat -c "C:\Program Files\ANSYS Inc\Shared Files\licensing\license_files\ansyslmd.lic" -a
 
3. Note the output returned from the lmutil (lmstat) command.
Example Output:
 
[Detecting lmgrd processes...]
License server status: 1055@{Host ServerName}
    License file(s) on {HOST SERVERNAME}: C:\Program Files\ANSYS Inc\Shared Files\Licensing\license_files\ansyslmd.lic:

{HOST SERVERNAME}: license server UP (MASTER) v11.19.0

Vendor daemon status (on {HOST SERVERNAME}):

  ansyslmd: UP v11.19.0
Feature usage info:
Users of stk_mission_air:  (Total of 99 licenses issued;  Total of 1 license in use)

  "stk_mission_air" v9999.9999, vendor: ansyslmd, expiry: 18-jun-2027
  vendor_string: customer:00000001
  floating license

    jdoe {HOST SERVERNAME}.stk.com {HOST SERVERNAME}.stk.com 6136 (v2023.0505) ({HOST SERVERNAME}/1055 114), start Wed 12/6 15:33
  
The following information from this output is used in the lmremove syntax:
 
Feature (STKIntegration) - The license or feature that is hung
User (jdoe) - User name of the person who checked out the license
Host ({HOST SERVERNAME}.stk.com) - Hostname of the machine which the license was being used on
Display ({HOST SERVERNAME}.stk.com) - Name of display on which user is working
Port (1055) - Port that the license manager uses to communicate
LM_Server ({HOST SERVERNAME}) - Hostname of the license manager server
Handle (114) - A unique identifier for the license session
 
4.  There are two variants to the lmremove command syntax.
 
.\lmutil lmremove [-c <port>@<LM_Server>] -h <feature> <LM_Server> <port> <handle>
OR
.\lmutil lmremove [-c <port>@<LM_Server>] <feature> <user> <host> <display>
 
Example1:
.\lmutil.exe lmremove -c "1055@{HOST SERVERNAME}" -h stk_mission_air {HOST SERVERNAME} 1055 114
 
Example2:
.\lmutil.exe lmremove -c 1055@{HOST SERVERNAME} stk_mission_air jdoe {HOST SERVERNAME}.stk.com {HOST SERVERNAME}.stk.com

NOTE: If the user name contains a space, it must be surrounded by quotes, and you must use the optional -c flag.
lmutil.exe lmremove -c 1055@{HOSTSERVERNAME} stk_mission_air "john doe" techsupportxp techsupportxp
 
5. To verify the license has been removed, rerun the lmstat command in step two.
 
TitleHow Do I Release a Hung Network License?
URL NameHow-do-I-release-a-hung-network-license

Related Files