English

How To: Release a hung license from a remote License Manager server

Summary

Instructions provided describe how to remove a hung license from a remote License Manager server.

Procedure

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.

  1. Install the ESRI License Manager on the local machine using the ArcGIS Desktop or ArcInfo Workstation installation CD.

    Note:
    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>

  2. 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.

    1. 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.
      ArcGIS 8.x:
      Navigate to Start > Programs > ArcGIS > License Manager > License Manager Tools.

  3. Select the 'Configuration using Services' radio button.
  4. 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
  5. Select the 'Configure Services' tab.
  6. Uncheck 'Start Server at Power Up' and 'Use Services'.
    [O-Image] Disable Use Services
  7. 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:
    Code:
    C:\> cd Program Files\ESRI\License

    Windows 9.0 License Manager:
    Code:
    C:\> cd Program Files\ESRI\License\arcgis9x

    UNIX:
    Code:
    UNIX% cd $ARCHOME/sysgen


    Note:
    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.
    Code:
    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:

    Code:
    lmutil lmremove -h <feature> <host> <port@LM_Server> <handle>

    or
    Code:
    lmutil lmremove <feature> <user> <host> <display>


    Note:
    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:

    Code:
    %> lmutil lmremove -h ARC/INFO client1 27005@server1 3180


    Using the 'lmutil lmremove <feature> <user> <host> <display>' option:

    Code:
    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:

    Code:
    lmutil lmremove -c license.dat ARC/INFO JohnDoe client1 "1_)e4(aHzr|~"

Related Information