Skip to main content
This topic also exists for Linux.
For correct operation of applications using ABBYY FineReader Engine 12, the Licensing Service is required. The Licensing Service is installed automatically during the Developer and Runtime installation in automatic mode. If you use manual installation, follow the instructions below. After the installation of the Licensing Service is complete, run the License Manager Utility to manage licenses. The Licensing Service settings are provided in the LicensingSettings.xml file. This file is generated automatically during automatic installation. When installing manually, you will have to create this file in the Bin (Bin64) folder and specify correct settings in it. The XML schema of the Licensing Service settings is described in the LicensingSettings.xsd file. You can find this file in the Inc folder. The detailed description of the settings is provided in the Working with the LicensingSettings.xml File section.
  • We recommend that you install (uninstall) the Licensing Service in manual mode only during Runtime installation (deinstallation). For development purposes use the standard installation and deinstallation.
  • Use ABBYY FineReader Engine and Licensing Service from the same package. Otherwise, compatibility is not guaranteed.

​
Installing in automatic mode

To install the Licensing Service in interactive mode, run the installLS.exe file in the distribution package and follow the installation instructions.

​
Installing in manual mode

Administrator access rights are necessary for the installation.
To install the Licensing Service manually, we recommend creating the Licensing Service package (let us call it a LS Package), which is a folder with the files necessary for ABBYY FineReader Engine licensing.
the /extract option for the installLS.exe file in the command line to unpack necessary files from the distribution package to a certain folder without installation. Inside it, there will be two folders:
  • Licensing - with the Licensing Service files
  • License Server - with the License Server files
The example of the command line:
installLS.exe /extract INSTALLDIR="C:\MyFolder"
Add to the LS Package on your computer:
  1. Licensing Service folder with all files copied from the unpacked Licensing folder.
  2. License Manager (License Manager64) folder with the following files copied from the unpacked License Server folder: Linux: libAbbyyZlib.so, libFineFormats.so, libFineNet.so, libFineObj.so, libPortLayer.so, libProtection.so, libProtectionConsoleUI.so, LicensingSchema.xe, ProductLicensingSchema.xe, LicensingService, and LicenseManager.Console. Copy the resource files libProtectionRes*.so for the interface languages you need, and libProtectionResShared.so
Windows: AbbyyZlib.dll, Awl.dll, concrt140.dll, FineFormats.dll, FineNet.dll, FineObj.dll, LicenseManager.exe, LicenseManager12.chm, LicensingSchema.xe, msvcp140.dll, ProductLicensingSchema.xe, Protection.dll, ProtectionRes0.dll, ProtectionResShared.dll, ProtectionUI.dll, vccorlib140.dll, vcruntime140.dll.
  1. KB2999226 update or the Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912. If you are not installing the Windows Update package, you can install the redistributable from the External Components\VC_Redist folder in the distribution package: vc_redist.x86.exe and vc_redist.x64.exe.
For Standalone installation:
  1. Copy the LS Package to the workstation.
We recommend you organizing ABBYY FineReader Engine files in a folder structure, easy to find and use. See the example below:
  • <YourApplicationFolder>/ABBYY FineReader Engine Library.
  • <YourApplicationFolder>/License Server/Licensing Service.
  • <YourApplicationFolder>/License Server/License Manager (License Manager64).
  1. Install the Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912.
  2. Copy the folders from the LS Package to the directory on the workstation you expected the Licensing Service to be.
  3. Create a folder for storing the licensing data (%ProgramData%\ABBYY\SDK\12\Licenses folder by default). Everyone must have full control permissions on this folder.
  4. For Online License: Create or choose a folder in which your application searches for the license token file, and place the token file there. You may choose the %ProgramData%\ABBYY\SDK\12\Licenses folder, which is the default behavior, or another folder used for storing the licensing data. Everyone must have full control permissions on these folders.
  5. Create a LicensingSettings.xml file and specify the settings according to the license type (see Working with the LicensingSettings.xml File for details).
  6. Copy the configured LicensingSettings.xml file into the following folders on the workstation:
  • Licensing Service.
  • License Manager (License Manager64).
  • folder with ABBYY FineReader Engine files next to FREngine.dll.
  1. Run LicensingService.exe with the “/install” parameter:
LicensingService.exe /install
For Network installation:
  1. Install the Licensing Service on the license server:
  2. Copy the LS Package to the license server.
    Note: We recommend you organizing ABBYY FineReader Engine files in a folder structure, easy to find and use. See the example below:
  • <YourApplicationFolder>/License Server/Licensing Service.
  • <YourApplicationFolder>/License Server/License Manager (License Manager64).
  1. Install the Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912.
  2. Copy the folders from the LS Package to the directory on the license server you expected the Licensing Service to be.
  3. Create a folder for storing the licensing data (%ProgramData%\ABBYY\SDK\12\Licenses folder by default). Everyone must have full control permissions on this folder.
  4. Create a LicensingSettings.xml file for the license server and specify the settings according to the license type (see Working with the LicensingSettings.xml File for details).
  5. Copy the configured LicensingSettings.xml file into the following folders on the license server:
  • Licensing Service.
  • License Manager (License Manager64).
  1. Configure the connection between the license server and workstations:
  2. For Online License: Create or choose on all workstations a folder in which your application searches for the license token file, and place the token file there. You may choose the %ProgramData%\ABBYY\SDK\12\Licenses folder, which is the default behavior, or another folder used for storing the licensing data. Everyone must have full control permissions on these folders.
  3. Create the LicensingSettings.xml file for the workstations and specify the settings according to the license type (see Working with the LicensingSettings.xml File for details).
  4. Copy the configured LicensingSettings.xml file into the folder with ABBYY FineReader Engine files next to FREngine.dll on all workstations.
  5. Run LicensingService.exe with the “/install” parameter: 
LicensingService.exe /install
We recommend implementing the Network installation, which allows separate use of the Licensing Service and the ABBYY FineReader Engine library, thus ensures continuous operation of the ABBYY FineReader Engine components. As an example of how this scenario can be applied in Docker containers, see Running ABBYY FineReader Engine 12 inside a Docker container

​
Uninstalling in manual mode

To uninstall the Licensing Service in manual mode, run LicensingService.exe with the “/uninstall” parameter: 
LicensingService.exe /uninstall
Then remove the directory with the Licensing Service files.

​
See also

Activation Distribution - Windows Working with the LicensingSettings.xml File