The OpenLM Agent End User Interface - KB4038 - OpenLM Software License Management
Israel +972 4 6308447         USA +1 619 831 0029              JAPAN +81 505 893 6263 担当:萩原

The OpenLM Agent End User Interface – KB4038

You are here:
< All Topics

1. General

OpenLM is a software license monitoring tool for a variety of concurrent license managers. It provides productivity tools for license usage optimization and application usage management.

OpenLM provides two main user interfaces:

  • The EasyAdmin web application is meant for managers and system administrators.
  • The OpenLM agent is meant for end-users. This document discusses the latter.

The OpenLM Agent is a lightweight optional software component that is installed on end users’ workstations. It provides a set of capabilities that empower end users, making them less dependent on system administrators. The Agent does not present a risk of negative impact on the organization’s network; It limits end users’ capabilities to a subset of safe actions according to their specific area of work.


2. Capabilities Provided by the OpenLM Agent

The OpenLM Agent provides a wide variety of productivity tools, affecting the working environment in many aspects:

2.1. Who’s Got My License?

End users are able to find out who’s got the license they need, and contact that person.


2.2. Idle or Active?

Idle sessions are monitored, and presented graphically in OpenLM EasyAdmin. See here for more information: Monitoring Idle Application time.


2.3. Manual Application Shutdown

Administrators can manually shut down specific applications or check licenses back into the license pool: Retrieving licenses manually via the CCL window


2.4. Automatic Idle License Retrieval

OpenLM Agent facilitates different methods to automatically shut down software applications, and retrieve concurrent licenses. Please refer to these application notes for more information:

A notification for licenses being shut down is available by configuring the EasyAdmin Start → Administration → “Agent Policy” → ”Notification for recently closed applications” .


2.5. Unmanaged Licenses

OpenLM monitors a wide variety of licensed applications, and provides license usage statistics by directly querying specific types of license servers. OpenLM is constantly striving to enhance its capabilities by supporting as many license server types as possible. Nevertheless, there will always be license server types for which OpenLM will not have a dedicated interface to apply license usage queries.

In such cases the OpenLM Agent is employed to accumulate usage statistics on the end-users’ workstations. OpenLM refers to this capability as “Unmanaged licenses” monitoring.  Further details on this can be found here: Working with Unmanaged licenses.


2.6. License management

The OpenLM Applications Manager serves as a shell for vendors’ license managers. It provides intricate license management capabilities that are not provided by the vendors’ license manager.

It is designed with the users’ best interest in mind: returning software control back to the user.

The OpenLM Applications Manager interfaces with end-user workstations through the OpenLM Agent. The Agent can be configured to intercept application launches according to a predefined configuration.


2.7. License availability notification

After the license pool has been exhausted and end users are denied from checking out further licenses, they would receive license availability notifications when these licenses have been made available again (see below). This option is enabled by checking the EasyAdmin Start → Administration → Agent Policy → ”Available license notification” check-box.


2.8. Projects

OpenLM can be configured to log license usage according to projects. The OpenLM Agent may prompt the end user for the currently active project name to actively select the project name through a menu item. This will attribute all license usage on that workstation to the selected project, until the setting is changed.

For more information on license usage logging according to projects see this document: License Usage Monitoring According to Projects


2.9. ArcGIS License level

OpenLM was originally written by ESRI ArcGIS veterans, and as such still includes some ArcGIS-oriented benefits. Setting the ArcGIS license level is one of them.


2.10. Additional information

Additional information such as the Workstation IP is provided to the OpenLM Server by the Agent.


3. Installation

The OpenLM Agent is available in the Downloads section of the OpenLM site. OpenLM Agent can either be installed manually per workstation, or silently distributed by a script as described in KB804.

During installation, the user may be prompted to choose whether to add OpenLM extensions for certain supported applications. At the time of writing this revision – these applications include ArcGIS, Autodesk and MATLAB. The OpenLM extensions provide additional capabilities for such as saving and closing idle sessions and managing ArcGIS license levels (see below).

After installing the software on the workstation, an OpenLM agent icon will appear on the taskbar:


4. Agent Interface

Right click the Agent’s icon to display the following menu:

4.1. Create New Project & Set Active Project

As stated above, OpenLM can attribute license usage according to active projects. The end user may create an active project name or be prompted to select the active project from a dropdown list.

The ”Set Active project” and “Create new project” option are hidden by default. In order to show them, open the EasyAdmin web application and click Start → Administration → Projects, and check the ”Log projects information” box. For more information on license usage logging according to projects see this document:  License Usage Monitoring According to Projects

4.2. Recently closed documents

As explained above, the OpenLM Agent facilitates different methods to actively shut down software applications and retrieve concurrent licenses. Please refer to these application notes for more information:

In addition, applications can be automatically shut down at a predefined time by checking the EasyAdmin Start → Administration → “Active Agent” → ”Extension dedicated” → ”Actively shut open applications down at” box.

OpenLM will indicate such cases of administrative license closure in the “Recently closed documents” window.

The Recently Closed Documents screen

Clicking the magnifying glass will pop a screenshot of the application prior to its closure.

Clicking the Process name will resume the application, and check out a new license for it (if available).

4.3. License usage information

The ability to query license availability from the end user workstation is a very important step towards improving license usability. The license usage window displays the total number of used, borrowed, and available licenses per license server. Click on a row to get the complete list of active users who are currently drawing on a specific license (e.g.: Autodesk). Click on one of the user entries to get the user’s details as they’re recorded in the OpenLM database.

The License Usage Agent Window

The license usage status may be hidden from end users by checking the ”Hide license status query option” box, in the EasyAdmin Start → Administration → Agent Policy window


4.4. License usage filtering

There are several methods of filtering entries in the Agent’s license usage window, so that end users would only see the information regarding licenses of interest.

1. Using the ‘Search’ text box, in the “License usage information” window

2. By applying roles and permissions to users and user groups. This will limit the presented information to specific license servers.

3. Filtering entries in single features’ resolution can be accomplished by editing the OpenLM_Agent.config XML file:

3.1 Open the Agent’s “License usage information” window

3.2 Open the  OpenLM_Agent.config file. It is typically located at:


This folder can also be found through the Windows Start menu:

Start → OpenLM → OpenLM Agent logs folder.

3.3 Check the ‘Hide’ button for each entry that the user will not see. This will automatically enter appropriate entries in the OpenLM_Agent.config XML file.

Agent with hidden rows in config file

3.4 This file can be copied and distributed among multiple users in order to show only necessary features.

4.5. Set ArcGIS License level

Three licensing levels are available in ArcGIS (From high to low): Professional, Editor and ArcView. ArcGIS end users can set this licensing level before activating the software. If such a license is available, the software will start in that chosen level.

OpenLM Agent Set ArcGIS level window

The Set ArcGIS licensing level option is hidden by default in order to avoid end users changing the licensing levels by themselves. It can be shown by clearing the EasyAdmin Start → Administration → “Active Agent” → “Extension dedicated” → “Hide Set ArcGIS License Level from agents checkbox”. For more on ArcGIS license level determination, please see this document:  Set ESRI ArcGIS licensing Level

4.6. About OpenLM

Display the OpenLM Agent and Server versions

4.7. Exit

The option of shutting down the agent software on the local workstation is hidden by default and can be displayed by clearing the ”Hide exit option for local administrator” box. Follow this path: EasyAdmin Start → Administration → Agent Policy.

NOTE:  When the Agent is closed, OpenLM is unable to ascertain license activity on that computer, therefore idle license retrieval will not be available.


5. OpenLM Agent Configuration

In most cases, the OpenLM Agent is silently distributed among all workstations of a network. The OpenLM Agent Configuration form is designed to manually set and test the connection of a single workstation to the OpenLM server.


5.1. ‘General’ tab

  • “Language” : Click the drop-down menu and select from the list of languages to be displayed in the Agent windows.
  • “OpenLM Server” : This is the OpenLM server, NOT the license (e.g.: Flexera FLEXnet) server.
  • “Port” : The communication port between the OpenLM Server and OpenLM Agent. The default is 7012.
  • “Use SSL” : use this option to use secure communication between the OpenLM Agent and the OpenLM Server. This process requires acquiring an SSL certificate, and should be performed by a system administrator.
  • “Logger configuration file” and “Logging level” The Agent’s Log file location and logging level are set here.
  • “Skip double instance alert” (Disabled by default): Avoid being notified when trying to open a second Agent instance.
  • “Use local computer’s proxy settings” (Disabled by default) : Communicate with the OpenLM server via proxy.
  • “Maximum number of lines in the Agent Console”: The Agent Console is a useful debugging tool that accounts the status of the OpenLM Agent. In order to open it, follow this path: Windows Start → OpenLM → OpenLM Agent Console.


5.2. OpenLM Applications Manager tab

The configuration options embedded in this tab enable all aspects of the OpenLM Agent in relation to the OpenLM Applications Manager (e.g. intercepting the launch of a specific application)


5.3. Agent configuration windows in OpenLM EasyAdmin

There are two configuration windows for the OpenLM Agent in the EasyAdmin administrative web application.

1. The ”Active Agent”  window is accessible by following this path: EasyAdmin Start → Administration →  Active Agent. For in-depth configuration options, please check out this how-to series on Active Agent.

2. The ”Agent Policy” window is accessible by following this path: EasyAdmin Start → Administration →  Agent Policy. All the configuration options for this window have already been explained above in this document.

Active Agent window in EasyAdmin

Previous The Core OpenLM Agent
Table of Contents