English

How To: Release a hung license from a 9.x License Manager server

Summary

Instructions provided describe how to release a hung license from a 9.x License Manager server using License Manager Tools and the 'lmremove' command.

Note:
The lmremove command is not effective for removing an idle or unwanted user. If the client application is still active on a user machine it will re-check out a license shortly after it is released with the lmremove command. This is because the client software is set to reconnect if the connection to the license server is severed.

Procedure

Note:
Version 9.3.1 is the last release of the ArcGIS License Manager that will support the command line based, lmremove command.

The steps given below require being at or remotely logged into the ArcGIS 9.x License Manager server.

  • Using the License Manager Tools application
    1. Navigate to Start > Programs > ArcGIS > License Manager 9.x > License Manager Tools.

    2. On the first tab, select Configuration using Services and make sure the 'ArcGIS license manager' is selected in the box below.

    3. Select the Start/Stop/Reread tab.

    4. Click Stop Server.

    5. Click Start Server.
  • Using the lmremove command
    1. Using the command line, navigate to the license manager directory.

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

    UNIX:
    Code:
    UNIX% cd $ARCHOME/sysgen

    2. Obtain the information necessary to execute the lmremove command by checking the license manager using the lmstat command.

    3. Check the output returned from the lmstat command to select the license for release.

    The following information is an explanation of the syntax used in Step 4 and 5:

    Feature (ARC/INFO) - The license or feature that is hung. 
    User (arcuser) - The user name of the person who checked out the license.
    Host (gismachine) - The hostname of the machine which the license was being used on.
    Port (27004) - The port the license manager uses to communicate.
    LM_Server (licenseserver) - The hostname of the license manager server.
    Handle (3180) - A unique identifier for the license session.

    4. There are two options for lmremove command syntax. See Step 5 for examples of usage.

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

    or

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

    Windows:
    Code:
    C:\Program Files\ESRI\License\arcgis9x> lmutil lmstat -a -c .

    UNIX:
    Code:
    UNIX% lmutil lmstat -a -c license.dat


    Note:
    On Windows it is possible to specify a specific .lic file instead of (.) if the licenses are in one file.

    Example of the output from the lmstat command:
    Code:
    C:\Program Files\ESRI\License\arcgis9x>lmutil lmstat -a -c .
    lmutil - Copyright (C) 1989-1999 Globetrotter Software, Inc.
    Flexible License Manager status on Sat 12/31/2005 12:00

    [Detecting lmgrd processes...]
    License server status: 27004@licenseserver
    License file(s) on licenseserver: C:\PROGRA~1\ESRI\License\arcgis9x\ARCINFO9.lic:

    licenseserver: license server UP (MASTER) v7.0

    Vendor daemon status (on licenseserver):

    ARCGIS: UP v7.0

    Feature usage info:

    Users of ARC/INFO: (Total of 1 license available)

    "ARC/INFO" v9.0, vendor: ARCGIS
    floating license

    arcuser gismachine wQ(V=pQB.cpY`fs+ (v9.0) (licenseserver/27004 3180), start Sat 12/31 12:00

    Users of Plotting: (Total of 1 license available)

    5. Use either of the following options to release the desired license.

    The -h <feature> <LM_Server> <port> <handle> option:

    Code:
    %> lmutil lmremove -c . -h ARC/INFO licenseserver 27004 3180

    The <feature> <user> <host> <display> option:

    Code:
    %> lmutil lmremove -c license.dat ARC/INFO arcuser gismachine "wQ(V=pQB.cpY`fs+"


    Note:
    Surround the encrypted string, in this case wQ(V=pQB.cpY`fs+ with quotes to ensure it is read.

    6. A successful execution of the command appears similar to this:

    Code:
    %> lmutil lmremove -c . -h ARC/INFO licenseserver 27004 3180
    lmutil - Copyright (C) 1989-1999 Globetrotter Software, Inc.

    7. To verify the license has been removed, run the lmstat command in step two.

Related Information