Manual network installation is possible only if you are using Software or Online protection.
Online Protection
Online Protection
In this scenario, you are installing your application which uses ABBYY FineReader Engine library on a server and workstations connected to this server through a network manually. You will need:To implement this scenario, you need to install the Licensing Service on the license server — a computer that will manage and distribute licenses among workstations in a network. After that, install the library on the workstations, set up the connection to the license server, and copy the license token to each workstation.By default, the 3022 TCP/IP port is used. If this port is closed on your server, specify another open port:If you set another TCP/IP port for the server, repeat the same setting here.
- an Online License token file (named like SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.ActivationToken).
Internet connection is required when the application is running.
To simplify creating a custom package, unpack the files using the /extract option for the installRnt**.exe or installLS.exe in the command line from the distribution package to a certain folder without installation. Inside it, there will be the following folders:
- for installRnt**.exe:
- FineReader Engine - with the ABBYY FineReader Engine files
- Inc - with the FREngine.tlb (for registering of the FREngine.dll)
- Licensing - with the Licensing Service files
- for installLS.exe:
- Licensing - with the the Licensing Service files
- License Server - with the License Server files
Creating the ABBYY FineReader Engine packages on your computer:
-
Library package. It is a folder with the ABBYY FineReader Engine files listed in ABBYY FineReader Engine Distribution Kit section in Developer’s Help. The list will include:
- Files marked as “mandatory” in ABBYY FineReader Engine Distribution Kit. They are system modules and main recognition databases.
- Recognition databases for handprinted text, if you want to recognize handprinted text.
- 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 select the Univers.amd and Univers.amm files.
- Scanning modules, scanning-specific resources and Twain modules if your application will perform scanning via the ABBYY FineReader Engine interface.
- Windows Visual Components modules and corresponding specific resources, if your application uses ABBYY FineReader Engine Visual Components.
-
License Server package. It consists of two folders with the Licensing Service and the License Manager utility files:
- Licensing Service folder with all files copied from the unpacked Licensing folder.
- License Manager (License Manager64) folder with the following files copied from the unpacked License Server folder: 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.
-
Other software components:
- 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.
- .NET Framework 4.6.2 if you intend to use the OfficeConverters module.
Installing the Licensing Service on the License Server:
- Copy the License Server package and the Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912 on the license server.
- Install the Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912.
- Copy the folders from the License Server package to the directory on the license server you expected the Licensing Service to be.
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).
- Create a folder for storing the licensing data (%ProgramData%\ABBYY\SDK\12\Licenses folder by default). Every user running your application must have full control permissions on this folder.
- Create a LicensingSettings.xml file. The XML schema to which it must conform can be found in the LicensingSettings.xml file which is located in the Inc folder of your developer installation or the CADF\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 types are LocalInterprocessCommunication, NamedPipes, TCP/IP, and Sockets:
-
Copy the configured LicensingSettings.xml file into the following folders:
- Licensing Service.
- License Manager (License Manager64).
- Run LicensingService.exe with the “/install” parameter:
Activating the license on the License Server:
An Online License does not need activation: license information is received at the application run-time from ABBYY Online licensing services. To authorize, the application sends a license token file and a license password. You will need to place the token file where it is expected by the application. This location must be specified by the developer (default is %ProgramData%\ABBYY\SDK\12\Licenses).At run-time, the application needs to connect to ABBYY Online licensing services periodically to receive license information and send usage statistics. No private information is exchanged with ABBYY servers.- Verify that you allow connections to *.abbyy.com on port 443 (HTTPS). If the connection is lost, the application will stop functioning after a certain reconnection timeout is exceeded. The synchronization period and the reconnection timeout are specific parameters of each Online License.
It is not possible to use two or more Online Licenses simultaneously on the same host. When the application is running and the connection to ABBYY licensing services is working, you can view details of the currently active Online License using the License Manager Utility.
Installing ABBYY FineReader Engine library on the workstations:
If the license server will also function as a workstation, perform this step for the server too.
- Copy the Library package and software components on all your workstations.
The easiest way to make sure all resource files can be located by the program is to maintain the same folder structure and include in your distribution package the SharedFiles.ini file you will find in the Bin (or Bin64) folder depending on your operating system. If you prefer not to use this file, instead of maintaining the folder structure do the following:
- Copy the Data\Resource folder with all subfolders into the following folder:
- Bin
- Bin64
- Copy contents of the Data\ExtendedDictionaries folder directly into Bin or Bin64 folder.
- Copy other files contained in the Data folder into Bin or Bin64 folder.
-
Install the necessary software components:
- The Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912.
- .NET Framework if it is needed.
- Copy the folder with the ABBYY FineReader Engine files from the Library Package to the directory on the workstation you expected the library to be.
-
Register the dynamic libraries you will need:
- If your application loads the Engine object by means of the IEngineLoader interface, register FREngine.dll using the following command line:
- If your application uses Visual Components, register VisualComponentsX.dll using the following command line:
-
Create the folders which will be used by ABBYY FineReader Engine. In the list below, the default values for these folders are denoted:
- folder %ProgramData%\ABBYY\SDK\12\FineReader Engine (full control permission is required)
- folder %ProgramData%\ABBYY\SDK\12\Licenses (full control permission is required for license server, optional for workstations)
To specify the license data folder during installation, see an example in Working with the LicensingSettings.xml File. You may also use the InitializeEngine function or method of the IEngineLoader interface.
- Copy the license token to a default folder on each workstation or to a folder, the path to which is used by your application in the InitializeEngine function.
Creating a LicensingSettings.xml file:
Create a LicensingSettings.xml file, setting up the same type of connection protocol you specified for the server and the address of the server:Copying the configured LicensingSettings.xml file:
Copy the configured LicensingSettings.xml file into the folder with ABBYY FineReader Engine files next to FREngine.dll on every workstation:Note: If the license server will also function as a workstation, the LicensingSettings.xml file for the server must contain both LicensingServers and LocalLicenseServer tags similar to those specified above. The contents of the file will look like this:Software Protection
Software Protection
In this scenario, you are installing your application which uses ABBYY FineReader Engine library on a server and workstations connected to this server through a network manually. You will need:By default, the 3022 TCP/IP port is used. If this port is closed on your server, specify another open port:If you set another TCP/IP port for the server, repeat the same setting here.
- the serial number of a Network Runtime License.
To simplify creating a custom package, unpack the files using the /extract option for the installRnt**.exe or installLS.exe in the command line from the distribution package to a certain folder without installation. Inside it, there will be the following folders:
-
for installRnt**.exe:
- FineReader Engine - with the ABBYY FineReader Engine files
- Inc - with the FREngine.tlb (for registering of the FREngine.dll)
- Licensing - with the Licensing Service files
-
for installLS.exe:
- Licensing - with the the Licensing Service files
- License Server - with the License Server files
Creating the ABBYY FineReader Engine packages on your computer:
-
Library package. It is a folder with the ABBYY FineReader Engine files listed in ABBYY FineReader Engine Distribution Kit section in Developer’s Help. The list will include:
- Files marked as “mandatory” in ABBYY FineReader Engine Distribution Kit. They are system modules and main recognition databases.
- Recognition databases for handprinted text, if you want to recognize handprinted text.
- 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 select the Univers.amd and Univers.amm files.
- Scanning modules, scanning-specific resources and Twain modules if your application will perform scanning via the ABBYY FineReader Engine interface.
- Windows Visual Components modules and corresponding specific resources, if your application uses ABBYY FineReader Engine Visual Components.
-
License Server package. It consists of two folders with the Licensing Service and the License Manager utility files:
- Licensing Service folder with all files copied from the unpacked Licensing folder.
- License Manager (License Manager64) folder with the following files copied from the unpacked License Server folder: 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.
-
Other software components:
- 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.
- .NET Framework 4.6.2 if you intend to use the OfficeConverters module.
Installing the Licensing Service on the License Server:
- Copy the License Server package and the Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912 on the license server.
- Install the Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912.
- Copy the folders from the License Server package to the directory on the license server you expected the Licensing Service to be.
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).
- Create a folder for storing the licensing data (%ProgramData%\ABBYY\SDK\12\Licenses folder by default). Every user running your application must have full control permissions on this folder. See an example of setting of license data folder in Working with the LicensingSettings.xml File.
- Create a LicensingSettings.xml file. The XML schema to which it must conform can be found in the LicensingSettings.xml file which is located in the Inc folder of your developer installation or the CADF\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 types are LocalInterprocessCommunication, NamedPipes, TCP/IP, and Sockets:
-
Copy the configured LicensingSettings.xml file into the following folders:
- Licensing Service.
- License Manager (License Manager64).
- Run LicensingService.exe with the “/install” parameter:
You also have the option of setting up a two-server configuration which will allow one of the license servers to act as a backup to another in case it goes offline. For details, see For details, see Setting up a redundant license server configuration.
Activating the license on the License Server:
Run LicenseManager.exe. Click on the Activate License… button and follow the wizard instructions to activate your license. If your server has access to the Internet you only need to enter the serial number and wait a few moments. For details about the License Manager, see License Manager Utility.You can also activate the license through the command line. For details, see Working with the License Manager from the command line..Installing the ABBYY FineReader Engine library on the workstations:
If the license server will also function as a workstation, perform this step for the server too.
- Copy the Library package and software components on all your workstations.
The easiest way to make sure all resource files can be located by the program is to maintain the same folder structure and include in your distribution package the SharedFiles.ini file you will find in the Bin (or Bin64) folder depending on your operating system. If you prefer not to use this file, instead of maintaining the folder structure do the following:
- Copy the Data\Resource folder with all subfolders into the following folder:
- Bin
- Bin64
- Copy contents of the Data\ExtendedDictionaries folder directly into Bin or Bin64 folder.
- Copy other files contained in the Data folder into Bin or Bin64 folder.
-
Install the necessary software components:
- The Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912.
- .NET Framework if it is needed.
- Copy the folder with the ABBYY FineReader Engine files from the Library Package to the directory on the workstation you expected the library to be.
-
Register the dynamic libraries you will need:
- If your application loads the Engine object by means of the IEngineLoader interface, register FREngine.dll using the following command line:
- If your application uses Visual Components, register VisualComponentsX.dll using the following command line:
-
Create the folders which will be used by ABBYY FineReader Engine. In the list below, the default values for these folders are denoted:
- folder %ProgramData%\ABBYY\SDK\12\FineReader Engine (full control permission is required)
- folder %ProgramData%\ABBYY\SDK\12\Licenses (full control permission is required for license server, optional for workstations)
To specify the license data folder during installation, see an example in Working with the LicensingSettings.xml File. You may also use the InitializeEngine function or method of the IEngineLoader interface.
Creating a LicensingSettings.xml file:
Create a LicensingSettings.xml file, setting up the same type of connection protocol you specified for the server and the address of the server:Copying the configured LicensingSettings.xml file:
Copy the configured LicensingSettings.xml file into the folder with ABBYY FineReader Engine files next to FREngine.dll on every workstation:If the license server will also function as a workstation, the LicensingSettings.xml file for the server must contain both LicensingServers and LocalLicenseServer tags similar to those specified above. The contents of the file will look like this: