ABBYY FineReader Engine 12 - Guide de l'administrateur du système

Descriptions étape par étape des scénarios d'installation de base

ABBYY

Pour réagir au contenu de ce tutoriel, un espace de dialogue vous est proposé sur le forum. Commentez

- Titre : ABBYY FineReader Engine 12 - Guide de l'administrateur du système

- Auteur : ABBYY

- Parution : 23 mars 2020

- Licence : Copyright ® 2020 ABBY. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Introduction

- II. Scénarios d'installation de base

- II-A. Installation par le développeur

- II-B. Installation d'un moteur d'exécution dans le Cloud

- II-C. Installation automatique de la durée d'exécution du cloud

- II-D. Installation manuelle du runtime dans les nuages

- II-E. Installation automatique d'un runtime autonome

- III. Clé de protection des logiciels

- IV. Clé de protection matérielle

- V. Installation manuelle d'un runtime autonome

- VI. Clé de protection des logiciels

- VII. Installation automatique de la durée d'exécution du réseau

- VIII. Clé de protection des logiciels

- IX. Clé de protection matérielle

- X. Installation manuelle de l'exécution du réseau

- XI. Clé de protection des logiciels

- XII. Désinstallation de la bibliothèque

- XII-A. Désinstallation de l'installation du développeur

- XII-B. Désinstallation de l'installation automatique du runtime

- XII-C. Désinstallation de l'installation manuelle du runtime

I - Introduction

Ce document est conçu pour vous aider à installer la bibliothèque ABBYY FineReader Engine 12 dans diverses situations et pour différents objectifs.

La première partie fournit des descriptions étape par étape des scénarios d'installation de base. La deuxième partie contient des références plus détaillées pour la gestion des licences.

Choix du type d'installation

Pourquoi installez-vous la bibliothèque ?

Si vous souhaitez développer une nouvelle application qui utilise la bibliothèque, consultez la section Installation pour les développeurs.

Si vous avez développé une application qui utilise la bibliothèque et que vous l'installez sur l'ordinateur de l'utilisateur final, décidez si vous avez besoin d'une installation autonome, en réseau ou en cloud :

- l'installation autonome est prévue lorsque votre application est exécutée sur un seul ordinateur local ; les informations relatives à la licence seront conservées sur le même ordinateur ;

- l'installation en réseau vous permet de stocker les licences sur un serveur distant et de les distribuer entre les postes de travail selon les besoins ;

- l'installation en cloud est destinée aux applications déployées sur le cloud, mais peut également être utilisée lors de l'installation sur un ou plusieurs postes de travail. Elle ne se lie pas avec un serveur de licence spécifique (peut être partagée entre plusieurs machines), mais nécessite une connexion Internet active afin de recevoir les informations de licence d'ABBYY au moment de l'exécution de l'application.

Le type de licence d'exécution requis dépend de ce choix : une licence d'exécution autonome pour une installation autonome, une licence d'exécution en réseau pour une installation en réseau et une licence « Cloud » pour l'installation du cloud.

Vous devez également déterminer si vous allez utiliser le programme d'installation en ligne de commande intégré d'ABBYY (installation automatique ) ou copier les fichiers manuellement/écrire votre propre script pour le faire (installation manuelle). Le mode d'installation manuel peut être utile si votre application nécessite un sous-ensemble de fonctionnalités spécifiques et que vous souhaitez économiser de l'espace disque en omettant tous les fichiers de ressources inutiles.

- Si vous allez déployer votre application sur le cloud ou si vous utilisez une licence Cloud, consultez la section sur l'installation du runtime Cloud.

- Si votre application doit fonctionner sur un seul ordinateur local et que vous préférez utiliser le programme d'installation intégré, consultez la section Installation automatique du runtime autonome.

- Si votre application doit fonctionner sur un seul ordinateur local et que vous ne devez copier que les fichiers de ressources nécessaires, consultez la section Installation manuelle du runtime autonome.

- Si vous devez installer l'application sur plusieurs ordinateurs à l'aide du programme d'installation intégré et utiliser un serveur distant pour gérer les licences, voir Installation automatique du moteur d'exécution en réseau.

- Si l'application doit fonctionner sur plusieurs ordinateurs, le serveur distant gérant les licences, et que vous ne devez copier que les fichiers de ressources nécessaires, consultez la section Installation manuelle du moteur d'exécution en réseau.

Deux types de protection sont disponibles pour les licences autonomes et les licences d'exécution en réseau : soit une clé de protection logicielle – un numéro de série nécessitant une activation, soit une clé de protection matérielle – un dongle USB contenant les informations de la licence. Il existe des différences mineures dans les instructions d'installation, et chaque scénario est décrit pour les deux types de protection. Les licences Cloud utilisent un type de protection spécifique qui est basé sur le logiciel, mais ne nécessite pas l'activation d'une licence. L'installation automatique et manuelle est également possible en cas d'utilisation d'une Licence Cloud ; ces scénarios sont généralement similaires aux scénarios d'installation autonome et sont tous deux décrits en détail dans la section sur l'installation du runtime Cloud.

II - Scénarios d'installation de base

Dans tous les scénarios décrits ci-dessous, à l'exception de l'installation par le développeur, vous devez d'abord installer votre application sur le poste de travail, puis installer la bibliothèque ABBYY FineReader Engine, et enfin, configurer la licence d'exécution qui vous permet d'utiliser la bibliothèque.

II-A - Installation par le développeur

Dans ce scénario, vous êtes sur le point de développer une nouvelle application qui utilise la bibliothèque ABBYY FineReader Engine, et vous installez la bibliothèque sur l'ordinateur de votre développeur.

Vous en aurez besoin :

- de votre numéro de projet client ;

- si vous utilisez une licence autonome : du numéro de série de votre licence de développeur ;

- si vous utilisez une licence de réseau : des détails de votre connexion au serveur de licence de réseau ;

- si vous utilisez une licence Cloud : il est recommandé d'installer le fichier du jeton de licence avec la bibliothèque, bien que cela ne soit pas obligatoire.

Exécutez setup.exe à partir du DVD-ROM d'installation et suivez les instructions de l'assistant d'installation.

1. Lisez le contrat de licence du développeur et confirmez que vous êtes en possession d'une licence de développeur.

