Hardware 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:

  • a USB dongle containing the parameters of your hardware protection key.

First, you need to install the library on a license server — a computer that will manage and distribute licenses among workstations in a network. After that, install the library on the workstations.

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.
    • WIBUDR=Yes
      This option installs the Wibu CodeMeter hardware key drivers.

Note: For additional command-line options, see Command line installation options.

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

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

This command line will install the library into C:\MyFolder in silent mode, without a progress bar, and 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.

In this case, you will have to install the Wibu CodeMeter key drivers yourself, as automatic installation is not provided in the Licensing Service installer. See License Server Administrator’s Guide for more details.

Connecting the hardware protection key:

Connect the hardware protection key to the USB port of the server. License activation is not required.

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 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.
    • 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 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.

Note: 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 Setting up a redundant license server configuration.

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.