OpenLM Docs
  • Home
  • Supported Software
  • Blog
  • Knowledge Base
  • Home
  • Supported Software
  • Blog
  • Knowledge Base
  • OpenLM System Architecture
  • Quick Start Guide: OpenLM – Engineering Software License
  • OpenLM SLM Installation Guide
    • Setting up SSL for OpenLM SLM and Identity Service
    • The OpenLM EasyAdmin User Interface
    • OpenLM Easy Admin User Interface Modules and Reports
      • OpenLM User Interface Reports  Samples
      • Named License Analysis (NNU) Report
      • License Denials Reporting
      • Determining license utilization efficiency
      • Historical license usage reports
    • OpenLM EasyAdmin User Interface - Administration
      • Products and Packages
      • Cleanup Manager module
      • Denials
      • Configuring the License Checkout Policy
  • OpenLM Identity Service Installation guide
    • OpenLM SLM and Identity Service Installation on Linux using RPM, DEB, and TAR Packages
    • Identity Service Configuration
      • Integration Between OKTA SSO and OpenLM
      • KeyCloak integration with OpenLM
      • Integration Between AD FS and OpenLM
      • Integration Between Azure Active Directory And OpenLM
      • How to move the Identity Service Instance to another machine and preserve the current configurations
      • Browser Configuration for OpenLM Windows Authentication
  • OpenLM Broker Installation on Windows
    • Installing OpenLM Broker on Unix / Linux
    • OpenLM Broker Web UI
    • OpenLM Broker Configuration
    • OpenLM Broker Connectivity Through HTTP Proxy Server
    • Troubleshoot OpenLM Broker by EasyAdmin User Interface messages
  • OpenLM Applications Manager Installation Guide
    • Installing two instances of Applications Manager in parallel
    • Applications Manager Installation on Linux
    • HTTPS/SSL support for Applications Manager and Broker
    • OpenLM Applications Manager Configuration
    • Optimal Configuration for Applications Manager
    • OpenLM Applications Manager Database Configuration Tool
    • Configure Applications Manager to Track Actual Usage
  • Directory Sync Installation Guide
    • Directory Sync v2x Configuration
  • OpenLM Reports Scheduler Installation Guide
    • Setting up SSL for Reports Scheduler
    • OpenLM Reports Scheduler Configuration
  • End-User Services & Workstation Agent Installation guide
    • Workstation Agent installation with Microsoft System Center Configuration Manager (SCCM)
    • The OpenLM Workstation Agent's interface - the Personal Dashboard
      •  Personal Dashboard User authentication
    • OpenLM AutoCAD Plugin Installation Guide
    • URL Monitoring With OpenLM
  • OpenLM ServiceNOW Adapter Installation and Configuration
  • OpenLM Reporting Hub Installation Guide
    • OpenLM Reporting Hub Data Structure
    • OpenLM Reporting Hub and customized license reporting
    • OpenLM Reporting Hub vs Embedded Reports Comparison
    • OpenLM Reporting Hub Upgrade
  • OpenLM SLM Features
    • License Allocation Manager - Options File management Using OpenLM EasyAdmin User Interface
    • OpenLM Alerts Configuration
    • OpenLM Roles & Permissions
    • OpenLM Group Usage Configuration
      • Introducing Entities in OpenLM - Users, Groups, IP and Hosts
    • License harvesting (Manual method), and Monitoring Idle Application time
      • License Harvesting of Idle Applications (MATLAB, AutoCAD, ArcGIS, ArcGIS Pro, SOLIDWORKS, and CATIA) – Save and Close
        • License Harvesting of Idle FlexLM Applications
          • License retrieval of idle applications – Enhanced Workstation Agent procedures
    • OpenLM Actual Usage
    • OpenLM Project Usage
    • OpenLM Unmanaged Processes
  • Software License Management Cloud Registration and Configuration Guide (SLMC)
    • OpenLM Virtual License Manager: A Comprehensive Guide
    • Setting up Cloud Directory Sync
    • LDAP Connector Configuration
    • OpenLM Cloud Logs uploader