2. Sélectionnez les fonctionnalités que vous devez installer. Consultez la description de chaque fonctionnalité dans le panneau de droite en cliquant sur le nom de la fonctionnalité.

3. Saisissez votre ID de projet client et sélectionnez le dossier dans lequel la bibliothèque doit être installée.

4. Sur l'écran suivant :

1. si vous utilisez une licence autonome ou une licence « cloud » : passez cette étape ;

2. si vous utilisez une licence réseau : sélectionnez « Oui, je veux me connecter au serveur de licence réseau » et entrez le nom ou l'adresse du serveur de licence et le type de protocole de connexion. Voir Licence Guide de l'administrateur du serveur pour plus de détails sur la configuration du serveur de licence.

Ne sélectionnez pas « Oui, je veux me connecter au serveur de licence réseau » si vous utilisez une licence « Cloud ». Les licences Cloud utilisent un type de protection spécifique qui n'est pas compatible avec le modèle de licence de réseau.

1. Attendre la fin de l'installation.

1. Si vous utilisez une licence autonome, sur l'écran final, choisissez Lancer le gestionnaire de licences pour activer votre licence. Cliquez sur le bouton Activer la licence… et suivez les instructions de l'assistant. Si votre ordinateur a accès à Internet, cela ne prend que quelques instants. Pour les autres options d'activation (par exemple si votre ordinateur n'est pas connecté à Internet), voir Activation de la licence.

2. Si vous utilisez une licence réseau, l'installation est maintenant terminée. Les informations relatives à la licence seront reçues du serveur de licence réseau que vous avez spécifié précédemment.

3. Si vous utilisez une licence Cloud, placez le fichier du jeton dans un dossier de votre choix. Il est recommandé d'utiliser le dossier %ProgramData%\ABBYY\SDK\12\Licenses : c'est le chemin de recherche par défaut des jetons de licence Cloud.

II-B - Installation d'un moteur d'exécution dans le Cloud

Cette section fournit des guides sur l'installation de votre application dans un environnement en nuage, l'utilisation du programme d'installation en ligne de commande ou la copie manuelle des fichiers requis.

II-C - Installation automatique de la durée d'exécution du cloud

Dans ce scénario, vous utilisez l'installateur en ligne de commande pour déployer votre application sur une instance en nuage, une machine virtuelle privée ou un poste de travail local. Vous aurez besoin :

- d’un fichier de jeton de licence pour le cloud (nommé comme SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.Cloud.ActivationToken).

Notez qu'une connexion Internet est nécessaire lorsque l'application est en cours d'exécution.

Suivez les instructions :

1. Installez la bibliothèque sur l'hôte.

Exécutez setup.exe à partir du paquet d'installation avec les options suivantes :

- /q (ou /qb si vous voulez qu'une barre de progression s'affiche)

- · /v

Indique le début de la liste des paramètres d'installation.

- INSTALLDIR="<destination path>"

Le chemin d'accès au dossier dans lequel la bibliothèque ABBYY FineReader Engine sera installée.

Pour d'autres options de ligne de commande, voir Options d'installation de la ligne de commande.

La ligne de commande de votre installation peut ressembler à ceci :

setup.exe /q /v INSTALLDIR="C:\MyFolder"

Cette ligne de commande installera la bibliothèque dans C:\MyFolder en mode silencieux, sans barre de progression.

1. Une licence Cloud n'a pas besoin d'être activée : les informations relatives à la licence sont reçues au moment de l'exécution de l'application par les services de licence Cloud d'ABBYY. Pour autoriser, l'application envoie un fichier de jeton de licence et un mot de passe de licence. Vous devrez placer le fichier du jeton à l'endroit prévu par l'application. Cet emplacement doit être spécifié par le développeur (la valeur par défaut est %ProgramData%\ABBYY\SDK\12\Licenses).

2. Au moment de l'exécution, l'application doit se connecter périodiquement aux services de licence en nuage d'ABBYY pour recevoir des informations sur les licences et envoyer des statistiques d'utilisation. Aucune information privée n'est échangée avec les serveurs ABBYY.

- Vérifiez que vous autorisez les connexions à *.abbyy.com sur les ports 80 et 443. Si la connexion est perdue, l'application cessera de fonctionner après le dépassement d'un certain délai de reconnexion. La période de synchronisation et le délai de reconnexion sont des paramètres spécifiques de chaque licence Cloud.

Notez qu'il n'est pas possible d'utiliser deux ou plusieurs licences Cloud simultanément sur le même hôte. Lorsque l'application est en cours d'exécution et que la connexion aux services de licence ABBYY fonctionne, vous pouvez consulter les détails de la licence Cloud actuellement active à l'aide de l'utilitaire de gestion des licences.

II-D - Installation manuelle du runtime dans les nuages

Dans ce scénario, vous déployez votre application sur une instance en cloud, une machine virtuelle privée ou un poste de travail local, en utilisant un installateur de votre choix, un script shell ou en copiant manuellement les fichiers. Vous aurez besoin :

- d’un fichier de jeton de licence Cloud (nommé comme SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.Cloud.ActivationToken).

Notez qu'une connexion Internet est nécessaire lorsque l'application est en cours d'exécution.

Suivez les instructions :

1. Constituez la liste des dossiers nécessaires au fonctionnement de votre demande. Consultez la section Kit de distribution du moteur ABBYY FineReader dans l'aide aux développeurs. La liste comprendra :

- fichiers marqués comme « obligatoires » dans le kit de distribution du moteur ABBYY FineReader. Il s'agit de modules du système et les principales bases de données de reconnaissance,

- bases de données de reconnaissance pour le texte imprimé à la main, si vous souhaitez reconnaître du texte imprimé à la main,

- fichiers de ressources pour les langues d'interface qui seront utilisées dans votre application,

- fichiers d'assistance dictionnaire pour les langues de reconnaissance qui seront prises en charge par votre application. Si les langues de reconnaissance comprennent des langues avec l'alphabet latin, assurez-vous de sélectionner les fichiers Univers.amd et Univers.amm,

- les modules de numérisation, les ressources spécifiques à la numérisation et les modules Twain si votre application doit effectuer une numérisation via l'interface du moteur ABBYY FineReader,

- les modules Visual Components et les ressources spécifiques correspondantes, si votre application utilise ABBYY Composants visuels du moteur FineReader.

