Upgrade guide of OpenLM to Version 2.0: Embedded Database - AN3101a - OpenLM Software License Management
USA +1 866 806 2068 | JAPAN +81 3 45208991 担当:萩原 info@openlm.com

Upgrade guide of OpenLM to Version 2.0: Embedded Database – AN3101a

Changes in OpenLM v2.0

OpenLM v2.0 has seen major improvements, enhancements and fixes to its predecessor – OpenLM v1.8. These changes are relevant to the OpenLM server and Database, as well as the OpenLM Broker and Agent. Please see this document for an overview of what’s new in version 2.0.


This document describes the upgrade process of OpenLM installations that use the embedded Firebird database, from v1.8 and from earlier versions of 2.0 to the latest 2.0 version.

Please note the following guidelines:

  • Upgrading OpenLM 1.8 versions to OpenLM 2.0 requires running the installation MSI file over the existing installation.

  • Upgrading of earlier versions of OpenLM (e.g. 1.7) to 2.0 requires a two-step procedure; OpenLM will first need to be upgraded to 1.8, and then to 2.0. Please refer to this document:

Application Note 1101: Upgrade guide of OpenLM Version 1.7 to 1.8 Embedded Database

  • The procedure of upgrading version 1.8 systems that use an external database (i.e. Oracle, MS-SQL or MySQL) is brought here:

Application note (3101b): Upgrade guide of OpenLM version 1.8 to version 2.0 external database.

The installation of such external databases requires additional licensing.


1. Before upgrading please make sure your system is compliant with the OpenLM System requirements.

2. If the OpenLM server (of any version) has been already installed on the machine for a period longer than the Evaluation period, A license file will be required . Please make sure you have one before proceeding with the upgrade process.

In order to obtain a valid OpenLM license file, please contact OpenLM support, and provide your MAC address and Hostname (case sensitive).

Download the latest OpenLM v2.0 system components

The OpenLM System components are available for download on the OpenLM site.


After filling in your name and email, you will be directed to the download section. Select the and download the latest OpenLM server version.


Full Upgrade procedure with preliminary check for embedded database configuration

1. Backup the database-VERY Important

Backing-up the database is mandatory, since the database upgrade process is sensitive to hardware and software malfunctions. Upgrade the OpenLM Server without backing up the database file may compromise the accumulated data. Stop the “OpenLM Server” Windows’ Service, and backup the database file, typically located at “C:\Program Files (x86)\OpenLM\OpenLM Server\db”.

2. Test the database upgrade process (optional stage)

Choose a test workstation (Not the production OpenLM Server machine) and take the following steps:

  • Install the exact OpenLM Server version that is currently in use (e.g. on the selected workstation.

  • Stop the “OpenLM Server” windows’ service on both the test workstation, and the Production server.

  • Replace the empty test database with a copy of the production database, typically located at “C:\Program Files (x86)\OpenLM\OpenLM Server\db\OPENLM_DB.FDB”

  • Start the “OpenLM Server” windows service on both the test workstation, and the Production server.

  • Close the Services window, as well as all OpenLM related windows.
  • Execute the OpenLM installation MSI file. This will upgrade the OpenLM server version to the latest 2.0 on-top of the existing installation.

  • When upgrading from an earlier 2.0 version (e.g. from to an additional database-upgrade script will need to be run. Download the zip file, Extract it, and run the .exe file within the extracted folder.

  • Test the new installation. Now you can upgrade your production system.

3. Upgrade the production system.

Execute the OpenLM installation MSI file. This will upgrade the OpenLM server version to the latest 2.0 on-top of the existing installation.

4. Update the OpenLM Agent.

OpenLM Agent versions prior to 2.0 are not compatible with OpenLM Server 2.0. The OpenLM Agent must be upgraded on all workstations. Please refer to this document for more information on silent Agent installation.

5. Install the OpenLM Broker on any license server managed by OpenLM.

The OpenLM Broker is an optional component that highly enhances the capabilities of the OpenLM Software. Download the latest OpenLM Broker version from the OpenLM site’s downloads section, and install it on each license server machine. On Windows’ machines, the OpenLM Broker will automatically detect the license managers that exist on that machine, and will just need to be configured to interface the OpenLM server.

6. OpenLM Alerts

Prior to version 2.0, OpenLM Alerts were implemented as a separate module. In version 2.0 the OpenLM alerts have been integrated into the OpenLM EasyAdmin web application. Alerts settings will not be saved during 1.8 to 2.0 upgrades.

Known issues:

1. After migrating the OpenLM server to version 2.0, the EasyAdmin web application may become non-responsive. In that case, it is recommended to clear the web browser’s cache.

2. The OpenLM Software is delivered with LightTPD: a built-in web server that starts as a service. Users can continue and use the built-in web server or use a standard web server such as Microsoft IIS 7. Upgrading the OpenLM Server from version 1.8 to 2.0 does not preserve IIS configuration. It is up to the System Administrator to reconfigure the IIS web server to work with OpenLM EasyAdmin.

OpenLM Contacts

If you encounter any issue during the upgrade process, or require technical assistance please refer to our support team, and we will be glad to help: