Transoft Solutions

Follow these steps to monitor Transoft Solutions licenses with OpenLM. The Transoft Solutions network license server offers no interface that Broker can query for live usage. OpenLM Broker therefore has the vendor's License Server Administration Utility, LicenseServerAdminTool.exe, write its Active Users and License reports, reads the license totals and the users who hold them from those reports, and reports them to OpenLM SLM.

Requirements

Before starting, make sure you have:

• OpenLM SLM installed on a machine in your organization, or a Software License Management Cloud (SLMC) account.
• OpenLM Broker v26.4.30.958 or higher, installed on the Windows machine that runs the Transoft Solutions network license server and reporting to OpenLM SLM. Earlier Broker versions do not list Transoft Solutions as a license manager type, and Broker runs the Transoft command only on Windows.
• The License Server Administration Utility, which the Transoft Solutions server installation puts in C:\Program Files (x86)\Transoft Solutions\License Server\LicenseServerAdminTool.exe.
• AutoIt v3 installed on the same machine, with its folder in the system Path. See Install AutoIt.

Monitoring capabilities

The current monitoring capabilities for Transoft Solutions through OpenLM Broker are:

LM Type in the Broker	Commands	Logs	Quantity	Expiration date	Denied	Borrowing	Allocations	Report resolution
Transoft Solutions	Yes	No	Yes	Yes	No	No	No	Seconds

From the License report, Broker reports for each license:

• Feature name: the product in Product 1, for example KeyLINES 10.5.
• Total: the value of Max. Num Users.
• Expiration date: the value of Rental Expiry, for licenses that have one.
• Vendor: the first vendor on the Vendors tab in Broker, or Transoft Solutions when the tab is empty.

Broker keeps each License Number apart, so 2 licenses for the same product arrive as 2 features with the same name.

From the Active Users report, Broker reports the users who hold each license:

• Username: the User ID column.
• Workstation: the Computer Name column.

The reports hold no check-out times. Broker reports who holds each license at each data inquiry, not when the license was checked out. Denied requests, borrowed licenses, and license allocations are not available.

How OpenLM interfaces with Transoft Solutions

Broker runs on the license server machine and sends the license data to OpenLM SLM. Every 55 seconds by default, its Data Inquiry command does the following:

1. Broker runs the AutoIt script transoft_trigger.au3, which ships with Broker in its lmsettings folder, with AutoIt3.exe.
2. The script closes any open License Server Administration Utility, starts it again with its windows hidden, and enters the Host and the port of the license manager in the Specify License Server dialog.
3. In the Select Product window, the script generates the Active Users report and the License report. The utility writes them as ActiveUsers.htm and LicenseReport.htm to the Reports folder next to LicenseServerAdminTool.exe.
4. Broker checks that both files changed, reads them, and sends the licenses and their users to OpenLM SLM.

Install AutoIt

Broker starts the script with the command AutoIt3.exe, so Windows must find AutoIt3.exe through the system Path. Broker does not install AutoIt.

1. On the license server machine, open the AutoIt downloads page, select Installer under AutoIt Full Installation, and run the installer.

2. Add the AutoIt folder, for example C:\Program Files (x86)\AutoIt3, to the system Path:

   1. Open Edit the system environment variables and select Environment Variables.
   2. Under System variables, select Path, then select Edit.
   3. Select New, enter the AutoIt folder, and select OK in each dialog.

3. In a new command prompt, run where AutoIt3.exe.

   The command prints the full path of AutoIt3.exe. If it prints an error, the folder is not in the Path.

OpenLM Broker configuration

Note

Install OpenLM Broker on the license server machine and confirm that it reports to OpenLM SLM before starting these steps.

1. Open a browser on the license server machine and go to the Broker web UI at http://localhost:5090/.

2. On the License Managers page, check Host.

   OpenLM lists the license server under this host name, and the script enters it in the Specify License Server dialog of the License Server Administration Utility. Use the name or IP address that you would enter in that dialog yourself. The field holds the host for every license manager on the page, not for Transoft Solutions alone. If the field is empty, enter the host and select the save icon next to the field.

3. Go to License Managers → Add License Manager.

4. From LM Type, select Transoft Solutions.

5. In Port, enter the port of the license server, and select Add.

   The Transoft Solutions default is 27099. Broker refuses a port that another license manager on this Broker already uses.

   Add Transoft Solutions as a license manager

6. On the Commands tab, select Data Inquiry, and enter the full path of LicenseServerAdminTool.exe as the command, for example:

   C:\Program Files (x86)\Transoft Solutions\License Server\LicenseServerAdminTool.exe

   The command box is empty for a new Transoft Solutions license manager. Broker reads the reports from the Reports folder next to this file.

   Point the Data Inquiry command at the License Server Administration Utility

7. Select Save.

OpenLM SLM configuration

Automatic configuration through EasyAdmin

If the preceding steps are complete, Broker runs the Data Inquiry command and reports Transoft Solutions to OpenLM SLM. Approve the license server in EasyAdmin:

1. Open EasyAdmin (http://<Server IP>:5015) and go to Start → Widgets → License Manager - Servers.

2. Select the There are N servers pending approval link at the top of the widget.

   The Administration - License Manager Servers window opens, with the pending entries at the top of the list.

3. Find the pending Transoft Solutions entry, with the host name and the port that you configured in Broker, and select the edit icon at the end of its row.

   Broker reports Transoft Solutions with the OpenLM Generic protocol, so its Type is OpenLM Generic.

4. Optionally rename the connection in Display name, confirm the Host Name and Port, and select APPROVE.

Manual configuration through EasyAdmin

If automatic configuration fails:

1. Go to Start → Administration → License Manager Servers.

2. Select Add LM.

3. In Display name, enter a name for the connection, for example Transoft Solutions.

4. From Type, select OpenLM Generic.

   Use Broker turns on.

5. In the row under Host Name, Port, and Time Zone, enter the host name and the port exactly as configured in Broker for Transoft Solutions, and select a time zone.

6. Select SAVE.

Verify your configuration

1. Open EasyAdmin in your browser.
2. Go to Start → Widgets → License Manager - Servers.
3. Confirm that the Transoft Solutions license server shows the Status Up to date.
4. Go to Start → Widgets → Feature Usage Status and confirm that each license appears with the product name and its total in Quantity.
5. Go to Start → Reports → License Activity, select Include Current Activity, and select Apply. Confirm that the users who hold each license appear.

Troubleshooting

If Transoft Solutions never appears as pending in EasyAdmin, confirm that the Broker reports to OpenLM SLM: other license managers on the same Broker update in EasyAdmin.

If the license server shows no licenses, the Broker log, in the logs folder of the Broker installation, names the reason:

• Report file was not updated by the script or Cannot read report file timestamp: the script did not produce new reports. Check that where AutoIt3.exe finds AutoIt, as described in Install AutoIt, and that the Host and Port in Broker let the License Server Administration Utility connect to the license server.
• commandLine must be a full path to the exe: the Data Inquiry command is not the full path of LicenseServerAdminTool.exe.
• AutoIT script not found: transoft_trigger.au3 is missing from the lmsettings folder of the Broker installation.

Known limitations

• At each data inquiry, the script closes any open License Server Administration Utility on the machine, including a window that an administrator is using.
• Broker runs the Transoft Solutions command only on Windows.
• The reports hold no check-out times. OpenLM sees who holds each license at each data inquiry, so sessions shorter than the watch interval can be missed.
• Broker reports an expiration date only for licenses that have a Rental Expiry value.
• Broker does not report denied requests, borrowed licenses, or license allocations, and does not upload usage history. Usage in OpenLM starts when you configure the license manager.