22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

TOTVS License Server Virtual

Tempo aproximado para leitura: superior a 15 minutos

License Server é um recurso computacional da TOTVS que têm como objetivo realizar o controle das
Status do Produção
licenças de uso dos softwares e aplicações TOTVS. Através deste recurso é possível prover de forma
documento
eficiente e segura as licenças e liberações de utilização de módulos e/ou funcionalidades das aplicações
TOTVS em conformidade com o contrato firmado entre o cliente e a TOTVS.
Data 31/07/2014

Cada instância do License Server identifica uma instalação física vinculada ao contrato de licenciamento Versão 3.5.0
do cliente. Para maximizar o uso do licenciamento TOTVS, recomenda-se a utilização de uma única
instância do License Server, independentemente do ambiente de operação (Produção, Homologação e Versão 3.4.3
Teste). Caso opte-se por mais de uma instalação física do License Server, será necessário o registro da anterior
divisão das licenças do contrato entre as instalações físicas.
Autores @ Eduardo Perusso Rie

O License Server foi projetado para permitir uma configuração em alta disponibilidade do serviço e @ Ivan Pinheiro Cabral
virtualização. Um sistema de alta disponibilidade (HA:High-Availability) é um sistema resistente a falhas
@ Bruno Lopes Malafa
de hardware, software e energia, cujo objetivo é manter os serviços disponibilizados o máximo de tempo
possível. Para garantir a ausência de interrupções de serviço é necessário, muitas vezes, dispor de @ Diogo Damiani Ferre
hardware redundante que entre em funcionamento automaticamente quando da falha de um dos
componentes em utilização, provocando a interrupção momentânea do serviço durante a troca (Hot @ Allan Rodrigo Leite
Swap).
@ Joao Paulo De Souz

Instaladores Windows
A TOTVS recomenda que seus cliente tenham um Plano de Recuperação de desastre (Disaster Recovery
Plan), que contenha os procedimentos para permitir a recuperação ou continuação da infraestrutura de Linux
tecnologia de nossos softwares, na sequência de um desastre. Neste manual você irá encontrar nossa
recomendação de plano. É imprescindível que o cliente conheça e simule a execução de nossas FAQ FAQ - TOTVS License S
recomendações.
Versões Release notes

Download https://suporte.totvs.com
Requisitos de Sistema e=1022352#000067/LS0

Esta recomendação tem fins meramente de avaliação e de planejamento de implementação, para uma
Índice resumido
instalação com até 500 conexões simultâneas.
Requisitos de Sistema
Instalação do License Server
Componente Requisito Operação do TOTVS | License
Server
Processador • Mínimo: 1 GHz • Recomendado: 2 GHz • Ideal: 3 GHz ou mais veloz. Plano de Recuperação de
Desastre
Observação: Não utilizar um processador menor que o recomendado pelo
Atualização do License Server
fabricante do sistema operacional.

Memória • Mínimo: 2 GB de RAM (livre do sistema operacional) Índice

• Recomendado: 4 GB de RAM
1 Requisitos de Sistema
Espaço • Mínimo: 1GB (livre)• Recomendado: 10GB (considerando crescimento do banco 2 Instalação do License Server
disponível em de dados temporário). Os componentes do software requerem menos de 500MB. 2.1 Instalação Windows
disco
2.2 Instalação Linux
2.3 Configuração
Acesso à O TOTVS | License Server necessita de acesso à internet para sua instalação e
2.4 Configuração por arquivo
internet operação.
O Acesso é realizado através do protocolo HTTPS e toda a comunicação é feita (licenseserverinstall.ini)
pela porta 443. Caso a sua empresa possua firewall e/ou restrições de acesso à 2.5 Configuração em HA:Alta
internet, é necessário que o administrador da rede libere o acesso para o Disponibilidade
endereço https://lscloud.totvs.app/api/ (Este é o endereço base dos serviços do 2.6 Virtualização
License Server). O tipo de conexão realizada é outbound (O License Server 2.7 Utilização do modelo FCI -
realiza uma chamada cliente a um servidor na Internet). Failover Cluster Instance
3 Operação do TOTVS | License
É possível executar a ferramenta HTTPANALYSER (disponível a partir da versão Server
1.03.016 do License Server) para verificar se o servidor onde o License Server 3.1 Monitoramento
será instalado está com a comunicação liberada com a Totvs. Maiores detalhes
3.2 Histórico de Consumo
sobre a ferramenta no link:
3.3 Botões da Interface
HTTPANALYSER - Validação de Comunicação com a Web
3.4 Uso do WebApp - Acesso ao
Monitor pelo Navegador
4 Plano de Recuperação de
 Aviso: Desastre
