Monitoring the Innovyze License Manager with OpenLM

This document describes the steps required to monitor the Innovyze License Manager with OpenLM in order to obtain license statistics.

Requirements

To query the Innovyze license manager the following components must be installed:

1. OpenLM Server v4.7 or higher installed on a machine in your organization
2. OpenLM Broker v4.14.0 or higher installed on the same machine as the Innovyze

Monitoring capabilities and features

The current monitoring capabilities available for Innovyze through the OpenLM Broker are as follows:

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 Innovyze License Manager

Broker reads the Innovyze LicenseMonitor log file. Once it has been 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 Innovyze from the “License Manager Type” drop-down menu. Click Apply.
4. Select “Vendor Name to Be Filled” under Vendors. Enter Innovyze in the “Vendor Name” field then click Apply.
5. Select the Log Files node and click on Add Log File.
6. Select the “log” node that has just been created. Click […] and browse to the path where the Innovyze LicenseMonitor Report.csv file is located (typically this is the CLS Data path you specified during Innovyze installation).
7. Click Apply.
8. Click Restart Broker.
9. Follow the steps in section 4 below.

Automatic OpenLM Broker configuration

OpenLM Broker supports the automatic configuration of Innovyze.

1. Click Detect in the bottom right corner of the Broker configuration tool window:

If the Innovyze process or service is started, the 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:

1. Click Add Port.
2. Enter the Innovyze port number (e.g. 20230).
3. Select Innovyze from the “License Manager Type” drop-down menu. Click Apply.
4. Select “Vendor Name to Be Filled” under Vendors. Enter Innovyze in the “Vendor Name”. field then click Apply.
5. Select the Log Files node and click on Add Log File.
6. Select the “log” node that has just been created. Click […] and browse to the path where the Innovyze CSV log file is located. (typically “C:ProgramDataInnovyze<LM>#.#Usage” where #.# is the Innovyze version number, e.g. “6.0”)
7. Click Advanced then check the “Watch Files by Pattern” box.
8. Click Apply.
9. Click Restart Broker.
10. Follow the steps in section 4 (“OpenLM Server configuration”), below.

OpenLM Server configuration

Automatic OpenLM Server configuration through EasyAdmin/Cloud

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 or Cloud either by accessing http://<OpenLM Server IP>:7019/EasyAdmin2/ in your browser or through Windows Start → OpenLM → OpenLM EasyAdmin User Interface or Cloud.OpenLM.com (
2. In the License Servers window, click (1) “There are X servers pending approval” and double click on it.
3. Type in the Display Name, (e.g. Innovyze).
4. Click Approve

At this point, the Innovyze has been automatically added to OpenLM Server and 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 Innovyze License machine. This is done manually via the OpenLM Server configuration tool (Windows Start → OpenLM → OpenLM Server).

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

Adding an Innovyze Server

1. Select the License Servers tab.
2. Click Add.
3. From the Type drop-down menu, select OpenLM Generic.
4. Insert a description in the Description text box (e.g. “Innovyze”)
5. Set the Time Zone to where the license server physically resides.
6. Enter the Hostname and Port number of the machine where the Innovyze License Manager is installed..
7. Is Triad Configuration box: unchecked.
8. Use Broker box: checked.
9. Click Apply and close the OpenLM Server configuration tool.

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

How to verify your Innovyze configuration

To check if the Innovyze License Server is being monitored correctly:

1. Open the EasyAdmin web application (access http://<OpenLM Server hostname>/EasyAdmin2/index.html 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.