OpenLM Applications Manager Installation Guide

836 views 0

Written by Maria Gilca
November 4, 2023

The OpenLM Applications Manager provides a solution for intervening in excessive license consumption and avoiding unplanned license expenditure or breach of license compliance.

The Applications Manager is a Java application hub for all OpenLM Workstation Agents. The OpenLM SLM queries the Broker component, which queries the Application Manager to obtain usage data. Because of this, the Broker component is mandatory and must be installed on the same machine as the Applications Manager.

OpenLM Applications Manager workflow

OpenLM Applications Manager workflow.

Installation

The OpenLM Applications Manager is implemented in Java and can be installed on any machine that supports it. This section covers both Windows and Unix / Linux installations.

System Requirements

  1. Java 11*
  2. 64-bit OS
  3. A working install of OpenLM SLM
  4. Working install of OpenLM Broker

* Java 11 is optionally bundled with the Applications Manager installer, so no additional download is required.

Unix / Linux Installation

Preliminary steps

1. Download the latest version of the Application Manager for Unix/Linux from the OpenLM website downloads section.

2. Extract the archive (OpenLM_AppManager_#.#.#.#.tar.gz) to a convenient location.

3. Open the settings.sh, file in your editor of choice. This file holds all the variables required for AppManager to operate. It is mandatory to modify the JAVA_HOME variable to point to the path of your JDK 11 install.

The JAVA_HOME path must not end with a trailing slash.

Optionally, you can also edit the APPMANGERSRVNAMEUSER variable in case you need to launch the service from a different account than “root.” In this case, you must ensure that all the files in the “OpenLM_AppManager_X.X.X.X” folder have their ownership reassigned to the new user.

4. Save the file and continue following the installation steps below, depending on your Linux distribution.

Installing AppManager as a service

If your Linux version supports systemd, the following steps will install OpenLM AppManager as a service which starts automatically on system start-up:

1. Install the AppManager as a service:

sudo ./appmanager.sh install

2. Test the status of the AppManager service:

sudo ./appmanager.sh status

3. Run the AppManager detection script. Alternatively, if your Linux install has a desktop user interface, you can run the GUI AppManager Configuration tool with:

sudo ./appmanager.sh config

Running AppManager as a background process

If your Linux version does not support systemd, the following steps will run OpenLM AppManager as a background process instead:

1. Run the AppManager process with:

sudo ./run_appmanager.sh

To open the AppManger configuration screen:

sudo ./run_appmanagerconfig.sh

Windows Installation

  1. Obtain the latest Windows installer from our Downloads page.
  2. Double-click the OpenLM Applications Manager installation file to launch the installation wizard.

    Figure 1: The Applications Manager Setup wizard.
  3. Click Next,  and the License agreement screen will appear
  4. Read the license agreement, then check the “I Accept the Terms of the License Agreement” box.

    Figure 2: The License Agreement screen.
  5. Click Next to advance to the Java Selection Screen. You have two options:
  6. Install Application Manager with Java OpenJDK
  7. If you already have it installed, browse to the path where it is installed:

    Figure 3: The Java Selection screen.
  8. Click Next to accept the configuration and advance to the “Install Location” screen.

    Figure 4: The “Choose Install Location” screen.
  9. Select the installation path. The default is: C:\Program Files\OpenLM\OpenLM App Manager\
  10. Provide the OpenLM SLM hostname and listener port – the default port is 5015:

    Figure 5: The Installation Completed screen.
  11. After installation is complete, click Next, then Finish to complete the installation:

    Figure 6: The completion screen.

Using an external JRE installation

Suppose you have chosen to use an external JRE installation instead of the one bundled with the Applications Manager installer. In that case, you must follow additional steps to get the “OpenLM App Manager” service to work. Please ensure that your Java installation is at least version 11 per the listed system requirements. To configure an external JRE with the Applications Manager:

  1. Locate your Applications Manager installation and open the bin folder (by default, the full path is C:\Program Files\OpenLM\OpenLM App Manager\bin).
  2. Double-click on OpenLMLicenseManager.exe.
  3. Select the Java tab.

    Figure 7: The “Java” tab in the OpenLM App Manager Config tool.
  4. Uncheck the “Use default” box.
  5. Click the … box near the “Java Virtual Machine” field.
  6. Browse to the location of your sqljdbc_auth.dll file. (e.g., on a typical JDK11 installation, this is located at C:\Program Files\OpenLM\OpenLM Applications Manager\bin)
  7. Click Open, then OK.

Generate an authorization file.

  1. Access the EasyAdmin User Interface.
  2. Navigate to Start → Administration → System & Security → Security → Authorization → ADD.
  3. From the Type drop-down list, select Applications Manager.
  4. In the Description field, type in a free text.
  5. Click SAVE. Click OK.  The authorization details (Client ID and Client Secret ) are displayed. You can either download the JSON file or copy and paste them.
  6. Click Download or Copy.
  7. Close the dialog.

Applications Manager Authorization

  1. Access C:\Program Files\OpenLM\OpenLM Applications Manager
  2. Look for the auth_tool bat file and open it. The OpenLM Applications Manager Auth Tool opens up.
  3. Click Import Authorization File. Please navigate to the location where the authorization file is saved and open it. (You can also manually paste the Client ID and Client Secret).
  4. Click Test. A pop-up message should appear that the connection is successful. Click OK to close it.
  5. Click Apply. A pop-up message should appear, prompting you to restart the Applications Manager.
  6. Open the Windows Services screen (open a Run dialog by pressing Windows + R, type services. msc, and click OK)
  7. Locate the “OpenLM App Manager” service and select it.
  8. Click on “Start” in the top-left corner.
  9. You can close the Services window once the service has started.

Configuring the Applications Manager

To run correctly, the Applications Manager requires configuration of the various components that it interacts with. These include the OpenLM SLM, OpenLM Broker, and OpenLM Workstation Agent. This section will show you how to configure each of these components separately.

OpenLM Broker Configuration for Applications Manager

The OpenLM Broker facilitates the connection to the OpenLM SLM. Once the Broker has been configured to interface with the Applications Manager, the settings will be passed along to the SLM. For this reason, we recommend that the configuration of the Applications Manager be done through the Broker first.

The Detect feature can automatically detect license manager information and simplify OpenLM Broker configuration. The function will add information for new ports (e.g., commands and paths) depending on what is detected.

  1. Open the OpenLM Broker. Go to License Managers Tab → ADD.
  2. Click Detect. This will populate the options with detected configurations or use defaults. The Applications Manager license server and additional nodes will be added to the navigation panel.

    Figure 8: The OpenLM Broker Configuration Tool and the “Detect” function.
  3. Review the auto-detected license managers to ensure the information corresponds to your installation. These items include the Applications Manager Host Name \ IP (License Server node), Port number and License Manager Type (Port node), command line paths to ‘status’ (Commands Status node) and ‘data_inquiry’ (Commands → data_inquiry node), and log file path (Log Files node). See the defaults listed in Table 1.
LM Type OpenLM App Manager
Hostname \ IP Localhost
Port Number 27080
Status Toggle Active
Log File C:\Program Files\OpenLM\OpenLM App Manager\logs\lm-log.log

Table 1: OpenLM Broker defaults for the Applications Manager


Click SAVE to commit the changes.

  1. Open the EasyAdmin User Interface of the SLM and Open the License Servers window. Go to Start → Widgets → License Servers.

    Figure 9: EasyAdmin User InterfaceLicense Servers screen.
  2. If the Broker has detected and added your Applications Manager, you should use the AppManager with Pending Status as depicted in the screenshot above. Double-click, then select the timezone and click Approve.

OpenLM Workstation Agent Configuration for Applications Manager

To enable the OpenLM Workstation Agent to intervene in software licensing distribution via the Applications Manager, it must be configured in the Workstation Agent. This can be done in two ways: before or after the Workstation Agent.

  1. While installing the Workstation Agent, one prompt will ask whether you are using the App Manager. Check the Use Applications Manager box and provide its host and port as depicted below:

    Figure 10: The OpenLM Workstation Agent installation prompt with Applications Manager settings
  2. For the complete Workstation Agent installation guide, follow this link
  3. If not already set, change the Applications Manager server address to the actual hostname or IP address where it is installed.
  4. Check the connectivity to the OpenLM License Manager by clicking the Check Connectivity Status button. This should return a success screen. If it returns a failure, check to see that the Applications Manager service is running, that the configuration for the Port and License Server in the Broker is set correctly, and that your license file has support for the Applications Manager extension. If the problem persists, please get in touch with OpenLM support (support@openlm.com)
  5. Click the Apply button. This will accept the changes and close the Agent Configuration screen.

At this point, the configuration is complete.

Please take a look at this document for more in-depth information.

Was this helpful?

Yes  No
Related Articles
  • OpenLM Cloud Logs uploader
  • KeyCloak integration with OpenLM
  • Setting up Cloud Directory Sync
  • OpenLM Reporting Hub and customized license reporting
  • OpenLM Virtual License Manager: A Comprehensive Guide
  • LDAP Connector Configuration

Didn't find your answer? Contact Us

Leave A Comment Cancel reply

Previously
Troubleshoot OpenLM Broker by EasyAdmin User Interface messages
Up Next
Installing two instances of Applications Manager in parallel
OpenLM Learning
Search
  • About Us
  • Contact Us
Twitter Facebook-f Youtube Linkedin

Products

  • Software License Management (SLM)
  • Software License Management Cloud
  • OpenLM Academic Program
  • OpenLM License Allocation Manager
  • OneDirectorySync
  • Virtual License Manager – VLM
  • OpenLM Directory Sync
  • OpenLM Applications Manager
  • OpenLM Features
  • Software License Management (SLM)
  • Software License Management Cloud
  • OpenLM Academic Program
  • OpenLM License Allocation Manager
  • OneDirectorySync
  • Virtual License Manager – VLM
  • OpenLM Directory Sync
  • OpenLM Applications Manager
  • OpenLM Features

What We Support

  • CAD Manager Tools
  • Supported License Managers
  • Supported Software & Vendors
  • License Manager Hosted (LMH)
  • OpenLM for Autodesk – A practical guide
  • OpenLM Token-based licenses
  • What is Sentinel HASP
  • CAD Manager Tools
  • Supported License Managers
  • Supported Software & Vendors
  • License Manager Hosted (LMH)
  • OpenLM for Autodesk – A practical guide
  • OpenLM Token-based licenses
  • What is Sentinel HASP

Resources

  • Downloads
  • Knowledge Base
  • Release Notes
  • Blog
  • Case Studies
  • Testimonials
  • Developers
  • Free Trial
  • OpenLM End User License Agreement
  • OpenLM SaaS EULA privacy policy
  • Downloads
  • Knowledge Base
  • Release Notes
  • Blog
  • Case Studies
  • Testimonials
  • Developers
  • Free Trial
  • OpenLM End User License Agreement
  • OpenLM SaaS EULA privacy policy

Company

  • About OpenLM
  • Our Team
  • Careers
  • Contact Us
  • Partner with OpenLM
  • GSA Contact Holder
  • Press Release
  • About OpenLM
  • Our Team
  • Careers
  • Contact Us
  • Partner with OpenLM
  • GSA Contact Holder
  • Press Release

Copyright © 2024 OpenLM | 19266 Coastal Hwy Unit 4-520 Rehoboth Beach DE 19971