Utilize sempre o endereço DNS https://lscloud.totvs.app/api. A utilização
5 Atualização do License Server
do seu respectivo endereço IP pode causar interrupção na atualização
diária das licenças caso a Totvs altere o endereço IP. Isso não fará com
que o LS Virtual pare de funcionar de imediato, mas pela perda de
comunicação diária, passará a exibir a mensagem de expiração da licença

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 1/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

Componente Requisito
e obrigará uma intervenção manual de troca do IP ou alteração para o
DNS (lscloud.totvs.app/api) na regra do seu servidor.

Em medições de nosso laboratório, para enviarmos um log gerado por 500

usuários e com 7 dias de gargalo de envio, foi necessária uma conexão que
entregasse 50Kb de Upload e Download para realizar toda a operação.
A operação de atualização da licença, consegue operar com uma conexão que
entregue 10Kb de Upload e Download.

Java O instalador do License Server precisa de um ambiente de execução Java (JRE)

para funcionar adequadamente. As versões atualmente suportadas são a 7 e a 8.
Caso você não possua o JRE instalado, faça o download em
https://www.java.com/pt_BR/download/manual.jsp

Sistemas Operacionais Homologados

Segue abaixo link com todas as versões de sistemas operacionais homologados para o License
Server:
https://tdn.totvs.com/pages/viewpage.action?pageId=452690307

Linha de Versão Data de Observação

Software Liberação

Microsiga 11.x e Setembro/2014 Necessita atualizar o pacote de Lib de

Protheus** posteriores Setembro/2014 ou superior

RM** 11.20 até Setembro/2014 Versão mínima do LS Virtual: 1.02.009

12.1.34

RM 12.1.2306 Junho/2023 Versão mínima do LS 3.5.0

Logix** 11.5 pacote 6 Setembro/2014 Para os clientes que estão no pacote 5

está disponível uma liberação especial
a partir de 30/09.

Datasul*** 11.5.14 e Novembro/2014

posteriores
12.1.2 e
posteriores
EMS 206, EMS
506 e HCM 210

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 Março/2015

PIMS MC 12.1.7 Outubro/2015

(Multicultivo)

PIMS CS (Cana) 12.1.6 Agosto/2015 Liberação para uso sob consulta.

** O suporte às versões anteriores dos ERPs TOTVS que utilizam o License Server com hardlock físico é
permitido a partir da versão 1.02.007 do LS para ambientes de base históricas, permitindo o uso de um
único License Server. Entende-se por base histórica os ambientes de ERP que possuem uso esporádico.
*** Para utilização do License Server Virtual, todas as versões homologadas para uso em bases
históricas na linha Datasul estão descritas no quadro acima. Para ambientes em versões inferiores,

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 2/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN
mantém-se apenas o suporte ao License Server com hardlock físico, quando compatível.

Instalação do License Server

Instalação Windows
O instalador do TOTVS | License Server pode ser obtido no link Windows -
https://suporte.totvs.com/portal/p/10098/download?e=1022351 e Linux -
https://suporte.totvs.com/portal/p/10098/download?e=1022352 desta página (no canto superior direito),
para maiores informações, consulte o Guia de Relacionamento e Suporte.

 Importante:
A versão atual do License Server solicita Usuário e Senha para acessar o Monitor de Licenças.
O usuário inicial padrão é Admin com a senha em branco. Recomendamos alterar a senha do
Admin no primeiro acesso.

De posse do arquivo de instalação, execute o arquivo e selecione o idioma de instalação, conforme

mostra a figura abaixo:

Após selecionar o idioma, será apresentada a tela abaixo:

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 3/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

Prosseguindo será exibido o EULA do software TOTVS. Estando de acordo, prossiga a instalação.

O instalador do TOTVS | License Server sugere um diretório padrão de instalação, que pode ser alterado
pelo usuário sem prejuízo de uso.

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 4/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

Prosseguindo, são apresentadas as informações do espaço requerido para a instalação. Lembre-se que
o TOTVS | License Server possui um banco de dados temporário que irá requerer mais espaço que o
apresentado na instalação. Para maiores informações, consulte o capítulo Requisitos do Sistema.

Na tela seguinte, é apresentada uma informação referente a numeração automática.

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 5/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

Na próxima tela serão apresentadas as portas de operação do TOTVS | License Server. As portas
precisam estar disponíveis para os demais servidores da TOTVS, pois estas portas são utilizadas por
eles para conexão com esta instalação.

Porta de Monitoramento/Manutenção: porta utilizada para o Smartclient do Monitor de Licenças

se comunicar com o Servidor do License Server
Porta do Serviço de Licenciamento: porta utilizada para comunicação dos Servidores de
Aplicação (ERPs) com o Servidor do License Server
Nome de demonstração serviço de Monitoramento/Manutenção: nome que aparece na
listagem de serviços do Sistema Operacional
Nome do serviço de Monitoramento/Manutenção: nome interno para controle do S.O.
Porta do SmartClient HTML: porta utilizada no navegador para acessar o Monitor de Licenças via
WebApp

 Notas
