OpenLM Software Manual 1.5.5

Stretching Your Licenses To Their Limit
OpenLM LTD. www.openlm.com

P.O.Box 659 Eliachin 38908 Israel | Tel: +1-866-806-2068| Fax: +1-206-203-2191
OpenLM System Software Manual Version 1.5.5
March 11, 2010
Purpose
The OpenLM Systems Software Manual describes all the processes, procedures, and updates
involved in usage of the OpenLM Systems efficiently.
OpenLM Systems Software Manual

Table of Contents
OpenLM System ........................................................................................................................................................ 5
Key Features ........................................................................................................................................................... 5
OpenLM System Architecture .............................................................................................................................. 6
Detailed System Architecture ............................................................................................................................................ 7
Additional components of OpenLM System ................................................................................................................... 9
OpenLM System Installation and Configuration .............................................................................................. 11

OpenLM Server Installation ............................................................................................................................... 11
Log into the System with Administrator Privileges ..................................................................................................... 11
Check Hardware Requirements ...................................................................................................................................... 11
Check the Software Requirements .................................................................................................................................. 11
OpenLM Server Installation ............................................................................................................................................. 12
OpenLM Server Configuration .......................................................................................................................... 13
License Server .................................................................................................................................................................... 14
Advanced ........................................................................................................................................................................... 15
OpenLM and Active Directory ........................................................................................................................................ 20
Notifications ....................................................................................................................................................................... 21
LM Tools ............................................................................................................................................................................. 22
License Release .................................................................................................................................................................. 24
Agent Policy ....................................................................................................................................................................... 25
Projects ................................................................................................................................................................................ 26
OpenLM Agent Installation and Configuration .............................................................................................. 27
OpenLM Utilizer Agent Installation ............................................................................................................................... 27
OpenLM Utilizer Agent Configuration .......................................................................................................................... 28
OpenLM Agent for ESRI ArcGIS ....................................................................................................................... 29
Installation and Configuration of OpenLM Agent for ESRI ArcGIS .......................................................................... 30
OpenLM Users Management Installation and Configuration ....................................................................... 30
OpenLM Users Management Installation ...................................................................................................................... 30
OpenLM Users Management Configuration ................................................................................................................. 31
OpenLM Users Management Configuration to Remote OpenLM Server ................................................................. 31
OpenLM Broker Installation and Configuration ............................................................................................. 32
OpenLM Broker Installation on Microsoft Windows ................................................................................................... 32
OpenLM Broker Configuration ....................................................................................................................................... 33
OpenLM Broker Installation on Other Platforms (UNIX, Linux, and Others) .......................................................... 36
Manual Configuration of OpenLM Broker .................................................................................................................... 38
OpenLM Alerts System Installation and Configuration ................................................................................. 39
OpenLM Alerts System Installation ................................................................................................................................ 40
OpenLM EasyAdmin2 ......................................................................................................................................... 42
Running OpenLM EasyAdmin2 ...................................................................................................................................... 42
Accessing OpenLM EasyAdmin ..................................................................................................................................... 42
EasyAdmin2 Configuration in Internet Information Service 7 (IIS7) ........................................................... 42
Enable Common Gateway Interface (CGI) in IIS7 ........................................................................................................ 43
Create EasyAdmin Site in IIS ........................................................................................................................................... 43
Enable EasyAdmin CGI .................................................................................................................................................... 45
Configure EasyAdmin to Use Proxy.exe ........................................................................................................................ 49
Delete Old Log Files .......................................................................................................................................................... 50
OpenLM Server ........................................................................................................................................................ 51

OpenLM Server Architecture ............................................................................................................................. 51
OpenLM Server Installation and Configuration .............................................................................................. 51
OpenLM Agent ........................................................................................................................................................ 52

OpenLM Utilizer Agent ...................................................................................................................................... 52
Query License Availability............................................................................................................................................... 53
License Availability Notifications ................................................................................................................................... 54
Reporting Active Project................................................................................................................................................... 54
OpenLM Agent Installation and Configuration .............................................................................................. 55
OpenLM Agent for ESRI ArcGIS ....................................................................................................................... 55
OpenLM for ESRI ArcGIS Installation and Configuration ............................................................................. 56
Distribution ........................................................................................................................................................... 56
End User Guide .................................................................................................................................................... 56
OpenLM EasyAdmin2 ............................................................................................................................................ 58

Control Panel Tab ................................................................................................................................................ 58
General Statistics ............................................................................................................................................................... 59
License Servers .................................................................................................................................................................. 59
Selected Feature Statistics................................................................................................................................................. 59
Licenses Tab .......................................................................................................................................................... 60
Filter Options ..................................................................................................................................................................... 60
Active Products Tab............................................................................................................................................. 60
Workstations Tab ................................................................................................................................................. 61
Licenses Activity Tab ........................................................................................................................................... 63
Released Licenses Tab ......................................................................................................................................... 63
Denials Tab ........................................................................................................................................................... 63
Reports Tab ........................................................................................................................................................... 64
Settings and Show/Hide Licenses ...................................................................................................................... 66
Display Preferences ........................................................................................................................................................... 67
Working Hours .................................................................................................................................................................. 67
Show/Hide Licenses .......................................................................................................................................................... 68
OpenLM Users Management ................................................................................................................................ 69

Groups & Projects ................................................................................................................................................ 69
Main User Interface ............................................................................................................................................. 69
Populating the User List ................................................................................................................................................... 71
Manipulating the Users List............................................................................................................................................. 73
Manipulating Groups ....................................................................................................................................................... 76
Manipulating Projects ....................................................................................................................................................... 77
Synchronize Users................................................................................................................................................ 77
Synchronize Groups ............................................................................................................................................ 77
Synchronize Projects ............................................................................................................................................ 77
OpenLM Broker ....................................................................................................................................................... 78

OpenLM Broker Architecture............................................................................................................................. 78
System Requirements .......................................................................................................................................... 78
Installation and Configuration ........................................................................................................................... 78
OpenLM Alerts System .......................................................................................................................................... 79

OpenLM Alerts System Architecture ................................................................................................................ 79
OpenLM Alerts Interface .................................................................................................................................... 79
Installation and Configuration ........................................................................................................................... 80
Configuring Alerts ............................................................................................................................................... 80
Implementation Tips ........................................................................................................................................... 82
OpenLM for Developers ........................................................................................................................................ 86

OpenLM Server API ............................................................................................................................................ 86
OpenLM Agent API ............................................................................................................................................. 86
Database ................................................................................................................................................................ 86
Licensing ............................................................................................................................................................... 86
OpenLM and LDAP Databases (Microsoft Active Directory) ......................................................................... 87

Synchronization ................................................................................................................................................... 87
Synchronization Policies ..................................................................................................................................... 87
Users.................................................................................................................................................................................... 87
Groups ................................................................................................................................................................................ 88
OpenLM System Documentation ........................................................................................................................ 89

Support Forums ................................................................................................................................................... 89
Support Email ....................................................................................................................................................... 89
What to Do Next .................................................................................................................................................. 89
Additional Information ....................................................................................................................................... 89
Product Licenses ................................................................................................................................................................ 89
Contacting OpenLM Support Services ........................................................................................................................... 89
Additional Documentation .............................................................................................................................................. 90
OpenLM System
OpenLM System is a license management system for organizations using software that
is licensed by license managers like Flexera FlexNet Publisher (commonly known as
FLEXlm), IBM LUM, Sentinel RMS, Sentinel HASP, and RLM. OpenLM facilitates an
effective use of the highly expensive software resources managed by these license
managers.
OpenLM is developed using Java,.NET C#, and other technologies. The distributing
system of OpenLM System includes Server, Agent, License manager broker, HTTP-
based interface, and Alerter.
Using OpenLM enables organizations easily achieve the following goals:

 Improve license usability by using the same no. of licenses for more users.
 Save expensive administration time by using OpenLM's management system
for all the organization’s license servers.
 Consolidate all the license servers of an organization and help facilitates all the
users to use a bigger pool of licenses. OpenLM provides the management tools
that handle access and usage.
 Maintain only the licenses that an organization needs by indicating the licenses
that are needed and which are not.
 Charge back usage time to departments, divisions, or any other customized user
grouping.
 Measure usage time for user groups or company projects.
 Manage charge back and control access by connecting OpenLM to an
organization’s LDAP database (Microsoft Active Directory).
Key Features
The key features of OpenLM System are:
 Unlimited number of license servers/vendor daemons — A single instance of
OpenLM System software can manage unlimited number of license servers.
 Multiple time-zones — Monitor license servers and users located in different
time zones which is a pre-requisite for multinational enterprises.
 Manage remote servers over LAN or WAN — OpenLM works in LAN, and also
with slow WAN networks.
 Modular Software Architecture — OpenLM supports any organization because
of its modular design.
OpenLM Systems Software Manual Page 5 of 92

 Easy-to-use and interactive WEB-based interface (AJAX) — OpenLM

EasyAdmin2 is OpenLM's interface for system managers and managers, and can
be accessed from any workstation on the network.
 Database driven — OpenLM System stores all usage information in a relational
database and make the use of log file unnecessary. With the ability to implement
an external database like Oracle or SQL Server, users can access the database to
create custom reports.
 All the usage reports needed — OpenLM System provides all the reporting
needs of system managers, and additional reports are added with each new
version of OpenLM. The ability to use an external database like Oracle or SQL
Server allows the creation of customized reports.
 Unique End-User Agent — OpenLM features a unique end-user agent that
empowers the user, thus saving expensive administration hours and enhances
the license usability.
 Open API — OpenLM features an open API that allows organizations to extend
the software functionality and to create custom applications.
OpenLM System is a modular system composed of several components:

 OpenLM Server
 OpenLM EasyAdmin
 OpenLM Utilizer Agent
 OpenLM Agent for ESRI ArcGIS
 OpenLM Utilizer
 OpenLM Alerts
 OpenLM License Manager Broker
OpenLM System Architecture

OpenLM System features a flexible distributed architecture that facilitates its
implementation both in small and big organizations. The system supports any
number of license servers and license activity.
OpenLM Server is the main component of the system. The server reads the usage
information from the license server and stores it in the embedded or an external
database (Oracle or Microsoft SQL Server). The system is built to support multiple
license servers, in different time zones, and in different locations over the world.
EasyAdmin Interface is the main user interface for system administrators and
managers. It allows the users to manage and query license servers using a powerful
and easy-to-use application running on any standard browser (Mozilla Firefox,
Microsoft IE, Google Chrome, or Apple Safari).
The end user interface is a system tray software that allows the users to query
license availability, get license availability notifications, and report active project.
Detailed System Architecture

OpenLM is implemented as a multi-threaded Windows Service that can
manage multiple license servers located in different time zones, over LAN or
WAN, thus fulfilling the security requirements of global organizations. It uses
HTTP protocol to communicate with the different components of the system.

Operating System: OpenLM System can run on physical or virtual windows

platforms (Windows 2003 or Windows 2008). It can also run on workstation
running Windows XP, Windows Vista, or Windows 7. The server, OpenLM
Alerts, and OpenLM Agent are the only components that must run on
windows platforms. All other components are implemented using Java or
HTML, and hence they can run on almost on any platform.
Database: OpenLM server stores the information to an embedded database or

to an external database like Oracle or MS SQL Server. The system can support
intensive license activity without performance reduction.
Active Directory: OpenLM uses an organization’s LDAP database to get

information on a user or multiple groups, thus minimizing administration
time and providing efficient billing policy.
OpenLM Server: The embedded HTTP server (LightTPD), which is installed

with OpenLM Server allows the immediate implementation of EasyAdmin2

Service. Any other standard HTTP server can also be used to serve
EasyAdmin2 system.
OpenLM Server configuration form helps configure OpenLM Server settings,

monitored license managers, security, and logging.
OpenLM has four open HTTP ports that provide service to the different
system components:
 OpenLM Server port (Default 7012) – Communicates with OpenLM
Agents.
 OpenLM Query port (Default 7014) – Responds to queries from all
other system components.
 OpenLM Brokers port (Default 7016) – Receives information from
OpenLM Brokers installed on the license managers.
 OpenLM Alerts Checking port (Default 7017) – Checks and responds to
alerts.
Additional components of OpenLM System

OpenLM Users Management: The component that facilitates System
Administrators to manage users, groups, and project. This tool can run on any
machine on the network.
OpenLM EasyAdmin2: A web-based management application for OpenLM.

The system is an Ajax application that can run on any browser or platform. It
provides high-end management and query capabilities. This interface can
work on any machine on the network.
OpenLM Broker: A software that needs to be installed on each monitored

license server. The software is a java software and can run on any platform. It
reads information from the license manager and sends the same information
to OpenLM Server. As OpenLM can also query license usage remotely, it is an
optional component. This component can run on any machine on the network.
OpenLM Agent: This component includes OpenLM Utilizer and OpenLM for
ESRI ArcGIS. In the current version 1.5.5, the software is only available for
windows platforms. It communicates with the server port to query license
server availability and to provide additional services. Unlimited number of
OpenLM can be distributed in organizations using OpenLM Software.

OpenLM Alerts: A component that allows the System Manager to define

conditions related to license server status and receive alerts when these
conditions are met. The system checks complex conditions related to multiple
features or servers. In the current version 1.5.5, the system can only be
installed on Microsoft windows platforms.

OpenLM System Installation and Configuration

The complete installation and configuration of OpenLM System includes the installation
of OpenLM Server and additional components.
The OpenLM System Installation and Configuration includes the following processes:
 OpenLM Server Installation and Configuration
 OpenLM Agent Installation and Configuration
 OpenLM Users Management Installation and Configuration
 OpenLM Broker Installation and Configuration
 OpenLM Alerts Installation and Configuration
 EasyAdmin2 Configuration in IIS7
OpenLM Server Installation

The process of installing OpenLM using the default installation options includes the
following procedures:
1. Check system compatibility.
2. Install the OpenLM Server software.
3. Configure OpenLM Server’s basic configuration.
Log into the System with Administrator Privileges

To install OpenLM Server on a computer, log on as a member of the
Administrators group (preferably as Administrator).
Check Hardware Requirements

OpenLM does not require special hardware, but when configured to manage
many FLEXlm license servers and when serving many workstations, the load
on the software is high, and hence a relatively strong hardware is required.
Note: If you are evaluating OpenLM System, the installation can be easily done on
any workstation running Windows XP or Vista.
Check the Software Requirements

Software requirements for OpenLM System installation includes:
Requirement Value
System Architecture 32-bit or 64-bit
Operating Systems OpenLM Server and OpenLM Alerts are supported on the
following operating systems:
 Windows XP
 Windows Vista
Requirement Value
 Windows 7
 Windows Server 2003
 Windows Server 2008
 Windows server 2008 r2
OpenLM Server that runs on a Windows server can
monitor FLEXlm servers that run on any OS (Linux,
UNIX, or Windows).
OpenLM Broker and OpenLM Users Management can

run on any operating system that supports Java.
External Database OpenLM Server supports the following databases:
 Embedded Firebird database (Default)
 Oracle
 MS SQL Server (2005 or 2008)
 Firebird Server
Network Protocol The OpenLM system uses the following industry
standard:
HTTP
Framework OpenLM Server, OpenLM Agent, and OpenLM Alerts
require Microsoft .NET Framework 3.5.
OpenLM Broker installer and configuration form require
Microsoft .NET Framework 3.5.
OpenLM Broker and OpenLM Users Management require
JRE version 1.6.
OpenLM Server Installation

To install OpenLM Server, go to www.openlm.com, and perform the
following steps:
1. Click Download button of OpenLM Utilizer Server , and save the
openlm_utilizer_full_server_win_1.5.5.msi file on the computer.
2. Run the file to open OpenLM Utilizer Installation Wizard and click
Next.
3. Read the License Agreement, select I Agree, and click Next.
4. Read the OpenLM Utilizer Server Information, and click Next.
5. Select the installation folder and click Next.
6. To Confirm Installation, click Next.
7. After the installation files are copied to the computer, OpenLM Server
Configuration Form opens.

8. Enter the license server name, port, and time zone. Click the Check
button to see if correct license output is displayed. Click Next.
9. Read the information and click Next.
10. To Register OpenLM Server, click Register. The registration page opens
on the default web browser. Enter the information and click Next.
11. Review the Summary displayed, and click Install.
12. When the Welcome screen opens, click Next.
OpenLM Server Configuration

OpenLM's policies and behavior are fully controlled by the system administrator
using OpenLM Configuration Form. To get more details on the Configuration
Form, click the help icon , which is attached to every setting at the configuration
form.
To open the Configuration form, navigate Start, OpenLM, Server, and click
OpenLM Server Configuration.
The Server has different configuration options:

1. License Servers - Allows the user to add license servers. It is important to
select the proper time zone for each server, and verify connectivity using
the Check button.

2. Advanced - Advanced configuration options. For most cases, there is no need

to change any setting. The available settings allow the users to perform the
following tasks to:
a. Set connectivity parameters between the server and agents.
b. Configure external database.
c. Control OpenLM networking.
d. Set logging level.
3. Active Directory - Allows OpenLM Server to search and display extended
user information from LDAP database (Active Directory).
4. Notifications - Allows the user to define SMTP Settings and destination
address to receive notifications on updates to OpenLM System.
5. LM Tools - Allows the end user to change the location of OpenLM files.
6. License Release - Allows the user to configure license release policy. License
release will only operate on supported systems (ESRI Desktop ArcGIS)
and only on workstations where OpenLM Agent for ESRI ArcGIS was
installed.
7. Agents Policy - Allows the system administrator to control OpenLM Agent's
display and decide which options will be available to the end user.
8. Projects - Controls OpenLM's project usage logging.
9. Software Updates - Support for this features will be dropped.
10. Register Software - Allows the user to register the software, request
extension for evaluation.
Note: Each time a change is made in the OpenLM Server Configuration form, restart the
OpenLM Service to update the new settings. All the settings of OpenLM Server are stored
in an encrypted file.
License Server
The License server tab helps determine the list of license managers that are
monitored by OpenLM.

Each line in the grid defines one license server with a specific port and time
zone. The tab includes the following buttons:
 Copy Local Definitions – This button locates data regarding a local
license server that is installed on the same machine as OpenLM Server.
 Check – This button checks the license manager settings. OpenLM tries
to connect with the license server. If the check fails, validate and fix the
port or server name.
Advanced
The Advanced tab features advanced settings of OpenLM. Change the desired
settings only if absolutely necessary.

1. The configurable ports facilitate OpenLM Server to accept http request

