Interfacing the DSLS license manager – KB4001c
OpenLM supports license monitoring of a wide and ever growing variety of license managers.
This application note elaborates the steps required to configure OpenLM to interface the Dassault Systemes License Server (DSLS), to monitor license usage and obtain license statistics.
There are two options to query the DSLS License Server:
- Directly query the license server from the OpenLM Server. This method only provides license usage information.
- Query the license server locally by the OpenLM Broker and propagate the information back to the OpenLM Server. This option may provide additional information, such as license denials and offline (borrowed) licenses.
2. Interfacing the DSLS License Server using OpenLM Server only
2.1. OpenLM Server configuration
In order to enable OpenLM to access the DSLS License Server, follow these steps:
1. Install the OpenLM Server, click the Windows Start button → OpenLM → “OpenLM Server”. The OpenLM Server configuration tool opens.
2. Select the ”LM Tools” tab, located on the left side.
3. Select the DSLS tab.
4. Either copy or install the DSLS Client folder to “C:\Program Files (x86)\OpenLM\OpenLM Server\LM”.
5. Type in the full path of the executable file, e.g.: “C:\Program Files\OpenLM\OpenLM Server\LM\DSLicSrv.exe” in the ”DSLS executable file” text box.
6. Click the ‘Apply’ button.
2.2. Introducing a new DSLS server
After configuring the OpenLM Server configuration tool to work with DSLS as described above, introduce a new DSLS server under the License Servers tab:
1. Select the License Servers tab.
2. Click Add.
3. From the Type drop-down menu, select DSLS.
4. Type in a descriptive name in the Description text box (e.g. “My DSLS License Server”)
5. Set the Time Zone to where the License Server physically resides (e.g. Pacific TZ).
6. Type in an appropriate Hostname and Port number (e.g. L312MD and 4084 respectively).
7. Is Triad Configuration: OpenLM supports multiple server redundancy configurations for several types of license servers (e.g. FlexLM, DSLS, IBM LUM).
- Checked : The OpenLM server will monitor the activity of all DSLS servers of the multiple server redundancy configuration.
- Unchecked (Default): The OpenLM server will only monitor the activity of a single DSLS license server
8. Use Broker checkbox:
- Checked (Default): Usage information is obtained solely via the OpenLM Broker installation on the License manager machine.
- Unchecked: The OpenLM Server actively queries the license manager. For this method (OpenLM Server only), make sure this is unchecked.
9. Password (‘Set’): DSLS license servers may be password protected. In this case it is necessary to click “Set” and enter the required password.
10. “Show named users allocations as usage” checkbox:
- Checked: OpenLM will present named licenses as part of the total amount of consumed licenses.
- Unchecked (Default): OpenLM will not present name-allocated licenses as part of the total amount of consumed licenses.
11. “Allow server fallback for denied license” checkbox:
- Checked: If license is denied by one license server, the license can be granted by another server monitored by OpenLM.
- Unchecked (Default): Licenses denied by this license server cannot be granted by other servers.
11. Click Apply.
The OpenLM Server is now ready to query the DSLS license manager and present the information over the EasyAdmin web application.
3. Interfacing the DSLS License Server using OpenLM Server + OpenLM Broker
The OpenLM Broker is an optional, though highly recommended component, that should be installed and configured on the DSLS license manager machine. The OpenLM Broker queries the license server locally, and propagates the data to the OpenLM Server. It facilitates robust, buffered communication with the OpenLM Server to overcome temporary network failures.
The OpenLM Broker also facilitates querying the DSLS License Server and presents:
- License usage reports
- Information regarding denied license requests
- License borrowing (‘offline’ licenses) information.
3.1. OpenLM Server configuration
Follow the same steps for configuring the OpenLM Server as listed in 2.1, but make sure that the Use Broker box is checked.
3.2. OpenLM Broker configuration
1. Download and install the latest OpenLM Broker version. Follow the installation and configuration instructions on the OpenLM Broker configuration guide.
2. Configure the OpenLM Broker to interface the DSLS license server (e.g. dsls_license_server) on the license manager’s port (e.g. 4084). By default, if the license manager service is running, using the Broker’s “Detect” function should find and configure the DSLS license manager automatically.
In case the OpenLM Server displays an invalid date or language for DSLS usage, click Advanced on the License Manager Port screen and take the following actions:
- DSLS Output Language – Change the system local language to reflect the System OS language settings;
- DSLS Date Time Format – Change the date format to reflect the DSLS output date format (if you cannot see a date format that matches your DSLS output in the list, this field can be edited manually to support a custom format);
Click Apply to commit the changes.
3. Type in the OpenLM hostname and port number (e.g. DESKTOP-7CRIQ3C and the default 7016).
4. Security/Firewall measures: Make sure that the said OpenLM Broker port (e.g. 7016) is not blocked for outgoing messages and that the same port number (e.g. 7016) is open for incoming messages on the OpenLM Server machine.
5. Select “Vendor name to be filled” under the Vendors node and type in the “Dassault Systemes” for the name then click Apply.
6. On the ‘Commands’ node, type the full path or browse to where DSLicSrv.exe resides on the DSLS license manager machine. Click Update then Apply.
7. If the DSLS license manager has been configured to use a password, you must edit the individual syntax for the following commands with your own password like so:
Note: make sure there is a space character before each semi-colon separator
For status and data_inquiry:
“C:\…\DSLicSrv” -admin -locale en_US;connect DESKTOP-7CRIQ3C 4048 -r ;PASSWORD ;getConfig ;getLicenseInfo ;getLicenseUsage -all;disconnect ;quit
“C:\…\DSLicSrv” -admin -locale en_US;connect DESKTOP-7CRIQ3C 4048 -r ;PASSWORD ;showLog -from @date@format:yyyy/MM/dd HH:mm:ss@ -to @date@format:yyyy/MM/dd HH:mm:ss@;disconnect ;quit”
Click Apply after each edit to commit the changes.
8. In case of a multiple-server redundancy configuration (“triad”), the OpenLM Broker will need to be installed on each of the DSLS license servers, through the same process as described above.
9. Make sure that the commands “status”, “data_inquiry” and “denial” have the locale “en_US” configured, as shown in the images below:
3.3. DSLS Log file information
In order to configure the DSLS log you need to:
1. Highlight the “Log files” node then click the ‘Add’ button.
2. Select log node that appears. The “Log File Definition” window opens.
3. Select the ‘Other’ type
4. Add a descriptive name (e.g. “The DSLS log file”)
5. Fill in or browse to the full path of the DSLS log file (e.g. “C:\…\my_dsls_log.log“).
6. If more than one vendor has been introduced, make sure that the one selected is “Dassault Systemes“.
7. DSLS logs may be configured to change names periodically. In order to continue acquiring DSLS log information throughout such changes, check the “Watch files by pattern” box so that Broker will detect such log files heuristically.
3.4. Verify the DSLS configuration on the EasyAdmin web application
To check if the DSLS License Server is configured properly:
- Open the EasyAdmin web application.
- Click EasyAdmin Start → Widgets→ License Servers. The License Servers window appears. Verify that the configured license managers appear on the list. A green circle node indicates an active connection to a license server.
4. DSLS denials reports
DSLS denials will be presented in the EasyAdmin web application Start → Reports → Denials.
1. DSLS denials are subject to “True denials” filtering. That means that denials’ reporting will be delayed for a while, to assert that the user has not been granted a license in the meanwhile.
Your OpenLM system is now configured to monitor DSLS licensing information. If you require further assistance on this subject, please contact email@example.com and our team will be glad to assist.