Passer au contenu principal
Pour que les applications utilisant ABBYY FineReader Engine 12 fonctionnent correctement, le service de licence est nécessaire. Le service de licence est installé automatiquement lors de l’installation Developer et de l’installation du runtime en mode automatique. Si vous utilisez le mode d’installation manuel, suivez les instructions ci-dessous. Une fois l’installation du service de licence terminée, exécutez l’Utilitaire du gestionnaire de licences pour gérer les licences.
Le service de licence fonctionne par défaut avec la suite logicielle systemd et prend également en charge le démon SysVinit. Si vous souhaitez remplacer SysVinit par systemd, désinstallez votre ancien package de distribution à l’aide du script uninstallfre.sh, puis installez le nouveau package de distribution à l’aide du script activatefre.sh (voir Installation de la bibliothèque ABBYY FineReader Engine). Si vous souhaitez désinstaller le package de distribution avec systemd alors que celui avec SysVinit est toujours installé, exécutez les commandes suivantes :
$ systemctl disable abbyy-fre12-licensing-service
$ systemctl stop abbyy-fre12-licensing-service
$ rm -rf /usr/local/{bin,lib}/ABBYY/SDK/12/Licensing
Désinstallez ensuite le package de distribution à l’aide du script uninstallfre.sh. Les paramètres du service de licence sont définis dans le fichier LicensingSettings.xml. Ce fichier est généré automatiquement lors de l’installation automatique. En cas d’installation manuelle, vous devrez créer ce fichier dans les dossiers Bin et CommonBin/Licensing et y indiquer les paramètres appropriés. Le schéma XML des paramètres du service de licence est décrit dans le fichier LicensingSettings.xsd. Vous trouverez ce fichier dans le dossier Inc. La description détaillée des paramètres est fournie dans la section Utilisation du fichier LicensingSettings.xml.
  • Nous vous recommandons d’installer (désinstaller) le service de licence en mode manuel uniquement lors de l’installation du runtime (désinstallation). Pour le développement, utilisez l’installation et la désinstallation standard.
  • Utilisez ABBYY FineReader Engine et le service de licence issus du même package. Dans le cas contraire, la compatibilité n’est pas garantie.

Installation en mode manuel

Le service de licence doit être installé sous ROOT.
Pour une installation autonome :
  1. Copiez les fichiers du service de licence et de l’utilitaire License Manager sur la station de travailLinux : libAbbyyZlib.so, libFineFormats.so, libFineNet.so, libFineObj.so, libPortLayer.so, libProtection.so, libProtectionConsoleUI.so, LicensingSchema.xe, ProductLicensingSchema.xe, LicensingService et LicenseManager.Console. Copiez les fichiers de ressources libProtectionRes*.so pour les langues d’interface dont vous avez besoin, ainsi que libProtectionResShared.so
Windows : AbbyyZlib.dll, Awl.dll, concrt140.dll, FineFormats.dll, FineNet.dll, FineObj.dll, LicenseManager.exe, LicenseManager12.chm, LicensingSchema.xe, msvcp140.dll, ProductLicensingSchema.xe, Protection.dll, ProtectionRes0.dll, ProtectionResShared.dll, ProtectionUI.dll, vccorlib140.dll, vcruntime140.dll..
  1. Créez un dossier pour stocker les données de licence (le dossier %ProgramData%\ABBYY\SDK\12\Licenses par défaut). Tout le monde doit disposer des autorisations d’accès complet à ce dossier.
  2. Pour une licence en ligne : créez ou choisissez un dossier dans lequel votre application recherche le fichier de jeton de licence, puis placez-y ce fichier. Vous pouvez utiliser le dossier %ProgramData%\ABBYY\SDK\12\Licenses, qui correspond au comportement par défaut, ou un autre dossier servant à stocker les données de licence. Tout le monde doit disposer des autorisations d’accès complet à ces dossiers.
  3. Si nécessaire, spécifiez les paramètres de LocalLicenseServer dans le fichier LicensingSettings.xml (voir Utilisation du fichier LicensingSettings.xml).
  4. Exécutez LicensingService :
  5. Créez le dossier /var/run/abbyy-licensing-daemon/ avec des autorisations de lecture et d’écriture réservées à l’utilisateur root.
  6. Exécutez LicensingService avec la ligne de commande suivante :
LicensingService /start
La variable d’environnement LD_LIBRARY_PATH doit être définie sur le chemin d’accès au dossier contenant les bibliothèques copiées. Pour exécuter le service à chaque démarrage du système, enregistrez-le dans votre système d’initialisation, par exemple comme démon. Si vous utilisez le système d’initialisation systemd :
  1. Créez le fichier de configuration du service abbyy-fre12-licensing-service.service et placez-le dans le dossier /etc/systemd/system/. Les autorisations du fichier doivent être définies sur 664 (lecture & écriture pour le propriétaire (qui est root) & le groupe d’utilisateurs, lecture pour les autres). Exemple de fichier :