from its clients. By default, the ports are defined as follows:
 7012 – The port is used to listen to data sent by OpenLM Agents. In
case of changing this port, OpenLM Agents need to be installed with
the changed value (for silent agent install, use SERVERPORT
parameter)
 7014 – The port is used to listen to user interface requests (usually -
Easyadmin).
 7016 – The port is used to listen to license server's reports (usually -
OpenLM Log Reader).
 7017 – The port is used to listen to alerts server reports (usually
OpenLM Alerts System).
Note: The default ports should be unblocked by firewall in the LAN.
2. For further configuration of the database, click the following buttons:
 Configure Database - OpenLM server is installed by default
with embedded Firebird database. However, other databases can
be configured to be working with OpenLM. For more information,
read Configuring OpenLM Server to External Database
 Logging Level - Set logging level for OpenLM Server's log
file (typically located in C:\Program Files\OpenLM\OpenLM
Server\Log). Default level is ERROR. To analyze system problems,
change the logging level to DEBUG.
Configuring OpenLM Server to an External Database

OpenLM supports external databases like Oracle or MS SQL Server (Version
1.5.2 and up). The ability to save OpenLM information in an external database
provides following advantages:
1. Saving information in a reliable and managed database.
2. Using the usual backup procedures to backup OpenLM DB.
3. Accessing OpenLM database in order to generate reports.
4. Services can access OpenLM DB and by that better use of the
information.
OpenLM supports the following databases:

 Oracle
 Microsoft SQL Server
 Firebird Server
 Firebird embedded (default, no action needed).
Prerequisites for configuring an external database:

 A schema that contains OpenLM tables (Creation script for database
can be downloaded from OpenLM Website).
 Database server name, user name, and password.
 If MS SQL Server is selected, an optional field called Initial Catalog
can also be filled.
Configuring OpenLM to use an external database

To configure OpenLM to an external database, perform the following steps:
 In the OpenLM Server configuration form, navigate to the Advanced
tab, and click Configure Database.
 OpenLM Database Configuration window opens.

 By default, embedded Firebird database is selected.

 In the DB Provider, select the desired database (Oracle, MS SQL

Server, or Firebird server).
a. OpenLM Server Configuration form with Oracle Database
selected:

b. OpenLM Server Configuration form with MS SQL Server

selected:

c. OpenLM Server Configuration form with Firebird Server

selected.
Note: With Firebird server, use the database file supplied with
OpenLM Server install.
OpenLM and Active Directory

OpenLM features a strong integration with Active Directory. OpenLM Server
synchronizes users and groups with Active Directory to integrate license
management with other company information. Active directory
synchronization allows companies to automatically maintain Users and
Groups for billing purposes. The Groups synchronization functionality is part
of the Users and Groups extension and an additional licensing is required in
order to use this functionality

Notifications
Notifications tab allows OpenLM to send the application's administrator
reports regarding several issues:
 Needed corrective actions when OpenLM is not configured to perform
those actions itself.
 New software version is available.

Configuring Notifications
1. Click on the Send Email notifications checkbox.
2. Under Mail Sender account, enter the desired SMTP Host, Port,
SMTP User Name, and Password.
3. Under Notification Recipients, enter Recipients Addresses and
Minimal delay between alerts for the same license in minutes.
4. Click Apply.
LM Tools
LM Tools tab lists system configuration files and utilities.


License Release
License Release tab provides settings are to be set only by users who
implement OpenLM TIMEOUT mechanism such as users of OpenLM for ESRI
ArcGIS).
License Release settings:

 Click to enable license release functionality.
 Set Start releasing license after usage rate and Maximum idle time
before client is released. The Default settings of which are 80 percent
and 15 minutes respectively.
 Enter the location of the Folder to save closed projects.
 Select the Application’s behavior when extension passes usage
threshold.
 Click to select Solve license manager errors.
 Click Apply to accept the new settings.

Agent Policy
Agent Policy tab settings determine the behavior of OpenLM Agent on end
users' workstations.
The various OpenLM Agent preferences include:

 Hide exit option for local administrator - Click this check box to hide
the option to close the OpenLM Agent for local Administrators. Users
without administrative privileges do not have the exit option.
 Hide agent configuration option for local administrators – Click this
check box to hide the option to configure the OpenLM Agent from local
Administrators. Users without administrative privileges cannot
configure OpenLM Agent.
 Hide license status query option from agents – Click this check box to
hide the option of querying license availability from the OpenLM
Agent. Users will not be able to verify which licenses are available nor
query who is using the licenses.
 System resource thresholds used to determine software inactivity –
The System resource thresholds include % Processor Time, IO Data
Operations/sec, % User usage. These thresholds are used by OpenLM
to check whether the software is processing, before closing it.
Altering these settings can cause the following issues:

1. OpenLM closes the software while processing a job.

2. OpenLM does not close the software when it is idle and same
license is being requested by a different user.
Note: The default values are already set, so do not change them. Consult the
OpenLM support team before making any changes to the settings.
 Available license notification – Click Notify end user check box so that
OpenLM can notify an end user that the license that was denied earlier,
has become available. This feature is only available when OpenLM
Broker is installed and OpenLM Agent is installed for end users.
Projects
OpenLM uses a user friendly interface to let end users switch the active
projects without having to stop the main work flow.
Under Projects tab, set Log projects information, and OpenLM records
projects data together with license usage history.
Log projects information includes the following settings:

 Minimal usage duration for project - Minimal usage duration for
project is logged in minutes. This setting is used to automatically merge
short (lower than the set Minimal) usage times with significant ones.
For example, a user opened the software and only set the active project
after 3 minutes. If Minimal usage duration is set to 5 minutes then the
short usage is merged with the one that follows.
 Agent's behavior - End users can change the active project in several
ways. When the user opens licensed software, OpenLM's projects
window appears, and enables the user to change the active project. If
the user chooses to ignore it, the projects window fades away after the
set amount of time. Projects window may also appear at a fixed time
while the licenses software is on.
OpenLM Agent Installation and Configuration

OpenLM Agent is the end-user tool of OpenLM System. The software is a Windows
system tray software that interacts with the user to improve software usability, save
administration time, and collect information from the user.
The basic OpenLM Utilizer functionality can be extended to add a dedicated

functionality for specific systems. OpenLM also offers OpenLM Agent for ESRI ArcGIS
that enhance the usage of ESRI ArcGIS Desktop licenses.
OpenLM Utilizer Agent Installation

To install OpenLM Utilizer Agent, go to OpenLM Downloads area and
perform the following steps:
 Click Download button of OpenLM Utilizer Agent , and save the
openlm_utilizer_full_agent_win.msi file on the computer.
 Run the file to open OpenLM Agent Setup Wizard and click Next.
 Read the License Agreement, select I Agree, and click Next.
 Read the OpenLM Agent Information, and click Next.
 Enter the OpenLM Server and click Next.
 Select the installation folder and click Next.
 To Confirm Installation, click Next.
 After the installation files are copied to the computer, OpenLM Server
Configuration Form opens.
 Enter the Server Name or IP Address of the OpenLM Server and accept
the default port number (change only if it was also changed on the
OpenLM Configuration Form). After that click the check button. The
check should be successful for the agent to function.
 Click Apply to save changes and close the form. The OpenLM Agent will
show in your Windows system tray.

OpenLM Utilizer Agent Configuration

To open OpenLM Agent Configuration Form during the installation of
OpenLM Utilizer Agent or at any other time, right-click the Agent icon and
select OpenLM Agent Configuration.
The Agent Configuration Form allows the user to set all the Agent settings.
The form sets these values in the Agent configuration file
OpenLM_Agent.exe.config. Restart the Agent for the new settings to be
applied.
OpenLM Agent Settings

Set up OpenLM definitions in the Agent Configuration form:
 Agent:
I am alive time interval – OpenLM Agent sends live signal to the
server every 1 minute.
Note: Do not change this value, since it can negatively effect the
responsiveness of the system.
 OpenLM Server definitions:

 OpenLM Server – Enter the server name that runs OpenLM

Server Software.
 Port – Enter the OpenLM Server port, which is 7012 by default.
This value can be changed respectively in OpenLM Server
Configuration form.
 Use SSL – Required for secured connection. Click the Use SSL
check box. This definition can be set on OpenLM Agent if not set
in OpenLM Server.
 Advanced
 Logger configuration file – Allows the system administrator to
set a different path to the logger configuration file.
 Logging level – Set to ERROR by default.
Note: It is recommended to set Logging level to ALL, which provides
all agent activity in case of any problem.
 Shut Agent when products are inactive after – This setting
avoids terminal server license occupation by a running agent after
the licensed software is already closed. This is a dedicated
functionality for Agent installation on terminal servers.
 Use local computer's proxy settings – Determines how OpenLM
Agent connects to the network. By default it will connect directly,
check this box when it is required to use the network proxy
server.
OpenLM Agent for ESRI ArcGIS

OpenLM for ESRI ArcGIS software is OpenLM Utilizer Agent software with
dedicated extensions for OpenLM for ESRI ArcGIS software. The dedicated
extensions are designed to enhance the license availability to the use lowering the
total number of required license.
OpenLM Agent of ESRI ArcGIS provides the following features:

 It allows OpenLM Server to implement Timeout for idle licenses - When
requested by OpenLM Server, OpenLM Agent saves the active project, save
the project, and leaves a message for the user on the workstation.
 Implement a special handling for ArcGIS software extensions – Releases all
ArcGIS extensions every time a session is closed, enhances extension usage by
assuring that only extensions that are really needed will be loaded. OpenLM
Agents also allows OpenLM Server to release and extend from an idle session
of OpenLM Desktop ArcGIS without closing the project. For more
information on license release, see OpenLM Server Configuration’s License
Release.
 Set ArcGIS Software Level – OpenLM Agent for ESRI ArcGIS allows the end
user to set the software level (ArcInfo, Editor, Viewer) using a dedicated tool
(Set license level).
Installation and Configuration of OpenLM Agent for ESRI ArcGIS

The installation and configuration of OpenLM for ESRI ArcGIS is the same as
OpenLM Utilizer. To provide the ESRI ArcGIS Desktop functionality, an ESRI
ArcGIS Extension is installed into the ArcGIS Software. The extension allows
OpenLM Software to save the active project, before closing an idle session and
also to perform other tasks.
The Installation and Configuration of OpenLM Agent for ESRI ArcGIS is the
same as the installation and configuration of OpenLM Utilizer Agent.
OpenLM Users Management Installation and Configuration

OpenLM Users Management is part of an optional component of the system that is
dedicated for Groups and Projects billing of FLEXlm usage. It is not a part of
OpenLM since it requires additional licenses. OpenLM Users Management software
is a Java software, and hence can be executed on any platform.
OpenLM Users Management allows the user to manage users, groups, and projects.
By creating different user groups, the user can calculate usage times according to
these groups. The support for projects is similar to groups, but the user can report
the active project using OpenLM Agent. The comprehensive support for Project
billing allows organizations to get accurate usage reports according to the projects.
Note: OpenLM Users Management module can be installed on many workstations on the
network, depending on the number of acquired licenses. Multiple Users Management
instances are not allowed to update the same information concurrently.
OpenLM Users Management Installation

To install OpenLM User Management, perform the followings steps:
1. Go to www.openlm.com website, select OpenLM Version 1.5.5, click
OpenLM Users Management Download button.
2. Save the file, openlm_user_management_win_1.5.5.msi to the

computer. Double-click the file and click Run.
3. OpenLM Users Management Setup Wizard opens. Click Next.

4. Select Installation Folder and Click Next.

5. Click Next to confirm installation.
6. After successful installation, click Close.
OpenLM Users Management Configuration

OpenLM Users Management, by default, is configured to connect with local
OpenLM Server.
1. To open Application settings window, navigate OpenLM Users
Management, Settings, and click Options.
2. The Server URL sets the connection which is essential for a system to
function. Click Check URL to ensure the correct URL.
3. The interface language can be set from the Select Language control.
Note: Contact support@openlm.com if the language you need is not
supported.
4. Click the Confirm all actions check box, and click Apply.
OpenLM Users Management Configuration to Remote OpenLM

Server
To connect OpenLM Users Management to a remote OpenLM Server, change
the server name at the Application settings:
1. Navigate to OpenLM Users Management, Settings, and click Options.
2. Enter the Server URL in the following format:
http://<OpenLM Server Name>:<OpenLM UI Port>/OpenLMServer

OpenLM Broker Installation and Configuration

OpenLM Broker, previously known as OpenLM Log Reader, is an optional but
highly recommended component of OpenLM System. It is a Java software designed
to help perform tasks and get license usage information from the license servers.
OpenLM Broker can be installed on any system that runs the license server software
such as FLEXlm/FLEXnet, IBM LUM, and Safenet RMS.
OpenLM Broker provides the following functionalities:

 Getting additional licensing information
 Query license server status
 Read license server Option files
OpenLM Broker Installation on Microsoft Windows

OpenLM Broker installation on Windows includes the following steps:
1. Double-click the MSI file and follow the instructions.

2. When the files are copied to the local hard drive, the OpenLM Log
Broker configuration form will open.
3. Under OpenLM Server connectivity, enter the OpenLM Server name

and click Check Connectivity.
Note: If the communication test fails, OpenLM Broker fails to send
information.
4. Under Monitored servers, OpenLM configuration form automatically
detects existing FLEXlm Services (on Microsoft Windows platform) and
fills the grid. Inspect the grid rows and fix problems, if any.
5. Under Advanced, set the Logging level for OpenLM Log Reader. The
default value is INFO.
Note: If OpenLM Broker is not working, set the Logging level to ALL to
locate the configuration problems.
OpenLM Broker Configuration

The configuration server allows the user to configure three OpenLM Broker
tasks for each license server:
 Send Debug log files content.

 Push usage information to the server. This task is useful when remote
access in not available.
 Define vendor information when applicable. For example, Option file
for FLEXlm license server.
The configuration of the license server services includes the following steps:
1. To configure multiple license servers on the same machine, use the Settings
option located on the right top corner of the window.
2. Click Settings, and set the path to your license manager service programs.
3. Enter OpenLM Server name and Port. The settings will be automatically
entered, if configured in the first stage.

4. Under Define Debug Log Files, enter the Log file path, select Data size limit
and Sample time interval to read. The system reads it as set time interval,
and sends the information to OpenLM Server.
5. Under Push Information to OpenLM Server, select License manager from
the list box, browse or enter LMutil.exe location, and set Execution time
interval to send license usage information to OpenLM Server. The system
will query the license server periodically and send the information to
OpenLM Server. This configuration helps solve access or network problems
that deny remote access from OpenLM Server.
For example, the following screenshot shows this feature configured to send
FLEXlm license usage information.

6. Under Define Vendors Information, enter Vendor & Options Files, if

supported by the license server.
For example, the following screenshot shows features vendor information for
ESRI ArcGIS:
OpenLM Broker Installation on Other Platforms (UNIX, Linux, and

Others)
OpenLM Broker is a standard Java software that can easily be installed and
configured on any platform.
OpenLM Broker installation includes the following steps:

 Downloading and Verifying system requirements.
 Installing.
 Configuration.
Downloading and Verifying System Requirements
1. To check the system requirements needed for OpenLM Broker
Installation, check OpenLM/OS Compatibility Table.
2. Download OpenLM Broker software from OpenLM website
downloads area.

3. Extract the folder into a preferred folder, which is usually

/usr/local. Ensure that JRE with a supported version is available on the
computer.
4. Create a software service that starts with the operating system
and runs in the background.
Command: java -jar openlm_broker.jar config.xml
Configuration
The configuration of the OpenLM Broker includes:
 Configuration of log files
 Configuration of the system
Configuration of Log Files

Edit openlm_log_reader.properties and modify the log file path to facilitate
installation. By default, a directory named log under the installation folder is
created.
Configuration of the System

 Open the file openlm_broker_config.xml using your favorite text
editor.
 Modify the following parameters to allow OpenLM Broker, to read
and send the information to the OpenLM Server:
 The name of OpenLM server.
 The name of FLEXlm server (exactly as displayed in FLEXlm
output).
 The port of FLEXlm server.
 Path to FLEXlm debug log file.
For example, the attributes that need to be edited are marked in red:

<ulm>
<receiver
receiver_url="http://openlm_server:7016/OpenLMServer"
sending_time_out="45"/>
<log_files>
<log server="license_manager_name" port="27000"
file_path="C:\Temp\lmgrd9.log" size_limit="1"
time_interval="10"/>
<log server="license_manager_name" port="9857"
file_path="C:\Temp\acad\lmgrd_acad.log" size_limit="1"
time_interval="10"/>
...
</log_files>
<commands>
</commands>
<vendors>
</vendors>
</ulm>
 Any number of combinations of files can be added, with relation to

the number of FLEXlm servers that run on the machine. When the
required modifications are done, restart the OpenLM Broker server.
Manual Configuration of OpenLM Broker

Manual configuration should only be done when the automatic configuration
process fails to configure the service. Manual configuration is not
recommended since the automatic configuration saves time and avoids errors.
Collect Required Data
 OpenLM Broker service configuration requires some data regarding the
monitored license manager. Collect the data using LMTOOLS program
- lmtools.exe.
 Open LMTOOLS and go to the Config Services tab.
 Locate the path of FLEXlm debug log file, and copy and save it for the
next step.
 Go to the Services tab, and click Perform Status Inquiry button. The
window provides the result in the top search for the string similar to
27000@license_server_status.
 Save the Port and Server name for the next stage.
Update OpenLM Broker Configuration File

1. Configure OpenLM Broker to track the desired log file.

2. Navigate to OpenLM Broker installation folder to C:\Program
Files\OpenLM\openlm_license_manager_broker.
3. Open openlm_broker_config.xml using a text editor.
4. Modify parameters to facilitate OpenLM Broker, to read and send the
information to the OpenLM Server. The required information is as
follows:
i. The name of OpenLM server.
ii. The name of FLEXlm server (exactly as shown in FLEXlm
output).
iii. The port of FLEXlm server.
iv. Path to FLEXlm debug log file.
For example, the attributes that need editing are marked in red.
<ulm>
<receiver
receiver_url="http://openlm_server:7016/OpenLMServer
" sending_time_out="45"/>
<log_files>
<log server="license_manager_name"
port="27000" file_path="C:\Temp\lmgrd9.log"
size_limit="10" time_interval="10"/>
<log server="license_manager_name"
port="9857" file_path="C:\Temp\acad\lmgrd_acad.log"
size_limit="10" time_interval="10"/>
...
</log_files>
</ulm>
5. Any number of ports or files can be added, according to the number of

