USA +1 866 806 2068 | UK +44 203 1292 513 | JAPAN +81 3 45208991 担当:萩原 info@openlm.com

The EasyAdmin web application – AN4055

General

The EasyAdmin web application is the main OpenLM administrative interface for reporting and system configuration. It is accessible from any standard internet browser, e.g.: Mozilla FireFox, Microsoft Internet Explorer, Opera, Apple Safari & Google Chrome.

1

Start up

EasyAdmin is installed as part of the OpenLM Server installation, and normally requires no modifications in order to be accessed. It can be launched by

  • Clicking Windows ‘Start’ → “All Programs” → OpenLM → “OpenLM EasyAdmin2” or
  • Typing in the EasyAdmin URL line in the web browser: http://localhost:7019/EasyAdmin2/index.html
  • In order to access EasyAdmin from another machine, simply replace ‘localhost’ with the OpenLM Server’s hostname or IP.
  • EasyAdmin comes with a lightweight Web server: LightTPD. The default port for connecting to EasyAdmin via LightTPD is 7019.
  • EasyAdmin may also be configured to work with IIS instead of LightTPD. In that case – the default port is 80.

EasyAdmin windows properties

The EasyAdmin report and management windows have some common properties worth mentioning:

OpenLM icon properties

Left-click the OpenLM icon on the top-left corner of the window to get some presentation properties

Most of these properties are self-explanatory. The ‘Properties’ option enables the user to set a window to open at EasyAdmin launch, and set the window’s refresh rate.

Filters

Most windows contain a filter pane, normally located on the window’s left side.

  • The filter’s position(Left, Right, Down, Up) may be configured through the gear wheel icon.
  • The filter fields specify the required query that EasyAdmin will propagate to the OpenLM Server.
  • In order to obtain report results, first fill in the filter fields, and then click the ‘Apply’ button.
  • NOT filling in a specific field will render ALL possible selections, i.e.: Not selecting a monitored license server name will require the query of all license servers
  • Some filter configurations can be saved and reloaded by using the funnel icon on the bottom-left corner. These filters are saved on the Browser’s cache memory per logged-in EasyAdmin user.
  • Some filter configurations can be shared through the ‘Share’ icon, also located on the bottom-left corner.

Display area

  • Some windows have multiple display areas distinguished by respective tabs, e.g. Table & “Group by” displays.
  • The presentation of columns can be controlled by clicking the column headers, and selecting the ‘Columns’ option.
  • The ordering and sorting according to columns can also be configured.
  • Some windows have the option to download their contents as CSV files, a PNG image, or to print them.

Sharing reports

The share button enables EasyAdmin users to share a view (report) with a single click;

  • Click the “Share” button on any report and get a link.
  • Send this link to any other EasyAdmin user to share the same presented information.

This functionality supports almost any filter in the system and allows different implementations such as periodic email report or a webpage with constant reports.

Report scheduling

In order to produce a scheduled report, The OpenLM administrator should:

  • Set up the EasyAdmin emailing configurations
  • Set up a specific EasyAdmin report (e.g. License Usage window)
  • Assign the report to a specific user, and optionally add additional recipients
  • Set up the scheduled report timing.

And that’s it. The OpenLM EasyAdmin scheduled reports will be sent to the designated recipients in the predefined timing. Please refer to this document for more information on the EasyAdmin report scheduler:

EasyAdmin Reports Scheduler – AN4062

Training

The ’Training’ icon expands to a short serie of slates. The slates demonstrate some technical qualities of the EasyAdmin windows, e.g.: Version information , Configuring filters and Adding columns. We recommend going through this short tutorial once.

Dashboard

The Dashboard presents general system status information in a single glance:

  • License Servers’ status.
  • OpenLM Broker status on each license server.
  • “Top 10” statistics concerning all monitored applications.

Widgets

Click the EasyAdmin ‘Start’ → ‘Widgets’ menu. The following menu options are presented:

License servers

The License servers’ window is typically the 1st place to start. It presents the status of monitored license servers and the status of the OpenLM brokers installed on the license server machines. This includes:

  • License Server status
  • Green: Up
  • Yellow: Problem on license server side, e.g.: Broker down, LM down, Time difference error.
  • Red: Down. No communication with license server.
  • Total number of licenses, with hyperlink to respective license inventory table
  • Used licenses, with hyperlink to respective Currently Consumed Licenses table
  • Borrowed licenses
  • Usage percentage
  • Broker information and actions:
  • Import files from the license server machine (e.g.: License file, Options file)
  • Broker version, and related Java (JRE) version
  • License Server time

Host availability

The host availability waveform diagram presents license servers’ activity over time.

Alerts

The OpenLM Alerts module is designed to ensure the stability of the licensing system. It enables system managers to define alert conditions, and consequent actions that will be taken when these conditions are met. The system can present alert messages on the EasyAdmin ‘Alerts’ window, as well as a log file. It can also be set to send alert messages to predefined email or SMS accounts.

Recent denials

This window provides preliminary statistic processing of license denials per feature: It presents the number of denied license requests in long term and short term period.

Feature usage status

A popular widget with many customers is this Green-To-Red license utilization presentation of specified monitored features.

Miscellaneous

  • General Statistics
  • Selected Feature Statistics

Operational

Currently Consumed licenses

The Currently Consumed licenses (CCL) window lists all active monitored license sessions. It serves as an important interface for license administors. Through this interface, authorized system managers are able to obtain comprehensive real time usage information, as well as manually retrieve a license from any user when necessary.

The presented information and controls include:

  • User details, e.g.: First / Last name, Phone, email, Group and Project membership
  • Feature details, e.g.: Version, Vendor, Feature, Product name
  • Session start time and duration
  • License Borrowing information, e.g.: Linger time, Linger due
  • License information, e.g.: License server, handle number
  • Idle session information, e.g.: Idle waveform presentations, Workstation idle time, Process idle time
  • Action buttons: Close application, and Remove license.

Released licenses

List of licenses that had been released by administrative intervention

Report windows

Click the EasyAdmin ‘Start’ → ‘Reports’ window. This will present a list of historical usage statistics and metrics:

License Usage

The powerful license usage report window accounts the actual license usage of single or multiple licensed features with respect to the total number of licenses. It plainly presents license consumption patterns over configurable time periods and sample resolutions. This information can be used to identifying bottlenecks and redundancies in the license inventory.

 

This report is available in 3 different formats, according to the tabs in the display pane: As a table, a chart or as a heatmap diagram.

license usage 3

The smart Filter enables users to build customized list of licenses and easily obtain usage information regarding these licenses. There are some unique features to the  “License usage” window’s filter:

  • The time span of the usage report is configurable: select between predefined periods (e.g. last 30 days) and a start – to – end period definition
  • When displaying a chart view, the displayed period can also be zoomed – in using the zoom drag buttons, at the bottom of the chart.
  • The “Aggregated usage” check box selects between displaying the maximal level of usage sampled per period (hour /day / week) or the actual usage occurrences as reported by the license manager.

License Activity

The License Activity window is a very powerful tool that enables system administrators to produce sophisticated reports, and track license activity of individual users. The “Group by” tab on this window facilitates license statistics report generation according to Workstations, Features, Users, Groups, and Projects.

Denials

This is a presentation of historic license denial occurrences. It is available for FlexLM and IBM-LUM license managers only, and requires the employment of an OpenLM Broker on the license server machine. Please consult this document for more information.

 

A few points to note regarding the Denials report window:

  • Information may be presented as a pie chart, line or table.
  • It may be sliced according to a list of criteria, e.g.: time, user, project etc.
  • The filter includes a “True denials” check box. This option filters out irrelevant denial reports made by the license manager. Such irrelevant reports include:
  • Multiple requests made by a specific user in a short period of time, and
  • License requests that have been denied by one server, but granted by another.

Projects and Groups usage

OpenLM facilitates monitoring of user activity, and can attribute license usage according to groups and projects. This functionality is often applied in order to implement license charge back policy (license usage billing).

Management

License procurement table

This window lists all the available licenses’ information resident in the OpenLM database.

It facilitates taking inventory of the organizational software assets. The information presented in this window includes:

  • License package contents
  • Feature properties, e.g.: Feature name, Product name, Vendor
  • License properties, e.g.: Quantity, Start, Issue and Expiration dates. Licenses that are approaching their expiration date are marked red.
  • FlexLM License file information, e.g.: Vendor info, Asset Info, Vendor String

Projects

OpenLM can attribute license usage to specific active projects. This serves to monitor software asset consumption according to organizational projects, and to produce charge-back reports.

There are two interfaces for creating new projects in the OpenLM database. One is this ‘Projects’ window. The other is the end-users’ Agent interface.

In this window, Administrators can create new projects, as well as editing the following:

  • Project name
  • Project Start and End time
  • Number of working hours allocated to this project
  • The project’s priority, and
  • The project’s completeness percentage.

License efficiency

Two complementary windows on this menu perform as indicators of license efficiency:

  • License utilization: This chart represents a histogram of license usage, i.e. each ‘y’ value answers the question: “what is the percentage of usage time that the respective x licenses have been in use”. This form of presentation ignores momentary usage peaks, and provides a vivid realization of the true license consumption pattern. It clearly depicts the number of licenses that are actually required in the organization.
  • Licenses not in use: Self explanatory. A list of licenses you could probably do without.

OpenLM License related

  • Audit report
  • Active users report

Miscellaneous

  • Licenses
  • Router Monitoring

Users and Groups

OpenLM relates to different types of entities, i.e. Users, Groups, IPs, Hosts and Host groups. There are various methods for introducing new such entities into the OpenLM database, as discussed above, in the “OpenLM Entities” paragraph.

This ‘Start’ menu option enables administrators to

  • Obtain a list of Users and Groups resident in the OpenLM database
  • Obtain information about workstations resident in the OpenLM database
  • Manually introduce new Users and Groups
  • Edit User properties and OpenLM passwords, and
  • Set up Group membership.

Options files

FLEXlm Options files grant license administrators close control over various operating parameters within the constraints of the license model. Licensed features can be dedicated, denied or reserved to users or groups of users, as well as Hosts, IPs, and Host Groups according to the Options file setting. For more information on Options file maintenance, please refer to the dedicated chapter below.

The EasyAdmin Administration menu

The Administration menu is OpenLM’s interface to a wide variety of administrative activities. Please note that I have elaborated on most of these activities in their respective context. I will therefore not repeat this information here, but rather link to the proper paragraphs.

System

  • Setting the default timezone
  • Temporarily setting the system’s logging level to ‘ALL’

Working hours

Setting the organization’s work hours. OpenLM will accumulate usage information regardless of the this configuration, but historical license usage may be configured to disregard weekends and after-hours.

Active Agent configuration

These are different windows that relate to the OpenLM Agent. The Agent is located on end-users’ workstations, and provide different capabilities deriving from monitoring processes on workstations. These capabilities include idle license retrieval and ‘Unmanaged licenses’ monitoring.

  • Active Agent
  • Agent Policy
  • Agent Procedures
  • Process / Features
  • Unmanaged processes

Presenting features:

  • Show/Hide – Users may select features to be omitted from report windows. License usage information will be accumulated regardless of the this configuration.
  • Products & Packages – Manual method for arranging licensed features in Packages. Other methods (via reading the FlexLM license file or updated online) are presented here.

Active directory Synchronization

These windows are all a part of the Active Directory synchronization process. An elaborated description is provided in the respective paragraph.

  • Sync definitions
  • Entities
  • Relations

Options files

Sets up some properties of the Options file maintenance capabilities, including data flow direction.

File fetching

File fetching is done through the “License servers” window. These are some related configurations, e.g.: Enable fetching, Timeout and location for the target directory.

 Projects

OpenLM provides a backbone for managing and reporting usage of licensed applications according to work projects.

Router Management

Setting up OpenLM Routers, Router groups, and routing rules.

Alerting administrators

OpenLM provides an administrative interface for real-time alerting and intervention. The Alerts may be sent to a predefined email or SMS account or to the EasyAdmin ‘Alerts’ window. The relevant windows are:

  • Email / SMS
  • Alert management

openlm licenses

The contents and capabilities available by your OpenLM license is presented in this window.

Cleanup manager

A tool for cleaning up unneeded information. Use this tool carefully, and only after backing up your database, as the cleanup process is irreversible.  Please read more about it here.

Vendors

Set up the OpenLM license count to match the vendor license consumption policy.

  • Multiple sessions opened by the same user on the same workstation consume a single license, or
  • Multiple sessions opened by the same user on the same workstation consume multiple licenses

Connectivity

  • EasyAdmin comes with a lightweight Web server: LightTPD. The default port for connecting to EasyAdmin via LightTPD is 7019.
  • EasyAdmin may also be configured to work with IIS instead of LightTPD. In that case – the default port is 80.
  • The default EasyAdmin URL is http://localhost:7019/EasyAdmin2/index.html.
  • In order to connect to EasyAdmin from a different machine on the network, simply replace ‘localhost’ with the target OpenLM Server hostname.
  • In case you have chosen to work with IIS instead of LightTPD, the URL will be: http://localhost/EasyAdmin2/index.html
  • EasyAdmin addresses APIs to the OpenLM Server via proxy, on two separate ports: 7014 (XML) and 7020 (SOAP).
  • A simple method to view the API syntax is to invoke an action through EasyAdmin, and examine the proxy log file, normally located at: C:\ProgramData\OpenLM\openlm_proxy.log

 

 

If you encounter trouble in launching the EasyAdmin web application, please make sure that:

  • The OpenLM Server service is up and running
  • LightTpd service is running, or IIS is operational (according to the selected web server)
  • All relevant ports (7019, 7014, 7020) are unblocked by Firewall.

If you still encounter a problem – feel free to contact our support team at support@openlm.com