O TOTVS | License Server permite a instalação no mesmo hardware. Caso seja necessário,
altere todas as portas nas instalações subsequentes.

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 6/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

Na tela seguinte terá início o processo de instalação do TOTVS | License Server, aguarde o término.

Após o termino da instalação será apresentada uma tela para a criação 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 são:
Serviço de Licenciamento - TOTVS | License Server. Este serviço é instalado automaticamente e
colocado em modo automático de inicialização. Caso seja necessário, deve-se alterar a conta do
usuário de Logon do Serviço.
Atalho da interface de monitoramento do TOTVS | License Server.

Instalação 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 instalação em modo console.
1. Baixe os arquivos do portal: https://suporte.totvs.com/portal/p/10098/download?e=1022352

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 7/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN
2. Execute o script install da pasta baixada
bash install

3. Será exibido o Termo e Condições do Software, pressione ENTER para continuar ou X para encerrar
(sair)

4. Vá pressionando ENTER para continuar a exibir as páginas do termo

5 . Pressione 1 e ENTER para Aceitar o termo de uso

6. Selecione o diretório base de instalação, onde será descompactado toda a estrutura do License
Server.

Caso não seja passado nenhum caminho será descompactado no diretório onde foi executado o
instalador
7. Caso seja exibido a mensagem The directory already exists and is not empty! Are you sure you
want to install here and delete all existing files?

Selecione 1 para aceitar apagar os arquivos no diretório selecionado no passo 6 .

8. Em seguida Pressione 1 e ENTER para continuar

9. No próximo passo pressione 1 e ENTER para continuar

10. Neste passo será solicitado a porta de execução do License Server, porta TCP do serviço.

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 8/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

Caso deseje alguma porta diferente da porta padrão 2234, pode digitar o número da porta e pressionar
ENTER ou pressione ENTER para prosseguir com a porta padrão.
11. Neste próximo passo será solicitado a porta do LogClient

Se desejar a porta padrão (4000) pressione ENTER, senão digite o número da porta e pressione ENTER
12. Neste passo será solicitado a porta de comunicação do License Server, está porta será utilizada para
a requisição das licenças entre as aplicações

Se desejar a porta padrão (5555) pressione ENTER, senão digite o número da porta e pressione ENTER.
13. Neste passo será solicitado o nome do serviço que será configurado para o License Server.

Se desejar o nome padrão pressione ENTER, senão digite o nome do serviço desejado e pressione
ENTER

14. Neste passo será solicitado a confirmação para gravar todas as configurações realizadas

Se estiver tudo certo pressione 1 e ENTER para prosseguir, senão digite 2 para encerrar
15. Neste ponto são impressos todos os passos da descompactação da estrutura do License Server e o
processo é finalizado

Caso o Servidor do TOTVS | License Server não execute automaticamente, vá até o diretório de
instalação /totvs/totvslicenseserver/bin/appserver e digite os seguintes comandos:
ulimit -s 1024
ulimit -n 65536
./appsrvlinux
Caso o monitor do TOTVS | License não inicie automaticamente, tente inicia-lo via terminal. Ele estará
instalado no seguinte diretório: /totvs/totvslicense/bin/monitor. Para executa-lo, basta
informar ./smartclient

Configuração
A configuração do TOTVS | License Server é realizada logo após o termino da instalação. Se por algum
motivo não for possível se conectar à TOTVS, a configuração poderá ser realizada posteriormente pelo
atalho de monitoramento que foi criado durante o processo de instalação.

Para configurar o TOTVS | License Server será necessário que o servidor tenha acesso à internet. O
Acesso é realizado através do protocolo HTTPS e toda a comunicação é feita pela porta 443. Caso a sua
empresa possua firewall e/ou restrições de acesso à internet, é necessário que o administrador da rede
libere o endereço https://lscloud.totvs.app/api/, para comunicação. O trafego ocorrerá uma vez por dia no

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 9/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN
horário configurado pela TOTVS, durante uma janela de 15 minutos. Caso o acesso seja interrompido por
mais de 15 dias, a autorização de uso do sistema expirará e os usuários e/ou administradores dos
software TOTVS serão notificados no Login do sistema, por mais 15 dias. Após este prazo, o sistema não
estará mais disponível.

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 identificação do contrato do cliente. Para obter este número, o cliente deverá acessar o
Portal do Cliente através 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 relação à
utilização do Portal do Cliente quanto ao uso de licenças, consulte o
link http://tdn.totvs.com/pages/viewpage.action?pageId=172298980 que traz toda a documentação
necessária.

 O Site fornece mais duas opções. Na aba Licenças caso o cliente possua mais de uma instalação
de License Server, o administrador poderá fazer a distribuição de suas licenças em cada uma das
instalações. Na aba mensagens, ele poderá obter informações sobre a situação de seu contrato.

O código de instalação é uma sequencia de caracteres gerada automaticamente com base em diversas
informações do hardware em que o aplicativo foi instalado.
Muita atenção neste momento pois frequentemente o código de instalação é gerado em outra maquina
ao invés do servidor utilizado pelo License Server, acarretando a não liberação da instalação. Isto ocorre
pelo fato das informações de hardware serem diferentes.

A caixa de marcação deve ser utilizada para indicar ao serviço de licenciamento que trata-se de uma
instalação de HA:Alta Disponibilidade e a instalação primária estar ativa. Ao deixar marcada esta opção,
você deverá informar o código de instalação da primeira instalação em vez de utilizar a sugestão
fornecida.

Na tela seguinte, serão solicitados o Nome e o Ambiente de operação do aplicativo. O Nome é um texto
livre para ser identificada facilmente a instalação pelo cliente no Portal do Cliente. O ambiente é a
identificação da natureza de uso do aplicativo.

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 10/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

Terminada a parametrização do aplicativo, será exibida uma tela para confirmação dos dados, conforme
abaixo.

Confirmando os dados o aplicativo irá enviar os dados para a TOTVS e receber a autorização de uso do
sistema, que será renovada diariamente.
Apesar do License Server estar instalado, recomendamos a leitura dos itens abaixo, principalmente do
tópico Plano de Recuperação de Desastres.

Configuração por arquivo (licenseserverinstall.ini)

Este tópico fornece uma visão geral da tarefa de configurar o TOTVS | License Server através de um
arquivo de configuração. Este formato de configuração pode ser utilizado em ambientes onde o sistema
operacional não possui interface ou possui restrição de interface.
Para instalar o TOTVS | License Server, siga os passos informados acima até o item "Configuração" em
um sistema operacional que não tenha restrição de interface e interrompa o processo assim que for
solicitado o TOTVS Id . Para efeitos didáticos, vamos chamar esta instalação de A.
Faça uma cópia do diretório de instalação, para o hardware que possui a restrição, para efeitos didáticos,
vamos chamar esta instalação de B. Crie o arquivo de configuração licenseserverinstall.ini, conforme
abaixo e adicione a pasta "appserver". Note que os dados preenchidos no arquivo de
configuração licenseserverinstall.ini, são os mesmos solicitados na interface original de instalação.

licenseserverinstall.ini Expandir origem

Configure o License Server para ser executado em modo de serviço, utilizando o seguinte comando no
shell do sistema operacional:

appserver -install

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 11/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN
Este comando deve ser executado na pasta appserver.
Inicialize o serviço e o TOTVS | License Server será configurado automaticamente. Em caso de dúvidas,
sobre a efetividade da instalação, consulte o arquivo console.log da pasta appserver.
Retorne à instalação A e altere a chave server do arquivo smartclient.ini para o IP ou DNS da
instalação B. Acesse o ícone do monitor criado automaticamente pelo instalador e confirme as licenças
do sistema.

Configuração em HA:Alta Disponibilidade

Este tópico fornece uma visão 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 não
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 serviços disponibilizados o máximo de tempo possível.

O TOTVS | License Server, dependendo da missão do sistema, da disponibilidade ou confiabilidade para

o negócio, 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 ausência de
interrupções de serviço é necessário dispor de hardware redundante que entre em funcionamento
automaticamente quando da falha de um dos componentes em utilização.

 Importante
O TOTVS | License Server não 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 estão configurados em alta disponibilidade, caso contrário a
configuração não terá efeito prático.

A configuração em alta disponibilidade pode ser realizada através da redundância total do hardware.
Neste modelo, faz-se necessário a instalação do TOTVS | License Server em ambos os hardwares. Neste
modelo de configuração do serviço, será necessário vincular ambas as instalações de forma que o
serviço reconheça a mesma autorização de uso.

Após já ter a instalação principal do License Server funcionando, seguem abaixo os passos para
configurar a segunda instalação:
No segundo hardware, que é o hardware de redundância, faça uma instalação normal do License
Server. Recomendamos utilizar as mesmas portas da instalação principal, para que o Servidor de
Aplicação do ERP não precise de alterações de porta de comunicação.
(caso precise verificar quais são as portas que estão em uso na instalação atual, abra o arquivo
appserver.ini da pasta do executável do License Server principal).
Após a instalação, abra o atalho do Monitor, e será iniciado o wizard de configuração. Marque a
caixinha "Esta é a segunda instalação de um ambiente de alta disponibilidade?", e informe o
mesmo TotvsID e Código de Instalação da primeira instalação.
(caso precise confirmar quais são esses códigos, abra o Monitor de Licenças do License Server
Principal, clique no botão **Informações, e em **Dados da Instalação estarão listados o TotvsID e
Código de Instalação da instalação principal, que devem ser utilizados na segunda instalação.
Outra opção é abrir o arquivo licenseserver.ini, da pasta Appserver da instalação principal do
License. Neste arquivo constam o TOTVSID e LOCALID (Cód. de Instalação) da instalação).
Após esse passo, finalize a configuração da mesma forma que a primeira instalação.

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 12/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

Não existe a necessidade de que ambos os hardwares sejam iguais, porém ambos devem ter acesso à
internet, caso contrário o sistema não irá operar adequadamente.

Adicionalmente à configuração do serviço TOTVS | License Server, o ambiente de alta disponibilidade

deverá garantir que o acesso do Software TOTVS ao serviço seja feito pelo mesmo IP e Porta, não
necessitando nenhuma reconfiguração dos Softwares TOTVS.

O TOTVS | License Server, não permite que ambas as instalações recebam conexões do Software
TOTVS, impedindo qualquer tentativa de alternância das requisições entre os ambientes, contudo, ambos
os ambientes recebem a autorização de uso diariamente.

 O License Server não irá operar em um ambiente de HA se não for realizada a configuração
mencionada acima. Realizar a configuração do ambiente de HA apenas utilizando Cluster/Redes
Sans irá provocar a interrupção do serviço em caso de falha, uma vez que o License Server
utiliza informações do hardware Físico/Virtual para operar.

Virtualização
Este tópico fornece uma visão geral da tarefa de configurar o TOTVS | License Server em um ambiente
virtualizado. A abordagem sobre como configurar um ambiente virtualizado não faz parte deste escopo.
O TOTVS | License possui um sistema de segurança de ultima geração que é constantemente reavaliado
e atualizado. A Virtual Machine necessita de algumas configurações especificas para o pleno
funcionamento do TOTVS | License Server.
A Virtual Machine deve ser configurada de modo que não permita duplicação do número serial BIOS
UUID, duplicação do MacAddress dos adaptadores de Rede ou que numa operação de Move da Virtual
Machine estas informações sejam alteradas. Caso isto aconteça o serviço de licenciamento irá ser
interrompido sem aviso prévio.

 Alguns HyperVisor, por padrão, alteram as informação de BIOS UUID a cada inicialização da
Virtual Machine. Verifique com o fornecedor como fazer para fixar o valor.

Quando efetuar qualquer manutenção na Virtual Machine, tenha certeza que nenhum placa de
rede foi removida e que a porta do License Server não foi alterada, caso isto aconteça o serviço
de licenciamento irá ser interrompido.

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 13/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

Utilização do modelo FCI - Failover Cluster Instance

Operação do TOTVS | License Server

Ao acessar a interface do License Server, a primeira vista podemos ver três separações:
Monitoramento: onde é possível analisar a utilização das licenças em tempo real;
Histórico de Consumo: onde são apresentadas informações de consumo e uso de acordo com o
tempo.
Intera: onde é possível monitorar o uso de licenças do tipo Intera.
As informações exibidas no monitor do License Server são atualizadas de acordo com o tempo
configurado na parte superior à direita da interface. Lá é possível estabelecer o intervalo ou solicitar a
atualização manualmente.
Para acessar o monitor do License Server, execute o atalho TOTVS License Monitor criado na instalação
do sistema.

Monitoramento
O objetivo do monitoramento é fornecer todas as informações referentes a utilização das licenças do
contrato para o qual o License Server foi instalado.
Na parte superior do monitoramento são exibidos três indicadores de uso, sendo eles:
Conexões em uso: apresentação de gráfico para exibir Licenças consumidas e Licenças
abonadas;
Licenças Full TOTVS: relação entre Licenças Full disponíveis e Licenças Full em uso;
Licenças Light TOTVS: também exibe a relação entre disponibilidade e uso, só que das Licenças
Light TOTVS.

Já na parte inferior, na seção Visão Geral, são apresentadas informações como:

Uso das Licenças: a lista de licenças é apresentada com as informações referentes ao total
disponível, licenças em uso, percentual de consumo e validade;
Licenças por CNPJ: exibe o consumo de licenças corporativas apresentando, por empresa,
quantas licenças estão em uso e quantas foram abonadas;
Conexões: apresenta todas as conexões ativas no License Server.

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 14/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

Histórico de Consumo
O histórico de consumo relaciona as informações históricas de uso do License Server. Nesta visão é
possível visualizar:
Licenças concorrentes: exibe o histórico de concorrência da licença selecionada, fazendo o
comparativo entre licenças disponíveis e pico de uso;
Conexões: Apresenta a relação entre quantidade de licenças utilizadas X licenças negadas. Isso
para verificar o volume de uso de cada licença selecionada;
Usuários: esta visão contem todas as conexões de usuários, apresentando informações como
licença utilizada, rotina acessada, tempo de uso, entre outras.

Na área de Histórico de Consumo, há também a possibilidade de exportar os dados de histórico para um

arquivo do tipo CSV (que pode ser importado em programas de planilha, como o Excel).

Cada uma das abas do Histórico de Consumo (Licenças Concorrentes, Conexões e Usuários) possui, do
lado direito da tela, um botão CSV. Em cada uma destas abas, ao clicar no botão CSV, serão exportados
os dados referentes aquela aba em específico. Se você executar um Filtro nas informações que estão
sendo exibidas, ao exportar o arquivo .CSV, as informações serão exportadas filtradas.

Para efetuar a exportação, basta clicar no botão CSV, e se você estiver em um Sistema Operacional com
um programa atribuído para arquivos do tipo .csv, o arquivo será automaticamente aberto neste
programa.

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 15/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

A partir da versão 3.0.3 do License Server, é possível configurar quantod dias o histórico de consumo é
mantido na base local (o padrão atual é 90 dias). É possível definir um valor entre 0 e 90 dias. Os dados
são apagados somente após a transmissão dos mesmos para a Totvs. Os registros de uso transmitidos
para a Totvs possuem a coluna "Tx" como "Transmitido".
Para acessar a configuração, clique no ícone de mensagem, conforme destacado abaixo:

Tela de Configuração:

Botões da Interface

Botão Cadastro de Usuários -

Permite cadastrar usuários que terão acesso ao Monitor de Licenças. Por padrão já vem criado o usuário
Admin. Ao acessar o Monitor do License Server pela primeira vez, utilize o usuário Admin com a senha
em branco.
Obs.: é altamente recomendável alterar a senha do usuário Admin no primeiro acesso.
Para criar novos usuários, faça o seguinte:
- Clique no botão Usuários

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 16/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN
- Clique em Incluir
- Preencha os dados do usuário, atentando-se aos campos obrigatórios
* Lembrando que esta listagem de usuários é exclusiva para acesso ao Monitor de Licenças, não tem
ligação com os usuários do ERP.

Botão Política de Segurança -

Permite configurar as regras para criação e uso de senha, regras de violação de senha, conexão SMTP
para envio de avisos do License Server por e-mail e notificações a serem recebidas.
Para configurar o envio de e-mails com as notificações, acesse o botão de Política de Segurança, aba
Conexões, e preencha os dados de SMTP do seu provedor de e-mails.

 Aviso:
É altamente recomendável a configuração da conexão SMTP, pois caso algum usuário do
Monitor do License Server esqueça a senha, uma nova senha somente é enviada por e-mail.

As notificações disponíveis no License Server são:

Notificação de atualização da autorização de uso. O License Server irá enviar um e-mail toda vez
que o License Server receber uma atualização de licenciamento, tanto manualmente como
automaticamente. A falta do recebimento desta notificação pode indicar um problema na conexão
do License Server com o servidores da TOTVS.
https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 17/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN
Notificação de contingência. O License Server irá enviar diariamente um e-mail 15 dias antes da
expiração do prazo da licença. Recomendamos que esta opção esteja sempre habilitada. Caso
ocorra uma atualização da autorização de uso, o e-mail será cancelado.
Notificação de atualização automática. O License Server irá enviar uma aviso toda vez que ocorrer
uma atualização do Serviço License Server. As atualizações do License Server ocorrem em
intervalos não programados. A cada atualização o sistema guarda um backup das 5 ultimas
atualizações do License Server e deixam no diretório <path de
instalação>\TOTVSLicense\data\apo. Para reverter uma instalação, basta alterar o arquivo
appserver.ini, chave SourcePath, indicando o path da instalação anterior. que fica no mesmo
diretório <path de instalação>\TOTVSLicense\data\apo, porém com uma data cronológica inferior.

Botão Atualização Manual das Licenças -

O License Server permite a atualização manual do licenciamento TOTVS.
Para realizar a atualização manual do licenciamento TOTVS, clique no botão indicado na figura acima
que fica no topo superior direito do Monitor de Licenças.
Ao pressionar este botão, o sistema automaticamente irá se conectar na TOTVS e atualizar as licenças
com base no contrato TOTVS.
Utilize esta opção sempre que realizar a distribuição, manutenção e ou aquisição de licenças junto a
TOTVS. Esta opção irá acelerar o processo de atualização das licenças com base nas modificações que
você realizou no Portal do Cliente. Caso não seja realizado o processo manual, a atualização ocorrerá
automaticamente durante o horário pré-estabelecido pela TOTVS.

 A partir da versão 3.4.3 será validado o envio dos dados de telemetria do cliente. Caso não
estejam sendo enviados não será permitida a atualização do agreement.

Toda vez que o monitor do License Server for acessado, logo após o login, o sistema fará uma
checagem para ver se está conseguindo se comunicar com o LSCloud e se está há mais de 2
dias sem reportar os dados de telemetria. Caso isso esteja acontecendo, será dado um aviso ao
usuário:

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 18/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN
Para checar se os dados estão sendo processados diariamente, a informação também será
apresentada na aba de informações do License Server:

Botão Ajuda -
Direciona para o link do TDN com as documentações do License Server Virtual.

Botão Informações -
Exibe as informações da instalação do License Server, tais como:
Build: versão do binário do License Server.
Versão: versão do RPO do License Server.
Data de geração da autorização de uso: exibe a data em que foi feita conexão com a Totvs e
revalidada a autorização de uso das licenças. Essa data deve ser atualizada diariamente, desde
que a conexão esteja OK.
Data de vencimento da autorização de uso: indica a data de vencimento da autorização de uso
das licenças, caso não esteja ocorrendo conexão do License Server com a Totvs. Caso a conexão
esteja OK, diariamente essa data será atualizada.
TOTVS Id: indica o Totvs ID que está em uso para esta instalação do License Server.
Código de Instalação: indica o código de instalação que foi gerado a partir das informações do
servidor, e que foi vinculado ao Totvs ID informado.

Botão Restaurar Agreement -

A Finalidade desse botão é restaurar um arquivo o contrato de licenças do cliente a partir do arquivo
totvslicenseagreement.key.
Após selecionar basta indicar qual o caminho do arquivo e seleciona-lo para que o monitor
processe-o e atualize as regras de licenciamento.
Funcionalidade disponível a partir da versão 3.4.3

 Licença Teste (4007 - Totvs Dev Test)

A licença com código 4007 - TOTVS DEV TEST é específica para uso em ambientes de teste. Ao
acessar um produto TOTVS a partir de um ambiente de teste, será permitido o acesso a todos os
módulos para verificação de funcionalidades.
A quantidade de licenças 4007 que serão disponibilizadas no License Server depende do
contrato do cliente, até um limite de 10 licenças.
No ERP Microsiga Protheus, a licença 4007 é válida apenas para a Empresa 99 (Teste).
No ERP Datasul, a licença 4007 é valida para ambientes configurados em modo teste, por meio
da chave license.ambient.type=test localizada no arquivo de propriedades
https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 19/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN
datasul_framework.properties.
No ERP RM, licenças NÃO SÃO CONSUMIDAS na conversão e utilização de base para testes,
pois, essa função independe do License Server.

Uso do WebApp - Acesso ao Monitor pelo Navegador

A partir da versão 2.0.0 do License Server, é possível acessar o Monitor de Licenças através do
navegador. A porta de acesso é definida no momento da instalação (conforme passos descritos na seção
de Instalação deste manual), e o acesso pode ser feito digitando na barra de endereços do navegador, o
endereço IP do servidor onde está o License Server mais a porta definida. Por
exemplo: http://192.168.1.77:8020

O acesso via SmartClient HTML (WebApp) possui as mesmas opções de controle e monitoramento que a
versão Desktop. Para maiores detalhes sobre o uso, favor consultar a seção Monitoramento acima.

Maiores informações sobre o uso do WebApp estão disponíveis em: SmartClient HTML

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 20/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

Plano de Recuperação de Desastre

O Plano de Recuperação de Desastres é composto por procedimentos que deverão ser aplicados
sempre que ocorrer uma falha devido a alguma inconsistência provocada em virtude de ameaças
externas ou falhas de tecnologia. Apesar do Plano de Recuperação de Desastre ser composto por 3
programas (Administração de Crise, Continuidade Operacional e Recuperação de Desastres), nós
focaremos no Programa de Recuperação de Desastres que é a aplicação na prática para a continuidade
operacional do ERP.
O tempo médio de solução foi calculado com base em profissionais que já tenham exercitado algum dos
procedimentos abaixo anteriormente. Portanto, recomendamos que após a instalação do License Server,
o plano seja analisado e treinado.

Ocorrência Plano de Recuperação Tempo

médio

Perda física do 1. Instalar uma nova versão do License Server em outro 1 Hora
hardware onde hardware que esteja disponível.
esta hospedado o 2. Bloquear o TOTVS id da instalação atual no site da TOTVS,
License Server conforme o Guia de Gestão de Licenças (Guia Gestão de
Licenças TOTVS)
3. Seguir os procedimentos de instalação listados acima
4. Caso tenha mais de um License Server, lembre-se de fazer a
distribuição manual das licenças, conforme o manual (Guia
Gestão de Licenças TOTVS#gestao-de-licencas)
5. Realizar a atualização manual das licenças.
6. Conferir se as licenças foram atualizadas corretamente.
7. Parametrizar o ERP para o novo License Server, conforme
documentação do ERP.

License Server 1. Acessar o Portal do Cliente e verificar se o TOTVS id não foi 30

sem licenças ou bloqueado por engano (Guia Gestão de Licenças TOTVS). minutos
com Utilize sempre o TOTVS id para realizar a comparação,
licenciamento principalmente se houver mais de uma instalação do License
errado. Server. Bloquear por engano uma instalação provoca a
parada do sistema.
a. Caso esteja bloqueado, desbloqueie e faça a atualização
manual das licenças, conforme citado acima.
b. Se não estiver bloqueado, confira a distribuição das
licenças. Em caso de problemas com a distribuição,
realize a distribuição novamente e faça a atualização
manual das licenças.
c. Se o problema persistir, siga o procedimento 2
2. Acesse o diretório de instalação do License Server e a pasta
\data\licenseagreement\Backup.
a. Pegue o arquivo que julgar conter o backup ideal de seu
licenciamento, em caso de duvida, pegue o mais velho.
Exemplo de nome do arquivo:
totvslicenseagreement_20220428.key
b. Copie o arquivo para o diretório \data\licenseagreement\
c. Reinicie o License Server
d. Acesse o Monitor do License Server e verifique se as
licenças foram restauradas.
e. Contacte a TOTVS para regularização definitiva do
problema.

Nenhum dos Acesse o Portal do Cliente e obtenha uma chave/arquivo de 15

procedimentos emergência que deverá ser aplicado no ERP conforme manual do minutos
anteriores ERP. Com esta chave, você terá tempo de contactar os
resolveu profissionais da TOTVS para solucionar os problemas.
Seguem abaixo links com a informação da utilização da
chave/arquivo de emergência baseado no produto que está
utilizando:

- Microsiga Protheus
- RM
- Datasul
- Logix
- Fluig

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 21/22
22/05/2023, 13:02 TOTVS License Server Virtual - Frameworksp - TDN

Atualização do License Server

Caso seja necessária a atualização do License Server, segue abaixo o procedimento:
- Baixe o instalador pelo link: Windows - https://suporte.totvs.com/portal/p/10098/download?e=1022351 e
Linux - https://suporte.totvs.com/portal/p/10098/download?e=1022352
- Pare o serviço da atual instalação do License Server
- Para desativar a instalação atual do License Server para utilização da nova, existem 2 opções:
1. Faça um backup da pasta atual, e então desinstale o License Server, pelo Painel de Controle do S.O.
ou pelo Uninstaller da pasta \TOTVS\TOTVSLicense2014\uninstall\
2. Mantenha a pasta, e no respectivo serviço, troque o Tipo de Inicialização de Automático para
Manual ou Desativado, para que esse serviço não volte a inicializar
- Execute o novo instalador
- Durante a instalação, utilize as mesmas portas que eram utilizadas na instalação anterior. Caso tenha
dúvidas, consulte as portas no arquivo appserver.ini da instalação anterior
- Ao término da instalação, quando abrir o Wizard de configuração, clique em Cancelar
- Abra os serviços do Windows e pare o serviço do TOTVS | License Server Virtual
- Na pasta onde foi instalado, acesse a pasta \TOTVS\TOTVSLicenseVirtual\bin\appserver e renomeie o
arquivo licenseserver.ini
- Copie o arquivo licenseserver.ini da instalação original, e cole nesta pasta
- Acesse a pasta \TOTVS\TOTVSLicenseVirtual\data\db_sys da sua instalação original
- Se sua instalação original não possui um arquivo chamado "SYSTEM.DB" ou então não possui essa
pasta, pule o passo seguinte
-Mova o arquivo SYSTEM.DB da instalação original para a pasta
\TOTVS\TOTVSLicenseVirtual\data\db_sys, caso exista um arquivo SYSTEM.DB nessa pasta, apague o
mesmo antes de executar a mudança
- Reinicie o serviço do TOTVS | License Server Virtual
- Abra o Monitor de Licenças
- No primeiro acesso as licenças ainda não vão aparecer. Clique no ícone de atualização manual (ícone
em forma de antena), aguarde sincronizar, e após a sincronização clique no ícone de atualizar a tela. As
licenças serão exibidas.

 Importante:
Para manter a mesma configuração, é necessário utilizar as mesmas portas utilizadas na versão
atual. Caso tenha dúvidas sobre quais portas estão sendo utilizadas, consulte o arquivo
appserver.ini da instalação atual. (Seções [TCP] e [LicenseServer])
Caso durante a instalação você tenha efetuado a troca da placa de rede ou HD, ou tenha
alterado a porta TCP, o Totvs ID será invalidado, sendo necessário gerar um novo. Neste caso,
siga os passos do Plano de Recuperação de Desastre para gerar e aplicar um novo TotvsID.

totvs protheus framework ls lsvirtual license server

licenseserver métricas

Política de Termos
privacidade de uso

https://tdn.totvs.com/display/public/framework/TOTVS+License+Server+Virtual 22/22