FLEXlm servers that run on the machine. After completing the
modifications, restart the OpenLM Broker service.
OpenLM Alerts System Installation and Configuration

OpenLM Alerts system is an alerting system for FLEXlm systems. The system
allows the user to set complex conditions, and when the conditions are met, a
notification is sent to a pre-defined list of email addresses or mobile phones.
OpenLM Alerts is a .NET system that can be installed on any machine with running
Windows. The user interface includes a system configuration form that determines
the Alerts system settings and a conditions editor that allows the user to create the
conditions.

Note: OpenLM Alerts monitors your license severs (FLEXlm, IBM LUM, and Syntinal
RMS) and it should not be installed on the same server as your license servers. Otherwise,
OpenLM alerting system will also stop running along with FLEXlm in case of any
hardware or software failure.
OpenLM Alerts System Installation

OpenLM Alerts system can be installed on any Windows machine on the
network. OpenLM Alerts system is only compatible with OpenLM Server
version 1.5.3 and higher.
OpenLM Alerts system can be downloaded from OpenLM Website. Perform

the following steps:
1. Download AlertSystemServiceSetup.msi file to the computer, and click
Run.
2. OpenLM Alerts System Setup Wizard opens, click Next.
3. Select Installation Folder, and click Next.
4. To confirm Installation, click Next.
5. At the end of the installation process, the Alerts Configuration Form will
be displayed.
6. Click Check connectivity to OpenLM Server button to make sure that the
Alerts system can connect to OpenLM Server.

7. Click Configure mail/sms services, a Configuration window opens.

Contact OpenLM Sales (sales@openlm.com) in order to receive your SMS
username and password.
8. Enter the needed fields, and click OK.
9. Click Apply to complete configuration. The OpenLM SMS server would

become available in a few minutes.
10. The installation is complete, click Close to close the installation wizard.
11. To access OpenLM Alerts system configuration, navigate to Start,
OpenLM, Alerts System Service, and click OpenLM Alerts
Configuration.

OpenLM EasyAdmin2
OpenLM EasyAdmin is an OpenLM interface for managers and system
administrators. OpenLM EasyAdmin also allows management and reporting for
FLEXlm servers.
OpenLM EasyAdmin is provided with an embedded web server, LightTPD, thus

EasyAdmin can be accessed from any machine on the network. LightTPD is a fast
and stable web server, which can be used as a permanent web server for OpenLM
EasyAdmin. EasyAdmin application can also be used on other web servers too. Any
web server that supports the use of CGI supports EasyAdmin.
For more information, check Configuring OpenLM using Apache or Microsoft IIS
web server.
Running OpenLM EasyAdmin2

To run OpenLM EasyAdmin on the OpenLM Server machine, click Start,
OpenLM, and then OpenLM EasyAdmin2.
Accessing OpenLM EasyAdmin

The older version of EasyAdmin that is based on Adobe Flash is also available
in version 1.5.5.
 To access OpenLM EasyAdmin, navigate Start, OpenLM, Server, and
click EasyAdmin Flash.
 EasyAdmin can also be accessed from other workstations on the
network by using this URL format: http://<OpenLM server name>:7015/
Note: To limit the access to OpenLM EasyAdmin, use the web server's ability to
configure that.
EasyAdmin2 Configuration in Internet Information Service 7

(IIS7)
To configure EasyAdmin2, perform the following tasks:
1. Enable CGI in IIS
2. Create EasyAdmin site in IIS
3. Enable EasyAdmin CGI
4. Configure EasyAdmin to use proxy.exe
5. Delete old log files located in
Enable Common Gateway Interface (CGI) in IIS7

To enable CGI, perform the following steps:
1. Navigate to Control Panel, Programs, and click Turn Windows
features on or off.
2. A new window, Windows Features opens.
3. Navigate to Internet Information Services, World Wide Web Services,
Application Development Features, and CGI.
4. Click CGI check box, and click OK.
Create EasyAdmin Site in IIS

To create EasyAdmin Site in IIS, perform the following steps:
 Navigate to Control Panel, Administrative Tools, Internet Information
Services (IIS) Manager.
 Right-click Default Web Site, and select Add Virtual Directory.

 Enter Alias as easyadmin, and set Physical path to EasyAdmin location,

which is typically: C:\Program Files\OpenLM\OpenLM
Server\WebApps\EasyAdmin2

 Now right-click easyadmin site, and select Convert to Application.

Enable EasyAdmin CGI

To enable EasyAdmin CGI, perform the following steps:
1. Under easyadmin Home, double-click Handler Mappings.

2. Under Executable path, enter cgi-bin\proxy.exe path that is typically:

C:\Program Files\OpenLM\OpenLM
Server\WebApps\EasyAdmin2\cgi-bin\proxy.exe

3. Click Request Restrictions... button to open a new window named

Request Restrictions.
4. In the Mapping tab, select File or Folder and and OK.

5. An Edit Module Mapping dialog box opens. Click Yes to allow the
ISAPI extension.

6. To enable CGI-exe, select Edit Feature Permission.
7. When the new window Edit Feature Permissions opens, select

Execute and click OK.
Configure EasyAdmin to Use Proxy.exe

To configure EasyAdmin to use proxy.exe, perform the following steps:
1. Navigate to easyadmin directory, which is typically: C:\Program
Files\OpenLM\OpenLM Server\WebApps\EasyAdmin2.
2. Edit file Config.js, by changing proxy.cgi to proxy.exe as follows:

Delete Old Log Files

Delete old log files located in
%ALLUSERSPROFILES%\OpenLM\openlm_proxy.log, which is typically:
C:\ProgramData\OpenLM\openlm_proxy.log
EasyAdmin has been configured. To check if EasyAdmin is working, open web

browser and browse http://<web server>/easyadmin/

OpenLM Server
OpenLM Server is the main component of the OpenLM System. The server receives the
usage information from different sources and provides management and reporting
services to all system users such as managers, System Administrators, and end-users.
OpenLM Server Architecture

Refer to OpenLM System Architecture for more information on OpenLM System
Architecture.
OpenLM Server Installation and Configuration

For detailed information on installation and configuration, see OpenLM Server
Installation and Configuration.

OpenLM Agent
OpenLM Agent is the end-user tool of OpenLM System. The software is a Windows
system tray software that interacts with the user to improve software usability, save
administration time, and collect information from the user.
The basic OpenLM Utilizer functionality can be extended to add a dedicated

functionality for specific systems. OpenLM also offers OpenLM Agent for ESRI ArcGIS
that enhance the usage of ESRI ArcGIS Desktop licenses.
OpenLM Utilizer Agent

OpenLM Utilizer helps OpenLM Software system to optimize the use of FLEXlm
managed software for more production at lesser costs. OpenLM Utilizer Agent can
be installed interactively by using the provided MSI (extension of Microsoft installer
file) in www.openlm.com.
OpenLM Supports software from the following vendors: Autodesk, Borland,

Cadence, EDS, Macromedia, Mathsoft, Mathworks, PTC, Rational, Softimage,
Solidworks, Sybase, Synopsys, Unigraphics, WindRiver, FreeScale, ICS, Foundry,
VSNi,Tri-Pacific Software and others.
OpenLM Utilizer agent provides the following functionalities:

1. The ability to monitor and support unlimited FLEXlm servers.
2. The ability to monitor and support FLEXlm servers on different time
zones world wide.
3. The ability to release orphan licenses by a simple click.
4. The ability to easily review license inventory in real time.
5. Receive per Minute, Hour, Day, Week, or Monthly license usage reports.
6. Receive FLEXlm reports, statistics and charting (FLEXnet reports).
7. Query users and licenses from any workstation.
8. Receive Billing reports for any time period, per user or software
(FLEXbill capabilities).The ability to query license availability.
9. Users can receive automatic license availability notifications when the
license that they were denied of, becomes available. (See OpenLM Server
Configuration’s Agent Policy).
10. Users can report the active project for the session. This is an optional
functionality explained here.

Query License Availability

OpenLM Agent allows end users to query license availability from their
workstations using OpenLM Agent software.
1. To receive all availability information on the licenses, right-click the Agent
icon and select Query License Availability.
2. Click to highlight one of the Servers, and click Show Users or double-click
a row to open a new window showing the list of users that are using the
selected feature:

3. When the user clicks a Server or feature Name, the system retrieves
complete user information from OpenLM Database. Any additional
information will also be displayed by the system.
For more information on getting user information by synchronizing OpenLM
with LDAP database, see OpenLM and LDAP Databases.
License Availability Notifications

When using floating (concurrent) licenses, users sometimes receive a license
denial when all the licenses are in use or checked out. OpenLM Agent notifies
such a user that the requested license/feature became available.
For more information on license availability notification, see OpenLM Server

Configuration’s Agent Policy.
Reporting Active Project

Project-oriented companies require active project reporting functionality to get
accurate report of license usage for each project.
OpenLM Agent allows users that are assigned to more than one project, to
report the active project for each session for which they are using licensed
software. Depending on the system administrator preferences, the Agent will
pop up the project selection form every time that the licensed software is
launched.

OpenLM also supports the collection of usage time according to the legacy
FLEXlm environment variable LM_PROJECT. By using this method, OpenLM
Agent sends the LM_PROJECT environment value to OpenLM Server every
time that the user is active.
For more information on OpenLM Server Setting for projects, see OpenLM
Server Configuration’s Project.

For detailed information on installation and configuration of OpenLM Agent, see
OpenLM Agent for ESRI ArcGIS

OpenLM Agent for ESRI ArcGIS is OpenLM Utilizer Agent with additional
dedicated functionality for ESRI Desktop ArcGIS Software. The dedicated ESRI
ArcGIS contains all the OpenLM Utilizer functionalities along with additional
dedicated functionality for ESRI ArcGIS Desktop Software.
\
OpenLM for ESRI ArcGIS Agents provides the following dedicated functionality:
* Close idle ArcGIS Desktop session when according to the OpenLM Server
settings (OpenLM Server Configuration->License Release tab). When closing
a project OpenLM Agent will pop a message in order to allow the user that
his session was closed. The user can reopen the project by a single click on the
bubble.
* Release all ESRI Desktop ArcGIS extensions when a session is closed. This is
done in order to assure that extensions will only be loaded when really
needed.
* Get the list of closed sessions and revoke a project with a single mouse click.

OpenLM for ESRI ArcGIS Installation and Configuration

For detailed information on installation and configuration of OpenLM for ESRI
ArcGIS, see OpenLM for ESRI ArcGIS Installation and Configuration
Distribution
When distributing OpenLM Software to multiple workstations, an automatic
distribution method is preferred. OpenLM Agent MSI supports silent install and
command line parameters that allow automatic distribution.
SERVERNAME - OpenLM Server name.
SERVERPORT - OpenLM Server port.
ERROR_LEVEL - Set's the Agents logging level after install.
SHUT_WHEN_NOT_ACTIVE - A setting that will remove the agent after
INACTIVITY_TIME, which is useful for installation on terminal servers.
INACTIVITY_TIME - Inactivity time in seconds. Active when
SHUT_WHEN_NOT_ACTIVE is set.
Examples:
Normal for debugging: msiexec /I openlm_arcgis_full_agent_win.msi /qn /passive
/quiet /norestart SERVERNAME="olm_server" SERVERPORT="7777"
ERROR_LEVEL="ALL"
On a terminal server: msiexec /I openlm_arcgis_full_agent_win.msi /qn /passive

/quiet /norestart SERVERNAME="localhost" SHUT_WHEN_NOT_ACTIVE="true"
INACTIVITY_TIME="300" TARGETDIR="C:\program files\OpenLM"
OpenLM can be automatically distributed using different methods like System

startup scripts, Active Directory, and network management software systems like
Microsoft SMS, CA Unicenter, and others.


OpenLM EasyAdmin2
OpenLM EasyAdmin2 is replacing the original OpenLM EasyAdmin interface.
EasyAdmin2 is the interface of OpenLM for FLEXlm management, reporting, statistics,
and charting. OpenLM EasyAdmin2 is implemented using HTML and Java script
(AJAX), facilitating the software to run on any web browser or from any workstation on
the network.
The interface provides different functionalities that allows system administrators or

managers to manage licenses easily. These include:
 Sorting – The information is mainly displayed in grids. A single click on the title
of each column sorts the view with respect to the selected column. A double-click
sorts the column in ascending or descending order.
 Show/Hide Columns – To display Show/Hide columns in the grid, right-click
the title of one of the columns from any one of the grids.
 Filter – The filter tab located on the left side of each tab allows the user to filter
the shown information with relation to the different fields of Date, Time, Server,
and Vendor daemon
 By feature/product filtering – OpenLM allows the user to filter lists with relation
to multiple features or products. To select the products, type the initial letter(s) of
the feature name. A list of all features that starts with this letter(s) is displayed.
The user can select multiple features by this method.
 Paging – Lists are shown in pages. To set the number of records displayed per
page by using the Settings menu, navigate to Control panel, Start, and click
Settings.
 Refresh – A refresh button is located on each list. Click Refresh button for the
system to request the information from OpenLM Server again.
 Export – Each list allows the user to export the displayed information to CSV file.
This feature allows the user to further analyze the information.
The user interface of EasyAdmin is composed of a multi tab view that allows the user to
access all the functionalities needed to manage license servers. The main tab, Control
Panel provides a set of views that allows system administrators or managers to locate
licensing problem very easily.
Control Panel Tab

The Control Panel Tab provides an overview of total license exploitation. The main
components of the tab include the following:
 General Statistics
 License Servers
 Selected Feature Statistics
General Statistics
The feature provides measures that can give a quick and good indication
about license utilization. The view provides the information for two periods:
the recent hour and daily statistics. The measures will refresh every hour.
Total Daily Users – Provides the total number of unique users that accessed
licensed products in the last monitored period. This parameter is very
important to the efficiency of floating license usage. If the number of users is
significantly higher than the number of available licenses, it may serve as an
indication for an efficient usage of the resources.
Efficiency - This parameter is calculated as the accumulative minutes of actual

software usage, divided by the total minutes of usage which are available out
of all the licenses that the company owns. A 100% result is the best and a 0%
result is inefficient (that is, no licenses were used). The efficiency parameter
represents actual usage against the total potential for usage.
License Servers
The License Server window provides detailed information about the status of
each license server that is defined at the system. The system shows the
following information:
1 Online (Indication) – Is the license server online.
2 Log Status (Indication) – Is OpenLM Server receiving the log file
information for this server.
3 Name
4 Port
5 Quantity
6 Used (number)
7 Usage (Percent)
Selected Feature Statistics

This window provides statistics regarding one selected feature. It is very
useful in organizations where there are many license servers with similar
features. For such a case, this view can provide the user the utilization rate of
the most popular features in each site.

Show/Hide Licenses
To open Show/Hide licenses, navigate to Start, and click Show/Hide licenses.
When OpenLM System Administrator defines licenses as hidden, their

statistics will not be used for the figures. This functionality is useful for
licenses available in large number.
For more information, see Show/Hide licenses.
Licenses Tab
Licenses tab lists all features that are monitored by OpenLM. This is actually an
inventory of all the licenses monitored by OpenLM, and in most cases it represents
the inventory of all the licenses of the organization.
Filter Options
This menu appears on the left side of every tab of EasyAdmin. The option
allows the user to restrict and filter data with relation to the given criteria.
Show/Hide Features button - Choose features that can be displayed or not.
Usage button - Show feature usage in resolution of

minutes/hours/days/weeks/months. The values that are shown are peak
values.
Active Products Tab

Active Products tab provides a list of all the licenses that are currently checked out.
Remove button – The red button is the Remove button. Click the Remove
button to remove stuck or hung licenses. Live licenses can also be removed, in
which case, the software will try to reconnect and grab another available license.
Workstations Tab
The Workstations tab shows information on the installation of OpenLM Agent and
if supported, the status of the activity on the workstation.
The tab provides information on the activity of the workstation and facilitates the
system administrator to manage remote distribution of OpenLM Agent to the
workstations.
Some of the information is only available for supported systems like ESRI Desktop
ArcGIS software.

The Workstations table displays the following fields:

 Hostname – As reported by the license manager (OpenLM changes all
characters to lower case)
 IP Address – As resolved by OpenLM Server, the resolving service needs to
be turned on. Check OpenLM Server Configuration’s License Servers
settings.
 Last User – Last user that has logged in.
 Agent version – Provides the version of OpenLM Agent installed on the
workstation.
 Online – Reports if a user is active on the workstation.
 User Idle Time – Reports the idle time of the user that logged in. This
functionality is not supported for every system.
Note: Contact support@openlm.com for the list of supported systems.
 Controlled – Provides indication for the agent status on the workstation.
This indication only applies for supported systems.

Licenses Activity Tab

Licenses Activity is the main tab for license utilization reports. Reports are
produced according to server, vendor, feature, user, group, or product. The grid
lists the results as well as a total sum of hours.
By using the combination of filters and exporting the results to a spreadsheet, the
users can easily create accurate and sophisticated reports.
Released Licenses Tab

Released Licenses is only relevant to supported system. The tab provides
information about the activity of OpenLM TIMEOUT mechanism. The Reason for
releasing software can be User Closure, when the user closed the software, or
OpenLM Closure, where user left the software idle and OpenLM released it to the
benefit of other users.
Denials Tab
OpenLM collects data of denied license requests so that the administrators can learn
about the necessity of licenses that are overused.
This tab displays information on license denials. It displays all license denials in the
system that can further be analyzed to recognize under-licensed or over-licensed
features.

Reports Tab
Reports tab provides the total sum of usage grouped by groups or projects.
The Reports tab provides a set of dedicated reports:
1. License Usage – Provides the maximum number of concurrently used license
for a selected interval (minute, hour, day, week or month).
The license usage report is a main tool used to determine the number of
needed licenses compared to the number of available licenses. The chart can
provide information that can indicate the following:
Over licensing – Usage is significantly below the available number of

licenses.
Under licensing – Usage is very high, it 100% most of the time. If the license
denials occur, then the feature is under licensed and additional licenses are
needed.
Uneven usage distribution – The licenses are highly used for a few hours of
the day and very low usage on other hours. The organization can consider
solutions like second shift and license server consolidation.

 Group Usage – This report and chart show total usage according to the
query as defined by the user. The user can use the chart or a tabular view of
the information.
This functionality requires the additional licensing of Groups and Projects.
 Project Usage – Project usage is mostly used by project-oriented companies

that focus on the exact usage time for each project. The chart displays the
relative usage time from the total according to the query created by the user.
A tabular view is also available that lists the information and allows the user
to export it for further processing.
Settings and Show/Hide Licenses

To set display preferences and working hours, a Settings button is available at the
start menu of the EasyAdmin2 control panel. The show/hide license is also available
on the same location and it allows the user to hide licenses from being showed or
included in OpenLM statistics.
Display Preferences
1. To open Display Preferences tab, click Settings button.
2. Select the Date Format, Time zones, and enter the Number of records per
page to be displayed.
3. Click Save.
4. A message box EasyAdmin need to restart opens, click OK.

Working Hours
Working Hours settings effects the general statistics calculation provided by
the system. The system displays these numbers in the General Statistics of the
Control Panel tab of EasyAdmin2. When working days and hours are set, the
General Statistics is more accurate since only valid working hours are taken
into account
1. To display Working Hours, click Settings button and select Working
Hours tab.
2. Enter Start Hour and End Hour, and select the desired days.
3. Click Save.
4. A message box EasyAdmin need to restart opens, click OK.
Show/Hide Licenses
This menu shows a list of all available features and allows the user to select
the licenses to be hidden. The setting is system wide and licenses will be
hidden for all system users – not only to the user that set it.

Hidden license will not be showen in OpenLM Lists and they will affect the
statistics showed by OpenLM.

OpenLM Users Management

OpenLM's Users management tool is the interface for managing users, groups, and
projects. The software can be installed on every workstation in the LAN for user
responsible for the management of user, groups, or projects.
Groups & Projects

Groups have hierarchical structure so they can be nested. Every group can have one
or more users in it. A typical implementation of groups would be an organization's
hierarchical structure where the different divisions of the organization are at the top
level, and smaller subunits are below.
Every user belongs directly to one or more groups. By inheritance, a user that
belongs to a certain group, belongs to all its parent/base groups. Each user has a
default group, which is the primary group; and every licensed activity done by the
user is also registered under the default group.
OpenLM provides two methods that can be used in order to create and maintain the
organizational structure in OpenLM:
 Manual - The manual method is based on the capabilities of OpenLM Users
Management interface. It allows the user to add/edit/delete groups and relate
user to these groups or projects.
 Automatic - The automatic method is based on OpenLM's ability to connect
to OpenLM the organizational LDAP database (Microsoft Active Directory).
For more information, see OpenLM synchronization with LDAP.
Projects have flat structure. Every user belongs to one or more projects. A user also
has a default project, and all licensed activity done by the user is registered under
that default project. To ensure accurate usage reporting, OpenLM Agent displays
the project prompt to the user every time a license is used by that user. The prompt
shows the active project and allows the user to switch or accept. The project
behavior is controlled centrally by the system administrator. For more information,
see OpenLM Server Configuration’s Projects.
Main User Interface

The main user interface of OpenLM Users Management is divided to 3 views:
 In the main view, all the users are listed.
 In the top left view, the groups are listed.
 In the bottom left view, the projects are listed.

Populating the User List

 To get a list of all the Users, select <All Groups> and <All Projects>.
 To get a list of Users that belong to a desired group and/or project, select a
group and/or a project.
Example 1: To get a list of users that belong to Management group, select
Management under the Groups section.
Example 2: To get a list of Users that belong to Distributors group and are
also assigned to Project B, select both Distributors in Groups section and
Project B in the Projects section at the same time.
 Find and Filter options available at the top of the main view helps
locating users.
Note: Both Find and Filter options are case sensitive.
 The Find option selects the users that comply with the words/phrase
entered in the text box. Only users that have the given string in their user
name, first name or last name will be selected.
Enter a letter/word/phrase in the Find text box and click Go button:


 The Filter option selects the users that comply with the letter/word/phrase
entered in the text box. Only users that have the given string in their user
name, first name or last name will be selected.
Enter a letter/word/phrase in the Filter text box and click Go button:
 To clear the Find or Filter option, clear the Find text box and Filter text
box, and click Go.
Manipulating the Users List

The User List can be manipulated by adding a new user or editing an existing
user’s information:
1. To add a new user, click New User button.
2. When Create New User window opens, enter user information:

3. Entering user name is mandatory.

4. When adding groups or projects to the user information, ensure to
select a default group/project. By default, the first group assigned to the
user becomes the user’s default group.
5. To select default group/project, click Groups or Project button, right-
click the desired group/project, and click Set as Default Groups or
Project:

6. After adding groups and projects, the list of groups/projects will appear
at the main display, while the default group/project will be marked in
red:
7. To edit information of an existing user, select the user and double-click

it or click User Details button.
8. To edit multiple users details at the same time, select multiple users,
click User Details button. This process is a good way to add several
users to an existing group.
Manipulating Groups
Groups are hierarchical and therefore displayed as a tree.
1. To add a new group, click New Group button.
2. To add a child group, select the parent group node, right-click it, and
select Add New Sub Group:
3. To add users to a group, drag and drop the user on the desired group
node.
4. When dragged and dropped, the group will be marked with an asterisk
(*) until the changes are saved. To save the changes, click Save Group
button or Save All if changes were made to more than one group:

Manipulating Projects
 To add new projects, click New Project button.
 To add users to project, drag and drop the user on the desired project
node.
 When dragged and dropped, the project will be marked with an
asterisk (*) until the changes are saved. To save the changes, click Save
Project button or Save All if changes were made to more than one
project.
Synchronize Users
When using LDAP synchronization, all users are automatically synchronized,
depending on the LDAP synchronization setting. In a manual mode, the system will
automatically list the users that are using licenses. The system interface allows the
system administrator to add additional user details, but this is not mandatory.
Synchronize Groups
Groups synchronization is explained in the OpenLM Configuration’s Active Directory.
System administrator can manually create and manage the organizational structure
using the Users Management interface.
Synchronize Projects
Projects are not usually managed in LDAP, and hence there is no immediate method to
automatically synchronize Projects with OpenLM. Project management information can
be synchronized with OpenLM by using OpenLM's programming API.

OpenLM Broker
OpenLM Broker is a tool designed to perform different tasks on the license server to
support the operation of OpenLM Server.
OpenLM Broker is a Java software, which can be installed on any system that runs the
license server software such as FLEXlm/FLEXnet, IBM LUM, SafeNet HASP and Safenet
RMS.
OpenLM Broker provides the following functionalities:

Getting additional licensing information – OpenLM Broker reads license manager
log files and sends the information to OpenLM Server. The system supports
FLEXlm debug log files and others. OpenLM Server uses the information to
report license denials along with getting accurate start and end session times.
Query license server status – OpenLM needs the information of the license server
status to perform its functions. This information can either be queried remotely
from OpenLM Server or pushed by OpenLM Broker to OpenLM Server. Thus
making it an accurate solution to help organizations solve access and network
problems.
Read license server Option files – OpenLM reads Options files as supported by the
FLEXlm license server. The information is sent and stored in OpenLM's database
for future use.
OpenLM Broker Architecture

OpenLM Broker is implemented as a Windows Service on Microsoft Windows
platforms and a daemon on other platforms. The Windows installer automatically
creates the Windows service. On other platforms, the system administrator should
create the daemon that will always be active if the license manager daemon is
running.
System Requirements
Windows: OpenLM .NET Frameworks 3.5 and Java JRE 1.6 or higher.
Other platforms: Java JRE 1.6 or higher
Installation and Configuration

For detailed information on installation and configuration of OpenLM Broker, see
OpenLM Broker Installation and Configuration.

OpenLM Alerts System

OpenLM Alerts is designed to assure the stability and availability of your licensing
system. The system allows the system manager to define conditions and what will
happen when these conditions are met. The system is able to handle complex conditions
on multiple license servers and features and is able to send alert by email or SMS.
Concept of Alert Systems: The implementation of OpenLM Alert system allows

organizations to handle problems related to the licensing system even before the users
experience the problems. High availability of licenses assures the availability of
resources to the organization users.
OpenLM Alerts System Architecture

The system is implemented by a Windows service working in conjunction with
OpenLM Server.
Alerts Editor OpenLM Server
Conditions File Alerts Service
SMTP (Email)
SMS Gateway
The Alert Systems interface, OpenLM Alerts Editor allows the user to define a set of
alerts that are written to an XML file. OpenLM Alerts service reads the alert and
constantly checks the conditions against OpenLM Server.
When a condition is met, OpenLM Alerts checks the defined destinations and timelines,
and sends the messages to the users using the SMTP and SMS gateway.

OpenLM Alerts Interface

The system interface is composed of three main parts:
 Main Window
 Configuration form
 Alerts editor
The main window displays all current defined alerts and allows the user to add, edit, or
remove alerts. It allows the user to access the system configuration form and the Alerts
Editor.
The configuration form allows the user to set services like SMTP and SMS Server. It also
allows the user to set the system logging level in order to track problems.
The Alerts Editor allows the user to completely define an alert with respect to:
1. Name and severity
2. The conditions to check
3. The action to be taken when the condition is met
4. To time limitation set to checking and to sending alerts
Installation and Configuration

For detailed information on installation and configuration of OpenLM Alerts System,
see OpenLM Alerts System Installation and Configuration.
Configuring Alerts
OpenLM Alerts System features a visual and easy-to-use Alerts Editor.
 To access the editor, navigate to Start, OpenLM, Alerts System Service,
