OpenLM Agent Installation V4.4 - OpenLM Software License Management
Israel +972 4 6308447         USA +1 866 806 2068        JAPAN +81 3 45208991 担当:萩原

 

Introduction

OpenLM Agent may be installed on any number of workstations to enhance the end-user experience and control it.

The goal is to allow administrators to obtain additional information regarding license usage on individual workstations which can be used for more effective resource management.

The capabilities include, but are not limited to:

Providing administrators with the capability of monitoring end-user application idle times, and releasing idle licenses as a result.

Providing the end-users with a license availability interface.

Reporting on IP, project information and workstation availability.

This document covers only installation and removal of OpenLM Agent.

The three most common options for installation are as follows:

Using standard Setup Wizard, by silent command prompt installation, System Center Configuration Manager (SCCM) installation and GPO rollout.

Other deployment systems can also be used – please contact ourtech support for more information on the matter.

For more information regarding the configuration process of the OpenLM Agent, please view the following documents:

Introduction to Using OpenLM Agent

OpenLM Agent Configurations

Using Custom Commands

 

Installation

To begin working with OpenLM Agent, users need to initiate and configure installation using installation package openlm_active_agent_win_####.msi (“####” represents version number). Installation can be handled by using a standard Setup Wizard (see section in this document titled “Option A: OpenLM Agent Setup Wizard Installation” ), by using silent installation (see section in this document titled “Option B: OpenLM Agent Silent Installation”), with Microsoft System Center Configuration Manager (see section in this document titled “Option C: OpenLM Agent Installation with SCCM”).

The Setup Wizard package is mostly automated, as it uses a simple “Click-Next” installation process.

Both silent installation (command prompt) andGroup Policy Object (GPO) installations offer options for installing OpenLM Agent on multiple workstations from a centralized server without any end-user involvement.

Installation file can be obtained by contacting our sales team or download area of the website (visit our downloads page and locate the OpenLM Agent download link).

 

Option A: OpenLM Agent Setup Wizard Installation

This installation method uses an on-screen wizard which leads end-users through the installation process.

1. Double-click the installer file to launch the installation.

A welcome screen for the OpenLM Agent Setup Wizard will appear (see Figure 1).

Figure 1: OpenLM Agent Setup Wizard

 

2. Click [NEXT] in order to continue to the License Agreement screen (See Figure 2).

Figure 2: License Agreement screen

 

3. Read the license agreement and choose one of the following options (A, B or C):

A. If you do not want to continue the installation, click [Cancel], and a confirmation screen will appear with a warning that you will be exiting the installer without completing the installation. Click [Yes] to exit the installer.

B. Click [<Back] to return to Setup Wizard window (Figure 1).

C. In order to continue with installation, click the “I Agree” radio button (see Figure 3), which will make the ‘[Next]’ button active.

Simply click [Next] to advance to OpenLM Extensions screen (see Figure 4).

Figure 3: License Agreement with “I Agree” checked.

 

4. The installer automatically checks for the presence of licensed software packages on the end-user workstation.

If any of the above-listed applications are installed on the end-user workstation, then they will be automatically detected, and their corresponding checkbox will be activated and checked by default.

Uncheck the extensions only if your OpenLM license file does not support the “Active Agent” extension.

Click [Next] to see part 2 of the “OpenLM Extensions” installation options (See Figure 5). [NOTE: If a new extension is installed, OpenLM Agent must be reinstalled and the appropriate extension flag must be reselected.]

Figure 4: The OpenLM Extensions screen.

 

5. Click “OpenLM Applications Manager” box to have the OpenLM Agent support the OpenLM Applications Manager, which allows for monitoring and control of standalone, unmanaged or named applications.

The OpenLM Applications Manager also adds additional options to OpenLM Agent Configuration screen (see Step #13).

See dedicated documentation on the OpenLM Applications Manager here, and for more technical information,check out the link here

Figure 5: OpenLM Extensions screen.

 

6. Click [Next] to select the relevant Installation Folder (see Figure 7).

This will be populated with a default installation path, but if you wish to change the path, simply click the [Browse…] button and select a new folder.

The button [Disk Cost…] will display all the available drives and their details, such as size and available space.

Figure 7: Select Installation Folder screen.

 

7. Click [Next] and installation confirmation screen will appear (see Figure 8).

Figure 8: Installation Confirmation screen.

8. Click [Next] and installation process will begin. A screen will appear displaying progress bar (see Figure 9).

Figure 9: OpenLM Agent installer progress bar.

 

9. When the software is installed, the “Agent Configuration” screen will appear (see Figure 10).

Figure 10: Agent Configuration screen.

 

10. Check if all options are correct, so it might be necessary to consult your system administrator first.

Unless there is a specific reason for altering the default options, it is suggested to keep them as they are.

“Language” determines which language the OpenLM Agent interface will be in (English by default).

“OpenLM Server” field should hold the OpenLM server hostname. (localhost by default).

‘SSL’ box should only be checked if your network uses SSL security. (Off by default).

“Port” field should match the OpenLM Server connection port. (7012 by default).

“Logging Level” field toggles the amount of details which will be written into the log files. (ERROR by default).

[NOTE: It is possible to close Agent Configuration screen and return to it at a later time for completing the setup.

In order to complete the configuration process at a later time simply click on the “Show Hidden Icons” arrow to the right of the Windows taskbar, then right-click the OpenLM Agent icon on the menu and select “OpenLM Agent Configuration” on the screen which pops up. Once the screen configuration appears follow Step #11 to Step #15.]

 

11. Check connectivity by clicking the “[Check Connectivity to OpenLM Server]“ button, which should return a success message in the “OpenLM Connection Check“ screen (see Figure 11).

Figure 11: Connection check success.

After receiving success message on OpenLM Connection Check screen, close the connection check screen by clicking [OK].

If the connection is not successful (see Figure 12), check to see that the OpenLM Agent services are running (see “Services Check” section later in this document).

Also check if there is network connectivity to the server hosting OpenLM server

(e.g., the server name and port are correct – server connection can be checked with cmd, using command “ping SERVER_NAME_HERE”; port connection can be checked using telnet:
https://www.acronis.com/en-us/articles/telnet/ ). If you have reviewed the services and installation and still get an error, please contact the OpenLM support team (support@openlm.com).

Figure 12: Connection check failure.

12. After receiving success message on “OpenLM Connection Check” screen, close it by clicking [OK].

 

13. [Optional] If the OpenLM Applications Manager extension is installed, OpenLM Applications Manager tab will be available on the top of the “Agent Configuration“ screen. Click the tab to reveal additional options concerning the “OpenLM Applications Manager” (see Figure 13).

Figure 13: OpenLM Applications Manager configuration options.

 

14. Check if all options are correct, so it might be necessary to consult your system administrator first.

Keeping the default values is generally recommended, unless there is a specific reason to alter them.

“OpenLM License Manager Server” field should hold the correct OpenLM Applications Manager hostname. (localhost by default)

Check SSL box if the network uses SSL security. (Off by default)

“Port” field must match the “OpenLM Applications Manager” connection port (27080 by default)

Use [Check connectivity status] to be sure that server connection is set up correctly and functioning. This should return a success screen (see suggestions in Step #11 if connection fails).

Use automatic products detection checkbox enables automatic application detection. Is used mainly for Bentley products.

Products list and paths – by pressing the Configure button, you’ll be able to list applications to be monitored by the OpenLM Applications Manager.

OpenLM Applications Manager Service status – shows the status of theOpenLM Applications Manager service, which can be updated by clicking the Run button.

15. Click [Apply] and the OpenLM Agent Configuration screen will close after saving all of the changes made.

16. An installation success screen appears when Agent Configuration screen is closed (see Figure 18).

Figure 18: Installation success screen.

17. Click [Close] to exit this part of installation.

At this point, installation of OpenLM Agent is complete. See the dedicated end-user documentation to begin using the functionality (Introduction to Using OpenLMAgent).

 

Option B: OpenLM Agent Silent Installation

This installation method allows users to install OpenLM Agent with predefined options and no on-screen ‘wizard’ assistance.

1. Open command prompt with administrative privileges (see Figure 19). The command prompt can be run in several ways:

A. Type ‘cmd’ in the taskbar search field and press RETURN on the keyboard. Right-click “Command Prompt” in the results list and choose “Run as administrator” from the popup menu.

B. Launch EXE directly by right-clicking (e.g., from C:\Windows\System32\cmd.exe) and choose “Run as administrator” from the popup window.

C. Navigate to the Start menu. Right-click on Start then choose Windows PowerShell (Admin). This will open Windows PowerShell in administration mode.

Figure 19: Command Prompt screen in Administrator role.

2. Enter the desired installation parameters in the command prompt, which will be in the following format:

msiexec /i <msi installation file path> /qn /norestart <parameters>

MSI installation file path is the location of the MSI file downloaded for installing the OpenLM Agent.

Parameters can be selected from parameter tables (see “Installation Parameters, Options, and Descriptions” section below in this document).

3. Press [Enter/Return] on the keyboard to launch installation.

At this point, the installation(s) will be completed. Please see our dedicated configuration documentation for more information on basic and advanced OpenLM Agent configurations (Configuring OpenLM Agent).

 

Option C: OpenLM Agent Installation with Microsoft System Center Configuration Manager (SCCM)

OpenLM recommends to useGroup Policy Object (GPO) installation. However it is possible to install OpenLM Agent with SCCM. Please see the following document describing in detail this installation process – User Guide on OpenLM Agent installation using Microsoft System Center Configuration Manager (SCCM). Note that SCCM installation is presented in that document as an example and requires additional fine-tuning on the part of your local expert/system administrator.

The following steps describe installation of OpenLM Agent. Instructions assume that there is already a working SCCM installation in your environment as well as on the workstations where OpenLM Agent will be deployed. It is advisable to seek IT department assistance with SCCM-related tasks. For additional information about SCCM and support of its installation and use beyond the instructions here, please consult with Microsoft Support (System Center Configuration Manager).

Installation requires two stages:

Creating installation package for the application

Deploying application on target workstations

 

Creating Installation Package

1. Locate the OpenLM Agent installer (openlm_active_agent_win_####.msi) on the SCCM server or on a network share to be sure it is accessible by that server.

2. Open SCCM Configuration Management Console on the SCCM server.

3. Navigate to the Applications tab in Software Library menu to the left of the screen (Software Library > Overview > Application Management > Applications).

4. [Optional] A folder can be created under Applications in order to help manage the applications of the organization. This may be helpful in cases where it is an advantage to create applications for a variety of situations.

To create a folder, simply right-click on Applications and choose “Folder” from the popup list. Enter Folder Name in Configurations Manager screen and click [OK].

5. Right-click on Applications and choose “Create Application” from pop-up menu.

An “Application Wizard” dialog will open, displaying general information (see Figure 20). [NOTE: If an application needs to be added to a folder, which was created by Step #4, You’ll simply need to right-click on the folder name in the menu, instead of clicking on Applications.]

Figure 20: Create Application Wizard displaying General panel.

6. Select “Automatically detect information about this application from the installation files” by clicking the radio button. This will use information from the installation files for automating the installation process as much as possible.

7. Choose an installation file type, then click the ‘down’ arrow on Type drop-down list and choose “Window Installer (*.msi)” by clicking on it.

8. Click on [Browse] button to locate the MSI installation file, which was identified on Step #1.

9. Click [Next] to advance to ‘View Imported Information’ panel, which displays information automatically captured from the installer package.

10. Click [Next] to advance to ‘Specify information about this application’ panel (see Figure 21).

Figure 21: “Specify information about this application” screen.

11. Input all relevant and desired details in to the upper portion of the screen.

These fields are free text which can help identify and sort applications during searches. The fields include Name, Administrative Comments, Manufacturer, Version, Optional Reference and Administrative Categories.

12. Modify the Installation program field as required and use the [Browse] button to locate the installation file in question. This field can include options you would normally use in silent installation from the command line. See “Installation Parameters, Options and Descriptions.” section in this document.

13. In the lower half of the panel, select the desired installation behavior from “install behavior” drop-down menu.

Install per user — Installs using rights taken from the current user.

Install per system — Installs using SMS Agent Host service rights (Local System account).

Install per system if the resource is a device; otherwise, install per user — If the application is targeted for a collection of devices, use install per system.

If the application is targeted as a collection of users or user groups, use install per user.

14. Click [Next] button to advance to the Summary screen.

15. Review information compiled for application. If anything needs to be changed use [Previous] button to navigate back through wizard screens; return to Summary screen after completing changes.

16. When compiled information has been reviewed, click [Next] button on Summary screen. It will save the changes and invoke progress screen (see Figure 22) while application is created. When the process is completed, the completion screen will appear along with a review of the process (see Figure 23).

Figure 22: “Create Application Wizard” progress screen.

Figure 23: “Create Application Wizard” success screen.

17. Click on [Close] to close Completion screen and exit the wizard.

At this point, creation of the installation package is complete. It will be available in the SCCM console listing under Software Library > Overview > Application Management > Applications.

Additional applications may be created to handle different installation criteria by repeating Step #4 to Step #17. Additional parameters and details may be added by right-clicking the application in the console and choosing “Properties.”

 

Deploying Application to Target Workstations

1. Open SCCM console and locate application in the listing under Software Library > Overview > Application Management > Applications.

2. Right-click on OpenLM Agent application and select “Deploy” from popup menu that appears. The “Deploy Software” Wizard will open along with a General screen (panel titled “Specify General Information for this Deployment”).The ‘Software’ field will be pre-populated with the application name (see Figure 24).

Figure 24: “Deploy Software Wizard” – specify general information for this deployment screen.

3. Click the [Browse] button to the right of the ‘Collection’ field – “Select Collections” screen will appear. By default User collections screen is opened (Figure 25).

Figure 25: “Users Collections” panel on Select Collection screen.

4. Use drop-down list in the upper left part of the Select Collections screen to navigate to the desired User Collections, then choose from any available options which appear in the right part of the screen.

5. [Optional] Use the drop-down list in the upper left part of the “Select Collections” screen. Then navigate to “Device Collections” and choose from the available options which appear in the right part of the screen.

Figure 25: “Device Collections” panel on Select Collection screen.

6. Click [OK] to accept changes and return to General screen.

7. Click [Next] to advance to the “Content” screen (panel titled “Specify Content Destination”).

8. Click [ADD] to open a popup menu and choose “Distribution Points”.

Add distribution points by marking the checkboxes on Add Distribution Points screen.

9. Click [OK] to return to Content screen.

10. Click [Next] to advance to the “Deployment Settings” screen (panel titled “Specify Settings to Control How this Software is Deployed”).

11. Default values for “Action and Purpose” are “Install” and “Available,” respectively. “Available” value needs to be changed to “Required”, as these options are the suggested ones for installing the OpenLM Agent.

Click [Next] to advance to the “Scheduling” screen (panel title “Specify Schedule for this Deployment).

12. [Optional] Use the options on the “Scheduling” screen to specify the time of installation. The default value of “As soon as possible after the available time” will launch installation as soon as possible following completion of the deployment setup.

13. Click [Next] to advance to “User Experience” screen (panel titled “Specify the user experience for the installation of the software on the selected devices”).

14. [Optional] Adjust the options as desired. The default for “User Notification” is “Display in Software Center and show all notifications.” “Commit changes at deadline or during maintenance window (requires restart)” is also checked by default.

15. Click [Next] to advance to “Alert” screen (panel title “Specify Configuration Manager and Operation Manager alert options”).

16. [Optional] Adjust the options as desired. None of the options are enabled by default.

17. Click [Next] to advance to “Summary” screen (panel title “Confirm settings for the new deployment”).

18. Review the information compiled for deployment. If anything needs to be changed, use [Previous] button to navigate back through wizard screens. Return to Summary screen after completing any changes.

19. Click the [Next] button on the “Summary” screen to accept changes and initiate creation of deployment, which will make a progress screen appear.

When the process is complete, Completion screen will be displayed along with review of completed process.

20. Click [Close] to exit the wizard to return to console screen.

21. [Optional] Locate deployment by clicking Deployments tab in the bottom of SCCM console screen with selected application.

Upon successful deployment, OpenLM Agent should appear in the “Software Center” on the client and will be installed automatically.

Installation Parameters, Options and Descriptions

This section lists parameters that can be used during installation (Option B the Silent Installation option, and Option C the SCCM Configuration Management Console). The parameters are divided into three sections:

Command Parameters

Active Agent Extensions

License Manager Extension Parameters

These parameters help administrators control installation options.

Installation Command Parameters

Basic parameters for the installation of OpenLM Agent are listed in Table 1: Command Parameters.

 

Command Parameters Options Default Description
SERVERNAME localhost Use actual OpenLM server name.
SERVERPORT 7012 Use actual OpenLM server port number.
SHOW_NOTIFICATION_ICON true

false

true False: hides OpenLM Agent icon from the user (not recommended).

True: Show notification icon in taskbar.

ERROR_LEVEL all

debug

info

warn

error

fatal

off

error Recommended logging level: Error
TARGETDIR C:\Program Files (x86)\OpenLM\OpenLM Agent Specifies root destination directory for installation.
SHUT_WHEN_NOT_ACTIVE

Note: starting with version 5 this command is obsolete and should not be used. Please use  “shut_when_products_are_inactive” switch instead.

true

false

false True: Shutdown Active Agent automatically when an application is monitored as inactive for a certain period of time defined in the INACTIVITY_TIME parameter.

False: Ignore inactivity.

INACTIVITY_TIME

Note: starting with version 5 this command is obsolete and should not be used. Please use  “shut_when_products_are_inactive” switch instead.

seconds A number representing inactivity time in seconds. Useful only when SHUT_WHEN_NOT_ACTIVE = true
SHUT_WHEN_PRODUCTS_ARE_INACTIVE seconds This switch determines after how much time the connection will be closed when application is not reporting.

Add requested time period in seconds (For example : shut_when_products_are_inactive=180). It’s recommended to set the min value to more than 60 seconds.

Important: When shut_when_products_are_inactive switch is used SHUT_WHEN_NOT_ACTIVE functionality will be bypassed.

Recommendation on how to use shut_when_products_are_inactive switch with shut_when_not_active:

Application mode – when working from Сitrix in application mode set SHUT_WHEN_NOT_ACTIVE to False in installation, and use the shut_when_products_are_inactive when launching the application.

Desktop mode – when working with Citrix in desktop mode set SHUT_WHEN_NOT_ACTIVE to False

When working with both types, set SHUT_WHEN_NOT_ACTIVE to False on install and when opening in application mode add shut_when_products_are_inactive with necessary time period.

LANG en-US

ru-RU

es-ES

de-DE

fr-FR

ja-JP

pt-BR

en-US The OpenLM language format. The options are as follows:

en-US: English

ru-RU: Russian

es-ES: Spanish

de-DE: German

fr-FR: French

ja-JP: Japanese

pt-BR: Portuguese

REQUEST_TIMEOUT 120 seconds Timeout for OpenLM Server request of OpenLM Agent. Customers using ‘Suspend and Resume’ to FlexLM controlled applications may want to consider extending the default.

Table 1: Command Parameters.

Installing OpenLM Agent Extensions

OpenLM Extensions are software modules that enable OpenLM to retrieve idle licenses through “Save and Close” method. Additional information on OpenLM extensions can be found on the OpenLM website (OpenLM Extensions). Parameters and values for installation during silent installation are listed in Table 2: OpenLM Agent Extension Parameters.

[NOTE: Extensions can only be installed when relevant application installation already exists on the workstation. So if an associated application is not present on the workstation, the installation flag will be ignored regardless if it is set or not].

Extensions

Options

Default

Description

INSTALL_ARCGIS

0: Do not install

1: Install

Determined at run time.

1 if application exists.

0 if application does not exist.

ArcGIS extension

INSTALL_PLUGIN

0: Do not install

1: Install

1

Relevant to ArcGIS users only. Allows selection of ArcInfo, ArcEditor or ArcView license levels.

INSTALL_ARCGISPRO

0: Do not install

1: Install

Determined at run time.

1 if application exists.

0 if application does not exist.

ArcGISPRO extension

INSTALL_MATLAB

0: Do not install

1: Install

Determined at run time.

1 if application exists.

0 if application does not exist.

Matlab extension

INSTALL_SOLIDWORKS

0: Do not install

1: Install

Determined at run time.

1 if application exists.

0 if application does not exist.

Solidworks extension

Table 2: OpenLM Agent Extension Parameters.

 

Installing License Manager Extensions

OpenLM Applications Manager helps monitor and manage named, standalone and unmanaged applications, but it can also intervene with their license checkout events.

For more information, see the dedicated documentation on the website (OpenLM Applications Manager documentation).

Parameters in Table 3: License Manager Extension Parameters list options for controlling these capabilities through silent installation.

 

 

Extensions Options Default Description
CHECK_INTERCEPTION 0: Do not activate

1: Activate

1 License management component
PRODUCTS_XML_PATH \\ServerName\Shared folder\OpenLM\products.xml Enables centralizing location of products.xml file which stores OpenLM Agent application management information. Use local or UNC path. File location:

C:\ProgramData\OpenLM

\OpenLM_SoftwareLockerService

CENTRALIZED_PRODUCTS_XML True

False

False Option of switching on update of versions of the products xml file from Applications Manager. Whenever new application is added in Applications Manager interface, any workstation that was set to work with centralized products (set as true) will be updated automatically.If this  parameter was added to installation as true,  the centralize functionality will be activated.

 

If it wasn’t part of the silent installation, it means the installation does not support centralized product xml (as if it was set to false).

ALLOW_EDIT_PRODUCT_LIST True

False

True When set to True it allows to edit product list from Agent’s interface. This is default value unless it was defined otherwise – so if user does not define it during installation process end user will be able to edit the list.When set to false it blocks editing option.
UNC_USER_NAME Username of authorized to (read/write) products.xml file.
UNC_PASSWORD Password of UNC_USER_NAME username.

Table 3: License Manager Extension Parameters.

Examples

The following examples are intended to be guidelines to possible real-world scenarios that may help users select and configure installations for their own needs. They are not intended to be suggested configurations. The ‘####’ string in each example represents version number of the installer which is subject to change.

Example 1

Install OpenLM Agent and connect it to OpenLM Server ‘145.13.4.121.’ Hide notification icon. Set logging level to ERROR:

msiexec /i “C:\tmp\openlm_agent_win_####.msi” /quiet /norestart SERVERNAME=145.13.4.121 SHOW_NOTIFICATION_ICON=false ERROR_LEVEL=ERROR

Example 2

Install OpenLM Agent and connect it to OpenLM Server ‘olm_server,’ whose server port 7777. Set the language to German. Set logging level to ALL.

msiexec /i “C:\tmp\openlm_agent_win_####.msi” /quiet /norestart SERVERNAME=olm_server SERVERPORT=7777 ERROR_LEVEL=ALL LANG=de-DE

Example 3

Install OpenLM Agent and connect it to OpenLM Server ‘olm_server,’ whose server port is 7012, then connect it to the OpenLM Applications Manager on port 27080 with centralized products rollout.

msiexec/i “C:\tmp\openlm_active_agent_win_####.msi” SERVERNAME=olm_server_host SERVERPORT=7012 LICENSE_MANAGER_SERVER=olm_app_manager_host LICENSE_MANAGER_PORT=27080 ERROR_LEVEL=ERROR CENTRALIZED_PRODUCTS_XML=true ALLOW_EDIT_PRODUCT_LIST=false /qn

Example 4

Install OpenLM Agent with all applications extensions and connect it to OpenLM Server ‘olm_server,’ whose server port is 7012.

msiexec/i “C:\tmp\openlm_active_agent_win_####.msi” SERVERNAME=olm_server_host SERVERPORT=7012 LICENSE_MANAGER_SERVER=olm_app_manager_host LICENSE_MANAGER_PORT=27080 ERROR_LEVEL=ERRORINSTALL_SOLIDWORKS=1 INSTALL_ARCGIS=1 INSTALL_ARCGISPRO=1 INSTALL_MATLAB=1 INSTALL_AUTOCAD=1 /qn

Example 4

Install OpenLM Agent with all applications extensions and connect it to OpenLM Server ‘olm_server,’ whose server port is 7012, then connect it to the OpenLM Applications Manager on port 27080 with centralized products rollout.

msiexec/i “C:\tmp\openlm_active_agent_win_####.msi” SERVERNAME=olm_server_host SERVERPORT=7012 LICENSE_MANAGER_SERVER=olm_app_manager_host LICENSE_MANAGER_PORT=27080 ERROR_LEVEL=ERRORINSTALL_SOLIDWORKS=1 INSTALL_ARCGIS=1 INSTALL_ARCGISPRO=1 INSTALL_MATLAB=1 INSTALL_AUTOCAD=1 CENTRALIZED_PRODUCTS_XML=true ALLOW_EDIT_PRODUCT_LIST=false /qn

Services Check

This section is only relevant when OpenLM Applications Manager was selected during installation. You will need to make sure all of the necessary OpenLM components are running before attempting to use the module.

1. Open Windows Services (e.g., execute C:\WINDOWS\system32\services.msc or type “Services” in Windows search on the taskbar and choose Services App from the result).

2. Be sure that OpenLM_SoftwareLockerService is running. If the service is not running, right click the service name in the Windows Services screen and choose “Start” from the pop-up menu.

3. When service has been started, close Services window by clicking [X] in the upper right of the screen.

When it is confirmed that the service is running, it is possible to check server connection.

Uninstalling OpenLM Agent

Uninstall can be initiated through Windows Control panel (Option A) or by launching OpenLM Agent Setup Wizard and choosing option to Remove OpenLM Agent (Option B), or using Silent Uninstall (Option C).

Option A: Uninstall Using Windows Control Panel

1. Open Windows Control Panel. This is located at C:\Windows\System32\control.exe or by typing “Control Panel” in the Windows search bar and selecting “Control Panel” from the results.

2. Locate and click “Uninstall a Program” option under Programs highlighted in Figure 26. Programs and Features screen will appear (see Figure 27).

Figure 26: Windows Control Panel with highlighted link.

Figure 27: Programs and Features screen.

3. Locate OpenLM Agent in the list of names. Options will appear at the top of the list for possible actions.

Figure 28: Programs and Features screen with highlighted options.

4. Click on Uninstall. This will open confirmation screen (see Figure 29).

Figure 29: Uninstall confirmation screen.

5. Click [Yes] to confirm the uninstall. A progress screen will appear (see Figure 30). Progress screen will close when the process is complete.

Figure 30: OpenLM Agent uninstall progress screen.

6. Close Programs and Features screen by clicking [x] in the upper right part of the window to close Control Panel.

Option B: Uninstall Using OpenLM Installer Package

1. Locate installer file and double-click installer file or right-click and choose “install” from the pop-up menu. OpenLM Agent Setup Wizard screen will appear (see Figure 31). “Repair OpenLM Agent” is selected by default.

Figure 31: OpenLM Agent Setup Wizard screen.

2. Click Remove OpenLM Agent radio button to select process for removing the installation (see Figure 32).

Figure 32: Setup Wizard with “Remove OpenLM Agent” selected.

3. Click [Next] button to initiate removal process. A progress screen will appear (see Figure 33).

Figure 33: Removing OpenLM Agent progress screen.

4. Click [Close] button to exit Setup Wizard.

Figure 34: Removal success screen.

At this point removal process is complete. Uninstalling will leave configuration files for OpenLM Agent intact and these must be deleted manually. They are left so that OpenLM Agent can be reinstalled without losing previous configurations. They can be found by default in C:\Program Files (x86)\OpenLM\OpenLM Agent.

c) Silent Uninstall

Open a command line prompt as an administrator and enter the following command line: msiexec /x<Product code> /quiet.

Notes:

Replace the product code with the relevant product code as described in the section “Installation Codes”.

The parameter /x uninstalls a product.

Example:

Silently uninstall version OpenLM Agent

msiexec /x {E1E35EA8-6C9E-458E-8902-E36474186B14} /quiet

Installation codes

In order to obtain product code of any application you want to install/uninstall type in cmd: “wmic product” command, where “Name like ‘%agent%’” get Name, Version, IdentifyingNumber.

For example:

================

C:\Users\TestUser>wmic product where “Name like ‘%agent%'” get Name, Version, IdentifyingNumber

IdentifyingNumberNameVersion

{6920D378-ACAF-4B16-A5A7-B80DB00452D3}OpenLM Agent4.4

====================================