Cette section contient des instructions pour installer manuellement votre application sur un serveur réseau ainsi que sur les postes de travail qui y sont connectés.Documentation Index
Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
Use this file to discover all available pages before exploring further.
L’installation manuelle en réseau n’est possible que si vous utilisez Software ou la protection en ligne.
Protection en ligne
Protection en ligne
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 de :Pour mettre en œuvre ce scénario, vous devez installer le service de licence sur le serveur de licences — un ordinateur chargé de gérer et de distribuer les licences entre les postes de travail d’un réseau. Ensuite, installez la bibliothèque sur les postes de travail, configurez la connexion au serveur de licences et copiez le jeton de licence sur chaque poste de travail.Par défaut, le port TCP/IP 3022 est utilisé. Si ce port est fermé sur votre serveur, indiquez un autre port ouvert :Si vous avez configuré un autre port TCP/IP pour le serveur, répétez le même paramètre ici.
- un fichier de jeton de licence en ligne (nommé, par exemple, SWRTXXXXXXXXXXXXXXXXXXXX.ABBYY.ActivationToken).
Une connexion Internet est requise pendant l’exécution de l’application.
Pour simplifier la création d’un package personnalisé, extrayez les fichiers vers un dossier donné, sans installation, à l’aide de l’option /extract de installRnt**.exe ou installLS.exe depuis la ligne de commande du package de distribution. Il contiendra les dossiers suivants :
-
pour installRnt**.exe :
- FineReader Engine - avec les fichiers ABBYY FineReader Engine
- Inc - avec le fichier FREngine.tlb (pour l’enregistrement de FREngine.dll)
- Licensing - avec les fichiers du service de licence
-
pour installLS.exe :
- Licensing - avec les fichiers du service de licence
- License Server - avec les fichiers de License Server
Création des packages ABBYY FineReader Engine sur votre ordinateur :
-
Package de bibliothèque. Il s’agit d’un dossier contenant les fichiers ABBYY FineReader Engine répertoriés dans la section ABBYY FineReader Engine Distribution Kit de l’aide du développeur. La liste comprend :
- Fichiers marqués comme “obligatoires” dans ABBYY FineReader Engine Distribution Kit. Il s’agit des modules système et des principales bases de données de reconnaissance.
- Bases de données de reconnaissance pour le texte écrit en lettres moulées, si vous souhaitez reconnaître ce type de texte.
- Fichiers de ressources pour les langues d’interface qui seront utilisées dans votre application.
- Fichiers de prise en charge des dictionnaires pour les langues de reconnaissance prises en charge par votre application. Si les langues de reconnaissance incluent des langues utilisant l’alphabet latin, veillez à sélectionner les fichiers Univers.amd et Univers.amm.
- Modules de numérisation, ressources spécifiques à la numérisation et modules TWAIN si votre application effectue la numérisation via l’interface ABBYY FineReader Engine.
- Modules Windows Visual Components et ressources spécifiques correspondantes, si votre application utilise les composants visuels ABBYY FineReader Engine.
-
Package License Server. Il comprend deux dossiers contenant les fichiers du service de licence et de l’Utilitaire du gestionnaire de licences :
- Dossier service de licence avec tous les fichiers copiés à partir du dossier Licensing décompressé.
- Dossier License Manager (License Manager64) avec les fichiers suivants copiés à partir du dossier License Server décompressé : 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.
-
Autres composants logiciels :
- La mise à jour KB2999226 ou Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912. Si vous n’installez pas le package de Windows Update, vous pouvez installer le package redistribuable à partir du dossier External Components\VC_Redist du package de distribution : vc_redist.x86.exe et vc_redist.x64.exe.
- .NET Framework 4.6.2 si vous prévoyez d’utiliser le module OfficeConverters.
Installation du service de licence sur le License Server :
- Copiez le package License Server ainsi que Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912 sur le serveur de licences.
- Installez le package redistribuable Microsoft Visual C++ 2015-2019 version 14.28.29912.
- Copiez les dossiers du package License Server dans le répertoire du serveur de licences où vous pensiez installer le service de licence.
Nous vous recommandons d’organiser les fichiers ABBYY FineReader Engine dans une arborescence de dossiers facile à repérer et à utiliser. Voir l’exemple ci-dessous :
- <YourApplicationFolder>/License Server/service de licence.
- <YourApplicationFolder>/License Server/License Manager (License Manager64).
- Créez un dossier pour stocker les données de licence (le dossier %ProgramData%\ABBYY\SDK\12\Licenses par défaut). Chaque utilisateur qui exécute votre application doit disposer des autorisations de contrôle total sur ce dossier.
- Créez un fichier LicensingSettings.xml. Le schéma XML auquel il doit se conformer se trouve dans le fichier LicensingSettings.xml, situé dans le dossier Inc de votre installation développeur ou dans le dossier CADF\Inc du package de distribution. Dans ce fichier, vous devez définir le protocole de connexion que votre serveur de licences utilisera. Les protocoles pris en charge sont LocalInterprocessCommunication, NamedPipes, TCP/IP et Sockets :
-
Copiez le fichier LicensingSettings.xml configuré dans les dossiers suivants :
- Service de licence.
- License Manager (License Manager64).
- Exécutez LicensingService.exe avec le paramètre “/install” :
Activation de la licence sur le License Server :
Une licence en ligne ne nécessite pas d’activation : les informations de licence sont reçues au moment de l’exécution de l’application depuis les services de licence en ligne ABBYY. Pour s’authentifier, l’application envoie un fichier de jeton de licence et un mot de passe de licence. Vous devrez placer le fichier de jeton à l’emplacement attendu par l’application. Cet emplacement doit être défini par le développeur (par défaut : %ProgramData%\ABBYY\SDK\12\Licenses).Au moment de l’exécution, l’application doit se connecter périodiquement aux services de licence en ligne ABBYY afin de recevoir les informations de licence et d’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 le port 443 (HTTPS). Si la connexion est perdue, l’application cessera de fonctionner une fois le délai de reconnexion dépassé. La période de synchronisation et le délai de reconnexion sont des paramètres propres à chaque licence en ligne.
Il n’est pas possible d’utiliser simultanément deux licences en ligne ou davantage sur le même hôte. Lorsque l’application est en cours d’exécution et que la connexion aux services de licence d’ABBYY fonctionne, vous pouvez afficher les détails de la licence en ligne actuellement active à l’aide de l’Utilitaire du gestionnaire de licences.
Installation de la bibliothèque ABBYY FineReader Engine sur les postes de travail :
Si le serveur de licences fait également office de poste de travail, effectuez aussi cette étape sur le serveur.
- Copiez le package de la bibliothèque et les composants logiciels sur tous vos postes de travail.
Le moyen le plus simple de s’assurer que le programme peut localiser tous les fichiers de ressources consiste à conserver la même structure de dossiers et à inclure dans votre package de distribution le fichier SharedFiles.ini que vous trouverez dans le dossier Bin (ou Bin64), selon votre système d’exploitation. Si vous préférez ne pas utiliser ce fichier, au lieu de conserver la structure de dossiers, procédez comme suit :
- Copiez le dossier Data\Resource avec tous ses sous-dossiers dans le dossier suivant :
- Bin
- Bin64
- Copiez directement le contenu du dossier Data\ExtendedDictionaries dans le dossier Bin ou Bin64.
- Copiez les autres fichiers du dossier Data dans le dossier Bin ou Bin64.
-
Installez les composants logiciels nécessaires :
- Le package redistribuable Microsoft Visual C++ 2015-2019 (14.28.29912).
- Le .NET Framework, si nécessaire.
- Copiez le dossier contenant les fichiers ABBYY FineReader Engine depuis le Library Package vers le répertoire du poste de travail où vous souhaitez installer la bibliothèque.
-
Enregistrez les bibliothèques dynamiques nécessaires :
- Si votre application charge l’objet Engine par l’intermédiaire de l’interface IEngineLoader, enregistrez FREngine.dll à l’aide de la ligne de commande suivante :
- Si votre application utilise des composants visuels, enregistrez VisualComponentsX.dll à l’aide de la ligne de commande suivante :
-
Créez les dossiers qui seront utilisés par ABBYY FineReader Engine. Dans la liste ci-dessous, les valeurs par défaut de ces dossiers sont indiquées :
- dossier %ProgramData%\ABBYY\SDK\12\FineReader Engine (l’autorisation de contrôle total est requise)
- dossier %ProgramData%\ABBYY\SDK\12\Licenses (l’autorisation de contrôle total est requise pour le serveur de licences et facultative pour les postes de travail)
Pour spécifier le dossier des données de licence lors de l’installation, consultez un exemple dans Utilisation du fichier LicensingSettings.xml. Vous pouvez également utiliser la fonction InitializeEngine ou une méthode de l’interface IEngineLoader.
- Copiez le jeton de licence dans un dossier par défaut sur chaque poste de travail ou dans un dossier dont le chemin est utilisé par votre application dans la fonction InitializeEngine.
Création d’un fichier LicensingSettings.xml :
Créez un fichier LicensingSettings.xml en configurant le même type de protocole de connexion que celui que vous avez indiqué pour le serveur, ainsi que l’adresse du serveur :Copie du fichier LicensingSettings.xml configuré :
Copiez le fichier LicensingSettings.xml configuré dans le dossier contenant les fichiers ABBYY FineReader Engine, à côté de FREngine.dll, sur chaque poste de travail :Remarque : si le serveur de licences doit également faire office de 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 se présentera comme suit :Protection logicielle
Protection logicielle
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 de :Par défaut, le port TCP/IP 3022 est utilisé. Si ce port est fermé sur votre serveur, indiquez un autre port ouvert :Si vous avez configuré un autre port TCP/IP pour le serveur, appliquez le même paramètre ici.
- le numéro de série d’une licence Runtime Network.
Pour simplifier la création d’un package personnalisé, extrayez les fichiers à l’aide de l’option /extract pour installRnt**.exe ou installLS.exe, depuis la ligne de commande, du package de distribution vers un dossier spécifique, sans procéder à l’installation. Ce dossier contiendra les dossiers suivants :
-
pour installRnt**.exe :
- FineReader Engine - avec les fichiers ABBYY FineReader Engine
- Inc - avec le fichier FREngine.tlb (pour l’enregistrement de FREngine.dll)
- Licensing - avec les fichiers du service de licence
-
pour installLS.exe :
- Licensing - avec les fichiers du service de licence
- License Server - avec les fichiers de License Server
Création des packages ABBYY FineReader Engine sur votre ordinateur :
-
Package de la bibliothèque. Il s’agit d’un dossier contenant les fichiers d’ABBYY FineReader Engine répertoriés dans la section ABBYY FineReader Engine Distribution Kit de l’aide du développeur. La liste comprend :
- Fichiers marqués comme “obligatoires” dans ABBYY FineReader Engine Distribution Kit. Il s’agit des modules système et des principales bases de données de reconnaissance.
- Bases de données de reconnaissance pour le texte manuscrit en lettres moulées, si vous souhaitez reconnaître ce type de texte.
- Fichiers de ressources pour les langues de l’interface qui seront utilisées dans votre application.
- Fichiers de support de dictionnaire pour les langues de reconnaissance que votre application prendra en charge. Si ces langues incluent des langues utilisant l’alphabet latin, veillez à sélectionner les fichiers Univers.amd et Univers.amm.
- Modules de numérisation, ressources spécifiques à la numérisation et modules TWAIN si votre application doit effectuer une numérisation via l’interface d’ABBYY FineReader Engine.
- Modules des composants visuels Windows et ressources spécifiques correspondantes, si votre application utilise les composants visuels d’ABBYY FineReader Engine.
-
Package License Server. Il se compose de deux dossiers contenant les fichiers du service de licence et de l’utilitaire License Manager :
- dossier service de licence contenant tous les fichiers copiés depuis le dossier Licensing décompressé.
- dossier License Manager (License Manager64) contenant les fichiers suivants copiés depuis le dossier License Server décompressé : 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.
-
Autres composants logiciels :
- Mise à jour KB2999226 ou Microsoft Visual C++ 2015-2019 Redistributable 14.28.29912. Si vous n’installez pas le package Windows Update, vous pouvez installer le package redistribuable à partir du dossier External Components\VC_Redist du package de distribution : vc_redist.x86.exe et vc_redist.x64.exe.
- .NET Framework 4.6.2 si vous prévoyez d’utiliser le module OfficeConverters.
Installation du service de licence sur le License Server :
- Copiez le package License Server ainsi que le Redistributable Microsoft Visual C++ 2015-2019 14.28.29912 sur le serveur de licences.
- Installez le package redistribuable Microsoft Visual C++ 2015-2019 version 14.28.29912.
- Copiez les dossiers du package License Server dans le répertoire du serveur de licences où le service de licence est censé se trouver.
Nous vous recommandons d’organiser les fichiers ABBYY FineReader Engine dans une arborescence de dossiers facile à retrouver et à utiliser. Consultez l’exemple ci-dessous :
- <YourApplicationFolder>/License Server/service de licence.
- <YourApplicationFolder>/License Server/License Manager (License Manager64).
- Créez un dossier pour stocker les données de licence (le dossier %ProgramData%\ABBYY\SDK\12\Licenses par défaut). Chaque utilisateur exécutant votre application doit disposer des autorisations de contrôle total sur ce dossier. Consultez un exemple de configuration du dossier de données de licence dans Utilisation du fichier LicensingSettings.xml.
- Créez un fichier LicensingSettings.xml. Le schéma XML auquel il doit être conforme se trouve dans le fichier LicensingSettings.xml, situé dans le dossier Inc de votre installation développeur ou dans le dossier CADF\Inc du package de distribution. Dans ce fichier, vous devez définir le type de protocole de connexion qu’utilisera votre serveur de licences. Les types pris en charge sont LocalInterprocessCommunication, NamedPipes, TCP/IP et Sockets :
-
Copiez le fichier LicensingSettings.xml ainsi configuré dans les dossiers suivants :
- Service de licence.
- License Manager (License Manager64).
- Lancez LicensingService.exe avec le paramètre “/install” :
Vous pouvez également configurer une architecture à deux serveurs, afin que l’un des serveurs de licences serve de secours à l’autre en cas d’indisponibilité. Pour plus de détails, voir Pour plus de détails, voir Configuration d’un serveur de licences redondant.
Activation de la licence sur le License Server :
Exécutez LicenseManager.exe. Cliquez sur le bouton Activate License… et suivez les instructions de l’assistant pour activer votre licence. Si votre serveur dispose d’un accès à Internet, il vous suffit de saisir le numéro de série et d’attendre quelques instants. Pour plus d’informations sur le License Manager, consultez Utilitaire du gestionnaire de licences.Vous pouvez également activer la licence via la ligne de commande. Pour plus d’informations, voir Utilisation du License Manager depuis la ligne de commande..Installation de la bibliothèque ABBYY FineReader Engine sur les postes de travail :
Si le serveur de licences fait également office de station de travail, effectuez aussi cette étape sur le serveur.
- Copiez le package de la bibliothèque et les composants logiciels sur tous vos postes de travail.
Le moyen le plus simple de vous assurer que le programme peut trouver tous les fichiers de ressources consiste à conserver la même structure de dossiers et à inclure dans votre package de distribution le fichier SharedFiles.ini, que vous trouverez dans le dossier Bin (ou Bin64) selon votre système d’exploitation. Si vous préférez ne pas utiliser ce fichier, au lieu de conserver la structure des dossiers, procédez comme suit :
- Copiez le dossier Data\Resource avec tous ses sous-dossiers dans l’un des dossiers suivants :
- Bin
- Bin64
- Copiez directement le contenu du dossier Data\ExtendedDictionaries dans le dossier Bin ou Bin64.
- Copiez les autres fichiers contenus dans le dossier Data dans le dossier Bin ou Bin64.
-
Installez les composants logiciels nécessaires :
- Le package redistribuable Microsoft Visual C++ 2015-2019 version 14.28.29912.
- Le .NET Framework, si nécessaire.
- Copiez le dossier contenant les fichiers d’ABBYY FineReader Engine depuis le package de bibliothèque vers le répertoire du poste de travail où vous souhaitez placer la bibliothèque.
-
Enregistrez les bibliothèques dynamiques nécessaires :
- Si votre application charge l’objet Engine via l’interface IEngineLoader, enregistrez FREngine.dll à l’aide de la ligne de commande suivante :
- Si votre application utilise les composants visuels, enregistrez VisualComponentsX.dll à l’aide de la ligne de commande suivante :
-
Créez les dossiers qui seront utilisés par ABBYY FineReader Engine. La liste ci-dessous indique les valeurs par défaut de ces dossiers :
- dossier %ProgramData%\ABBYY\SDK\12\FineReader Engine (l’autorisation de contrôle total est requise)
- dossier %ProgramData%\ABBYY\SDK\12\Licenses (l’autorisation de contrôle total est requise pour le serveur de licences, et facultative pour les postes de travail)
Pour spécifier le dossier des données de licence lors de l’installation, consultez l’exemple présenté dans Utilisation du fichier LicensingSettings.xml. Vous pouvez également utiliser la fonction InitializeEngine ou la méthode de l’interface IEngineLoader.
Création d’un fichier LicensingSettings.xml :
Créez un fichier LicensingSettings.xml en configurant le même type de protocole de connexion que celui que vous avez indiqué pour le serveur, ainsi que l’adresse du serveur :Copie du fichier LicensingSettings.xml configuré :
Copiez le fichier LicensingSettings.xml configuré dans le dossier contenant les fichiers ABBYY FineReader Engine, à côté de FREngine.dll, sur chaque poste de travail :Si le serveur de licences fait également office de station de travail, le fichier
LicensingSettings.xml du serveur doit contenir à la fois les balises LicensingServers et LocalLicenseServer, comme indiqué ci-dessus. Le contenu du fichier se présentera comme suit :