[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
  1. Mettez à jour la liste des services :
$ systemctl daemon-reload
  1. Activez le service au démarrage du système.
$ systemctl enable abbyy-fre12-licensing-service
  1. Démarrez LicensingService.
$ systemctl start abbyy-fre12-licensing-service
Si vous utilisez le système d’initialisation SysVinit ou Upstart :
  1. Créez le fichier de configuration de service abbyy-fre12-licensing-service.sh et placez-le dans le répertoire /etc/init.d/. Les autorisations du fichier doivent être définies sur 755 (lecture, écriture et exécution pour le propriétaire (qui est root), lecture et exécution pour le groupe et les autres). Exemple de fichier :
#! /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: Démarrer le service de licence ABBYY SDK 12
# Description:       Fournit la gestion du service de licence ABBYY SDK 12
### 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 "Utilisation : $0 {start|stop|restart|force-reload|status}" >&2
    exit 1
    ;;
esac
  1. Configurez le service pour qu’il se charge au démarrage du système.
Pour SysVinit :
$ chkconfig --add abbyy-fre12-licensing-service
Pour Upstart :
update-rc.d abbyy-fre12-licensing-service defaults
  1. Lancez LicensingService.
$ service abbyy-fre12-licensing-service start
SELinux peut perturber le bon fonctionnement du service de licence. Si vous rencontrez des erreurs de licence, essayez la ligne de commande suivante en indiquant le chemin réel vers LicensingService :
chcon -u system_u -t bin_t /path/to/LicensingService
Pour l’installation en réseau :
  1. Installez le service de licence sur le serveur de licences :
    1. Copiez les fichiers du service de licence et de l’utilitaire License Manager sur un ordinateur qui sera utilisé comme serveur de licencesLinux : libAbbyyZlib.so, libFineFormats.so, libFineNet.so, libFineObj.so, libPortLayer.so, libProtection.so, libProtectionConsoleUI.so, LicensingSchema.xe, ProductLicensingSchema.xe, LicensingService et LicenseManager.Console. Copiez les fichiers de ressources libProtectionRes*.so pour les langues d’interface dont vous avez besoin, ainsi que libProtectionResShared.so
Windows : AbbyyZlib.dll, Awl.dll, concrt140.dll, FineFormats.dll, FineNet.dll, FineObj.dll, LicenseManager.exe, LicenseManager12.chm, LicensingSchema.xe, msvcp140.dll, ProductLicensingSchema.xe, Protection.dll, ProtectionRes0.dll, ProtectionResShared.dll, ProtectionUI.dll, vccorlib140.dll, vcruntime140.dll..
  1. Créez un dossier pour stocker les données de licence (le dossier %ProgramData%\ABBYY\SDK\12\Licenses par défaut). Tous les utilisateurs doivent disposer des droits d’accès complets sur ce dossier.
  2. Créez un fichier LicensingSettings.xml pour le serveur de licences.
  3. Spécifiez dans le fichier LicensingSettings.xml les paramètres en fonction du type de licence (voir Utilisation du fichier LicensingSettings.xml pour plus de détails) :
    • Pour une licence en ligne : la balise OnlineLicensing si vous souhaitez utiliser une licence en ligne avec un serveur proxy. Dans les autres cas de configuration d’une licence en ligne, ignorez cette étape.
  4. Copiez le fichier LicensingSettings.xml configuré sur le serveur de licences dans le dossier où le service de licence est installé.
  5. Configurez la connexion entre le serveur de licences et les postes de travail :
    1. Pour une licence en ligne : sur tous les postes de travail, créez ou choisissez un dossier dans lequel votre application recherche le fichier de jeton de licence, puis placez-y le fichier de jeton. Vous pouvez choisir le dossier %ProgramData%\ABBYY\SDK\12\Licenses, qui est utilisé par défaut, ou un autre dossier servant à stocker les données de licence. Tous les utilisateurs doivent disposer des droits d’accès complets sur ces dossiers.
    2. Créez le fichier LicensingSettings.xml pour les postes de travail.
    3. Spécifiez dans le fichier LicensingSettings.xml les paramètres en fonction du type de licence (voir Utilisation du fichier LicensingSettings.xml pour plus de détails) :
      • Les attributs ServerAddress et ProtocolType de la balise MainNetworkLicenseServer.
    4. Copiez le fichier LicensingSettings.xml configuré sur tous les postes de travail dans le dossier /opt/ABBYY/FREngine12/Bin/ où License Manager est installé.
    5. Exécutez LicensingService comme décrit à l’étape 5 de l’installation autonome.
Si vous souhaitez exécuter le service de licence en tant qu’utilisateur non-root, lancez-le manuellement à chaque démarrage du système d’exploitation :
  1. Créez le fichier start_licensing_service.sh et placez-le dans le dossier <FRE_installation_directory>/CommonBin/Licensing. Exemple de fichier :
#!/bin/bash
export LD_LIBRARY_PATH=<FRE_installation_directory>/CommonBin/Licensing
pgrep LicensingServic || exec <FRE_installation_directory>/CommonBin/Licensing/LicensingService /standalone
  1. Démarrez le service de licence à l’aide de la commande :
en mode démon
run "<FRE_installation_directory>/Bin/ServiceWrapper <FRE_installation_directory>/CommonBin/Licensing/start_licensing_service.sh"
en tant qu’application
run "LD_LIBRARY_PATH=<FRE_installation_directory>/CommonBin/Licensing <FRE_installation_directory>/CommonBin/Licensing/LicensingService /standalone"

Voir aussi

Activation Distribution - Linux Utilisation du fichier LicensingSettings.xml