Vous pouvez également créer la liste des fichiers automatiquement, à l'aide du fichier FREngineDistribution.csv. Voir l'aide aux développeurs pour les instructions ;

1. Copiez les fichiers que vous avez sélectionnés sur le poste de travail.

Important ! La façon la plus simple de s'assurer que tous les fichiers de ressources peuvent être localisés par le programme est de conserver la même structure de dossiers et d'inclure dans votre distribution le fichier SharedFiles.ini que vous trouverez dans le dossier Bin (ou Bin64). Si vous préférez ne pas utiliser ce fichier, au lieu de maintenir la structure des dossiers, procédez comme suit :

- copiez le dossier Data\Resource avec tous les sous-dossiers dans le dossier Bin (Bin64) ;

- copiez le contenu du dossier Data\ExtendedDictionaries directement dans le dossier Bin (Bin64) ;

- copiez les autres fichiers contenus dans le dossier Data dans le dossier Bin (Bin64).

1. Enregistrez les bibliothèques dynamiques dont vous aurez besoin :

- si votre application charge l'objet Engine au moyen de l'interface IEngineLoader, enregistrez FREngine.dll en utilisant la ligne de commande suivante :

regsvr32 /s /n /i:"<path to the Inc folder>" "<path to FREngine.dll>"

- si votre application utilise Visual Components, enregistrez VisualComponentsX.dll en utilisant la ligne de commande suivante :

regsvr32 /s "<path to VisualComponentsX.dll>"

Créez les dossiers qui seront utilisés par ABBYY FineReader Engine,

- dossier %ProgramData%\ABBYY\SDK\12\FineReader Engine ;

- dossier %ProgramData%\ABBYY\SDK\12\Licences ;

Chaque utilisateur qui exécute votre application doit avoir un contrôle total de l'accès à ces dossiers.

Vous pouvez choisir d'utiliser un autre dossier pour le dossier de données du moteur FineReader au lieu de …

\ABBYY\SDK\12\FineReader Engine. Dans ce cas, vous devrez créer ce dossier lors de l'installation, en vous assurant des mêmes droits d'accès. Passez le chemin d'accès à ce dossier comme paramètre FREngineDataFolder de la fonction InitializeEngine ou de la méthode de l'interface IEngineLoader.

1. Installez le serveur de licence. Utilisez le moteur ABBYY FineReader et le serveur de licence à partir du même package.

Sinon, la compatibilité n'est pas garantie.

Des droits d'accès d'administrateur sont nécessaires pour l'installation.

Le serveur de licence nécessite la mise à jour KB2999226 ou le Microsoft Visual C + + 2015 Redistributable 14.0.24212. Si vous n'installez pas le paquet Windows Update, vous pouvez installer le redistribuable à partir du dossier License Server\VC_Redist sur le DVD-ROM d'installation.

o Pour Windows 32 bits, installez vc_redist.x86.exe.

o Pour Windows 64 bits, installez à la fois vc_redist.x86.exe et vc_redist.x64.exe.

Après avoir installé cette mise à jour, vous pouvez procéder à l'installation du serveur de licence.

1. Copiez les fichiers pour le service de licence et l'utilitaire de gestion des licences dans un dossier séparé sur le poste de travail. Ces fichiers se trouvent dans le dossier License Server\ sur le DVD-ROM d'installation : copiez tous les fichiers du dossier License Server\Common\ABBYY\SDK\12\Licensing et les fichiers suivants du dossier License Server\ABBYY SDK\12\License Server : Awl.dll, LicenseManager.exe,

LicenseManager12.chm, Protection.dll, et ProtectionUI.dll.

Voir la section Kit de distribution du moteur ABBYY FineReader dans l'aide aux développeurs pour plus de détails.

1. Exécutez LicensingService.exe avec le paramètre « /install » :

LicensingService.exe /install

1. Dans le dossier où se trouvent les autres fichiers du service de licence, créez un fichier LicensingSettings.xml avec le contenu suivant :

1. <?xml version="1.0" encoding="utf-8"?>

2. <LicensingSettings

3. xmlns="http://www.abbyy.com/Protection/LicensingSettings">

4. <LocalLicenseServer>

5. <EnableCloud Enable="yes" />

6. </LocalLicenseServer>

7. </LicensingSettings>

1. Une licence Cloud n'a pas besoin d'être activée : les informations relatives à la licence sont reçues au moment de l'exécution de l'application par les services de licence Cloud d'ABBYY. Pour autoriser, l'application envoie un fichier de jeton de licence et un mot de passe de licence. Vous devrez placer le fichier du jeton à l'endroit prévu par l'application. Cet emplacement doit être spécifié par le développeur (la valeur par défaut est %ProgramData%\ABBYY\SDK\12\Licenses).

2. Au moment de l'exécution, l'application doit se connecter périodiquement aux services de licence en cloud d'ABBYY pour recevoir des informations sur les licences et envoyer des statistiques d'utilisation. Aucune information privée n'est échangée avec les serveurs ABBYY.

- Vérifiez que vous autorisez les connexions à *.abbyy.com sur les ports 80 et 443.

Si la connexion est perdue, l'application cessera de fonctionner après le dépassement d'un certain délai de reconnexion. La période de synchronisation et le délai de reconnexion sont des paramètres spécifiques de chaque licence Cloud.

Notez qu'il n'est pas possible d'utiliser deux ou plusieurs licences Cloud simultanément sur le même hôte. Lorsque l'application est en cours d'exécution et que la connexion aux services de licence ABBYY fonctionne, vous pouvez consulter les détails de la licence Cloud actuellement active à l'aide de l'utilitaire de gestion des licences.

II-E - Installation automatique d'un runtime autonome

Cette section fournit des guides sur l'installation de votre application sur un poste de travail local en mode non interactif à l'aide de la ligne de commande.

III - Clé de protection des logiciels

Dans ce scénario, vous installez votre application qui utilise la bibliothèque ABBYY FineReader Engine sur un poste de travail local via la ligne de commande, sans aucune interaction avec l'utilisateur. Vous aurez besoin :

- du numéro de série d'une licence d'exécution autonome.

Suivez les instructions :

1. Installez la bibliothèque sur le poste de travail.

Exécutez setup.exe depuis le DVD-ROM d'installation avec les options suivantes :

- /q (ou /qb si vous souhaitez qu'une barre de progression s'affiche)

