Interfacing the Intergraph SPLM License Manager – KB4001p

This document describes the steps required to interface OpenLM with the Intergraph SmartPlant License Manager (SPLM) in order to monitor license usage and obtain license statistics.

1. Requirements #

To query the Intergraph SPLM license manager:

1. OpenLM Server v4.3 or higher must be installed on a machine in your organization.
2. (Optional) OpenLM Broker v4.x or higher must be installed on the Intergraph SPLM machine in order to take advantage of additional monitoring capabilities and features.

2. Monitoring capabilities and features #

OpenLM can monitor the following Intergraph SPLM license activity:

Additionally, installing OpenLM Broker on the machine hosting the SPLM license manager allows for buffered communication to OpenLM Server in case of network interruptions.

3. Interfacing using OpenLM Server only #

Diagram of how OpenLM interfaces with Intergraph SPLM using OpenLM Server only

The first option for interfacing Intergraph SPLM is to have OpenLM Server query the license manager server directly. This is done remotely with the Intergraph SPLM command-line tools.

3.1. LM Tools configuration #

In order to get OpenLM Server to query the Intergraph SPLM license server, OpenLM needs access to the Intergraph SPLM command-line tools to query the server. Since these are usually located on a different machine than OpenLM Server, they must first be copied there:

1. Copy pdlice.exe from the machine where Intergraph SPLM resides (e.g. C:Win32appingrpdlicebin) to the OpenLM Server machine in the LM folder (e.g. C:Program Files (x86)OpenLMOpenLM ServerLM).
2. Go to Windows Start → OpenLM → OpenLM Server. The OpenLM Server configuration tool will open.
3. Select the LM Tools tab located on the left side.
4. Select the SPLM tab.
5. Click … and browse to where you just copied pdlice.exe (e.g. “C:Program Files (x86)OpenLMOpenLM ServerLM”), select it and click Open.
6. Click Apply to save the configuration.

3.2. Adding a new Intergraph SPLM server #

After setting up the OpenLM Server configuration tool to work with the Intergraph SPLM command-line utility as described above, add a new Intergraph SPLM server under the License Servers tab:

1. Select the License Servers tab.
2. Click Add.
3. From the Type drop-down menu, select SPLM.
4. Insert a description in the Description box to help you recognize the license manager.
5. Set the Time Zone to where the license server physically resides (e.g. UTC +02:00 Jerusalem).
6. Submit an appropriate Hostname and Port number (default: 807).
7. Is Triad Configuration box: unchecked.
8. Use Broker box: unchecked.
9. Click Apply then close the OpenLM Server configuration tool.

OpenLM Server should now be ready to query your Intergraph SPLM license manager remotely and present the relevant license information via the EasyAdmin interface.

4. Interfacing using OpenLM Server + OpenLM Broker #

Diagram of how OpenLM interfaces with Intergraph SPLM using OpenLM Broker

The second option for interfacing Intergraph SPLM is to have OpenLM Broker query the license manager server locally. This is done through the same Intergraph SPLM command-line utility (pdlice.exe). The advantage of this option is that OpenLM Broker can buffer license usage data. If at any point the connection to OpenLM Server is lost, the data is cached and sent in full when connectivity resumes.

Please note that OpenLM Broker must already be installed and configured to report to OpenLM Server before proceeding further.

4.1. OpenLM Broker configuration #

To configure Intergraph SPLM with OpenLM Broker, in the Broker configuration tool:

1. Click Add Port
2. Enter the Intergraph SPLM server port number (e.g. 807).
3. Select SPLM from the “License Manager Type” drop-down menu.
4. Select the Commands node. Click […] to the left of “Update path for commands:” and browse to the folder where the pdlice.exe command-line utilities resides (typically C:Win32appingrpdlicebin). Click Update.
5. Click Apply.
6. Select the data_inquiry node under Commands then click Execute. Make sure that you see a valid output (e.g no errors or warnings)
7. Click Restart Broker.

#

4.2. OpenLM Server configuration #

Once Broker has been configured, it should be sending data to OpenLM Server. The final step in interfacing Intergraph SPLM with OpenLM is to approve the configuration in EasyAdmin.

Automatic OpenLM Server configuration via EasyAdmin

1. Open the EasyAdmin interface (Windows Start → OpenLM → OpenLM EasyAdmin User Interface or navigate to http://<OpenLM Server host>:7019/EasyAdmin2/)
2. In the License Servers window, hover over the red row that contains the details of the newly added Intergraph SPLM server entry and click Approve.

The Intergraph SPLM configuration has now been automatically added to OpenLM Server and should also be present in the OpenLM Server configuration tool.

Manual OpenLM Server configuration

If automatic configuration of OpenLM Server via EasyAdmin has failed, you can manually configure OpenLM Server to connect to the Broker installation located on the Intergraph SPLM machine.

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

The steps for configuring OpenLM Server are the same as described in section 3.2 of this document, with the following exception:

1. The “Use Broker” box must be checked.

5. How to verify your Intergraph SPLM configuration #

To check if the Intergraph SPLM License Server is monitored correctly:

1. Open the EasyAdmin interface (Windows Start → OpenLM → OpenLM EasyAdmin User Interface or navigate to http://<OpenLM Server host>:7019/EasyAdmin2/)
2. Click EasyAdmin Start → Widgets → License Servers.

The License Servers window will open. Verify that the configured license manager(s) appears on the 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 for new connections.