Installing the ABBYY FineReader Engine Library

The first step of distribution of applications using the ABBYY FineReader Engine library is installation of the application and the ABBYY FineReader Engine library on the local disk of the workstation.

After installing your application on a workstation, you should install the ABBYY FineReader Engine library. It may be installed in automatic or manual mode.

Installing in automatic mode

To install FineReader Engine library in automatic mode, run the installation script %archive_name%.sh and select Runtime installation option during installation.

After installation specify the path to the Bin folder of the distribution package in the system variable LD_LIBRARY_PATH.

Alternatively, use ldconfig utility to specify the path to Bin folder. A command line can look like this:

echo "<path to Bin folder>" | sudo tee -a /etc/ld.so.conf; sudo ldconfig
    

You can also perform silent installation from command line. Run the script with the parameters you need. Here is the complete list of the parameters:

Parameter Description
--install-dir <folder path>

Set this option to specify the full path to the folder which will be used for ABBYY FineReader Engine installation. This parameter is required.

Note: If you set only this option, the installation wizard, where the specified folder path is set as the default installation directory, will be run.

--serial-number <number> Set this option to specify the ABBYY FineReader Engine 12 serial number.
--license-path <file path>
--license-password <password>
Set these options to specify the full path and the password to the Online License token file (you are going to use an Online License).
--licenses-folder Set this option to specify a path to a folder with licensing data. Note that you must set this option only when installing ABBYY FineReader Engine as a non-root user.
--service-address <address> Set this option to specify the DNS name or IP address of the computer where the Licensing Service must be installed.
--installHWKeyDriver Set this option if Wibu CodeMeter drivers should be installed (you are going to use a hardware protection key).
--developer-install Set this option if developer installation should be performed.
--project-id <Customer Project ID> Set this option to specify the Customer Project ID to which the license corresponds.
--skip-local-service-installation Set this option to skip the installation of the local Licensing Service.
--skip-local-license-activation Set this option to skip the license activation on the local Licensing Service. You may activate your license using the License Manager utility after ABBYY FineReader Engine installation.
-h
--help
Use these options to display the list of commands with short descriptions.

Here is a command line that will perform runtime installation of the library in silent mode into the folder /home/user/FREngine12 using the serial number XXXX-XXXX-XXXX-XXXX-XXXX-XXXX:

%archive_name%.sh -- --install-dir /home/user/FREngine12 --serial-number XXXX-XXXX-XXXX-XXXX-XXXX-XXXX
    

You can also install FineReader Engine library using the RPM package %rpmpackage_name%.rpm.

This command line will help you to perform the runtime installation of the library in silent mode using an Online License:

%archive_name%.sh -- --install-dir "<folder path>" --license-path "<file path>" --license-password "<password>"
    

The package installation can be performed from command line. The following command will install the library into the default folder /opt/ABBYY/FREngine12:

# rpm -i %rpmpackage_name%.rpm
    

Use the --prefix option if you need to install the library into a different folder:

# rpm -i –-prefix=<path> %rpmpackage_name%.rpm
    

After installing run the activatefre.sh script to activate your license. See more in License Manager Utility.

Deinstalling in automatic mode

To deinstall FineReader Engine library in automatic mode, run Scripts/uninstallfre.sh. If you need to deinstall the library in silent mode, run the uninstallfre.sh script with the --force option.

Important! FineReader Engine may only be deinstalled under ROOT.

If the library was installed with the help of the RPM package, you will need to remove it:

# rpm -e %rpmpackage_name%
    

You can check the package name in the list of all installed RPM packages:

rpm -qa|grep FREngine
    

Installing in manual mode

To install the library, please copy the following files:

  1. Files for the functioning of the modules that your application will support.
  2. Files marked as "mandatory" in ABBYY FineReader Engine Distribution Kit. They are system modules and main recognition databases.
  3. Resource files for interface languages that will be used in your application.
  4. 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.
  5. The License Manager utility (LicenseManager.Console, libProtectionConsoleUI.so).

Note: You can use the FREngineDistribution.csv file to automatically create a list of files required for your application to function.

See also

ABBYY FineReader Engine Distribution Kit

Licensing

03.07.2024 8:50:25

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.