- · /v

Indique le début de la liste des paramètres d'installation.

- INSTALLDIR="<chemin de destination>"

Le chemin d'accès au dossier dans lequel la bibliothèque ABBYY FineReader Engine sera installée.

Pour d'autres options de ligne de commande, voir Options d'installation de la ligne de commande.

La ligne de commande pour votre installation peut ressembler à ceci :

setup.exe /q /v INSTALLDIR="C:\MonDossier"

Cette ligne de commande installera la bibliothèque dans C:\MyFolder en mode silencieux, sans barre de progression.

1. Activez la licence.

Après avoir installé la bibliothèque, vous trouverez l'utilitaire de gestion des licences (LicenseManager.exe) dans le dossier Bin (pour les systèmes d'exploitation 32 bits) ou Bin64 (pour les systèmes d'exploitation 64 bits) de votre installation.

Si votre poste de travail a accès à Internet, exécutez LicenseManager.exe avec les options suivantes pour activer votre licence :

- /SilentActivation

- /SN:<numéro de série>

Le numéro de série de votre licence d'exécution autonome.

Indiquez le numéro de série dans l'un des formats suivants : XXXX-XXXX-XXXX-XXXX-XXXX-XXXX ou XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.

La ligne de commande pour l'activation de votre licence peut ressembler à ceci :

LicenseManager.exe /SilentActivation /SN:XXXX-XXXX-XXXX-XXXX-XXXX-XXXX

Pour les autres options d'activation (par exemple si votre poste de travail n'a pas accès à Internet), voir Activation de la licence.

L'activation manuelle de la licence via l'interface graphique est également possible. Voir Utilitaire de gestion des licences.

IV - Clé de protection matérielle

Dans ce scénario, vous installez votre application qui utilise la bibliothèque ABBYY FineReader Engine sur un site local via la ligne de commande, sans aucune interaction avec l'utilisateur. Vous aurez besoin :

- d’une clé USB contenant les paramètres de votre clé de protection matérielle.

Suivez les instructions :

1. Installez la bibliothèque sur le poste de travail.

Exécutez le fichier setup.exe à partir du DVD-ROM d'installation avec les options suivantes :

- /q (ou /qb si vous souhaitez qu'une barre de progression s'affiche)

- · /v

Indique le début de la liste des paramètres d'installation.

- INSTALLDIR="<destination path>"

Le chemin d'accès au dossier dans lequel la bibliothèque ABBYY FineReader Engine sera installée.

- WIBUDR=Yes

Cette option permet d'installer les pilotes de clés matérielles Wibu CodeMeter.

Pour des options de ligne de commande supplémentaires, voir Options d'installation en ligne de commande.

La ligne de commande de votre installation peut ressembler à ceci :

setup.exe /qb /v INSTALLDIR="C:\MyFolder" WIBUDR="YES"

Cette ligne de commande installera la bibliothèque dans C:\MyFolder en mode silencieux. Une barre de progression sera affichée.

1. Connectez la clé de protection matérielle au port USB du poste de travail. L'activation de la licence n'est pas nécessaire. Votre application peut maintenant utiliser la bibliothèque ABBYY FineReader Engine lorsque la clé est connectée, et vous pouvez consulter les détails de la licence dans le gestionnaire de licences.

V - Installation manuelle d'un runtime autonome

Cette section fournit des guides sur l'installation manuelle de votre application sur un poste de travail local.

Notez que l'installation autonome manuelle n'est possible que si vous utilisez une clé de protection du logiciel. L'utilisation d'une clé matérielle Wibu CodeMeter nécessite des pilotes clés qui sont installés lors de l'installation automatique du runtime.

VI - Clé de protection des logiciels

Dans ce scénario, vous installez manuellement votre application qui utilise la bibliothèque ABBYY FineReader Engine sur un poste de travail local. Vous aurez besoin :

- du numéro de série d'une licence d'exécution autonome.

Suivez les instructions :

1. Constituez la liste des dossiers nécessaires au fonctionnement de votre demande. Consultez la section Kit de distribution du moteur ABBYY FineReader dans l'aide aux développeurs. La liste comprendra :

- les fichiers marqués comme « obligatoires » dans le kit de distribution d'ABBYY FineReader Engine. Il s'agit de modules du système et des principales bases de données de reconnaissance ;

- bases de données de reconnaissance pour le texte imprimé à la main, si vous souhaitez reconnaître du texte imprimé à la main ;

- fichiers de ressources pour les langues d'interface qui seront utilisées dans votre application ;

- fichiers de support de dictionnaire pour les langues de reconnaissance qui seront prises en charge par votre application. Si les langues de reconnaissance comprennent des langues avec l'alphabet latin, assurez-vous de sélectionner les fichiers Univers.amd et Univers.amm ;

- les modules de numérisation, les ressources spécifiques de numérisation et les modules Twain si votre application effectue la numérisation via l'interface du moteur ABBYY FineReader ;

- les modules Visual Components et les ressources spécifiques correspondantes, si votre application utilise ABBYY Composants visuels du moteur FineReader.

Vous pouvez également créer la liste des fichiers automatiquement, à l'aide du fichier FREngineDistribution.csv. Voir l'aide aux développeurs pour les instructions.

1. Copiez les fichiers que vous avez sélectionnés sur le poste de travail.

La façon la plus simple de s'assurer que tous les fichiers de ressources peuvent être localisés par le programme est de conserver la même structure de dossiers et d'inclure dans votre distribution le fichier SharedFiles.ini que vous trouverez dans le dossier Bin (ou Bin64). Si vous préférez ne pas utiliser ce fichier, au lieu de maintenir la structure des dossiers, procédez comme suit :

- copiez le dossier Data\Resource avec tous les sous-dossiers dans le dossier Bin (Bin64) ;

- copiez le contenu du dossier Data\ExtendedDictionaries directement dans le dossier Bin (Bin64) ;

- copiez les autres fichiers contenus dans le dossier Data dans le dossier Bin (Bin64).

1. Enregistrez les bibliothèques dynamiques dont vous aurez besoin :

- si votre application charge l'objet Engine au moyen de l'interface IEngineLoader, enregistrez FREngine.dll en utilisant la ligne de commande suivante :

regsvr32 /s /n /i:"<path to the Inc folder>" "<path to FREngine.dll>"

