Interfacing Datamine License Manager

This document describes the steps required to interface OpenLM with the Datamine License Manager in order to monitor license usage and obtain license statistics.

Requirements

To query the Datamine License Manager the following components must be installed:

1. OpenLM Server v2x installed on a machine in your organization
2. OpenLM Broker v22.5 or higher installed on the same machine as the Datamine

Monitoring capabilities and features

The current monitoring capabilities available for Datamine License Manager through OpenLM Broker are as follows:

OpenLM Broker configuration

Diagram of how OpenLM interfaces with the Datamine LicenseManager

Broker reads the Datamine License Manager .csv log file. Once read, the data is compiled and sent to OpenLM Server for processing.

OpenLM Broker must already be installed and configured to report to OpenLM Server before proceeding further:

1. Click Add Port.
2. Since Broker only reads the log file, enter any port number (e.g. 888).
3. Select Datamine from the “License Manager Type” drop-down menu. Click Apply.
4. Select the Log Files node click Add Log File.
5. Provide the path to the LicenseServicesXXXXXXXX.csv log file.
6. Select the “log” node that has just been created. Click […] and browse to the path where the LicenseServicesXXXXXXXX.csv log file is located.
7. Click Apply.
8. Click Restart Broker.
9. Follow the steps in section 4 below.

Alternative – configuration via Broker WEB UI

1. Open any convenient web browser. In the address bar type in the following address: http://localhost:5090/;
2. Click on the License Managers tab then Add License Manager:

3. A pop-up will open. From the drop-down list select the License Manager type (Datamine) and input the port (since Broker only reads the log file, enter any port number (e.g. 888). Click Add:

4. In the newly opened screen, click on the Log Files tab.

5. Click Add Log File, a pop-up window will appear.

You can either input the path manually or browse it by clicking on the Magnifying glass Icon:

Once found, click on the log file to select it then click Open.

6. Click Continue.

File explorer pop up window

7. Click Save.

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:

1. Open the EasyAdmin interface either by accessing Windows Start → OpenLM → OpenLM EasyAdmin User Interface.
2. In the License Servers window, double click on the row that contains the details of the newly added Datamine License Manager server entry.

3. In the newly opened prompt, give a descriptive name to the added connection or leave the default one. Also, leave the default type “OpenLM Generic. Click Approve.

At this point, the Datamine License Manager has been automatically added to OpenLM Server and the configuration is complete. It will take a few moments until the data is parsed and available. The green circle will confirm the status:

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 Datamine License Manager machine.

The hostname and port settings must match those that have been configured for OpenLM Broker.

1. Go to Start→Administration→ License Manager Servers.
2. Click Add LM.
3. From the Type drop-down menu, select OpenLM Generic.
4. Insert a description in the Description text box (e.g. “Datamine”)
5. Set the Time Zone to where the License Server physically resides.
6. Enter the Hostname and Port number of the machine where the DatamineLM is installed.
7. Allow server fall back to denied license: unchecked.
8. Use Broker: checked.
9. Click Save.

OpenLM Server is now configured to monitor the incoming data from OpenLM Broker.

How to verify your Datamine License Manager configuration

To check if the Datamine License Manager server is being monitored correctly:

1. Open the EasyAdmin web application in your browser.
2. Click EasyAdmin Start → Widgets → License 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.