This document describes the steps required to interface OpenLM with Lloyd’s Register Licence Manager, and further, LiMBR in order to monitor license usage and obtain license statistics.
Requirements
To query the LiMBR license manager the following components must be installed:
- OpenLM Server v21.x or higher installed on a machine in your organization or a Cloud account.
- OpenLM Broker v21.x or higher installed on the same machine as the LiMBR.
Monitoring capabilities and features
The current monitoring capabilities available for LiMBR through the OpenLM Broker are as follows:
Feature | Resolution | License totals | License usage | Denials Reporting | Borrowed License Reporting | Expiration Date Reporting | Multiple Server Redundancy |
---|---|---|---|---|---|---|---|
Support | start time: by second end time: by minute | ✔ | ✔ | ✔ | ✔ | ✔ | ❌ |
Additionally, using the Broker component allows for buffered communication and the ability to remotely start/stop the license manager service.
OpenLM Broker configuration
Diagram of how OpenLM interfaces with the LiMBR License Manager
The mechanism for interfacing LiMBR License Manager through OpenLM Broker works as follows: the license manager server is first queried locally. This is done by Broker through the LiMBR License Manager command-line utility. Once queried, this data is compiled by Broker and sent to OpenLM Server for processing.
Please note that OpenLM Broker must already be installed and configured to report to OpenLM Server before further actions might be taken.
Automatic OpenLM Broker configuration
OpenLM Broker supports automatic configuration of LiMBR.
1. Click Detect in the bottom right corner of the Broker configuration tool window:
If the LiMBR process or service is started, Broker will automatically create a port node with all required settings.
2. Click Apply to commit the changes.
3. Click Restart Broker to send the changes to OpenLM Server.
It is recommended to manually check that the automatic configuration is working by going to Commands → data_query and clicking Execute.
Manual OpenLM Broker configuration
If auto-detect did not work, you can also add and configure the license manager manually. To do so:
- Click Add Port.
- Enter the LiMBR LM port number (e.g. 11362).
- Select LiMBR from the “License Manager Type” drop-down menu. Click Apply.
- Select the Commands node. Click […] to the left of “Update path for commands:” and browse to the folder where the LiMBR is located. Click Update then Apply.
- Select the status node
- Select the data_inquiry node under Commands then click Execute. Make sure that you see a valid output (i.e. no errors).
- Click Restart Broker.
- Select “Vendor Name to Be Filled” under Vendors. Enter LiMBR in the “Vendor Name”. field then click Apply.
- Click Apply.
- Click Restart Broker.
- Follow the steps in section 4 (“OpenLM Server configuration”), below.
OpenLM Server configuration
Automatic OpenLM Server configuration through EasyAdmin
If you have followed the steps in the section above, OpenLM Broker should now be transmitting data to OpenLM Server. The final step is to approve the configuration in EasyAdmin:
- Open the EasyAdmin interface either by accessing http://<OpenLM Server FQDN>:5015 in your browser or through Windows Start → OpenLM → OpenLM EasyAdmin User Interface
- In the License Manager Servers window, at the top center license servers are listed which are pending approval.
- Verify and approve the configured license manager.
At this point, the LiMBR has been automatically added to OpenLM Server and the configuration is complete.
Manual OpenLM Server configuration
If the automatic configuration has failed, you can manually configure OpenLM Server to connect to the OpenLM Broker installation located on the LiMBR machine. This is done manually via the OpenLM EasyAdmin (Windows Start → OpenLM → OpenLM EasyAdmin → Administration → License Manager Servers → Add LM).
The hostname and port settings must match those that have been configured for OpenLM Broker.
Adding a LiMBR server
- Give a Display name.
- From the Type drop-down menu, select LiMBR.
- Insert a description in the Description text box (e.g. “LiMBR”)
- Set the Time Zone to where the license server physically resides.
- Enter the Hostname and Port number of the machine where the LiMBR is installed. The LiMBR LM default port is 11362.
- Is Triad Configuration toggle: off
- Use Broker toggle: On.
- Click Save.
OpenLM Server is now configured to monitor the incoming data from OpenLM Broker.
How to verify your LiMBR configuration
To check if the LiMBR License Server is being monitored correctly:
- Open the EasyAdmin web application (access http://<OpenLM Server FQDN>:5015 or Cloud.openlm.com in your browser)
- Click EasyAdmin Start → Widgets → License Manager Servers. Verify that the configured license manager(s) appears in the server list. A green circle node indicates an active connection to the license server.
Please note that sometimes it may take up to 3 minutes for the status indicator to change if this is a new connection.