TOTVS | License Server 2014

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

controle das licenas de uso dos softwares e aplicaes TOTVS Status do Produo
documento
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 Data 31/07/2014
contrato firmado entre o cliente e a TOTVS.
Verso 1.0
Cada instancia do License Server identifica uma instalao fsica vinculada ao contrato de Verso 1.0
licenciamento do cliente. Para maximizar o uso do licenciamento TOTVS, recomenda-se a anterior
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 Autores Eduardo
License Server, ser necessrio o registro da diviso das licenas do contrato entre as instalaes Perusso Riera
fsicas.
Ivan Pinheiro
Cabral
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 Bruno Lopes
falhas de hardware, software e energia, cujo objetivo manter os servios disponibilizados o Malafaia
mximo de tempo possvel. Para garantir a ausncia de interrupes de servio necessrio,
muitas vezes, dispor de hardware redundante que entre em funcionamento automaticamente Diogo Damiani
quando da falha de um dos componentes em utilizao, provocando a interrupo momentnea do Ferreira
servio durante a troca (Hot Swap).
Allan Rodrigo
Leite

Instaladores ftp://ftp.totvs.co
Requisitos de Sistema m.br/hlcloud/In
staladores/
Esta recomendao tem fins meramente de avaliao e de planejamento de implementao, para
uma instalao com at 500 conexes simultneas. ndice resumido

Requisitos de Sistema
Instalao do License Server
Componente Requisito Operao do TOTVS | License
Server
Processador Mnimo: 1 GHz Recomendado: 2 GHz
Ideal: 3 GHz ou mais veloz.
ndice
Observao: No utilizar um processador
menor que o recomendado pelo fabricante do 1 Requisitos de Sistema
sistema operacional. 2 Instalao do License Server
2.1 Instalao
Memria Mnimo: 2 GB de RAM (livre do sistema 2.2 Instalao Linux
operacional) 2.3 Configurao
Recomendado: 4 GB de RAM 2.4 Configurao por arquivo
(licenseserverinstall.ini)
Espao disponvel em disco Mnimo: 1GB (livre) Recomendado: 10 GB 2.5 Configurao em HA:Alta
(considerando crescimento do banco de Disponibilidade
dados temporrio). Os componentes do 2.6 Virtualizao
software requerem menos de 500kb 3 Operao do TOTVS |
License Server
Acesso internet O TOTVS | License Server necessita de 3.1 Monitoramento
acesso internet para sua instalao e 3.2 Histrico de Consumo
operao. 3.3 Atualizando manualmente
O Acesso realizado atravs do protocolo as Licenas
HTTPS/FTP e toda a comunicao feita 3.4 Notificaes por email
pela porta 443/21. Caso a sua empresa
possua firewall e/ou restries de acesso
internet, necessrio que o administrador da Notas de Requisitos
rede libere o acesso para o endereo https://li Release implementado
censeservercloud.totvs.com.br/. O tipo de s
conexo realizada outbound ( O License
Serve realiza uma chamada cliente a um 1.01.001 Verso de
servidor na Internet ) . Beta teste

1.01.002 Correo
de bugs de
travament
o
Java O instalador do License Server 2014 precisa 1.01.003 Correo
de um ambiente de execuo Java (JRE) de bugs de
para funcionar adequadamente. A mxima travament
verso suportada a 7.0. Caso voc no o
possua o JRE instalado, faa o download em
http://www.oracle.com/technetwork/pt/java/jav 1.01.004 Verso de
ase/downloads/jre7-downloads-1880261.html expedio
para
clientes
aps o
termino do
periodo de
Sistema Operacional Verso beta

Microsoft Windows Server 2008 Enterprise 1.01.005 Correo

Windows Server 2008 R2 Enterprise na
Windows Server 2012 Standard atualiza
o
Novell SUSE Linux Enterprise Server 9 automatica
(x86/x86_64) via ftp
SUSE Linux Enterprise Server 10 seguro.
(x86/x86_64) Para
SUSE Linux Enterprise Server 11 alguns
(x86/x86_64) ambientes
identificou-
Red Hat Red Hat Enterprise Linux 5.4 Server se que
(x86) ocorreia
Red Hat Enterprise Linux 5.5 Server um erro de
(x86/x86_64) socket.
Red Hat Enterprise Linux 6.1 Server Melhori
(x86_64)
a de
desemp
enho do
Monitor
Linha de Software Verso Data de Liberao Observao
1.01.006 Implementao
Microsiga Protheus 11.x e posteriores Setembro/2014 Necessita atualizar o
de notificaes
pacote de Lib de (atual) por e-mail.
Setembro/2014 ou
superior

RM 11.82.36 e Setembro/2014
posteriores;

11.83.55 e
posteriores;

Logix 11.5 pacote 6 Setembro/2014 Para os clientes que

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

Datasul 11.5.14 e posteriores Novembro/2014

12.1.2 e posteriores

Datasul ( TSA, 12.1.3 *Fevereiro/2015 previso

Planning e BI)

SARA n/d * *em analise

Fluig 1.4 Outubro/2014

ECM n/d * *em analise

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
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 ht
tp://tdn.totvs.com/pages/viewpage.action?pageId=172298980 que traz toda a documentao
necessria.

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 trata-se 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.

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 o TOTVS 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 licenseserverinstal
l.ini, conforme abaixo e adicione a pasta "appserver". Note que os dados preenchidos no arquivo
de configurao licenseserverinstall.ini, so os mesmos solicitados na interface original de
instalao.

licenseserverinstall.ini Expand
[licenseserver]
source
TotvsId= ;;Informe o TotvsId solicitado pela
interface
LsEnv=1 ;;Informe 1 para Produo; 2 para Homologao e
3 para Desenvolvimento
LsAlias= ;;Informe um nome para identificar o License
Server no Portal do Cliente
LocalId= ;;Informe o Cdigo de Instalao da instalao
padro se este for uma instalao de HA.

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
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 "Est
a 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.

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 Mov
e da Virtual Machine estas informaes sejam alteradas. Caso isto acontea o servio de
licenciamento ir ser interrompido sem aviso prvio.

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.

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 e-mail 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 appser
ver.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.