Questo argomento si applica a FRE per Linux e Windows.
Il file LicensingSettings.xml contiene le impostazioni di protezione di ABBYY FineReader Engine. Questo file è richiesto dal Licensing Service (obbligatorio) quando si utilizza una licenza di rete con qualsiasi tipo di protezione o una licenza standalone con protezione online.Il file viene generato automaticamente durante l’installazione Developer o Runtime in modalità automatica. Sia per l’installazione di rete sia per quella standalone, questo file viene generato in due percorsi:Linux:
nelle cartelle Bin e
CommonBin/Licensing della cartella di installazione
Windows:
%CommonProgramFiles(x86)%\ABBYY\SDK\12\Licensing\
<Cartella di installazione>\Bin64\ (se disponibile)
<Cartella di installazione>\Bin\ (se disponibile)
In caso di installazione manuale, sarà necessario creare questo file e specificarvi le impostazioni corrette. In Linux, creare il file in entrambe le cartelle sopra elencate. In Windows, creare il file nella cartella Bin(Bin64).Lo schema XML delle impostazioni del Licensing Service è descritto nel file LicensingSettings.xsd. Questo file si trova nella cartella Inc.
Le impostazioni del Licensing Service comprendono due parti principali:
Le impostazioni del Licensing Service installato sul computer corrente, specificate nel tag <LocalLicenseServer>.
I parametri di connessione al server di rete su cui è installato il Licensing Service. Questi parametri sono specificati nel tag <LicensingServers><MainNetworkLicenseServer>.
Se ABBYY FineReader Engine è installato su un computer locale, è necessario specificare le impostazioni solo in <LocalLicenseServer>, se necessario. Se invece ABBYY FineReader Engine viene eseguito in rete, i parametri <LocalLicenseServer> vengono specificati sul server, mentre i parametri <LicensingServers><MainNetworkLicenseServer> sulle workstation. Se un computer viene utilizzato sia come server sia come workstation, devono essere specificati sia i parametri <LocalLicenseServer> sia quelli di <LicensingServers><MainNetworkLicenseServer>. Per ulteriori dettagli, consulta le descrizioni dei tag riportate di seguito.
In Linux, ProtocolType è Sockets; in Windows, TCP/IP.
Dettagli
| Per impostazione predefinita, il Licensing Service utilizza la porta 3022. Se questa porta è chiusa sul computer in cui è installato il Licensing Service, il Licensing Service non funzionerà. In questo caso, specifica una porta aperta nell’attributo EndPointName del tag <LocalLicenseServer> o <LicensingServers><MainNetworkLicenseServer>, ad esempio: <LocalLicenseServer> <ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/> </LocalLicenseServer> oppure <LicensingServers> <MainNetworkLicenseServer ServerAddress="computername" ProtocolType="TCP/IP" EndPointName="1025"/> </LicensingServers> |
Attivazione della licenza tramite un server proxy - Linux
Se devi attivare una licenza quando il computer è connesso a Internet tramite un server proxy, specifica i parametri di connessione nel tag <ProxyServer>.I protocolli supportati sono SOCKS5 e HTTP. Per HTTP, puoi usare l’autenticazione di base oppure nessuna autenticazione; per SOCKS, nome utente/password oppure nessuna autenticazione.Di seguito è riportato un file di esempio per l’attivazione tramite un server proxy:
Una licenza online non richiede impostazioni particolari, ma per connettersi tramite un server proxy è necessario specificarne i parametri nel tag <OnlineLicensing>.Il protocollo supportato è HTTP, per il quale è possibile usare gli schemi di autenticazione Anonymous, Basic o Digest.Di seguito è riportato un file di esempio con le impostazioni del server proxy per la gestione delle licenze online:
Per impostazione predefinita, ABBYY FineReader Engine archivia le informazioni ausiliarie sulla gestione delle licenze in %ProgramData%\ABBYY\SDK\12\Licenses. Per impostare un’altra cartella, specificare l’attributo Path nel tag <LicensesFolder>. Le autorizzazioni di controllo completo per la cartella dei dati di licenza sono:
richieste per la cartella situata sul server di licenze
facoltative per la cartella situata sulle workstation
È inoltre possibile usare la funzione InitializeEngine per ridefinire la cartella dei dati di licenza.
I percorsi di LicenseFolder mostrati nell’esempio sono per Windows. I percorsi Linux sono rispettivamente /home/user/workstation_logs_folder e /home/user/server_logs_folder.
Dettagli
| Per la workstation: <LicensingServers> ... </LicensingServers> <LicensesFolder Path="path_to_workstation_logs_folder"/> Per il server di licenze: <LocalLicenseServer> ... </LocalLicenseServer> <LicensesFolder Path="path_to_server_logs_folder"/> |
Per le licenze distribuite in rete, è possibile configurare una configurazione a due server che consente a uno dei server di fungere da backup dell’altro in caso di indisponibilità. Per farlo, è necessaria una singola Runtime License Network di un tipo speciale con il supporto della ridondanza abilitato.
Sui server:
La stessa licenza deve essere attivata sia sul server principale che su quello di backup.
Ciascun server deve specificare l’indirizzo dell’altro nel tag <LocalLicenseServer><RedundancyNetworkLicenseServer>.
Sulle workstation:
Tutte le workstation devono specificare gli indirizzi di entrambi i server nei tag <LicensingServers><MainNetworkLicenseServer> e <LicensingServers><BackupNetworkLicenseServer>.
Durante l’uso della licenza, le workstation interagiscono con il server di licenze principale, inviandogli i parametri della licenza e le statistiche di utilizzo. Il server di licenze principale sincronizza regolarmente questi dati con il server di backup. Se il server di licenze principale non è disponibile, il server di backup subentra nella gestione delle licenze e continua a memorizzare le informazioni provenienti dalle workstation.Si noti che il server di backup smetterà di fornire licenze dopo un determinato timeout. Questo timeout è specificato nelle impostazioni interne della licenza e può variare da 4 a 5000 ore. Per riconnettersi al server di licenze principale quando torna online, riavviare l’elaborazione con Engine (deinizializzare e inizializzare nuovamente).Se il server di licenze di backup non è disponibile mentre il server principale è operativo, il sistema continuerà a funzionare come se fosse presente un solo server di licenze. Quando il server di backup viene ripristinato, verrà sincronizzato con il server principale e riprenderà a funzionare come backup.Per aggiornare la licenza dopo la scadenza su entrambi i server:
Spegnere uno dei due server.
Aggiornare la licenza sul server disponibile.
Spegnere il server con la licenza aggiornata.
Accendere il server precedentemente spento.
Aggiornare la licenza sul server disponibile.
Ripristinare la connessione tra i server accendendoli.
Riavviare il Licensing Service su entrambi i server per aggiornare le impostazioni della licenza.
Di seguito è riportato un esempio di configurazione della ridondanza per workstation e server.
In Windows, per la comunicazione tra il server e le workstation viene utilizzato il protocollo TCP/IP.
Dettagli
| Per la workstation: <LicensingServers> <MainNetworkLicenseServer ServerAddress="mainserver" ProtocolType="TCP/IP" EndPointName="1025"/> <BackupNetworkLicenseServer ServerAddress="backupserver" ProtocolType="TCP/IP" EndPointName="1025"/> </LicensingServers> Per il server di licenze principale: <LocalLicenseServer> <ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/> <RedundancyNetworkLicenseServer ServerAddress="backupserver" ProtocolType="TCP/IP" EndPointName="1025"/> </LocalLicenseServer> Per il server di licenze di backup: <LocalLicenseServer> <ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/> <RedundancyNetworkLicenseServer ServerAddress="mainserver" ProtocolType="TCP/IP" EndPointName="1025"/> </LocalLicenseServer> |
Se è necessario utilizzare questa configurazione, assicurarsi che la licenza la supporti. Per maggiori informazioni, contattare il proprio responsabile commerciale.
I parametri del Servizio di Licenza situato sullo stesso computer.
ConnectionProtocol
Complex Type.
Attributi:
ProtocolType — il tipo di protocollo. Per
Linux, specificare sempre il protocollo Sockets. Per
Windows: LocalInterprocessCommunication,
NamedPipes, TCP/IP, o Sockets.
In Windows, questo è un tipo di protocollo aggiuntivo per il Servizio di Licenza locale.
Non è necessario specificare questo attributo per un’installazione standalone,
poiché le licenze Standalone vengono sempre utilizzate con il tipo di protocollo
LocalInterprocessCommunication.
EndPointName — (facoltativo) numero di porta. Per impostazione predefinita,
“3022”.
0…1
LocalLicenseServer
I parametri del protocollo di connessione.
OnlineLicensing
Complex Type.
Attributi:
Timeout — (facoltativo)specifica il periodo di riconnessione
Attualmente l’unico protocollo supportato per la connessione tramite server
proxy è HTTP, per il quale è possibile specificare i seguenti attributi:
ProxyServer — (facoltativo) l’indirizzo del server proxy
e le impostazioni di connessione, come stringa ”
protocol://server:port”, dove le sottostringhe hanno il seguente significato:
protocol — il protocollo utilizzato per connettersi al server
proxy. Attualmente l’unico valore supportato è HTTP.
server — il nome o l’indirizzo IP del server proxy.
port — la porta di connessione.
ProxyAuth — (facoltativo) autenticazione a un server proxy come
stringa “login:password”, dove le sottostringhe hanno il seguente significato:
login — il nome utente per l’autenticazione.
password — la password per l’autenticazione.
0…1
LocalLicenseServer
Specifica se le licenze online possono essere utilizzate sul computer.
RedundancyNetwork LicenseServer
NetworkServerAddress.
Attributi:
ServerAddress — il nome DNS o l’indirizzo IP di un altro
server nella configurazione ridondante.
ProtocolType — il tipo di protocollo. Per
Linux: specificare sempre il protocollo Sockets. Per
Windows: LocalInterprocessCommunication,
NamedPipes, TCP/IP, o Sockets.
EndPointName — (facoltativo) numero di porta. Per impostazione predefinita,
“3022”.
0…1
LocalLicenseServer
Specifica le impostazioni di connessione a un altro server e
la sincronizzazione con esso per ciascuno dei server di licenza di rete che
lavorano insieme in una configurazione ridondante a due server.
LicensingServers
Complex Type.
Elementi:
MainNetworkLicenseServer
BackupNetworkLicenseServer
0…1
LicensingSettings
L’elenco dei server di rete in cui è installato il Servizio di Licenza.
MainNetworkLicense Server
NetworkServerAddress.
Attributi:
ServerAddress — il nome DNS o l’indirizzo IP del computer
in cui è installato il Servizio di Licenza.
ProtocolType — il tipo di protocollo. Per
Linux : specificare sempre il protocollo Sockets. Per
Windows: LocalInterprocessCommunication,
NamedPipes, TCP/IP o Sockets.
EndPointName — (facoltativo) numero di porta. Per impostazione predefinita,
“3022”.
1
LicensingServers
I parametri della connessione al server di rete principale in cui
è installato il servizio di gestione delle licenze.
BackupNetwork LicenseServer
NetworkServerAddress.
Attributes:
ServerAddress — il nome DNS o l’indirizzo IP del computer
in cui è installato il servizio di gestione delle licenze.
ProtocolType — il tipo di protocollo. Per
Linux, specificare sempre il protocollo Sockets. Per
Windows: LocalInterprocessCommunication,
NamedPipes, TCP/IP o Sockets.
EndPointName — (facoltativo) numero di porta. Per impostazione predefinita,
“3022”.
0…1
LicensingServers
I parametri della connessione al server licenze di rete di backup.
LicensesFolder
Tipo complesso.
Attributi:
Path - il percorso della cartella contenente le informazioni sulla gestione delle licenze.
Per impostazione predefinita, “%ProgramData%\ABBYY\SDK\12\Licenses”. Le autorizzazioni di controllo completo sulla cartella dei dati di licenza sono:
obbligatorie per la cartella situata sul server licenze
facoltative per la cartella situata sulle workstation
0…1
LicensingSettings
Specifica dove archiviare la cartella contenente le informazioni ausiliarie sulla gestione delle licenze.
ProxyServer
ProxyServer.
Attributi:
Server — l’indirizzo del server proxy e le impostazioni di connessione,
come stringa “protocol://server:port”,
dove le sottostringhe hanno il seguente significato:
protocol —
il protocollo utilizzato per connettersi al server proxy: SOCKS5
o HTTP.
server — il nome o l’indirizzo IP del server proxy.
port — la porta di connessione.
Login — (facoltativo) il nome utente per l’autenticazione.
Password — (facoltativo) la password per l’autenticazione.
0…1
LicensingSettings
Le impostazioni della connessione Internet tramite server proxy, necessarie per
l’attivazione della licenza.
L’esempio seguente mostra un semplice file LicensingSettings.xml per un’installazione stand-alone. In Windows viene utilizzata la comunicazione locale tra processi.
Gli esempi seguenti mostrano semplici file LicensingSettings.xml per un’installazione di rete: un file per le workstation e un file per il server. Il Licensing Service è installato sul computer denominato “computername”. In Windows, per la comunicazione tra il server e le workstation viene utilizzato il protocollo TCP/IP.Per una workstation:
