License Server é um recurso computacional da TOTVS que têm como objetivo realizar o controle das licenças de uso dos softwares e aplicações TOTVS. Através deste recurso é possível prover de forma 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.

Cada instância do License Server identifica uma instalação física vinculada ao contrato de licenciamento 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 Teste). Caso opte-se por mais de uma instalação física do License Server, será necessário o registro da divisão das licenças do contrato entre as instalações físicas.

O License Server foi projetado para permitir uma configuração em alta disponibilidade do serviço e virtualização. Um sistema de alta disponibilidade (HA:High-Availability) é um sistema resistente a falhas 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 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 Swap).

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 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 recomendações.

Requisitos de Sistema

Esta recomendação tem fins meramente de avaliação e de planejamento de implementação, para uma instalação com até 500 conexões simultâneas.

** 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, 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=1022352desta página (no canto superior direito), para maiores informações, consulte o Guia de Relacionamento e Suporte.

De posse do arquivo de instalação, execute o arquivo e selecione o idioma de instalação, conforme mostra a figura abaixo:

Instalação

O instalador do TOTVS | License Server pode ser obtido no link Instaladores desta página (no canto superior direito), para maiores informações, consulte o Guia de Relacionamento e Suporte.

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:

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.

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.

Image AddedImage Removed


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



Na próxima tela serão apresentadas as portas de operação do TOTVS | License Server. As porta do Servidor de Log e do Serviço de Licenciamento 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.Image Removed

Image Added

• 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

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

Image Added

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.

Image Added

Por último, será executado o Monitor do TOTVS | License Server, Na tela seguinte terá início o processo de instalação do TOTVS | License Server, aguarde o termino.Image Removed
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.Image Removed
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.

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 -console

1. Baixe os arquivos do portal: https://suporte.totvs.com/portal/p/10098/download?e=1022352

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)

Image Added

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

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

Image Added

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

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?
Image Added

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
Image Added

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

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
Image Added

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
Image Added

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.
Image Added

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
Image Added

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

Image Added

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-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://licenseservercloudlscloud.totvs.com.brapp/api/, para comunicação. O trafego ocorrerá uma vez por dia no 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.

Image AddedImage Removed

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 código de instalação é um número gerado 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.

Image AddedImage Removed

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

Image AddedImage Removed

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.

[licenseserver]
TotvsId=    ;;Informe o TotvsId solicitado pela interface
LsEnv=1		;;Informe 1 para Produção; 2 para Homologação e 3 para Desenvolvimento
LsAlias=	;;Informe um nome para identificar o License Server no Portal do Cliente
LocalId=	;;Informe o Código de Instalação da instalação padrão se este for uma instalação de HA.

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

appserver -install

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.

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.

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.

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.

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.

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.

Intera

Nesta aba pode-se controlar o uso das licenças do tipo Intera. Diferente da licença tradicional, a licença do tipo Intera fica vinculada a um usuário, e libera o uso do sistema para todos os módulos que são compreendidos por aquele ID. Porém a licença não é liberada quando o usuário não está usando o sistema, ela fica atrelada àquele usuário (até que o vínculo seja desfeito pelo botão "Remover ID").