This guide explains how to install ABBYY FineReader Engine 12 for Linux, configure and activate a license, manage licenses, and run the SDK code samples.
Before installing FineReader Engine 12 for Linux, complete the following preparations:
- Download the ABBYY FineReader Engine SDK to your computer.
- Have your serial number and corresponding Project ID available.
Installing FineReader Engine 12 for Linux
Follow these steps to install FineReader Engine 12 for Linux.
1. Run the installation archive
Type %archive_name%.sh in the command line to run the self-extracting installation archive.
You can run the archive without parameters to start the interactive installation. The installer prompts you to enter the required information.
- You can also run the archive with installation options. For details about the available options, see the Distribution chapter in the FineReader Engine User Guide.
Root Privileges Required
The installation of the Licensing Service and license activation require root privileges. ABBYY recommends running the FineReader Engine installation as the root user.
To switch to the root user, use one of the following commands:
-
su rootif you have the root password. -
sudo suif you have the password for the current user.
2. Accept the End User License Agreement (EULA)
Read the End User License Agreement displayed by the installer.
Type y to accept the agreement and continue the installation.
3. Specify the installation directory
The installer prompts you to select the installation directory. The default installation directory is: /opt/ABBYY/FREngine12
- Type
yto install FineReader Engine 12 in the default directory - Type
nto specify a different installation directory
This guide uses the default installation directory.
4. Select the installation type
- Type
1to select Developer installation- Select this option when installing FineReader Engine to develop a new application that uses the engine. See Developer installation (in our User Guide docs) for details.
- Type
2to select Runtime installation- Select this option when installing an application that uses FineReader Engine. See Runtime installation (in our User Guide docs) for details.
5. Select the activation type
- Type
1to select Local server.- Select this option for a standalone installation where the Licensing Service runs on the same machine as FineReader Engine 12. This applies to installations using either a Software License Key or an Online License Key.
- Type
2to select Remote server.- Select this option for a network license where the Licensing Service runs on a different machine.
6. Configure the license parameters
Specify whether you are configuring an Online License Key:
- Type
nto select Software License Key - Type
yto select Online License Key, then provide the required license parameters:- Password
- Path to the activation file
7. Select Licensing Service installation option
- Type
1to install the Licensing Service and start it - Type
2to start the Licensing Service without installing it - Type
3to skip the Licensing Service configuration steps
Option 2 is useful when the Licensing Service is already installed on the machine and you only need to start it.
Activating a FineReader Engine 12 license
FineReader Engine 12 supports two license types:
- Software License Key: Requires license activation.
- Online License Key: Does not require license activation.
Follow the instructions for your license type.
Activating a Software License Key
A Software License Key requires activation after installing FineReader Engine 12.
- Type
yto start the license activation wizard. - Type your serial number.
- Select the connection method for the license activation:
-
Internet
- ABBYY recommends selecting this option if the computer has an internet connection. License activation is performed automatically and typically takes a few seconds.
-
E-Mail
- Use this method to receive activation information by email. After receiving the activation file from ABBYY, specify its path in the activation wizard.
-
Load license file
- Select this option when you already have a license file.
-
Internet
- The activation process generates an Installation ID using information about the computer's hardware.
The Installation ID does not contain personal information about the user or the computer. The code cannot be used to identify the user.
Using an Online License Key
An Online License Key does not require license activation.
The Online License Key uses the ABBYY License Service utility to manage FineReader Engine 12 licensing. It supports distributed environments, including cloud computing and virtual environments such as Docker containers. Online licensing can also be used for on-premises installations.
Internet connection requirements
The ABBYY License Service requires a permanent internet connection to communicate with ABBYY services. Short interruptions are tolerated.
Allow connections to the following address and port:
-
Address:
*.abbyy.com -
Port:
443
You can review Online License Key parameters through the LicenseManager.Console utility.