and click Alerts Editor.

 Alerts Editor opens.
 To add a new alert, click Add button, a Condition Editor window opens.
 Enter the Query Name and select one Severity level between Alert,
Warning or Notice.

 OpenLM Alerts system uses conditions to help organizations locate failure

or inefficient usage of licenses. The two conditions include:
 Feature threshold - Checks the usage level of a feature.
 Check duplicate licenses - Checks if the same username
uses the same features on multiple workstations.
 Select the condition type.
 To select one or multiple Destinations:
a. Select Type between Email, SMS, and EasyAdmin.
b. Enter the Destination.
c. To customize the no. of times an alert could be sent, select Limit
Send Times and customize.
 Click Add.
 Under Query Definition, depending on the condition selected, definitions
appear that can be customized.
 To define the Query, enter desired Usage percentage of feature, vendor,
and on server.
 Click OK. A new alert is added to the Alerts List.
 To edit an alert, select a name and click Edit to open the Conditions
Editor, and make the necessary changes.
Implementation Tips
A good alerts system will contain the minimum number of checks that can assure a
stable and effective licensing system. Every check defined by the system consumes

resources from both OpenLM Alerts and Alerts system and hence it is best to keep the
number of ongoing checks to a minimum. The frequency of the checks can be
configured by the Select Frequency dialog box.
1. To open Select Frequency dialog box:

 Click Frequency button in the Alerts Editor
(Or)
 Click Limit Send Times button in Conditions Editor.
2. The Limit Send Time button in Conditions Editor allows you to direct the alert
to the desired destination.
For example, during work hours, the alert is sent to email and to SMS after work
hours.

3. To limit the frequency of checks, limit checks by day of the week.
Note: OpenLM Alert should Not be installed on license server or OpenLM Server.
Install OpenLM Alert only on a separate server.

4. In Select Frequency, the use of more complex patterns is possible by custom

strings.

OpenLM for Developers

OpenLM Open API allows developers to easily integrate licensing-related functionality
in their application. This feature is very useful in an organization that query OpenLM
Server and incorporate the information in reports and interfaces. Developers can use the
API provided by OpenLM to develop different applications and offer them to OpenLM
Users. Contact OpenLM sales at sales@openlm.com before using the API to receive
licensing information.
OpenLM Database is also available for developers that create custom reports or perform
queries that are not directly supported by OpenLM API. OpenLM provides to main
API's:
 Server API
 Agent API
OpenLM Server API

The Server API allows developers to send queries to the server using HTTP protocol.
The API allows a very wide range of functionalities.
For more information on OpenLM Server API contact sales@openlm.com.
OpenLM Agent API

The agent software can be extended to provide dedicated functionality for companies or
specific systems. OpenLM for ESRI ArcGIS is an example of such an implementation.
Extending OpenLM Agent API contact sales@openlm.com.
Database
OpenLM supports external databases like Oracle, MS SQL Server, or Firebird server. If
one of these databases are used, the user can access OpenLM information to extend the
functionality of the system.
Licensing
For more information on OpenLM API licensing, contact sales@openlm.com.

OpenLM and LDAP Databases (Microsoft Active

Directory)
OpenLM allows organizations to synchronize their LDAP database with OpenLM, thus
efficiently managing their licensing, and saving the costs related to redundant
management of users in two systems.
The current functionality allows organization to synchronize users and users groups
between an organization’s LDAP Database and OpenLM Server. This functionality
allows organizations to achieve these goals:
 Provide detailed user information to all OpenLM System users (Managers,
System Administrators, or end users).
 Allows organizations to analyze and bill usage time according to the
synchronized users groups.
Synchronization
Synchronization can be set using the OpenLM Server Configuration form’s Active
Directory tab.
For more information on synchronization, see OpenLM Server Configuration’s Active

Directory.
Synchronization Policies
Users
Depending on the provided LDAP root path, OpenLM server will synchronize
all users with OpenLM Users Table. The match between existing OpenLM
User and the LDAP user is done according to the system username. OpenLM
converts all usernames to lowercase to avoid duplicate usage records for the
same user.
The ability to synchronize users is included with the base functionality of

OpenLM. No additional licensing is required.
OpenLM system user can access the OpenLM user’s information by using
OpenLM Users Management application. It allows the user to perform all the
needed actions:
 Browse
 Query
 Search
 Filter
 Add
 Edit
Groups
Groups synchronization is more complex than Users synchronization since
there are many different options to define the groups.
OpenLM server supports three group synchronization methods:

 LDAP Groups – Synchronize groups depending on native LDAP
Groups
 Organization User – Synchronize groups depending on OU structure
in LDAP.
 LDAP Attribute – Synchronize groups depending on attribute that
usually contains the cost center of the user.

OpenLM System Documentation

A lot of technical information about OpenLM system can be accessible at our web site:
http://www.openlm.com/
Support Forums
Any question can be posted into OpenLM support forums (registration required).
Support Email
Support questions can be sent to our support team: support@openlm.com.
What to Do Next
To become familiar with this release of OpenLM, install all the system components
and interact with the system. OpenLM provides licenses to evaluate OpenLM
system for 30 days while enjoying full support from OpenLM support team.
If longer evaluation is required, please contact OpenLM sales by OpenLM contact

form or email to sales@openlm.com.
Additional Information
This section contains information about the following:
 Product Licenses
 Contacting OpenLM Support Services
 Additional Documentation
Product Licenses
Install and evaluate the products included in the media pack for 30 days under
the terms of the Trial License Agreement. However, you must purchase a
program license if you want to continue using any product after the 30-day
evaluation period. Please contact OpenLM Sales team for further information.
Note: If you need an extension to your evaluation period, please contact our sales
team at sales@openlm.com.
Contacting OpenLM Support Services

If you are a customer with valid support contract or during your 30-day
evaluation period, contact OpenLM support by email support@openlm.com.

Additional Documentation
Additional documentation for OpenLM is available at the articles section of
OpenLM web site.

OpenLM Software Manual 1.5.5

Enviado por

Dados do documento

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

OpenLM Software Manual 1.5.5

Enviado por

Direitos autorais:

Formatos disponíveis

Stretching Your Licenses To Their Limit

OpenLM LTD. www.openlm.com

OpenLM System Software Manual Version 1.5.5

March 11, 2010

OpenLM Systems Software Manual

OpenLM System Installation and Configuration .............................................................................................. 11

OpenLM Server ........................................................................................................................................................ 51

OpenLM Agent ........................................................................................................................................................ 52

OpenLM EasyAdmin2 ............................................................................................................................................ 58

OpenLM Users Management ................................................................................................................................ 69

OpenLM Broker ....................................................................................................................................................... 78

OpenLM Alerts System .......................................................................................................................................... 79

OpenLM for Developers ........................................................................................................................................ 86

OpenLM and LDAP Databases (Microsoft Active Directory) ......................................................................... 87

OpenLM System Documentation ........................................................................................................................ 89

Using OpenLM enables organizations easily achieve the following goals:

OpenLM Systems Software Manual Page 5 of 92

 Easy-to-use and interactive WEB-based interface (AJAX) — OpenLM

OpenLM System is a modular system composed of several components:

OpenLM System Architecture

Detailed System Architecture

OpenLM Systems Software Manual Page 7 of 92

Operating System: OpenLM System can run on physical or virtual windows

Database: OpenLM server stores the information to an embedded database or

Active Directory: OpenLM uses an organization’s LDAP database to get

OpenLM Server: The embedded HTTP server (LightTPD), which is installed

OpenLM Systems Software Manual Page 8 of 92

OpenLM Server configuration form helps configure OpenLM Server settings,

Additional components of OpenLM System

OpenLM EasyAdmin2: A web-based management application for OpenLM.

OpenLM Broker: A software that needs to be installed on each monitored

OpenLM Systems Software Manual Page 9 of 92

OpenLM Alerts: A component that allows the System Manager to define

OpenLM Systems Software Manual Page 10 of 92

OpenLM System Installation and Configuration

OpenLM Server Installation

Log into the System with Administrator Privileges

Check Hardware Requirements

Check the Software Requirements

OpenLM Broker and OpenLM Users Management can

OpenLM Server Installation

OpenLM Systems Software Manual Page 12 of 92

OpenLM Server Configuration

The Server has different configuration options:

OpenLM Systems Software Manual Page 13 of 92

2. Advanced - Advanced configuration options. For most cases, there is no need

OpenLM Systems Software Manual Page 14 of 92

OpenLM Systems Software Manual Page 15 of 92

1. The configurable ports facilitate OpenLM Server to accept http request

Configuring OpenLM Server to an External Database

OpenLM supports the following databases:

Prerequisites for configuring an external database:

Configuring OpenLM to use an external database

OpenLM Systems Software Manual Page 17 of 92

 By default, embedded Firebird database is selected.

OpenLM Systems Software Manual Page 18 of 92

 In the DB Provider, select the desired database (Oracle, MS SQL

OpenLM Systems Software Manual Page 19 of 92

b. OpenLM Server Configuration form with MS SQL Server

OpenLM Systems Software Manual Page 20 of 92

c. OpenLM Server Configuration form with Firebird Server

OpenLM and Active Directory

OpenLM Systems Software Manual Page 21 of 92

OpenLM Systems Software Manual Page 22 of 92