Este tópico se aplica ao FRE para Linux e Windows.
O arquivo LicensingSettings.xml contém as configurações de proteção do ABBYY FineReader Engine. Esse arquivo é exigido pelo Licensing Service (obrigatório) quando você usa uma licença de rede com qualquer tipo de proteção ou uma licença autônoma com proteção online.O arquivo é gerado automaticamente durante a instalação do Developer ou do Runtime no modo automático. Tanto na instalação em rede quanto na instalação autônoma, esse arquivo é gerado em dois locais:Linux:
pasta Bin e
pasta CommonBin/Licensing na pasta de instalação
Windows:
%CommonProgramFiles(x86)%\ABBYY\SDK\12\Licensing\
<Pasta de instalação>\Bin64\ (se disponível)
<Pasta de instalação>\Bin\ (se disponível)
Na instalação manual, você precisará criar esse arquivo e especificar nele as configurações corretas. No Linux, crie o arquivo nas duas pastas listadas acima. No Windows, crie o arquivo na pasta Bin(Bin64).O esquema XML das configurações do Licensing Service está descrito no arquivo LicensingSettings.xsd. Você pode encontrar esse arquivo na pasta Inc.
As configurações do Licensing Service incluem duas partes principais:
As configurações do Licensing Service instalado no computador atual, especificadas na tag <LocalLicenseServer>.
Os parâmetros de conexão com o servidor de rede em que o Licensing Service está instalado. Esses parâmetros são especificados na tag <LicensingServers><MainNetworkLicenseServer>.
Se o ABBYY FineReader Engine estiver instalado em um computador local, você deverá especificar as configurações somente em <LocalLicenseServer>, se necessário. Por outro lado, se o ABBYY FineReader Engine funcionar em rede, os parâmetros de <LocalLicenseServer> deverão ser especificados no servidor, e os parâmetros de <LicensingServers><MainNetworkLicenseServer>, nas estações de trabalho. Se um computador for usado tanto como servidor quanto como estação de trabalho, deverão ser especificados os parâmetros de <LocalLicenseServer> e de <LicensingServers><MainNetworkLicenseServer>. Consulte as descrições das tags abaixo para mais detalhes.
ProtocolType é Sockets no Linux e TCP/IP no Windows.
Detalhes
| O Licensing Service usa a porta 3022 por padrão. Se essa porta estiver fechada no computador em que o Licensing Service está instalado, ele não funcionará. Nesse caso, especifique uma porta aberta no atributo EndPointName da tag <LocalLicenseServer> ou da tag <LicensingServers><MainNetworkLicenseServer>, por exemplo: <LocalLicenseServer> <ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/> </LocalLicenseServer> ou <LicensingServers> <MainNetworkLicenseServer ServerAddress="computername" ProtocolType="TCP/IP" EndPointName="1025"/> </LicensingServers> |
Se você precisar ativar uma licença quando sua máquina estiver conectada à Internet via um servidor proxy, especifique os parâmetros de conexão na tag <ProxyServer>.Os protocolos compatíveis são SOCKS5 e HTTP. Para HTTP, você pode usar autenticação básica ou nenhuma autenticação; para SOCKS, nome de usuário/senha ou nenhuma autenticação.Aqui está um arquivo de exemplo para ativação via servidor proxy:
Uma Licença Online não exige nenhuma configuração especial, mas, para se conectar por meio de um servidor proxy, você deve especificar os parâmetros dele na tag <OnlineLicensing>.O protocolo compatível é HTTP, para o qual você pode usar os esquemas de autenticação Anonymous, Basic ou Digest.Aqui está um arquivo de exemplo com as configurações do servidor proxy para a Licença Online:
Por padrão, o ABBYY FineReader Engine armazena as informações auxiliares sobre licenciamento em %ProgramData%\ABBYY\SDK\12\Licenses. Para definir outra pasta, especifique o atributo Path na tag <LicensesFolder>. As permissões de controle total para uma pasta de dados de licença são:
obrigatórias para a pasta localizada no servidor de licenças
opcionais para a pasta localizada nas estações de trabalho
Você também pode usar a função InitializeEngine para redefinir a pasta de dados de licença.
Os caminhos de LicenseFolder mostrados no exemplo são para Windows. No Linux, os caminhos são /home/user/workstation_logs_folder e /home/user/server_logs_folder, respectivamente.
Detalhes
| Para a estação de trabalho: <LicensingServers> ... </LicensingServers> <LicensesFolder Path="path_to_workstation_logs_folder"/> Para o servidor de licenças: <LocalLicenseServer> ... </LocalLicenseServer> <LicensesFolder Path="path_to_server_logs_folder"/> |
Configurando uma configuração redundante de servidor de licenças
Para licenças distribuídas pela rede, você pode configurar uma estrutura com dois servidores, permitindo que um deles atue como backup do outro caso ele fique offline. Para isso, você precisará de uma única licença Runtime Network de um tipo especial com suporte a redundância habilitado.
Nos servidores:
A mesma licença deve ser ativada tanto no servidor principal quanto no servidor de backup.
Cada servidor deve especificar o endereço do outro na tag <LocalLicenseServer><RedundancyNetworkLicenseServer>.
Nas estações de trabalho:
Todas as estações de trabalho devem especificar os endereços de ambos os servidores nas tags <LicensingServers><MainNetworkLicenseServer> e <LicensingServers><BackupNetworkLicenseServer>.
Ao usar a licença, as estações de trabalho se comunicarão com o servidor de licenças principal, enviando a ele os parâmetros da licença e as estatísticas de uso. O servidor de licenças principal sincronizará esses dados regularmente com o servidor de backup. Se o servidor de licenças principal falhar, o servidor de backup assumirá o gerenciamento das licenças e continuará armazenando as informações recebidas das estações de trabalho.Observe que o servidor de backup deixará de fornecer licenças após um determinado tempo limite. Esse tempo limite é especificado nas configurações internas da licença e pode variar de 4 a 5000 horas. Para se reconectar ao servidor de licenças principal quando ele voltar a ficar online, reinicie o processamento com o Engine (desinicialize e inicialize novamente).Se o servidor de licenças de backup falhar enquanto o servidor principal estiver funcionando, o sistema continuará operando como se houvesse apenas um servidor de licenças. Quando o servidor de backup for restaurado, ele será sincronizado com o servidor principal e voltará a funcionar como backup.Para atualizar a licença após a expiração em ambos os servidores:
Desligue qualquer um dos dois servidores.
Atualize a licença no servidor disponível.
Desligue o servidor com a licença atualizada.
Ligue o servidor que foi desligado anteriormente.
Atualize a licença no servidor disponível.
Restaure a conexão entre os servidores ligando-os.
Reinicie o Licensing Service em ambos os servidores para atualizar as configurações da licença.
Veja abaixo um exemplo de configuração de redundância para estações de trabalho e servidores.
No Windows, o protocolo TCP/IP é usado para a comunicação entre o servidor e as estações de trabalho.
Detalhes
| Para a estação de trabalho: <LicensingServers> <MainNetworkLicenseServer ServerAddress="mainserver" ProtocolType="TCP/IP" EndPointName="1025"/> <BackupNetworkLicenseServer ServerAddress="backupserver" ProtocolType="TCP/IP" EndPointName="1025"/> </LicensingServers> Para o servidor de licenças principal: <LocalLicenseServer> <ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/> <RedundancyNetworkLicenseServer ServerAddress="backupserver" ProtocolType="TCP/IP" EndPointName="1025"/> </LocalLicenseServer> Para o servidor de licenças de backup: <LocalLicenseServer> <ConnectionProtocol ProtocolType="TCP/IP" EndPointName="1025"/> <RedundancyNetworkLicenseServer ServerAddress="mainserver" ProtocolType="TCP/IP" EndPointName="1025"/> </LocalLicenseServer> |
Se você precisar usar essa configuração, verifique se sua licença oferece suporte a ela. Entre em contato com seu gerente de vendas para obter mais informações.
Os parâmetros do Licensing Service localizado no mesmo computador.
ConnectionProtocol
Tipo Complexo.
Atributos:
ProtocolType — o tipo de protocolo. Para
Linux, sempre especifique o protocolo Sockets. Para
Windows: LocalInterprocessCommunication,
NamedPipes, TCP/IP ou Sockets.
No Windows, este é um tipo de protocolo adicional para o Licensing Service local.
Não é necessário especificar este atributo em uma instalação standalone,
pois as licenças Standalone sempre utilizam o tipo de protocolo LocalInterprocessCommunication.
EndPointName — (opcional) número da porta. Por padrão,
“3022”.
0…1
LocalLicenseServer
Os parâmetros do protocolo de conexão.
OnlineLicensing
Tipo Complexo.
Atributos:
Timeout — (opcional)especifica o período de reconexão
Atualmente, o único protocolo suportado para conexão via servidor proxy
é o HTTP, para o qual é possível especificar os seguintes atributos:
ProxyServer — (opcional) o endereço do servidor proxy
e as configurações de conexão, como uma string ”
protocol://server:port”, onde os significados das substrings são:
protocol — o protocolo utilizado para conectar ao servidor proxy.
Atualmente, o único valor suportado é HTTP.
server — o nome ou endereço IP do servidor proxy.
port — a porta de conexão.
ProxyAuth — (opcional) autenticação em um servidor proxy como
uma string “login:password”, onde os significados das substrings são:
login — o nome de usuário para autenticação.
password — a senha para autenticação.
0…1
LocalLicenseServer
Especifica se as licenças online podem ser utilizadas no computador.
RedundancyNetwork LicenseServer
NetworkServerAddress.
Atributos:
ServerAddress — o nome DNS ou endereço IP de outro
servidor na configuração redundante.
ProtocolType — o tipo de protocolo. Para
Linux: sempre especifique o protocolo Sockets. Para
Windows: LocalInterprocessCommunication,
NamedPipes, TCP/IP ou Sockets.
EndPointName — (opcional) número da porta. Por padrão,
“3022”.
0…1
LocalLicenseServer
Especifica as configurações de conexão a outro servidor e
sincronização com ele para cada um dos servidores de licença de rede que
operam em conjunto em uma configuração redundante de dois servidores.
LicensingServers
Tipo Complexo.
Elementos:
MainNetworkLicenseServer
BackupNetworkLicenseServer
0…1
LicensingSettings
A lista de servidores de rede onde o Licensing Service está instalado.
MainNetworkLicense Server
NetworkServerAddress.
Atributos:
ServerAddress — o nome DNS ou endereço IP do computador
onde o Licensing Service está instalado.
ProtocolType — o tipo de protocolo. Para
Linux : sempre especifique o protocolo Sockets. Para
Windows: LocalInterprocessCommunication,
NamedPipes, TCP/IP, ou Sockets.
EndPointName — (opcional) número da porta. Por padrão,
“3022”.
1
LicensingServers
Os parâmetros de conexão com o servidor de rede principal onde
o Licensing Service está instalado.
BackupNetwork LicenseServer
NetworkServerAddress.
Attributes:
ServerAddress — o nome DNS ou endereço IP do computador
onde o Licensing Service está instalado.
ProtocolType — o tipo de protocolo. Para
Linux, especifique sempre o protocolo Sockets. Para
Windows: LocalInterprocessCommunication,
NamedPipes, TCP/IP, ou Sockets.
EndPointName — (opcional) número da porta. Por padrão,
“3022”.
0…1
LicensingServers
Os parâmetros de conexão com o servidor de licença de rede de backup.
LicensesFolder
Complex Type.
Attributes:
Path - o caminho para uma pasta com as informações de licenciamento.
Por padrão, “%ProgramData%\ABBYY\SDK\12\Licenses”. As permissões de controle total sobre a pasta de dados de licença:
obrigatórias para a pasta localizada no servidor de licença
opcionais para a pasta localizada nas estações de trabalho
0…1
LicensingSettings
Especifica onde deve ser armazenada uma pasta com informações auxiliares sobre licenciamento.
ProxyServer
ProxyServer.
Attributes:
Server — o endereço do servidor proxy e as configurações de conexão,
como uma string “protocol://server:port”,
onde o significado de cada substring é:
protocol —
o protocolo utilizado para conectar ao servidor proxy: SOCKS5
ou HTTP.
server — o nome ou endereço IP do servidor proxy.
port — a porta de conexão.
Login — (opcional) o nome de usuário para autenticação.
Password — (opcional) a senha para autenticação.
0…1
LicensingSettings
As configurações de conexão à Internet via servidor proxy, necessárias para
a ativação da licença.
O exemplo abaixo mostra um arquivo LicensingSettings.xml simples para uma instalação autônoma. No Windows, é usada a comunicação local entre processos.
Os exemplos abaixo mostram arquivos LicensingSettings.xml simples para uma instalação em rede: um arquivo para estações de trabalho e outro para um servidor. O Licensing Service está localizado no computador chamado “computername”. No Windows, o protocolo TCP/IP é usado na comunicação entre o servidor e as estações de trabalho.Para uma estação de trabalho:
