TOTVS | License Server 2014

License Server um recurso computacional da TOTVS que tm como objetivo realizar o

controle das licenas de uso dos softwares e aplicaes TOTVS
Atravs deste recurso possvel prover de forma eficiente e segura as licenas e
liberaes de utilizao de mdulos e/ou funcionalidades das aplicaes TOTVS em
conformidade com o contrato firmado entre o cliente e a TOTVS.
Cada instancia do License Server identifica uma instalao fsica vinculada ao contrato de
licenciamento do cliente. Para maximizar o uso do licenciamento TOTVS, recomenda-se a
utilizao de uma nica instancia do License Server, independentemente do ambiente de
operao (Produo, Homologao e Teste). Caso opte-se por mais de uma instalao
fsica do License Server, ser necessrio o registro da diviso das licenas do contrato
entre as instalaes fsicas.
O License Server foi projetado para permitir uma configurao em alta disponibilidade do
servio e virtualizao. Um sistema de alta disponibilidade (HA:High-Availability) um
sistema resistente a falhas de hardware, software e energia, cujo objetivo manter os
servios disponibilizados o mximo de tempo possvel. Para garantir a ausncia de
interrupes de servio necessrio, muitas vezes, dispor de hardware redundante que
entre em funcionamento automaticamente quando da falha de um dos componentes em
utilizao, provocando a interrupo momentnea do servio durante a troca (Hot Swap).

Requisitos de Sistema
Esta recomendao tem fins meramente de avaliao e de planejamento de
implementao, para uma instalao com at 500 conexes simultneas.

Component
e

Requisito

Processador

Mnimo: 1 GHz Recomendado: 2 GHz Ideal: 3 GHz ou mais

veloz.
Observao: No utilizar um processador menor que o
recomendado pelo fabricante do sistema operacional.

Memria

Mnimo: 2 GB de RAM (livre do sistema operacional)

Recomendado: 4 GB de RAM

Espao
disponvel
em disco

Mnimo: 1GB (livre) Recomendado: 10 GB (considerando

crescimento do banco de dados temporrio). Os componentes do
software requerem menos de 500kb

Component
e

Requisito

Acesso
internet

O TOTVS | License Server necessita de acesso internet para sua

instalao e operao.
O Acesso realizado atravs do protocolo HTTPS/FTP e toda a
comunicao feita pela porta 443/21. Caso a sua empresa possua
firewall e/ou restries de acesso internet, necessrio que o
administrador da rede libere o acesso para o
endereohttps://licenseservercloud.totvs.com.br/. O tipo de conexo
realizada outbound ( O License Serve realiza uma chamada
cliente a um servidor na Internet ) .
Em medies de nosso laboratrio, para enviarmos um log gerado
por 500 usurios e com 7 dias de gargalo de envio, foi necessrio
uma conexo que entregasse 50Kb de Upload e Donwload para
realizar toda a operao.
A operao de atualizao da licena, consegue operar com uma
conexo que entregue 10Kb de Upload e Download.

Java

O instalador do License Server 2014 precisa de um ambiente de

execuo Java (JRE) para funcionar adequadamente. A mxima
verso suportada a 7.0. Caso voc no possua o JRE instalado,
faa o download
emhttp://www.oracle.com/technetwork/pt/java/javase/downloads/jre
7-downloads-1880261.html

Sistema Operacional

Verso

Microsoft

Windows Server 2008 Enterprise

Windows Server 2008 R2 Enterprise

Windows Server 2012 Standard

SUSE Linux Enterprise Server 9 (x86/x86_64)

SUSE Linux Enterprise Server 10 (x86/x86_64)

SUSE Linux Enterprise Server 11 (x86/x86_64)

Novell

Sistema Operacional

Verso

Red Hat

Red Hat Enterprise Linux 5.4 Server (x86)

Red Hat Enterprise Linux 5.5 Server
(x86/x86_64)

Linha de
Software

Verso

Red Hat Enterprise Linux 6.1 Server (x86_64)

Data de
Liberao

Observao
Necessita atualizar o pacote
de Lib de Setembro/2014 ou
superior

Microsiga
Protheus**

11.x e
posteriores

Setembro/2014

RM**

11.82.36 e
posteriores;

Setembro/2014

11.83.55 e
posteriores;

Logix**

11.5 pacote 6

Setembro/2014

Datasul**

11.5.14 e
posteriores

Novembro/2014

Para os clientes que esto no

pacote 5 est disponvel uma
liberao especial a partir de
30/09.

12.1.2 e
posteriores
BI Datasul

12.1.4

Abril/2015

Update 17 de 10/04/15

BI Logix

12.1.5

Junho/2015

Update 02/2015 de 19/06/15

Planning

12.1.4

Abril/2015

Update 15 de 22/05/15

SARA

12.1.9

Junho/2015

Fluig

1.4

Outubro/2014

ECM

3.0.46

Maro/2015

**Em breve estar disponvel uma nova verso do License Server 2014 com suporte as
verses anteriores dos ERPs TOTVS que utilizam o License Server com hardlock fsico.

Instalao do License Server

Instalao
O instalador do TOTVS | License Server pode ser obtido no link Instaladores desta pgina
(no canto superior direito) ou no Portal do Cliente, para maiores informaes, consulte o
Guia de Relacionamento e suporte.
De posse do arquivo de instalao, execute o arquivo e selecione o Idioma de instalao,
conforme mostra a figura abaixo:

Aps selecionar o idioma, ser apresentada a tela abaixo:

Prosseguindo ser exibido o EULA do software TOTVS, estando de acordo, prossiga a

instalao.

O instalador do TOTVS | License Server sugere um diretrio padro de instalao, que

pode ser alterado pelo usurio sem prejuzo de uso.

Prosseguindo, apresentado as informaes do espao requerido para a instalao.

Lembre-se que o TOTVS | License Server possui um banco de dados temporrio ir
requerer mais espao que o apresentado na instalao. Para maiores informaes,
consulte o captulo Requisitos do Sistema.

A prxima tela ser apresentada as portas de operao do TOTVS | License Server. As

porta do Servidor de Log e do Servio de Licenciamento precisam estar disponvel para os
demais servidores da TOTVS, pois estas portas so utilizadas por eles para conexo com
esta instalao.

Notas
Icon
O TOTVS | License Server permite a instalao no mesmo hardware. Caso seja
necessrio, altere as portas de monitoramento/manuteno e do servio de licenciamento.

Na tela seguinte ser incio o processo de instalao do TOTVS | License Server, aguarde
o termino.

Aps o termino da instalao ser apresentada uma tela para a criao do atalho da
interface de monitoramento do TOTVS | License Server.

Por ltimo, ser executado o Monitor do TOTVS | License Server, onde o mesmo dever
ser configurado.
Os componentes instalados do TOTVS | License Server so:

Servio de Licenciamento - TOTVS | License Server. Este servio instalado

automaticamente e colocado em modo automtico de inicializao. Caso seja necessrio,
deve-se alterar a conta do usurio de Logon do Servio.

Atalho da interface de monitoramento do TOTVS | License Server.

Instalao Linux
Para instalar o TOTVS | License Server no Linux voc poder precisar de algumas
bibliotecas adicionais do Sistema Operacional Linux, por isto recomenda-se a instalao
em modo console.
Caso o Servidor do TOTVS | License Server no execute automaticamente, v at o
diretrio de instalao/totvs/totvslicenseserver/bin/appserver e digete os seguintes
comandos:

ulimit -s 1024

ulimit -n 65536

./appsrvlinux -console
Caso o monitor do TOTVS | License no inicie automaticamente, tente inicia-lo via
terminal. Ele estar instalado no seguinte diretrio: /totvs/totvslicense/bin/monitor. Para
executa-lo, basta informar./smartclient

Configurao
A configurao do TOTVS | License Server realizada, logo aps o termino na instalao.
Se por algum motivo, no for possvel se conectar a TOTVS. A configurao poder ser
realizada pelo atalho de monitoramento que foi criado durante o processo de instalao.
Para configurar o TOTVS | License Server ser necessrio que o servidor tenha acesso
internet. O Acesso realizado atravs do protocolo HTTPS e toda a comunicao feita
pela porta 443. Caso a sua empresa possua firewall e/ou restries de acesso internet,
necessrio que o administrador da rede libere o
endereo https://licenseservercloud.totvs.com.br/, para comunicao. O trafego ocorrer
uma vez por dia no horrio configurado pela TOTVS, durante uma janela de 15 minutos.
Caso o acesso seja interrompido por mais de 7 dias, a autorizao de uso do sistema
expirar e os usurios e/ou administradores dos software TOTVS sero notificados no
Login do sistema, por mais 15 dias. Aps este prazo, o sistema no estar mais disponvel.
Ao iniciar o monitor do TOTVS | License Server, ser exibida uma tela de boas vindas e na
tela seguinte, ser solicitado o TOTVS Id.

O TOTVS Id a identificao do contrato do cliente. Para obter este nmero, o cliente

dever acessar o Portal do Cliente atravs do link
http://suporte.totvs.com/gestaodelicencas e aceitar os termos de uso - EULA. O passo
seguinte gerar o TOTVS Id (1 ou mais se for o caso). Em caso de duvida em relao
utilizao do Portal do Cliente quanto ao uso de licenas, consulte o
link http://tdn.totvs.com/pages/viewpage.action?pageId=172298980 que traz toda a
documentao necessria.
Icon

O Site fornece mais duas opes. Na aba Licenas caso o cliente possua mais de uma
instalao de License Server, o administrador poder fazer a distribuio de suas licenas
em cada uma das instalaes. Na aba mensagens, ele poder obter informaes sobre a
situao de seu contrato.

O cdigo de instalao um nmero gerado automaticamente com base em diversas

informaes do hardware em que o aplicativo foi instalado.
Muita ateno neste momento pois frequentemente o cdigo de instalao gerado em
outra maquina ao invs do servidor utilizado pelo License Server acarretando no
liberao da instalao. Isto ocorre pelo fato das informaes de hardware serem
diferentes.

A caixa de marcao deve ser utilizada para indicar ao servio de licenciamento que tratase de uma instalao de HA:Alta Disponibilidade e a instalao primaria estar ativa. Ao
deixar marcada esta opo, voc dever informar o cdigo de instalao da primeira
instalao em vez de utilizar a sugesto fornecida.
Na tela seguinte, sero solicitados o Nome e o Ambiente de operao do aplicativo. O
Nome um texto livre para ser identificado facilmente a instalao pelo cliente no Portal do
Cliente. O ambiente a identificao da natureza de uso do aplicativo.

Terminada a parametrizao do aplicativo, ser exibida uma tela para confirmao dos
dados, conforme abaixo.

Confirmando os dados o aplicativo ir enviar os dados para TOTVS e receber a

autorizao de uso do sistema, que ser renovada diariamente.
Apesar do License Server estar instalado, recomendamos a leitura dos itens abaixo,
principalmente do tpico Plano de Recuperao de Desastres.

Configurao por arquivo (licenseserverinstall.ini)

Este tpico fornece uma viso geral da tarefa de configura o TOTVS | License Server
atravs de um arquivo de configurao. Este formato de configurao, pode ser utilizado
em ambientes onde o sistema operacional no possui interface ou possui restrio de
interface.
Para instalar o TOTVS | License Server, siga os passos informado acima at o item
"Configurao" em um sistema operacional que no tenha restrio de interface e
interrompa o processo, assim que for solicitado oTOTVS Id . Para efeitos didaticos, vamos
chamar esta instalao de A.
Faa uma cpia do diretrio de instalao, para o hardware que possui a restrio, para
efeitos didaticos, vamos chamar esta instalao de B. Crie o arquivo de
configurao licenseserverinstall.ini, conforme abaixo e adicione a pasta "appserver".
Note que os dados preenchidos no arquivo de configuraolicenseserverinstall.ini, so
os mesmos solicitados na interface original de instalao.
licenseserverinstall.ini Expand source
Configure para o License Server para ser executado em modo de servio, utilizando o
seguinte comando no shell do sistema operacional:
appserver -install

Este comando deve ser executado na pasta appserver.

Inicialize o servio e o TOTVS | License Server ser configurado automaticamente. Em

caso de duvidas, sobre a efetividade da instalao, consulte o arquivo console.log da
pasta appserver.
Retorne instalao A e altere a chave server do arquivo smartclient.ini para o IP ou
DNS da instalao B. Acesse o cone do monitor criado automaticamente pelo instalador e
confirme as licenas do sistema.

Configurao em HA:Alta Disponibilidade

Este tpico fornece uma viso geral da tarefa de configurar o TOTVS | License Server em
um ambiente de HA:Alta disponibilidade. A abordagem sobre como configurar um ambiente
de Alta Disponibilidade na faz parte deste escopo.

Um ambiente de alta disponibilidade (HA:High-Availability) um sistema resistente a falhas

de hardware e software, cujo objetivo manter os servios disponibilizados o mximo de
tempo possvel.

O TOTVS | License Server, dependendo da misso do sistema, da disponibilidade ou

confiabilidade para o negcio, pode ser considerado como um SPOF. Um ponto nico de
falha (Single Point Of Failure) uma parte de um sistema que, se falhar, vai parar todo o
sistema. Para garantir a ausncia de interrupes de servio necessrio, dispr de
hardware redundante que entre em funcionamento automaticamente quando da falha de
um dos componentes em utilizao.
Importante
Icon
O TOTVS | License Server no pode ser o nico componente em alta disponibilidade. Ele
somente deve ser configurado em alta disponibilidade se todos os componentes de
software e hardware envolvidos no sistema esto configurados em alta disponibilidade,
caso contrrio a configurao no ter efeito prtico.

A configurao em alta disponibilidade pode ser realizada atravs da redundncia total do

hardware. Neste modelo, faz-se necessrio a instalao do TOTVS | License Server em
ambos os hardwares. Neste modelo de configurao do servio, ser necessrio vincular
ambas as instalaes de forma que o servio reconhea a mesma autorizao de uso,
para isto siga os passos de instalao do License Server e quando for solicitado o TOTVS
Id, marque a opo "Esta a segunda instalao de um ambiente de alta
disponibilidade?", informe o TOTVS Id e Cdigo de Instalao da instalao padro
(primeira instalao) e finalize a configurao.

No existe a necessidade de que ambos os hardware sejam iguais, porm ambos devem
ter acesso Internet, caso contrrio o sistema no ir operar adequadamente.

Adicionamento a configurao do servio TOTVS | License Server, o ambiente de alta

disponibilidade dever garantir que o acesso do Software TOTVS ao servio seja feito pelo
mesmo IP e Porta, no necessitando nenhuma reconfigurao dos Softwares TOTVS.

O TOTVS | License Server, no permite que ambas as instalaes recebem conexes do

Software TOTVS, impedindo qualquer tentativa de alternncia das requisies entre os
ambientes, contudo, ambos os ambientes recebem a autorizao de uso diariamente.

Icon
O License Server no ir operar em um ambiente de HA se no for realizada a
configurao mencionada acima. Realizar a configurao do ambiente de HA apenas
utilizando Cluster/Redes Sans ir provocar a interrupo do servio em caso de falha, uma
vez que o License Server utiliza informaes do hardware fsico/Virtual para operar.

Virtualizao
Este tpico fornece uma viso geral da tarefa de configurar o TOTVS | License Server em
um ambiente virtualizado. A abordagem sobre como configurar um ambiente virtualizado
na faz parte deste escopo.

O TOTVS | License possui um sistema de segurana de ultima gerao que

constantemente reavaliado e atualizado. A Virtual Machine necessita de algumas
configuraes especificas para o pleno funcionamento do TOTVS | License Server.

A Virtual Machine deve ser configurada de modo que no permita duplicao do nmero
serial BIOS UUID, duplicao do MacAddress dos adaptadores de Rede ou que numa
operao de Move da Virtual Machine estas informaes sejam alteradas. Caso isto
acontea o servio de licenciamento ir ser interrompido sem aviso prvio.
Icon
Alguns HyperVisor, por padro, alteram as informao de BIOS UUID a cada inicializao
da Virtual Machine. Verifique com o fornecedor como fazer para fixar o valor.

Quando efetuar qualquer manuteno na Virtual Machine, tenha certeza que nenhum
placa de rede foi removida e que a porta do License Server no foi alterada, caso isto
acontea o servio de licenciamento ir ser interrompido.

Operao do TOTVS | License Server

Ao acessar a interface do License Server, a primeira vista podemos ver duas separaes:

Monitoramento: onde possvel analisar a utilizao das licenas em tempo real;

Histrico de Consumo: onde so apresentadas informaes de consumo e uso de

acordo com o tempo.
As informaes exibidas no monitor do License Server so atualizadas de acordo com o
tempo configurado na parte superior direita da interface. L possvel estabelecer o
intervalo ou solicitar a atualizao manualmente.
Para acessar o monitor do License Server, execute atalho 'TOTVS License Monitor' criado
na instalao do sistema.

Monitoramento
O objetivo do monitoramento fornecer todas as informaes referentes a utilizao das
licenas do contrato para qual o License Server foi instalado.
Na parte superior do monitoramento so exibidos trs indicadores de uso, sendo eles:

Conexes em uso: apresentao de grfico para exibir Licenas consumidas e

Licenas abonadas;

Licenas Full TOTVS: relao entre Licenas Full disponveis e Licenas Full em
uso;

Licenas Light TOTVS: tambm exibe a relao entre disponibilidade e uso, s que
das Licenas Light TOTVS.
J na parte inferior, na seo Viso Geral, so apresentadas as informaes como:

Uso das Licenas: a lista de licenas apresentada com as informaes referente

ao total disponvel, licenas em uso, percentual de consumo e validade;

Licenas por CNPJ: exibe o consumo de licenas corporativas apresentando, por

empresa, quantas licenas esto em uso e quantas foram abonadas;

Conexes: apresenta todas as conexes ativas no License Server.

Histrico de Consumo
O histrico de consumo relaciona as informaes histricas de uso do License Server.
Nesta viso possvel visualizar:

Licenas concorrentes: exibe o histrico de concorrncia da licena selecionada,

fazendo o comparativo entre licenas disponveis e pico de uso;

Conexes: Apresenta a relao entre quantidade de licenas utilizadas X licenas

negadas. Isso para verificar o volume de uso de cada licena selecionada;

Usurios: esta viso contem todas as conexes de usurios, apresentando

informaes como licena utilizada, rotina acessada, tempo de uso, entre outras.

Atualizando manualmente as Licenas

O License Server permite a atualizar manual do licenciamento TOTVS.
Para realizar a atualizao manual do licenciamento TOTVS, clique no boto indicado na
figura abaixo que fica no topo superior direito do monitor do sistema.

Ao pressionar este boto, o sistema automaticamente ir se conectar na TOTVS e

atualizar as licenas com base no contrato TOTVS.
Icon
Utilize esta opo, sempre que realizar a distribuio, manuteno e ou aquisio de
licenas junto a TOTVS. Esta opo ir acelerar o processo de atualizao das licenas
com base nas modificaes que voc realizou no Portal do Cliente. Caso no seja
realizado, a atualizao ocorrer durante o horario pr-estabelecido pela TOTVS.

Notificaes por email

O License Server permite a notificao de alguns eventos por e-mail..
Para configurao a notificao License Server, clique no boto indicado na figura abaixo
que fica no topo superior direito do monitor do sistema.

A seguinte interface ir aparecer:

1.

Preencha a conta de e-mail que dever receber as notificaes do License Server.

2.

Preencha o endereo do Servidor de e-mail (SMTP).

3.

Preencha a conta do usurio de conexo com o Servidor de e-mail.

4.

Preencha a senha da conta do usurio de conexo com o Servidor de e-mail.

5.

Informe se o tipo de negociao com o Servidor de e-mail do tipo Autenticado.

6.

Informe se a conexo com o Servidor de e-mail criptografada (SSL).

7.

Informe se a conexo com o Servidor de e-mail criptografada (TLS).

As notificaes disponveis no License Server so:
Notificao de atualizao da autorizao de uso. O License Server ir enviar um email toda vez que o License Server receber uma atualizao de licenciamento, tanto

