openlm software manual 1.5.5

OpenLM Systems Software Manual

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

March 11, 2010

Version 1.5.5

Purpose

The OpenLM Systems Software Manual describes all the processes, procedures, and updates

involved in usage of the OpenLM Systems efficiently.

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

Stretching Your Licenses To Their Limit

OpenLM Systems Software Manual of 92

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.



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.

http://www.openlm.com/



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.

http://www.openlm.com/index.php?option=com_docman&Itemid=18



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

http://openlm.com/index.php?option=com_docman&Itemid=18



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


http://openlm.com/index.php?option=com_docman&task=cat_view&gid=33&Itemid=18



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 [email protected] 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

mailto:[email protected]



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.

http://openlm.com/index.php?option=com_content&view=article&id=20&Itemid=26

http://openlm.com/index.php?option=com_content&view=article&id=20&Itemid=26



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.

http://openlm.com/index.php?option=com_docman&task=cat_view&gid=31&Itemid=18



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

Contact OpenLM Sales ([email protected]) 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

http://www.openlm.com/%20index.php?option=com_content&task=view&id=67&Itemid=7

http://www.openlm.com/index.php?option=com_content&task=view&id=46&Itemid=7



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 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 [email protected] 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.

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.

Conditions File

Alerts Editor

Alerts Service

SMTP (Email)

SMS Gateway

OpenLM Server



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 [email protected] 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 [email protected].

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 [email protected].

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 [email protected].





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:


Support Forums

Any question can be posted into OpenLM support forums (registration required).

Support Email

Support questions can be sent to our support team: [email protected].

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 [email protected].

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 [email protected].

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 [email protected].




Additional Documentation

Additional documentation for OpenLM is available at the articles section of

OpenLM web site.

openlm software manual 1.5.5

Documents

openlm system installation

configuration of openlm

openlm agent installation

openlm server configuration

openlm server installation

limit openlm

openlm system architecture

remote openlm server