Network license

In this scenario, you are about to develop an application that uses ABBYY FineReader Engine library on a workstation connected to the license server through a network. The installation is performed by manually copying the files.

You will need:

  • a USB dongle containing the parameters of your hardware protection key.
  • your Customer Project ID.
  • the DNS name or IP-address of the license server.

Follow the instructions:

  1. Install the Licensing Service on the license server, as described in Installing the Licensing Service.

Use ABBYY FineReader Engine and Licensing Service from the same package. Otherwise, compatibility is not guaranteed.

  1. Create a LicensingSettings.xml file. The XML schema to which it must conform can be found in the LicensingSettings.xsd file, which is located in the Inc folder of your developer installation or the Inc folder in the distribution package.

In this file you need to set up the type of connection protocol your license server will use. The supported type is Sockets:

<LocalLicenseServer>
    <ConnectionProtocol ProtocolType="Sockets"/>
</LocalLicenseServer>
    

By default, the 3023 port is used. If this port is closed on your server, specify the port from the sample below:

<LocalLicenseServer>
    <ConnectionProtocol ProtocolType="Sockets" EndPointName="1025"/>
</LocalLicenseServer>
    

Copy the configured LicensingSettings.xml file into the folder where other Licensing Service files are located.

  1. Install the Wibu CodeMeter key drivers on the license server.
  2. Connect the hardware protection key to the USB port of the license server. License activation is not required, but the dongle must be connected for the whole time you are using the library.
  3. Install the library on workstations:
    1. Unpack the %archive_name%.sh with the --target and --noexec options. The example of command line:
%archive_name%.sh --noexec --target <where to unpack>
    
  1. Copy the following files:
      • Files for the functioning of the modules that your application will support.
      • Files marked as “mandatory” in ABBYY FineReader Engine Distribution Kit section in Developer's Help. They are system modules and main recognition databases.
      • Resource files for interface languages that will be used in your application.
      • Dictionary support files for recognition languages that your application will support. If the recognition languages include languages with the Latin alphabet, make sure that you copy the Univers.amd and Univers.amm files.
      • The License Manager utility (LicenseManager.Console, libProtectionConsoleUI.so).
    1. Create a folder for storing the licensing data on each workstation (default is /var/lib/ABBYY/SDK/12/Licenses). Everyone should have full access permissions on it. To change this folder, see an example described in Working with the LicensingSettings.xml File article.
    1. Create a LicensingSettings.xml file, setting up the same type of connection protocol you specified for the server and the address of the server:
<LicensingServers>
   <MainNetworkLicenseServer ServerAddress="[your server address]" ProtocolType="Sockets"/>
</LicensingServers>
    

If you set another port for the server, repeat the same setting here, specifying the port number from the sample below.

<LicensingServers>
   <MainNetworkLicenseServer ServerAddress="[your server address]" ProtocolType="Sockets" EndPointName="1025"/>
</LicensingServers>
    

Now your application can use ABBYY FineReader Engine library while the key is connected, and you can view the license details in the License Manager Utility.

12.12.2022 20:26:02

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.