Cette rubrique s’applique à FRE pour Linux et Windows.
Le fichier LicensingSettings.xml contient les paramètres de protection d’ABBYY FineReader Engine. Ce fichier est requis par le Licensing Service (obligatoire) lorsque vous utilisez une licence réseau avec n’importe quel type de protection ou une licence autonome avec protection en ligne.Le fichier est généré automatiquement lors de l’installation en mode Developer ou Runtime. Pour les installations réseau comme autonomes, ce fichier est généré à deux emplacements :Linux :
Bin et
CommonBin/Licensing dans le dossier d’installation
Windows :
%CommonProgramFiles(x86)%\ABBYY\SDK\12\Licensing\
<Installation Folder>\Bin64\ (si disponible)
<Installation Folder>\Bin\ (si disponible)
En cas d’installation manuelle, vous devez créer ce fichier et y spécifier les paramètres appropriés. Sous Linux, créez le fichier dans les deux dossiers indiqués ci-dessus. Sous Windows, créez le fichier dans le dossier Bin(Bin64).Le schéma XML des paramètres du Licensing Service est décrit dans le fichier LicensingSettings.xsd. Vous trouverez ce fichier dans le dossier Inc.
Les paramètres du service de licence comportent deux parties principales :
Les paramètres du service de licence installé sur l’ordinateur actuel, spécifiés dans la balise <LocalLicenseServer>.
Les paramètres de connexion au serveur réseau sur lequel le service de licence est installé. Ces paramètres sont spécifiés dans la balise <LicensingServers><MainNetworkLicenseServer>.
Si ABBYY FineReader Engine est installé sur un ordinateur local, vous devez spécifier les paramètres uniquement dans la balise <LocalLicenseServer>, si nécessaire. En revanche, si ABBYY FineReader Engine est utilisé en réseau, les paramètres <LocalLicenseServer> sont spécifiés sur le serveur, et les paramètres <LicensingServers><MainNetworkLicenseServer> sur les postes de travail. Si un ordinateur est utilisé à la fois comme serveur et comme poste de travail, les paramètres <LocalLicenseServer> et <LicensingServers><MainNetworkLicenseServer> doivent tous deux être spécifiés. Consultez les descriptions des balises ci-dessous pour plus de détails.
ProtocolType est Sockets sous Linux et TCP/IP sous Windows.
Détails
| Par défaut, le service de licence utilise le port 3022. Si ce port est fermé sur l’ordinateur où le service de licence est installé, le service de licence ne fonctionnera pas. Dans ce cas, spécifiez un port ouvert dans l’attribut EndPointName de la balise <LocalLicenseServer> ou <LicensingServers><MainNetworkLicenseServer>, par exemple : <LocalLicenseServer> <ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/> </LocalLicenseServer> ou <LicensingServers> <MainNetworkLicenseServer ServerAddress="computername" ProtocolType="TCP/IP" EndPointName="1025"/> </LicensingServers> |
Activation d’une licence via un serveur proxy - Linux
Si vous devez activer une licence lorsque votre machine est connectée à Internet via un serveur proxy, indiquez les paramètres de connexion dans la balise <ProxyServer>.Les protocoles pris en charge sont SOCKS5 et HTTP. Pour HTTP, vous pouvez utiliser l’authentification de base ou aucune authentification ; pour SOCKS, un nom d’utilisateur et un mot de passe, ou aucune authentification.Voici un exemple de fichier pour l’activation via un serveur proxy :
Utilisation d’une licence en ligne avec un serveur proxy
Une licence en ligne ne nécessite aucun paramétrage particulier, mais pour vous connecter via un serveur proxy, vous devez spécifier ses paramètres dans la balise <OnlineLicensing>.Le protocole pris en charge est HTTP, et vous pouvez utiliser les schémas d’authentification Anonymous, Basic ou Digest.Voici un exemple de fichier contenant les paramètres du serveur proxy pour la licence en ligne :
Par défaut, ABBYY FineReader Engine stocke les informations auxiliaires relatives à la licence dans %ProgramData%\ABBYY\SDK\12\Licenses. Pour définir un autre dossier, spécifiez l’attribut Path dans la balise <LicensesFolder>. Les autorisations de contrôle total sur un dossier de données de licence sont :
requises pour le dossier situé sur le serveur de licences
facultatives pour le dossier situé sur les postes de travail
Vous pouvez également utiliser la fonction InitializeEngine pour redéfinir le dossier des données de licence.
Les chemins de LicenseFolder indiqués dans l’exemple correspondent à Windows. Sous Linux, les chemins sont /home/user/workstation_logs_folder et /home/user/server_logs_folder respectivement.
Détails
| Pour le poste de travail : <LicensingServers> ... </LicensingServers> <LicensesFolder Path="path_to_workstation_logs_folder"/> Pour le serveur de licences : <LocalLicenseServer> ... </LocalLicenseServer> <LicensesFolder Path="path_to_server_logs_folder"/> |
Mise en place d’une configuration redondante du serveur de licences
Pour les licences distribuées via le réseau, vous pouvez mettre en place une configuration à deux serveurs, permettant à l’un d’eux de servir de secours à l’autre si celui-ci devient indisponible. Pour cela, vous avez besoin d’une Runtime License Network d’un type spécial avec prise en charge de la redondance activée.
Sur les serveurs :
La même licence doit être activée sur le serveur principal et sur le serveur de secours.
Chaque serveur doit spécifier l’adresse de l’autre dans la balise <LocalLicenseServer><RedundancyNetworkLicenseServer>.
Sur les postes de travail :
Tous les postes de travail doivent spécifier les adresses des deux serveurs dans les balises <LicensingServers><MainNetworkLicenseServer> et <LicensingServers><BackupNetworkLicenseServer>.
Pendant l’utilisation de la licence, les postes de travail communiquent avec le serveur de licences principal, auquel ils envoient les paramètres de licence et les statistiques d’utilisation. Le serveur de licences principal synchronise régulièrement ces données avec le serveur de secours. Si le serveur de licences principal tombe en panne, le serveur de secours prend le relais pour la gestion des licences et continue à stocker les informations provenant des postes de travail.Notez que le serveur de secours cesse de fournir des licences après un certain délai. Ce délai est défini dans les paramètres internes de la licence et peut aller de 4 à 5000 heures. Pour vous reconnecter au serveur de licences principal une fois qu’il est de nouveau en ligne, redémarrez le traitement avec Engine (désinitialisez-le, puis réinitialisez-le).Si le serveur de licences de secours tombe en panne alors que le serveur principal fonctionne, le système continuera à fonctionner comme s’il n’y avait qu’un seul serveur de licences. Une fois le serveur de secours restauré, il sera synchronisé avec le serveur principal et recommencera à fonctionner comme serveur de secours.Pour mettre à jour la licence après son expiration sur les deux serveurs :
Arrêtez l’un des deux serveurs.
Mettez à jour la licence sur le serveur disponible.
Arrêtez le serveur sur lequel la licence a été mise à jour.
Redémarrez le serveur précédemment arrêté.
Mettez à jour la licence sur le serveur disponible.
Rétablissez la connexion entre les serveurs en les remettant en marche.
Redémarrez le service de licence sur les deux serveurs pour actualiser les paramètres de licence.
Voir ci-dessous un exemple de configuration de la redondance pour les postes de travail et les serveurs.
Sous Windows, le protocole TCP/IP est utilisé pour la communication entre le serveur et les postes de travail.
Détails
| Pour le poste de travail : <LicensingServers> <MainNetworkLicenseServer ServerAddress="mainserver" ProtocolType="TCP/IP" EndPointName="1025"/> <BackupNetworkLicenseServer ServerAddress="backupserver" ProtocolType="TCP/IP" EndPointName="1025"/> </LicensingServers> Pour le serveur de licences principal : <LocalLicenseServer> <ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/> <RedundancyNetworkLicenseServer ServerAddress="backupserver" ProtocolType="TCP/IP" EndPointName="1025"/> </LocalLicenseServer> Pour le serveur de licences de secours : <LocalLicenseServer> <ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/> <RedundancyNetworkLicenseServer ServerAddress="mainserver" ProtocolType="TCP/IP" EndPointName="1025"/> </LocalLicenseServer> |
Si vous devez utiliser cette configuration, assurez-vous que votre licence la prend en charge. Pour en savoir plus, contactez votre responsable commercial.
Les paramètres du service de licence situé sur le même ordinateur.
ConnectionProtocol
Complex Type.
Attributs :
ProtocolType — le type de protocole. Pour
Linux, spécifiez toujours le protocole Sockets. Pour
Windows : LocalInterprocessCommunication,
NamedPipes, TCP/IP ou Sockets.
Sous Windows, il s’agit d’un type de protocole supplémentaire pour le
service de licence local. Il n’est pas nécessaire de spécifier cet attribut
pour une installation autonome, car les licences autonomes utilisent toujours
le type de protocole LocalInterprocessCommunication.
EndPointName — (facultatif) numéro de port. Par défaut,
« 3022 ».
0…1
LocalLicenseServer
Les paramètres du protocole de connexion.
OnlineLicensing
Complex Type.
Attributs :
Timeout — (facultatif)spécifie la période de reconnexion
Actuellement, le seul protocole pris en charge pour la connexion via un
serveur proxy est HTTP. Vous pouvez spécifier les attributs suivants :
ProxyServer — (facultatif) l’adresse du serveur proxy
et les paramètres de connexion, sous la forme d’une chaîne «
protocol://server:port », où les sous-chaînes
correspondent à :
protocol — le protocole utilisé pour se connecter au serveur
proxy. Actuellement, la seule valeur prise en charge est HTTP.
server — le nom ou l’adresse IP du serveur proxy.
port — le port de connexion.
ProxyAuth — (facultatif) authentification auprès d’un serveur
proxy sous la forme d’une chaîne « login:password »,
où les sous-chaînes correspondent à :
login — le nom d’utilisateur pour l’authentification.
password — le mot de passe pour l’authentification.
0…1
LocalLicenseServer
Indique si les licences en ligne peuvent être utilisées sur l’ordinateur.
RedundancyNetwork LicenseServer
NetworkServerAddress.
Attributs :
ServerAddress — le nom DNS ou l’adresse IP d’un autre
serveur dans la configuration redondante.
ProtocolType — le type de protocole. Pour
Linux : spécifiez toujours le protocole Sockets. Pour
Windows : LocalInterprocessCommunication,
NamedPipes, TCP/IP ou Sockets.
EndPointName — (facultatif) numéro de port. Par défaut,
« 3022 ».
0…1
LocalLicenseServer
Définit les paramètres de connexion à un autre serveur et de
synchronisation avec celui-ci pour chacun des serveurs de licences réseau
fonctionnant ensemble dans une configuration redondante à deux serveurs.
LicensingServers
Complex Type.
Éléments :
MainNetworkLicenseServer
BackupNetworkLicenseServer
0…1
LicensingSettings
La liste des serveurs réseau sur lesquels le service de licence est installé.
MainNetworkLicense Server
NetworkServerAddress.
Attributs :
ServerAddress — le nom DNS ou l’adresse IP de l’ordinateur
sur lequel le service de licence est installé.
ProtocolType — le type de protocole. Pour
Linux : spécifiez toujours le protocole Sockets. Pour
Windows: LocalInterprocessCommunication,
NamedPipes, TCP/IP, or Sockets.
EndPointName — (facultatif) numéro de port. Par défaut,
“3022”.
1
LicensingServers
Les paramètres de connexion au serveur réseau principal sur lequel
le service de licence est installé.
BackupNetwork LicenseServer
NetworkServerAddress.
Attributes:
ServerAddress — le nom DNS ou l’adresse IP de l’ordinateur
sur lequel le service de licence est installé.
ProtocolType — le type de protocole. Pour
Linux, spécifiez toujours le protocole Sockets. Pour
Windows : LocalInterprocessCommunication,
NamedPipes, TCP/IP ou Sockets.
EndPointName — (facultatif) numéro de port. Par défaut,
“3022”.
0…1
LicensingServers
Les paramètres de connexion au serveur de licence réseau de secours.
LicensesFolder
Type complexe.
Attributs :
Path - le chemin d’accès à un dossier contenant les informations de licence.
Par défaut, “%ProgramData%\ABBYY\SDK\12\Licenses”. Les autorisations de contrôle total sur un dossier de données de licence :
obligatoires pour le dossier situé sur le serveur de licence
facultatives pour le dossier situé sur les postes de travail
0…1
LicensingSettings
Indique l’emplacement de stockage du dossier contenant les informations auxiliaires relatives à la licence.
ProxyServer
ProxyServer.
Attributs :
Server — l’adresse du serveur proxy et les paramètres de connexion, sous forme de chaîne “protocol://server:port”,
où les sous-chaînes ont la signification suivante :
protocol —
le protocole utilisé pour se connecter au serveur proxy : SOCKS5
ou HTTP.
server — le nom ou l’adresse IP du serveur proxy.
port — le port de connexion.
Login — (facultatif) le nom d’utilisateur pour l’authentification.
Password — (facultatif) le mot de passe pour l’authentification.
0…1
LicensingSettings
Les paramètres de connexion Internet via un serveur proxy, requis pour
l’activation de la licence.
Cette balise est implémentée sous Linux uniquement.
L’exemple ci-dessous présente un fichier simple LicensingSettings.xml pour une installation autonome. Sous Windows, la communication interprocessus locale est utilisée.
Les exemples ci-dessous présentent de simples fichiers LicensingSettings.xml pour une installation réseau : un fichier pour les postes de travail et un fichier pour le serveur. Le service de licence est installé sur l’ordinateur nommé “computername”. Sous Windows, le protocole TCP/IP est utilisé pour la communication entre le serveur et les postes de travail.Pour un poste de travail :
