How To: Release a hung license from a remote License Manager server
Instructions provided describe how to remove a hung license from a remote License Manager server.
If a physical or remote login access to the License Manager server cannot be obtained, a user account with administrative rights on that machine can use the following steps to release a hung license from a remote License Manager server.
- Install the ESRI License Manager on the local machine using the ArcGIS Desktop or ArcInfo Workstation installation CD.
Since this will not be an active license manager a hardware key and license file is not required.
<a href='http://support.esri.com/en/knowledgebase/techarticles/detail/19819' target='_blank'>How To: Create a dummy license file</a>
- Disable the License Manager service from starting automatically.
Summary:Instructions provided describe how to disable the License Manager from automatically starting on Windows. The License Manager does not start automatically by default on UNIX.
Procedure:The steps below refer to the License Manager installed with ArcGIS versions 8.x and 9.x.
- Start License Manager Tools.
<div id='indent' style='padding: 0em,0em,0em,1em;'>ArcGIS 9.x:
Navigate to Start > Programs > ArcGIS > License Manager (9.x) > License Manager Tools.
Navigate to Start > Programs > ArcGIS > License Manager > License Manager Tools.
- Start License Manager Tools.
- Select the 'Configuration using Services' radio button.
- Select the License Manager.
<div id='indent' style='padding: 0em,0em,0em,1em;'>For ArcGIS 9.x:
Highlight ArcGIS License Manager
For ArcGIS 8.x:
Highlight ESRI License Manager
- Select the 'Configure Services' tab.
- Uncheck 'Start Server at Power Up' and 'Use Services'.
- Click 'Save Service' and 'Yes' to save the changes.
- Navigate to the directory where License Manager is installed using the command line.
Windows 8.x License Manager:
C:\> cd Program Files\ESRI\License
Windows 9.0 License Manager:
C:\> cd Program Files\ESRI\License\arcgis9x
UNIX% cd $ARCHOME/sysgen
Hence forth, the Windows directory will be referred to as C:\Program Files\ESRI\License> and UNIX as UNIX%, regardless of version.
- Obtain the information for the required fields of the lmremove command by running the license manager status command for the remote server.
C:\Program Files\ESRI\License> lmutil lmstat -a -c 27005@server1
Example of the output from the lmutil lmstat command:
Feature usage info:
Users of ARC/INFO: (5 licenses available)
JohnDoe client1 X:%#($1:0.0 (v8.01) (server1/27005 3180), start Wed 5/1/03 10:38
- Check the output returned from the lmstat command to select the license you would like to release.
- The proper syntax for the lmremove command is:
lmutil lmremove -h <feature> <host> <port@LM_Server> <handle>
lmutil lmremove <feature> <user> <host> <display>
The following information is an explanation of the syntax used in Step 6 and 7:
Feature - ARC/INFO - This is the license that is hung.
User - JohnDoe - The username of the person who checked out the license.
Host - client1 - The hostname of the machine on which the license was being used.
Port - 27005 - The port the license manager daemon is using to communicate.
LM_Server - server1 - The hostname of the License Manager server.
Handle - 3180 - A unique identifier for the license session.
- Using the '-h <feature> <host> <port@LM_SERVER> <handle>' option:
%> lmutil lmremove -h ARC/INFO client1 27005@server1 3180
Using the 'lmutil lmremove <feature> <user> <host> <display>' option:
lmutil lmremove -c license.dat ARC/INFO JohnDoe client1 X:%#($1:0.0
- It is possible the display information is encrypted. Such is the case here:
JohnDoe client1 1_)e4(aHzr|~ (v8.01) (server1/27005 3180), start Wed 5/1/03 10:38
In such cases it is best to use the lmremove option '-h <feature> <host> <port@LM_Server> <handle>', unless the license manager is pre-ArcInfo 7.2.1 or pre-ArcView 3.1. When the display is encrypted, it may contain special characters, such as |, (,), ~, which will not be read for their text value. Use the double quotes when encountering such characters. For example:
lmutil lmremove -c license.dat ARC/INFO JohnDoe client1 "1_)e4(aHzr|~"