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, via the command line, without any interaction with the user. You will need:

  • an Online License token file (named like SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.ActivationToken).

Note that Internet connection is required when the application is running.

First, you need to install the library 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.

Installing the library and the Licensing Service on the license server:

Run the installRnt32.exe (for both 32-bit and 64-bit versions of Windows) or installRnt64.exe (for 64-bit version of Windows) file from the distribution package with the following options:

    • /quiet (or /passive if you want a progress bar to be displayed)
    • INSTALLDIR="<destination path>"
      The path to the folder where the ABBYY FineReader Engine library will be installed.

The command line for your server installation can look like this:

installRnt64.exe /quiet INSTALLDIR="C:\MyFolder"
    

This command line will install the library into C:\MyFolder in silent mode, without a progress bar, taking the current computer for the license server.

Important! If you don't use "RegisterCOM=No" in your command line, please check the correctness of the path to FREngine.dll in the registry on the license server before launching your application. Consider the same check for the OfficeConverters and Visual Components modules in case of their installation. If there are errors in the paths, repeat the procedure of registration.

Note: If your license server will not function as one of the workstations, you only need to install the Licensing Service on it. Run the installLS.exe file from the License Server folder in the distribution package and follow the wizard instructions:

    1. On the first screen select the path to the folder where the Licensing Service will be installed and the connection protocol it will use. Click Next.
    2. On the second screen review your settings and click Install.

See License Server Administrator’s Guide for more details.

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.

Check that the GoDaddy root certificate is installed in the local machine version of the Trusted Root Certification Authorities certificate store. This certificate should be on the license server with the Licensing Service installed. See the detailed information about the certificate on the GoDaddy website.

Note that 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 the library on the workstations:

Run the installRnt32.exe (for both 32-bit and 64-bit versions of Windows) or installRnt64.exe (for 64-bit version of Windows) file from distribution package with the following options:

    • /quiet (or /passive if you want a progress bar to be displayed)
    • INSTALLDIR="<destination path>"
      The path to the folder where the ABBYY FineReader Engine library will be installed.
    • LICENSESRV=No
      Indicates that the Licensing Service need not be installed.
    • SERVERNAME="<the DNS name or IP address>"
      The DNS name or IP address of the license server you set up in the previous step.
      Note: When specifying SERVERNAME, LICENSESRV is automatically set to No.
    • LICENSEDATADIR="<destination path>" (optional)
      The path to a new folder where the auxiliary information about licensing will be stored. By default, it is the %ProgramData%\ABBYY\SDK\12\Licenses or, if the installRnt**.exe runs with the LICENSEDATADIR option, LICENSEDATADIR\ABBYY_SDK_12_Licenses folder.

The command line for your workstation installation can look like this:

installRnt64.exe /quiet INSTALLDIR="C:\MyFolder" LICENSESRV="No" SERVERNAME="XXX.XXX.XXX.XX"

This command line will install the library into C:\MyFolder in silent mode, without a progress bar, and configure the workstation to receive licenses from the license server with the IP-address XXX.XXX.XXX.XX

Important! If you don't use "RegisterCOM=No" in your command line, please check the correctness of the path to FREngine.dll in the registry on all workstations before launching your application. Consider the same check for the OfficeConverters and Visual Components modules in case of their installation. If there are errors in the paths, repeat the procedure of registration.

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.

The license use will still be managed by the license server, and only the server needs an Internet connection. Your workstations require only the connection to the license server.

24.03.2023 8:51:51

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.