Configuring OpenLM Agent v4.5 product list for OpenLM Applications Manager - OpenLM Software License Management
Israel +972 4 6308447         USA +1 619 831 0029              JAPAN +81 505 893 6263 担当:萩原

Configuring OpenLM Agent v4.5 product list for OpenLM Applications Manager

The following document describes how to add definitions to OpenLM Agent’s application (product) list so that they may be propagated and configured in OpenLM Applications Manager. It is assumed that OpenLM Applications Manager is already installed.

1. Required configuration file changes

2. Adding an application to the products list

2.1 Adding an application manually

2.2 Adding one or more applications using “Choose folder”

2.3 Adding an application using “Choose file”

2.4 Adding an application process using “Choose process”

3. Checking if an application definition has been added to OpenLM Applications Manager

4. Manually replicating the application list to other OpenLM Agents

 

1. Required configuration file changes

OpenLM Applications Manager rules are enforced only if the same entry is present in both the local list where OpenLM Agent resides and OpenLM Applications Manager master list. In order to be able to add application definitions to OpenLM Agent’s application list:

1. Open the OpenLM_Agent.exe.config file with administrator privileges (typically located in C:\Program Files (x86)\OpenLM\OpenLM Agent)

2. Edit the following flags:

OpenLM Agent config file required flags

allow_edit_product_list set to True

This allows the local user to be able to edit the Products list described below in this document. If this is set to False instead, the button will be greyed out in the Agent’s configuration window.

centralized_products_xml set to True

Synchronizes the local Agent list with the master list as defined in EasyAdmin’s OpenLM Applications Manager administration window. When set to True, adding an application definition on a local Agent installation will automatically add it to the master list, and vice-versa: any definition added to the master list through EasyAdmin will be automatically copied to the local list. Setting this to False means that no synchronization with the master list will occur and applications will have to be added manually to both lists.

These flags can also be automatically configured at installation time as arguments when using the Agent silent installation mode.

3. Save the changes.

4. Restart the OpenLM Agent (Windows Start → OpenLM → Restart OpenLM Agent)

 

2. Adding an application to the products list

1. Right-click the OpenLM Agent system tray icon and click on OpenLM Agent Configuration (a User Account Control pop-up window may appear, click Yes):

Configuring OpenLM Agent from the tray icon

2. Go to the OpenLM Applications Manager tab and click Configure next to “Products list and paths” to add or edit products which will be managed by OpenLM Applications Manager:

If OpenLM SoftwareLocker Service status is showing “stopped”, press Run to start it.

3. The opened Products list window displays all the applications that are currently tracked by Applications Manager.

Note: If using Bentley products, check the “Auto scan for Bentley Products” box to have Agent scan the computer every 5 minutes for new products and automatically add them to the Products list. This function will be triggered once you click OK.

4. Click Add and complete the appropriate fields in the Product editor window.

Consult each corresponding section below depending on what kind of application type you want to define:

2.1 Adding an application manually

Users can manually enter an application’s details in the Product editor:

  • Name – type in the name of the monitored application. Will be displayed in OpenLM Applications Manager (e.g. ‘ArcMap’).
  • Description – type in a description for the application. Will be displayed in OpenLM Applications Manager (e.g. ‘ArcMap for testing’).
  • Path – type in the full path of the folder which contains the application’s executable file (e.g. ‘C:\Program Files (x86)\ArcGIS\Desktop 10.6\bin\ArcMap.exe’).
  • Parameters (optional) – type in any parameter that the application requires in order to monitor it with OpenLM Agent and have it reported to OpenLM Applications Manager.

Note: OpenLM Agent will monitor only those applications/processes which have been launched with the parameter(s) in question.

  • Version (optional) – the application version number. Will be displayed in OpenLM Applications Manager (e.g. ‘10.6’).
  • Vendor – the name of the application manufacturer. Will be displayed in OpenLM Applications Manager (e.g. ‘ESRI’).

 

2.2 Adding one or more applications using “Choose folder”

By clicking Choose and then “Choose folder” in the Product editor window, it’s possible to configure monitoring for a folder which contains one or more applications:

Click OK to set a selected folder.

  • Name – type in the name of the monitored application. Will be displayed in OpenLM Applications Manager (e.g. ‘3 AutoCAD applications’).
  • Description – Auto-completed by default with the folder name. Also can be modified with a description of the application(s) to be displayed in OpenLM Applications Manager (e.g. ‘AutoCAD’).
  • Path – Auto-completed by default with the path to the folder that contains executable file(s) of the application(s) (e.g. ‘C:\Program Files (x86)\AutoCAD’).
  • Parameters (optional) – type in any parameter that the application requires in order to monitor it with OpenLM Agent and have it reported to OpenLM Applications Manager.

Note: OpenLM Agent will monitor only those applications/processes which have been launched with the parameter(s) in question.

  • Version (optional) – the application(s) version number. Will be displayed in OpenLM Applications Manager (e.g. ‘2’).
  • Vendor – the name of the application manufacturer. Will be displayed in OpenLM Applications Manager (e.g. ‘Autodesk’).

 

2.3 Adding an application using “Choose file”

By clicking Choose and then “Choose file” it’s possible to select an executable file associated with the required application:

Click Open to select the file. The Product editor window will appear:

  • Name – type in the name of the monitored application. Will be displayed in OpenLM Applications Manager (e.g. ‘acad’).
  • Description – Auto-completed by default with the filename. Can be modified to hold a description of the application to be displayed in OpenLM Applications Manager (e.g. ‘acad.exe’).
  • Path – Auto-completed by default with the path to the application executable file that has been selected (e.g. ‘C:\Program Files (x86)\Autodesk\AutoCAD2017/acad.exe’).
  • Parameters (optional) – type in any parameter that the application requires in order to monitor it with OpenLM Agent and have it reported to OpenLM Applications Manager.

Note: OpenLM Agent will monitor only those applications/processes which have been launched with the parameter(s) in question.

  • Version (optional) – the application version number. Will be displayed in OpenLM Applications Manager (e.g. ‘v1’).
  • Vendor – the name of the application manufacturer. Will be displayed in OpenLM Applications Manager (e.g. ‘Autodesk’).

 

2.4 Adding an application process using “Choose process”

To have OpenLM Agent monitor an application process, click Choose then select Choose process:

The Select Process window will appear, displaying a list of currently active processes. Select the required process then click OK.

Click Refresh to update the list of processes.

If the required process is not active yet not in this list, type in its name in the New field then click OK.

  • Name – Auto-completed by default with the name of the monitored process. Will be shown in OpenLM Applications Manager (e.g. ‘chrome’). Cannot be changed once the process has been selected.
  • Description – Auto-completed by default with the process name. Can be modified with a description of the process which will be shown in OpenLM Applications Manager (e.g. ‘chrome’).
  • Path – Auto-completed by default. Cannot be changed (e.g. ‘chrome’).
  • Parameters (optional) – type in any parameter that the application requires in order to monitor it with OpenLM Agent and have it reported to OpenLM Applications Manager.

Note: OpenLM Agent will monitor only those applications/processes which have been launched with the parameter(s) in question.

  • Version (optional) – the application version number. Will be displayed in OpenLM Applications Manager (e.g. ‘v80’).
  • Vendor – the name of the application manufacturer. Will be displayed in OpenLM Applications Manager (e.g. ‘Google’).

5. Click OK to save the changes and add the application to the Products list.

6. Click Apply in the OpenLM Applications Manager tab to save the changes and close the configuration window.

7. A User Account Control pop-up window may appear, click Yes.

 

3. Checking if an application definition has been added to OpenLM Applications Manager

To check whether an application definition in OpenLM Agent’s product list has been added successfully to OpenLM Applications Manager’s list:

1. Open EasyAdmin (Windows Start → OpenLM → OpenLM EasyAdmin User Interface)

2. Go to EasyAdmin Start → Administration:

2. Click OpenLM Applications Manager:

3. The OpenLM Applications Manager window is now open. The applications list should contain the application(s) added in OpenLM Agent’s Product list:

Refer to the OpenLM Applications Manager configuration guide or this webinar recording for more information on configuring License Return and License Consumption policies.

 

4. Manually replicating the application list to other OpenLM Agents

Once an OpenLM Agent application list has been configured, it is possible to replicate the list to other OpenLM Agents without having the centralized_products_xml flag in the configuration file set to True.

This can be done manually by copying the products.xml file located in C:\ProgramData\OpenLM\OpenLM_SoftwareLockerService and overwriting it to other computers that have OpenLM Agent in the same location.

in

Related Articles