Installing the Licensing Service on Linux

$ systemctl disable abbyy-fre12-licensing-service
$ systemctl stop abbyy-fre12-licensing-service
$ rm -rf /usr/local/{bin,lib}/ABBYY/SDK/12/Licensing

• We recommend that you install (uninstall) the Licensing Service in manual mode only during Runtime installation (deinstallation). For development purposes use the standard installation and deinstallation.
• Use ABBYY FineReader Engine and Licensing Service from the same package. Otherwise, compatibility is not guaranteed.

​

Installing in manual mode

1. Copy the files for the Licensing Service and the License Manager utility to the workstationLinux: libAbbyyZlib.so, libFineFormats.so, libFineNet.so, libFineObj.so, libPortLayer.so, libProtection.so, libProtectionConsoleUI.so, LicensingSchema.xe, ProductLicensingSchema.xe, LicensingService, and LicenseManager.Console. Copy the resource files libProtectionRes*.so for the interface languages you need, and libProtectionResShared.so

1. Create a folder for storing the licensing data (%ProgramData%\ABBYY\SDK\12\Licenses folder by default). Everyone must have full access permissions on this folder.
2. For Online License: Create or choose a folder in which your application searches for the license token file, and place the token file there. You may choose the %ProgramData%\ABBYY\SDK\12\Licenses folder, which is the default behavior, or another folder used for storing the licensing data. Everyone must have full access permissions on these folders.
3. If necessary, specify parameters of the LocalLicenseServer in the LicensingSettings.xml file (see Working with the LicensingSettings.xml File).
4. Run LicensingService:
5. Create /var/run/abbyy-licensing-daemon/ folder with the read and write permissions for root user only.
6. Run LicensingService with the following command line:

LicensingService /start

1. Create abbyy-fre12-licensing-service.service configuration service file and place it to /etc/systemd/system/ folder. File permissions should be 664 (read & write for owner (which is root) & user group, read for others). The file example:

[Unit]
Description=abbyy-fre12-licensing-service: Provides managements of ABBYY SDK 12 Licensing Service
After=network.target
 
[Service]
Type=forking
Environment="LD_LIBRARY_PATH=/usr/local/lib/ABBYY/SDK/12/Licensing"
ExecStartPre=/bin/mkdir -p /var/run/abbyy-licensing-daemon
ExecStart=/usr/local/bin/ABBYY/SDK/12/LicensingService /start
ExecStop=/usr/local/bin/ABBYY/SDK/12/LicensingService /stop
ExecReload=/usr/local/bin/ABBYY/SDK/12/LicensingService /stop
ExecReload=/usr/local/bin/ABBYY/SDK/12/LicensingService /start
 
[Install]
WantedBy=multi-user.target

2. Update the services list:

$ systemctl daemon-reload

3. Enable loading service on system startup.

$ systemctl enable abbyy-fre12-licensing-service

4. Run LicensingService.

$ systemctl start abbyy-fre12-licensing-service

1. Create abbyy-fre12-licensing-service.sh configuration service file and place it to /etc/init.d/ folder. File permissions should be 755 (read, write, execute for owner (which is root), read & execute for user group and others). The file example:

#! /bin/sh
### BEGIN INIT INFO
# Provides:          abbyy-fre12-licensing-service
# Required-Start:    $all
# Required-Stop:
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Start ABBYY SDK 12 Licensing Service
# Description:       Provides managements of ABBYY SDK 12 Licensing Service
### END INIT INFO
 
export LD_LIBRARY_PATH=/usr/local/lib/ABBYY/SDK/12/Licensing:$LD_LIBRARY_PATH
 
set -e
 
case $1 in
  start)
    mkdir -p /var/run/abbyy-licensing-daemon
    /usr/local/bin/ABBYY/SDK/12/LicensingService /start
    ;;
  stop)
    /usr/local/bin/ABBYY/SDK/12/LicensingService /stop
    ;;
  restart|force-reload)
    $0 stop
    $0 start
    ;;
  status)
    /usr/local/bin/ABBYY/SDK/12/LicensingService --status=$0
    ;;
  *)
    echo "Usage: $0 {start|stop|restart|force-reload|status}" >&2
    exit 1
    ;;
esac

1. Enable loading service on system startup.

$ chkconfig --add abbyy-fre12-licensing-service

update-rc.d abbyy-fre12-licensing-service defaults

1. Run LicensingService.

$ service abbyy-fre12-licensing-service start

chcon -u system_u -t bin_t /path/to/LicensingService

1. Install the Licensing Service on the license server:
   1. Copy the files for the Licensing Service and the License Manager utility to a computer, which will be used as a license serverLinux: libAbbyyZlib.so, libFineFormats.so, libFineNet.so, libFineObj.so, libPortLayer.so, libProtection.so, libProtectionConsoleUI.so, LicensingSchema.xe, ProductLicensingSchema.xe, LicensingService, and LicenseManager.Console. Copy the resource files libProtectionRes*.so for the interface languages you need, and libProtectionResShared.so

1. Create a folder for storing the licensing data (%ProgramData%\ABBYY\SDK\12\Licenses folder by default). Everyone must have full access permissions on this folder.
2. Create a LicensingSettings.xml file for the license server.
3. Specify in the LicensingSettings.xml file the settings according to the license type (see Working with the LicensingSettings.xml File for details):
   • For Online License: OnlineLicensing tag if you want to use an Online License with a proxy server. In other cases of setting an Online License skip this step.
4. Copy the configured LicensingSettings.xml file to the license server into the folder where the Licensing Service is installed.
5. Configure the connection between the license server and workstations:
   1. For Online License: Create or choose on all workstations a folder in which your application searches for the license token file, and place the token file there. You may choose the %ProgramData%\ABBYY\SDK\12\Licenses folder, which is the default behavior, or another folder used for storing the licensing data. Everyone must have full access permissions on these folders.
   2. Create the LicensingSettings.xml file for the workstations.
   3. Specify in the LicensingSettings.xml file the settings according to the license type (see Working with the LicensingSettings.xml File for details):
      • The ServerAddress and ProtocolType attributes of the MainNetworkLicenseServer tag.
   4. Copy the configured LicensingSettings.xml file to all workstations into the /opt/ABBYY/FREngine12/Bin/ folder where the License Manager is installed.
   5. Run LicensingService as described in step 5 of Standalone installation.

1. Create start_licensing_service.sh file and place it to the <FRE_installation_directory>/CommonBin/Licensing folder. The file example:

#!/bin/bash
export LD_LIBRARY_PATH=<FRE_installation_directory>/CommonBin/Licensing
pgrep LicensingServic || exec <FRE_installation_directory>/CommonBin/Licensing/LicensingService /standalone

2. Start the Licensing Service via the command:

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"

​

See also