- si votre application utilise Visual Components, enregistrez VisualComponentsX.dll en utilisant la ligne de commande suivante :

regsvr32 /s "<path to VisualComponentsX.dll>"

Créez les dossiers qui seront utilisés par ABBYY FineReader Engine :

- dossier %ProgramData%\ABBYY\SDK\12\FineReader Engine ;

- dossier %ProgramData%\ABBYY\SDK\12\Licences.

Chaque utilisateur qui exécute votre application doit avoir un contrôle total de l'accès à ces dossiers.

Vous pouvez choisir d'utiliser un autre dossier pour le dossier de données du moteur FineReader au lieu de …

\ABBYY\SDK\12\FineReader Engine. Dans ce cas, vous devrez créer ce dossier lors de l'installation, en vous assurant des mêmes droits d'accès. Passez le chemin d'accès à ce dossier comme paramètre FREngineDataFolder de la fonction InitializeEngine ou de la méthode de l'interface IEngineLoader.

1. Installez le service de licence.

Utilisez le moteur ABBYY FineReader et le service de licence à partir du même ensemble. Sinon, la compatibilité n'est pas garantie.

Des droits d'accès d'administrateur sont nécessaires pour l'installation.

Le serveur de licence nécessite la mise à jour KB2999226 ou le Redistributable 14.0.24212 de Microsoft Visual C  + + 2015. Si vous n'installez pas le paquet Windows Update, vous pouvez installer le redistribuable à partir du dossier License Server\VC_Redist sur le DVD-ROM d'installation.

o Pour Windows 32 bits, installez vc_redist.x86.exe.

o Pour Windows 64 bits, installez à la fois vc_redist.x86.exe et vc_redist.x64.exe.

Après avoir installé cette mise à jour, vous pouvez procéder à l'installation du serveur de licence.

1. Copiez les fichiers pour le service de licence et l'utilitaire de gestion des licences dans un dossier séparé sur le poste de travail. Ces fichiers se trouvent dans le dossier License Server\ sur le DVD-ROM d'installation : copiez tous les fichiers du dossier License Server\Common\ABBYY\SDK\12\Licensing et les fichiers suivants du dossier License Server\ABBYY SDK\12\License Server : Awl.dll, LicenseManager.exe, LicenseManager12.chm, Protection.dll, et ProtectionUI.dll.

Voir la section Kit de distribution du moteur ABBYY FineReader dans l'aide aux développeurs pour plus de détails.

1. Exécutez LicensingService.exe avec le paramètre « /install » :

LicensingService.exe /install

1. Activez la licence.

Exécutez LicenseManager.exe. Cliquez sur le bouton Activer la licence… et suivez les instructions de l'assistant pour activer votre licence. Si votre ordinateur a accès à Internet, il vous suffit de saisir le numéro de série et d'attendre quelques instants. Pour plus de détails sur le gestionnaire de licences, voir l'utilitaire du gestionnaire de licences.

Vous pouvez également activer la licence par la ligne de commande. Pour plus de détails, voir Travailler avec le gestionnaire de licences à partir de la ligne de commande.

VII - Installation automatique de la durée d'exécution du réseau

Cette section fournit des guides sur l'installation de votre application sur un serveur de réseau et sur les postes de travail connectés à ce serveur à l'aide de l'installateur en ligne de commande.

VIII - Clé de protection des logiciels

Dans ce scénario, vous installez votre application qui utilise la bibliothèque ABBYY FineReader Engine sur un serveur et des postes de travail connectés à ce serveur par un réseau, via la ligne de commande, sans aucune interaction avec l'utilisateur. Vous aurez besoin :

- du numéro de série d'une licence d'exécution en réseau.

Vous devez d'abord installer la bibliothèque et activer la licence sur un serveur de licence – un ordinateur qui gérera et distribuera les licences entre les postes de travail d'un réseau. Ensuite, vous devez installer la bibliothèque sur les postes de travail. L'activation sur les postes de travail n'est pas nécessaire.

Suivez les instructions :

1. Installez la bibliothèque et le service de licence sur le serveur de licence.

Exécutez le fichier setup.exe à partir du DVD-ROM d'installation avec les options suivantes :

- /q (ou /qb si vous souhaitez qu'une barre de progression s'affiche)

- · /v

Indique le début de la liste des paramètres d'installation.

- INSTALLDIR="<destination path>"

Le chemin d'accès au dossier dans lequel la bibliothèque ABBYY FineReader Engine sera installée.

La ligne de commande pour l'installation de votre serveur peut ressembler à ceci :

setup.exe /q /v INSTALLDIR="C:\MyFolder"

Cette ligne de commande va installer la bibliothèque dans C:\MyFolder en mode silencieux, sans barre de progression, en prenant l'ordinateur actuel pour le serveur de licence.

Si votre serveur de licence ne fonctionne pas comme l'un des postes de travail, il vous suffit d'y installer le service de licence. Exécutez Setup.exe depuis le dossier du serveur de licence sur le DVD-ROM d'installation et suivez les instructions de l'assistant :

1. Sur le premier écran, sélectionnez le chemin d'accès au dossier dans lequel le service de licence sera installé et le protocole de connexion qu'il utilisera. Cliquez sur Suivant ;

2. Sur le deuxième écran, vérifiez vos paramètres et cliquez sur Installer.

Voir le Guide de l'administrateur du serveur de licence pour plus de détails.

1. Activez la licence sur le serveur de licence.

Après avoir installé la bibliothèque, vous trouverez l'utilitaire de gestion des licences (LicenseManager.exe) dans le dossier Bin (pour un système d'exploitation 32 bits) ou Bin64 (pour un système d'exploitation 64 bits) de votre installation.

Si le réseau a accès à Internet, exécutez LicenseManager.exe avec les options suivantes pour l'activer votre permis :

- /SilentActivation ;

- /SN:<numéro de série>.

Le numéro de série de votre licence d'exécution autonome.

Indiquez le numéro de série dans l'un des formats suivants : XXXX-XXXX-XXXX-XXXX-XXXX-XXXX ouXXXXXXXXXXXXXXXXXXXXXXXXXX.

La ligne de commande pour l'activation de votre licence peut ressembler à ceci :

LicenseManager.exe /SilentActivation /SN:XXXX-XXXX-XXXX-XXXX-XXXX-XXXX

Pour les autres options d'activation (par exemple, si votre réseau n'a pas accès à Internet), voir Licence Activation.

L'activation manuelle de la licence via l'interface graphique est également possible. Voir l'utilitaire de gestion des licences.

1. Installez la bibliothèque sur les postes de travail.

Exécutez le fichier setup.exe à partir du DVD-ROM d'installation avec les options suivantes :

- /q (ou /qb si vous souhaitez qu'une barre de progression s'affiche)

- /v

Indique le début de la liste des paramètres d'installation.

- INSTALLDIR="<destination path>"

Le chemin d'accès au dossier dans lequel la bibliothèque ABBYY FineReader Engine sera installée.

- LICENSESRV=No

Indique qu'il n'est pas nécessaire d'installer le service de licence.

- SERVERNAME="<the DNS name or IP address>"

LicenseManager.exe /SilentActivation /SN:XXXX-XXXX-XXXX-XXXX-XXXX-XXXX

Pour les autres options d'activation (par exemple, si votre réseau n'a pas accès à Internet), voir Licence Activation.

L'activation manuelle de la licence via l'interface graphique est également possible. Voir l'utilitaire de gestion des licences.

1. Installez la bibliothèque sur les postes de travail.

Exécutez le fichier setup.exe à partir du DVD-ROM d'installation avec les options suivantes :

- /q (ou /qb si vous souhaitez qu'une barre de progression s'affiche)

- · /v

Indique le début de la liste des paramètres d'installation.

- INSTALLDIR="<chemin de destination>"

Le chemin d'accès au dossier dans lequel la bibliothèque ABBYY FineReader Engine sera installée.

- LICENSESRV=Non

Indique qu'il n'est pas nécessaire d'installer le service de licence.

SERVERNAME="<le nom DNS ou l'adresse IP>"

Le nom DNS ou l'adresse IP du serveur de licence que vous avez mis en place à l'étape précédente.

La ligne de commande pour l'installation de votre poste de travail peut ressembler à ceci :

setup.exe /q /v INSTALLDIR="C:\MyFolder" LICENSESRV="No"

SERVERNAME="XXX.XXX.XXX.XX ?"

Cette ligne de commande installera la bibliothèque dans C:\MyFolder en mode silencieux, sans barre de progression, et configurera le poste de travail pour recevoir des licences du serveur de licence avec l'adresse IP XXX.XXX.XXX.XX ?

Remarque : vous avez également la possibilité de mettre en place une configuration à deux serveurs qui permettra à l'un des serveurs de licences d'agir en tant que sauvegarde pour un autre au cas où il serait déconnecté. Pour plus de détails, voir la configuration d'un serveur de licence redondant.

IX - Clé de protection matérielle

Dans ce scénario, vous installez votre application qui utilise la bibliothèque ABBYY FineReader Engine sur un serveur et des postes de travail connectés à ce serveur par un réseau, via la ligne de commande, sans aucune interaction avec l'utilisateur. Vous aurez besoin :

- d’une clé USB contenant les paramètres de votre clé de protection matérielle.

Vous devez d'abord installer la bibliothèque sur un serveur de licence – un ordinateur qui gérera et distribuera les licences entre les postes de travail d'un réseau. Ensuite, installez la bibliothèque sur les postes de travail.

Suivez les instructions :

1. Installez la bibliothèque et le service de licence sur le serveur de licence.

Exécutez le fichier setup.exe à partir du DVD-ROM d'installation avec les options suivantes :

- /q (ou /qb si vous souhaitez qu'une barre de progression s'affiche)

- · /v

Indique le début de la liste des paramètres d'installation.

- INSTALLDIR="<destination path>"

Le chemin d'accès au dossier dans lequel la bibliothèque ABBYY FineReader Engine sera installée.

- WIBUDR=Yes

Cette option permet d'installer les pilotes de clés matérielles Wibu CodeMeter.

Pour des options de ligne de commande supplémentaires, voir Options d'installation de ligne de commande.

La ligne de commande pour l'installation de votre serveur peut ressembler à ceci :

setup.exe /q /v INSTALLDIR="C:\MyFolder" WIBUDR="Yes"

Cette ligne de commande installera la bibliothèque dans C:\MyFolder en mode silencieux, sans barre de progression, et en prenant l'ordinateur actuel pour le serveur de licence.

Remarque : si votre serveur de licence ne fonctionne pas comme l'un des postes de travail, il vous suffit d'installer le logiciel Licensing Service sur ce poste. Exécutez Setup.exe à partir du dossier License Server du DVD-ROM d'installation et suivez les instructions de l'assistant :

1. sur le premier écran, sélectionnez le chemin d'accès au dossier où le service de licence sera installé et le protocole de connexion qu'il utilisera. Cliquez sur Suivant ;

2. sur le deuxième écran, vérifiez vos paramètres et cliquez sur Installer.

Dans ce cas, vous devrez installer vous-même les pilotes clés du Wibu CodeMeter, car l'installation automatique n'est pas fournie par l'installateur du service de licence. Voir le guide de l'administrateur du serveur de licence pour plus de détails.

1. Connectez la clé de protection matérielle au port USB du serveur. L'activation de la licence n'est pas nécessaire.

2. Installez la bibliothèque sur les postes de travail.

Exécutez le fichier setup.exe à partir du DVD-ROM d'installation avec les options suivantes :

- /q (ou /qb si vous souhaitez qu'une barre de progression s'affiche)

- · /v

Indique le début de la liste des paramètres d'installation.

- INSTALLDIR="<destination path>"

Le chemin d'accès au dossier dans lequel la bibliothèque ABBYY FineReader Engine sera installée.

- LICENSESRV=No

Indique qu'il n'est pas nécessaire d'installer le service de licence.

- SERVERNAME="<the DNS name or IP address>"

Le nom DNS ou l'adresse IP du serveur de licence que vous avez mis en place à l'étape précédente.

La ligne de commande pour l'installation de votre poste de travail peut ressembler à ceci :

setup.exe /q /v INSTALLDIR="C:\MyFolder" LICENSESRV="No"

SERVERNAME="XXX.XXX.XXX.XX ?"

Cette ligne de commande installera la bibliothèque dans C:\MyFolder en mode silencieux, sans barre de progression, et configurez le poste de travail pour recevoir les licences du serveur de licence avec l'adresse IP XXX.XXX.XXX.XX ?

Vous avez également la possibilité de mettre en place une configuration à deux serveurs qui permettra à l'un des serveurs de licence d'agir en tant que sauvegarde pour un autre au cas où il serait hors ligne. Pour plus de détails, voir Configuration d'une configuration redondante des serveurs de licence.

X - Installation manuelle de l'exécution du réseau

Cette section fournit des guides sur l'installation manuelle de votre application sur un serveur de réseau et sur les postes de travail connectés à ce serveur.

Notez que l'installation manuelle sur le réseau n'est possible que si vous utilisez une clé de protection du logiciel. L'utilisation d'une clé matérielle Wibu CodeMeter nécessite des pilotes clés qui sont installés lors de l'installation automatique du runtime.

XI - Clé de protection des logiciels

Dans ce scénario, vous installez manuellement votre application qui utilise la bibliothèque ABBYY FineReader Engine sur un serveur et des postes de travail connectés à ce serveur via un réseau. Vous aurez besoin :

- du numéro de série d'une licence d'exécution en réseau.

Vous devez d'abord installer le service de licence et activer la licence sur un serveur de licence – un ordinateur qui gérera et distribuera les licences entre les postes de travail d'un réseau. Ensuite, installez la bibliothèque sur les postes de travail et établissez la connexion au serveur de licence.

Suivez les instructions :

1. Installez le service de licence sur le serveur de licence.

Utilisez ABBYY FineReader Engine et le service de licence à partir du même package. Sinon, la compatibilité n'est pas garantie.

Important ! Des droits d'accès d'administrateur sont nécessaires pour l'installation.

Le serveur de licence nécessite la mise à jour KB2999226 ou le Microsoft Visual C + + 2015 Redistributable 14.0.24212. Si vous n'installez pas le paquet Windows Update, vous pouvez installer le redistribuable à partir du dossier License Server\VC_Redist sur le DVD-ROM d'installation.

o Pour Windows 32 bits, installez vc_redist.x86.exe.

o Pour Windows 64 bits, installez à la fois vc_redist.x86.exe et vc_redist.x64.exe.

Après avoir installé cette mise à jour, vous pouvez procéder à l'installation du serveur de licence.

1. Copiez les fichiers pour le service de licence et l'utilitaire de gestion des licences dans un dossier séparé sur le serveur. Ces fichiers se trouvent dans le dossier License Server\ sur le DVD-ROM d'installation : copiez tous les fichiers du dossier License Server\Common\ABBYY\SDK\12\Licensing et les fichiers suivants du dossier License Server\ABBYY SDK\12\License Server : Awl.dll, LicenseManager.exe, LicenseManager12.chm, Protection.dll, et ProtectionUI.dll.

Voir la section Kit de distribution du moteur ABBYY FineReader dans l'aide aux développeurs pour plus de détails.

1. Créez le dossier %ProgramData%\ABBYY\SDK\12\Licenses. Chaque utilisateur qui exécute votre application doit avoir un contrôle total de l'accès à ce dossier.

2. Exécutez LicensingService.exe avec le paramètre « /install » :

LicensingService.exe /install

d. Créez un fichier LicensingSettings.xml. Le schéma XML auquel il doit se conformer se trouve dans le fichier LicensingSettings.xsd, qui se trouve dans le dossier Inc de votre installation de développeur ou dans le dossier CADF\Inc du DVD-ROM d'installation.

Dans ce fichier, vous devez définir le type de protocole de connexion que votre serveur de licence utilisera. Les types supportés sont LocalInterprocessCommunication, NamedPipes, TCP/IP et Sockets :

<LocalLicenseServer>
<ConnectionProtocol ProtocolType="[your protocol type]"/>
</LocalLicenseServer>

Par défaut, le port TCP/IP 3022 est utilisé. Si ce port est fermé sur votre serveur, indiquez un autre port ouvert :

<LocalLicenseServer>
<ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/>
</LocalLicenseServer>

Copiez le fichier LicensingSettings.xml configuré dans le dossier où se trouvent les autres fichiers du service de licence localisé.

Remarque : vous avez également la possibilité de mettre en place une configuration à deux serveurs qui permettra à l'un des serveurs de licence d'agir en tant que sauvegarde pour un autre au cas où il serait hors ligne. Pour plus de détails, voir Configuration d'un serveur de licence redondant.

1. Activez la licence sur le serveur de licence.

Exécutez LicenseManager.exe. Cliquez sur le bouton Activer la licence… et suivez les instructions de l'assistant pour activer votre licence. Si votre serveur a accès à Internet, il vous suffit de saisir le numéro de série et attendez quelques instants. Pour plus de détails sur le gestionnaire de licences, voir l'utilitaire du gestionnaire de licences.

Vous pouvez également activer la licence par le biais de la ligne de commande. Pour plus de détails, voir Travailler avec la licence Gestionnaire de la ligne de commande.

1. Installez la bibliothèque sur les postes de travail.

Note : si le serveur de licence fonctionne également comme un poste de travail, effectuez cette étape pour le serveur également.

1. Établissez la liste des fichiers nécessaires au fonctionnement de votre application. Consultez le site ABBYY FineReader Section du kit de distribution du moteur dans l'aide aux développeurs. La liste comprendra :

les fichiers marqués comme « obligatoires » dans le kit de distribution du moteur ABBYY FineReader. Il s'agit de modules du système et des principales bases de données de reconnaissance.

- Bases de données de reconnaissance pour le texte imprimé à la main, si vous souhaitez reconnaître du texte imprimé à la main.

- Fichiers de ressources pour les langues d'interface qui seront utilisées dans votre application.

- Fichiers de support de dictionnaire pour les langues de reconnaissance qui seront prises en charge par votre application. Si les langues de reconnaissance comprennent des langues avec l'alphabet latin, assurez-vous que vous sélectionnez l'option Fichiers Univers.amd et Univers.amm.

- Les modules d'analyse, les ressources spécifiques d'analyse et les modules Twain si votre application effectuera la numérisation via l'interface du moteur ABBYY FineReader.

- Les modules Visual Components et les ressources spécifiques correspondantes, si votre application utilise ABBYY Composants visuels du moteur FineReader.

Vous pouvez également créer la liste des fichiers automatiquement, à l'aide du fichier FREngineDistribution.csv. Voir Aide aux développeurs pour les instructions.

1. Copiez les fichiers que vous avez sélectionnés sur tous vos postes de travail.

Le moyen le plus simple de s'assurer que tous les fichiers de ressources peuvent être localisés par le programme est de conserver la même structure de dossiers et d'inclure dans votre distribution le fichier SharedFiles.ini que vous trouverez dans le dossier Bin (ou Bin64). Si vous préférez ne pas utiliser ce fichier, au lieu de conserver la structure du dossier, procédez comme suit :

- copiez le dossier Data\Resource avec tous les sous-dossiers dans le dossier Bin (Bin64) ;

- copiez le contenu du dossier Data\ExtendedDictionaries directement dans le dossier Bin (Bin64) ;

- copiez les autres fichiers contenus dans le dossier Data dans le dossier Bin (Bin64).

1. Enregistrez les bibliothèques dynamiques dont vous aurez besoin.

- Si votre application charge l'objet Engine au moyen de l'interface IEngineLoader, enregistrez FREngine.dll en utilisant la ligne de commande suivante :

regsvr32 /s /n /i:"<path to the Inc folder>" "<path to FREngine.dll>"

- Si votre application utilise Visual Components, enregistrez VisualComponentsX.dll en utilisant la ligne de commande suivante :

regsvr32 /s "<path to VisualComponentsX.dll>"

Créez les dossiers qui seront utilisés par ABBYY FineReader Engine ;

- dossier %ProgramData%\ABBYY\SDK\12\FineReader Engine ;

- dossier %ProgramData%\ABBYY\SDK\12\Licences .

Chaque utilisateur qui exécute votre application doit avoir un contrôle total de l'accès à ces dossiers.

Vous pouvez choisir d'utiliser un autre dossier pour le dossier de données du moteur FineReader au lieu de … \ABBYY\SDK\12\FineReader Engine. Dans ce cas, vous devrez créer ce dossier lors de l'installation, en garantissant les mêmes droits d'accès. Passez le chemin d'accès à ce dossier comme paramètre FREngineDataFolder de l'option InitializeEngine fonction ou méthode de l'interface IEngineLoader.

1. Créez un fichier LicensingSettings.xml, en définissant le même type de protocole de connexion que vous avez spécifié pour le serveur et l'adresse du serveur :

1. <LicensingServers>

2. <MainNetworkLicenseServer ServerAddress="[your server address]"

3. ProtocolType="[your protocol type]"/>

4. </LicensingServers>

Si vous définissez un autre port TCP/IP pour le serveur, répétez le même réglage ici.

1. <LicensingServers>

2. <MainNetworkLicenseServer ServerAddress="[your server address]"

3. ProtocolType="TCP/IP" EndPointName="1025"/>

4. </LicensingServers>

Copiez le fichier configuré dans le dossier Bin (pour un système d'exploitation 32 bits) ou Bin64 (pour un système d'exploitation 64 bits) de votre installation de bibliothèque sur chaque poste de travail.

Si le serveur de licence fonctionne également comme un poste de travail, le fichier LicensingSettings.xml du serveur doit contenir à la fois les balises LicensingServers et LocalLicenseServer similaires à celles indiquées ci-dessus. Le contenu du fichier ressemblera à ceci :

1. <?xml version="1.0" encoding="utf-8"?>

2. <LicensingSettings

3. xmlns="http://www.abbyy.com/Protection/LicensingSettings">

4. <LicensingServers>

5. <MainNetworkLicenseServer ServerAddress="[your server address]"

6. ProtocolType="[your protocol type]"/>

7. </LicensingServers>

9. <LocalLicenseServer>

10. <ConnectionProtocol ProtocolType="[your protocol type]"/>

11. </LocalLicenseServer>

12. </LicensingSettings>

XII - Désinstallation de la bibliothèque

XII-A - Désinstallation de l'installation du développeur

Pour l'installation des développeurs, utilisez le menu Désinstaller ou modifier un programme de Windows (Panneau de configuration > Programmes et fonctionnalités).

XII-B - Désinstallation de l'installation automatique du runtime

La désinstallation automatique du runtime est la même pour les installations autonomes et en réseau. Pour l'installation en réseau, effectuez les étapes requises sur chaque poste de travail.

Si la bibliothèque ABBYY FineReader Engine a été installée à l'aide d'un installateur intégré (installation automatique du runtime), elle doit être désinstallée également à l'aide de cet installateur. Exécutez setup.exe à partir du DVD-ROM d'installation avec les options suivantes :

- /q (ou /qb si vous souhaitez qu'une barre de progression soit affichée)

- · /v

Il indique le début de la liste des paramètres d'installation.

- INSTALLDIR="<chemin de destination>"

Le chemin d'accès au dossier où la bibliothèque ABBYY FineReader Engine a été installée.

- DeinstallRuntime=Yes

Il indique que l'installation du runtime doit être supprimée.

XII-C - Désinstallation de l'installation manuelle du runtime

La désinstallation manuelle du runtime est la même pour les installations autonomes et en réseau. Pour l'installation en réseau, effectuez les étapes requises sur chaque poste de travail, et celles concernant le service de licence sur le serveur de licence.

Suivez les instructions :

1. Désenregistrez les bibliothèques dynamiques (FREngine.dll et VisualComponentsX.dll) si elles ont été enregistrées lors de l'installation manuelle.

regsvr32.exe /u "<chemin vers FREngine.dll>"

regsvr3.exe /u "<chemin d'accès à VisualComponentsX.dll>"

Désinstallez le service de licence s'il a été installé (c'est-à-dire depuis le poste de travail pour une installation autonome, et depuis le serveur de licence pour une installation en réseau) :

LicensingService.exe /uninstall

Supprimez ensuite le dossier contenant les fichiers du Service des licences.

1. Supprimez tous les fichiers de la bibliothèque du moteur ABBYY FineReader. Ils peuvent se trouver dans les dossiers Bin, Bin64 (uniquement pour les systèmes d'exploitation 64 bits) et Data de votre dossier d'installation.

2. Supprimez les dossiers qui ont été utilisés par ABBYY FineReader Engine :

- dossier %ProgramData%\ABBYY\SDK\12\FineReader Engine ;

- dossier %ProgramData%\ABBYY\SDK\12\Licences.