Skip to main content
Online protection uses a password-protected file that contains the license parameters. In this case, license activation is not required.
In this scenario, you are installing your application that uses ABBYY FineReader Engine library and to be deployed to a cloud instance, private virtual machine, or a local workstation, via the command line, without any interaction with the user.You will need:
  • an Online License token file (named like SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.ActivationToken).
  • the password to the license token file.
Follow the instructions:
  1. Run the %archive_name%.sh as non-root user.
  2. Specify the following parameters in the command line:
    • The path to the folder where the ABBYY FineReader Engine library will be installed.
    • The path to a folder for storing the licensing data (it can be any folder in the /home directory, while excluding the /tmp directory).
    • The full path and the password to the Online License token file.
The example of command line:
%archive_name%.sh -- --install-dir "<folder path>" --license-path "<file path>" --license-password "<password>"
--licenses-folder "<folder path>"
run "<FRE_installation_directory>/Bin/ServiceWrapper
<FRE_installation_directory>/CommonBin/Licensing/start_licensing_service.sh"
run "LD_LIBRARY_PATH=<FRE_installation_directory>/CommonBin/Licensing <FRE_installation_directory>/CommonBin/Licensing/LicensingService /standalone"
  1. Wait for installation to complete.
After installing ABBYY FineReader Engine, the folder for storing the licensing data can be changed in LicensingSettings.xml. See the example in Working with the LicensingSettings.xml File article.
  1. Start the Licensing Service via the command:
as a daemonor as an applicationAn 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 a folder set for —licenses-folder parameter during installation).Note that:
  • Internet connection is required when the application is running.
  • Connections to *.abbyy.com on port 443 (HTTPS) are allowed. 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.
  • GoDaddy root certificate should be installed. See the detailed information about the certificate on the GoDaddy website.
In this scenario, you are installing your application that uses ABBYY FineReader Engine library on a workstation connected to the license server through a network via the command line, without any interaction with the user.You will need:
  • an Online License token file (named like SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.ActivationToken).
  • the password to the license token file.
  • 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. Install the library on the workstations:
  2. Run the %archive_name%.sh as non-root user.
  3. Specify the following parameters in the command line:
    • The path to the folder where the ABBYY FineReader Engine library will be installed.
    • IP-address of the license server with the Licensing Service installed.
    • The path to a folder for storing the licensing data (it can be any folder in the /home directory, while excluding the /tmp directory).
    • The full path and the password to the Online License token file.
The example of command line:
%archive_name%.sh -- --install-dir "<folder path>" 
--service-address "<address>" --license-path "<file path>" --license-password "<password>" --licenses-folder "<folder path>"
  1. Wait for installation to complete.
After installing ABBYY FineReader Engine, the folder for storing the licensing data can be changed in LicensingSettings.xml. See the example in Working with the LicensingSettings.xml File article.
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 a folder set for —licenses-folder parameter during installation).Note that:
  • Internet connection is required when the application is running.
  • Connections to *.abbyy.com on port 443 (HTTPS) are allowed. 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.
  • Port 3023 must be opened on the license server for its connection to the workstations. The only supported connection protocol is Sockets.
  • GoDaddy root certificate should be installed on the license server with the Licensing Service installed. See the detailed information about the certificate on the GoDaddy website.