manualmente como automaticamente. A falta do recebimento desta notificao, pode

indicar um problema na conexo do License Server com o servidores da TOTVS.
Notificao de contingncia. O License Server ir enviar diariamente um e-mail 15 dias
antes da expirao do prazo da licena. Recomendamos que esta opo esteja sempre
habilitada. Caso ocorra uma atualizao da autorizao de uso, o e-mail ser cancelado.
Notificao de atualizao automtica. O License Server ir enviar uma aviso, toda vez
que ocorrer uma atualizao do Servio License Server. As atualizaes do License Server
ocorrem em intervalos no programados. A cada atualizao o sistema guarda um backup
das 5 ultimas atualizaes do License Server e deixam no diretrio <path de
instalao>\TOTVSLicense\data\apo. Para reverter uma instalao, basta alterar o
arquivo appserver.ini, chave SourcePath, indicando o path da instalao anterior. que
fica no mesmo diretrio <path de instalao>\TOTVSLicense\data\apo, porm com uma
data cronologica inferior.

Plano de Recuperao de desastre

O plano de recuperao de desastres composto, por procedimentos, que devero ser
aplicados sempre que ocorrer uma falha devido a alguma inconsistncia provocada em
virtude de ameaas externa ou falhas de tecnologia. Apesar do Plano de Recuperao de
Desastre ser composto por 3 programas ( Administrao de Crise, Continuidade
Operacional e Recuperao de Desastres ), nos focaremos no programa de Recuperao
de Desastre que a aplicao na prtica para a continuidade operacional do ERP.
O tempo mdio de soluo foi calculado com base em profissionais que j tinha exercitado
algum dos procedimentos abaixo anteriormente. Portanto, recomendamos que aps a
instalao do License Server, o plano seja analisado e treinado.

Ocorrncia

Plano de Recuperao

Tempo
mdio

Perda fisica do
hardware onde 1.
Instalar uma nova verso do License
esta hospedado o
Server em outro hardware que esteja disponvel.
License Server
2.
Bloquear o TOTVSId da instalao atual
no site da TOTVS, conforme o Guia de Gesto
de Licenas (Guia Gesto de Licenas TOTVS)

1 Hora

3.

Seguir os procedimentos de instalao

listados acima

4.

Caso tenha mais de um License Server,

lembre-se de fazer a distribuio manual das
licenas, conforme o manual (Guia Gesto de

Ocorrncia

Plano de Recuperao

Tempo
mdio

Licenas TOTVS#gestao-de-licencas)
5.

Realizar a atualizao manual das

Licenas.

6.

Conferir se as licenas foram atualizadas

corretamente.

7.

Parametrizar o ERP para o novo License

Server, conforme documentao do ERP.

License Server
sem licenas ou 1.
Acesar o Portal do Cliente e verificar se o
com licenciamento TOTVSid no foi bloqueado por engano (Guia
errado.
Gesto de Licenas TOTVS).
a.

Caso esteja bloqueado,

desbloqueie e faa a atualizao manual das
licenas.

b.

Se no estiver bloqueado, conferia

a distribuio das licenas. Em caso de
problemas com a distribuio, realize a
distribuio novamente e faa a atualizao
manual das licenas.

c.

Se o problema persistir, siga o

procedimento 2

2.

Acesse o diretrio de instalao do

License Server e a pasta
\data\licenseagreement\Backup.

a.

Pegue o diretrio que julgar conter

o backup ideal de seu licenciamento, em caso de
duvida, pegue o mais velho.

b.

copie o arquivo para o

diretrio \data\licenseagreement\

c.
d.

Reinice o License Server

Acesse o monitor do License
Server e verifique se as licenas foram

30
minutos

Ocorrncia

Plano de Recuperao

Tempo
mdio

restauradas.
e.

Nenhum dos
procedimentos
anteriores resolveu

Contacte a TOTVS para

regularizao definitiva do problema.
Acesse o Portal do cliente e obtenha um arquivo
de emergncia que dever ser aplicado no ERP
conforme manual. Com este arquivo, voc ter
tempo de contactar os profissionais da TOTVS
para solucionar os problemas.

15
minutos