You are on page 1of 39

License Server TOTVS 11

18/09/2014

License Server TOTVS 11

Ttulo do documento
Sumrio
1.

Viso Geral ................................................................................................................................... 3

2.

Requisitos do Sistema................................................................................................................... 3

3.

Instalao do LS ........................................................................................................................... 4

4.

Entendendo o modelo de licenas (TOTVSlic.key) ....................................................................... 11

5.

Configurao do License Server no TOTVS 11 ............................................................................ 13

6.

Licenas Comercializadas............................................................................................................. 14

6.1. Viso Geral .................................................................................................................................. 14


6.2. TOTVS Full .................................................................................................................................. 15
6.3. Full Determinado ......................................................................................................................... 15
6.4. TOTVS Light ................................................................................................................................ 16
6.5. TOTVS Light OnDemand............................................................................................................. 17
6.6. Corporativo .................................................................................................................................. 17
6.7. TOTVS Dev Test ......................................................................................................................... 17
6.8. EmergencialKey (Chave de Emergncia) .................................................................................... 18
6.9. Startkey (chave de inicializao) ................................................................................................. 19
6.10. Exemplo de Licenas................................................................................................................... 20
7.

Consumo e Abono de Licenas .................................................................................................... 20

8.

License Server x Hash .................................................................................................................. 24

9.

Funo de Ambiente de Teste no TOTVS 11 ............................................................................... 25

10. Funo de Ambiente de Demonstrao no TOTVS 11 ................................................................. 27


11. License Monitor ............................................................................................................................. 28
12. Mensagens, dvidas e situaes comuns ..................................................................................... 33
13. Glossrio ....................................................................................................................................... 39

Verso 1.0

License Server TOTVS 11

1. Viso Geral
O TOTVS License Server (LS) um produto baseado no TOTVS | Application Server que tem o objetivo de realizar o
controle das licenas de uso dos softwares e aplicaes TOTVS. Atravs deste recurso possvel prover de forma eficiente e segura
o consumo e liberao de licenas na utilizao de mdulos e/ou funcionalidades das aplicaes TOTVS em conformidade com o
contrato firmado entre o cliente e a TOTVS. Cada instancia do TOTVS License Server refere-se a uma instalao fsica vinculada
ao contrato de licenciamento do cliente. Para maximizar o uso do licenciamento TOTVS, recomenda-se a utilizao de uma nica
instncia do TOTVS License Server, independentemente do ambiente de operao (produo, homologao e teste). Caso optese por mais de uma instalao fsica do TOTVS License Server, ser necessrio o registro da diviso das licenas do contrato entre
as instalaes fsicas junto ao Centro de Servios TOTVS (CST).
O TOTVS License Server faz uso de um dispositivo fsico denominado hardlock (Figura 1), que possui um cdigo de
identificador nico, e uma chave de liberao de licenas de uso, codificada e exclusiva para cada cliente.
Figura 1 - Hardlock

Caso ocorra qualquer anomalia no hardware ou nos servios do License Server, possvel utilizar a chave de emergncia
como contingncia, que opera de forma independente do License Server reestabelecendo o acesso aos softwares TOTVS, sem que
o servio esteja ativo.

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

Memria
Espao disponvel em disco

Verso 1.0

Requisito
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.
Mnimo: 2 GB de RAM (livre do sistema operacional)
Recomendado: 4 GB de RAM
Mnimo: 1GB (livre)
Recomendado: 10 GB (considerando crescimento do banco de dados temporrio)

License Server TOTVS 11

Ttulo do documento
Sistema Operacional
Microsoft

Verso
Windows Server 2008 Enterprise (x64)
Windows Server 2008 R2 Enterprise (x64)
Windows Server 2012 Standard (x64)

Novell

SUSE Linux Enterprise Server 9 (x86/x86_64)


SUSE Linux Enterprise Server 10 (x86/x86_64)
SUSE Linux Enterprise Server 11 (x86/x86_64)

Red Hat

Red Hat Enterprise Linux 5.4 Server (x86)


Red Hat Enterprise Linux 5.5 Server (x86/x86_64)
Red Hat Enterprise Linux 6.1 Server (x86_64)

3. Instalao do LS
Neste item sero abordados os procedimentos para instalao e configurao do License Server, possibilitando a utilizao
das licenas de acordo com o contrato. Para que seja possvel fazer a instalao do License Server, alguns pr-requisitos so
necessrios:
Possuir o hardlock, que foi enviado previamente pela TOTVS;
Possuir uma licena (TOTVSlic.key) vlida para o hardlock em questo;
Instalador do License Server, cuja verso mnima a 2010.
Importante:
caso a licena esteja vencida, ou por algum outro motivo seja necessrio solicitar uma nova licena, necessrio acessar
o http://suporte.TOTVS.com.br, opo CST (Relacionamento) > Gerao de Senhas. Ou ento, atravs do URA, telefone 40030015, opes 4 3.
O License Server um recurso que aliado ao uso de um dispositivo fsico hardlock, dotado de um cdigo identificador nico,
e da utilizao de um arquivo de licenas de uso, codificada e exclusiva para cada cliente, permite prover de forma eficiente e segura
as informaes de licenciamento em conformidade com o contrato firmado entre o cliente e a TOTVS.
Por ser um servio de instncia nica, isto , em um ambiente e/ou instalao de um ou mais produtos TOTVS, somente
deve haver um nico License Server.
Clientes da linha Datasul, no geral, receberam o Hardlock Compact-500 USB, desta forma, o License Server deve ser
instalado em um servidor que possua uma entrada USB dedicada/exclusiva para uso do hardlock, sendo que esse servidor no
precisa ser o mesmo da aplicao ou banco de dados.
O download da mdia de instalao do License Server pode ser realizado na pgina de Suporte TOTVS, atravs do link:
http://www.TOTVS.com/suporte/central-de-download/seu-segmento/produto/tecnologia. J o guia de instalao est disponvel na

Verso 1.0

License Server TOTVS 11

TDN, na estrutura Tecnologia TOTVS > TOTVS | Plataform > TOTVS | Application Server > License Server, ou pelo o link direto:
http://tdn.TOTVS.com/pages/viewpage.action?pageId=6065890.
Aps realizar o download da mdia de instalao, ao abrir a mdia necessrio escolher o sistema operacional para o
License Server. Seguindo com base no sistema operacional Windows, pode-se analisar passo a passo como ocorre a instalao do
License Server.
1. Escolher o idioma para instalao.

2. Tela de boas vindas.

Verso 1.0

License Server TOTVS 11

Ttulo do documento
3. Verificar o contrato de licena e aceitar os termos para prosseguir.

4. Escolher o diretrio de instalao do License Server.

Verso 1.0

License Server TOTVS 11

5. Habilitar o License Server no servidor.

6. Escolher uma porta para instalar o License Server. Vale ressaltar que deve ser uma porta que no esteja em uso e que
no ser bloqueada por firewall ou antivrus.

Verso 1.0

License Server TOTVS 11

Ttulo do documento
7.

8.

Verificar necessidade de habilitar controle de numerao automtica pelo HL.

Verificar necessidade de instalao do driver do HL.

Verso 1.0

License Server TOTVS 11

9. Verificar qual o modelo do Hardlock recebido pelo cliente, em sua maioria, recebem o tipo Safenet. Depois de avanar,
aparecer uma tela para confirmar as informaes de instalao e avanar para que a instalao do License Server seja
realizada.

10. Aguardar a instalao concluir.

Verso 1.0

License Server TOTVS 11

Ttulo do documento
11. Por fim, verificar no diretrio de instalao que o License Server foi instalado.

Atualizao do arquivo de licenas


Aps realizar a solicitao da licena, o responsvel receber um email cujo assunto ser TOTVS - Departamento de
Liberao de Senha, com o arquivo de licenas anexo. O arquivo ser enviado com a seguinte nomenclatura,
TOTVSlic_numero_hardlock.key, que dever ser renomeado para totvslic.key e atualizado no diretrio de instalao do License
Server, pasta BIN, conforme Figura 2.
Figura 2 Localizao do TOTVSlic.key

Concluda a atualizao da Licena, o servio do License Server poder ser iniciado.


Figura 3 - Servio do License Server

10

Verso 1.0

License Server TOTVS 11

Por padro ser criado um servio .TOTVS License Server, em ambientes Windows. Caso no tenha sido criado, pode
ser utilizado um atalho com o seguinte comando <dir_instalacao_ls>\BIN\AppServer.exe -install. Caso queira iniciar o servio
manualmente, pode ser utilizado um atalho com o seguinte comando <dir_instalacao_ls>\BIN\AppServer.exe -console.
Importante:
no email com as licenas, alm do arquivo TOTVSlic.key, pode ser recebido tambm um arquivo chamado applylic.key,
este arquivo pode ser desconsiderado. Este arquivo vlido apenas para clientes da linha de produtos Microsiga Protheus ou Logix
at a verso 10.
possvel verificar se o servio do License Server foi inciado com sucesso. No diretrio de instalao do License Server,
na pasta BIN, existe um arquivo chamado TOTVSconsole.txt, este um log relacionado ao License Server, sendo possvel verificar,
conforme abaixo, que o servio foi iniciado com sucesso.
[INFO ][SERVER] [Thread 11744] Application Server started on port 2234
[25/09/2014 14:29:15] Server started.
Starting Job [INITLS]

Outra maneira, atravs do Monitor do License Server, caso a instalao tenha sido feita no Windows. Para acesso ao
monitor, no servidor em que foi instalado o LS, ser criado um atalho no Iniciar > Programas para acesso ao monitor, caso seja
possvel abrir o monitor, e na sesso Licenas disponveis forem listadas as licenas contratadas, indica que o servio foi iniciado
com sucesso.
Importante:
caso ocorra algum problema ao iniciar o servio do License Server em ambientes Windows, certifique-se de que o
executvel <dir_instalacao_ls>\BIN\AppServer.exe est devidamente configurado como exceo no recurso de segurana de
Preveno de Execuo de Dados.

4. Entendendo o modelo de licenas (TOTVSlic.key)


Aps a instalao do License Server no servidor de destino, possvel encontrar uma pasta denominada TOTVSLicense.
Neste diretrio possvel encontrar uma pasta denominada bin, onde encontra-se o arquivo TOTVSlic.key. Ele o responsvel
pelas informaes sobre controle de licenas adquiridas pelo cliente, bem como, as regras de escalonamento de licenas. As Figuras
4 e 5 demonstram um exemplo de arquivo.

Verso 1.0

11

License Server TOTVS 11

Ttulo do documento
Figura 4 - TOTVSlic.key

Figura 5 - TOTVSlic.key - Rules

O arquivo de licenas dividido em dois blocos principais, o bloco [LICENSES] e o bloco [RULES]. No primeiro, h uma
listagem com as licenas adquiridas pelo cliente. Para facilitar a visualizao, pode ser utilizado o TOTVS | License Monitor.
Observao:
algumas licenas listadas no arquivo podem no ser apresentadas no License Monitor, pois algumas delas so utilizadas
apenas para controle interno.

12

Verso 1.0

License Server TOTVS 11

O segundo bloco do arquivo de licenas, o [RULES], o bloco em que so definidas as regras de escalonamento das
licenas, a partir do cdigo do mdulo (slot solicitado) enviado do produto para o License Server, feita uma anlise das licenas
disponveis e as que podem ser consumidas por aquele programa, de acordo com o segmento.
Alm das licenas e as regras, o arquivo contempla uma chave (checksum), que garante a autenticidade e combatibilidade
entre o arquivo de licena e o hardlock que est sendo utilizado. Com este arquivo, possvel tambm verificar a data de validade
da licena, procure pela varivel vencto, que utiliza o formato AAAAMMDD.
Este documento no visa detalhar a leitura do arquivo de licenas, uma vez que possvel utilizar o monitor para controle,
esta anlise feita pelo Suporte Framework quando necessrio.

5. Configurao do License Server no TOTVS 11


Aps o License Server ser instalado e seu servio estar ativo no sistema operacional, so necessrias algumas
configuraes no TOTVS 11 para que seja possvel realizar o controle de licenas e funcionamento do produto.
No JBoss do servidor que se conectar ao License Server, necessrio alterar o arquivo datasul_framework.properties,
localizado no seu servidor em JBOSS_HOME/server/NOME-INSTANCIA/conf, onde, JBOSS_HOME o local onde o servidor JBoss
est instalado e NOME-INSTANCIA representa o nome da instncia do ambiente a ser alterado o License Server. Deve-se incluir,
conforme o exemplo a seguir, as propriedades de configurao de licena.

#+-------------------------------------------+
#|

CONFIGURACOES DE LICENCA

#+-------------------------------------------+
license.server=10.80.6.100
license.port=5555
license.timeout=30
# Tipos de logs permitidos: none, all, info, debug, error
license.showlog=info
# Tipos permitidos: normal, test e demonstration
license.ambient.type=normal

Na propriedade license.server deve ser includo o IP onde o servio do License Server est disponvel e na propriedade
license.port

a porta liberada informada na instalao do Lincense Server. O timeout configurado na propriedade

license.timeout
error.

e o tipo de log permitido em license.showlog, que permite os valores: none, all, info, debug e

A propriedade que faz a definio do modo que o ambiente trabalhar em relao ao License Server

license.ambient.type. O modo do ambiente pode variar em trs tipos: normal (quando ocorre o consumo de licenas padro,

sendo tipicamente um ambiente de produo), test (o ambiente est configurado para o modo de testes) e demonstration (o
ambiente est configurado para o modo de demonstrao).

Verso 1.0

13

License Server TOTVS 11

Ttulo do documento
6. Licenas Comercializadas
6.1. Viso Geral
O License Server controla diversos tipos de licenas TOTVS, como por exemplo:

Licena TOTVS Full


Licena TOTVS Light
Licena TOTVS Light OnDemand
Corporativo
TOTVS Dev Test
Chave de Emergncia (Emergencial Key)
Startkey

Os tipos de licena so divididos em conformidade com sua natureza de controle, geralmente, para o TOTVS 11, so
licenas concorrentes, licenas por capacidade de demanda (OnDemand) ou licenas de habilitao.
As licenas de natureza concorrentes so aquelas cujo controle do License Server realizado atravs da contagem dos
usurios simultneos do sistema em um determinado Agrupador de Negcio TOTVS. Para cada Agrupador de Negcio adicional
que um usurio determinado utilizar, ser considerado um novo consumo de licena. No ser considerado como um novo consumo
de licena se o usurio utilizar, simultaneamente, mais de uma funcionalidade pertencente a um mesmo Agrupador de Negcio.
As licenas de natureza OnDemand so aquelas cujo controle realizado pela contagem do volume de itens ativos de
uma determinada mtrica, por exemplo: volume de funcionrios ativos. Esta natureza de licena no realiza a contagem do nmero
de usurios simultneos nos sistemas, mas faz o bloqueio da mtrica definida, impedindo a operao do sistema quando a mesma
atingida e permite um nmero infinito de usurios.
Os Agrupadores de Negcio TOTVS, agrupam um conjunto de funcionalidades de regras de negcio independentemente
da linha de software. Por exemplo, tomemos como base o Agrupador de Negcio Comrcio Exterior. Segundo nosso Guia de
Software, este agrupador rene as funcionalidades de negcio:
Cambio
Importao
Exportao
Drawback
Assim os itens de menu de todas as linhas de software que possuem estas funcionalidades so agrupados no Agrupador
de Negcio Comercio Exterior. Resumidamente podemos afirmar que o Agrupador de Negcio o contexto da de soluo sistmica,
definida pela TOTVS, para um processo (mdulo/agrupador) licenciado.

14

Verso 1.0

License Server TOTVS 11

6.2.

TOTVS Full

A licena TOTVS Full permite o acesso de um usurio a uma lista de Agrupadores de Negcio TOTVS. A natureza de
controle desta licena concorrente e sua contagem leva em considerao o usurio concorrente e o agrupador de negcio utilizado.
A principal diferena desta licena para a TOTVS Light est no Agrupador de Negcio. Enquanto a licena light disponibiliza um
Agrupador de Negcio, esta licena disponibiliza uma lista de agrupadores, podendo assim ser utilizada como uma licena coringa.
Isto quer dizer que ela pode assumir qualquer segmento (light) dependendo da necessidade.
Quando o License Server detecta que no h licenas TOTVS Light disponvel, automaticamente ele faz a escala para uma
licena TOTVS Full. Mais adiante falaremos sobre as regras de escala.

6.3. Full Determinado


Um "Usurio Determinado" aquele que sempre consome uma licena FULL no processo de login, ou seja, durante a
sesso deste usurio no sero consumidas licenas de nenhum light disponvel no arquivo de licenas. Um "usurio determinado"
consome apenas uma nica licena por sesso, independente da quantidade de programas executados. Para informar que um
usurio ser um "Usurio Determinado" e que vai consumir apenas uma licena Full por toda a sua sesso, deve ser selecionada a
flag "Usurio Determinado?" no Cadastro de Usurios, aba Geral, opo Mdulo License.(Figuras 6 e 7).
Figura 6 - Cadastro de Usurio

Verso 1.0

15

License Server TOTVS 11

Ttulo do documento
Figura 7 - Opo de usurio Full Determinado

Esta modalidade poder ser encontrada como uma licena, isso ocorre para licenas/contratos antigos, ou ainda embutida
em outras licenas, que no geral so as licenas Full ou Light ERP.
Para identificar se sua licena contempla o Full determinado, so seguidas as seguintes regras:
Para licenas e/ou contratos antigos, tanto no corpo do email enviado pela CST/Senhas, quanto no License Monitor de
licenas, na rea de licenas disponveis, haver o id 4008 FULL Determinado;
Para licenas e/ou contratos mais recentes, no haver uma licena 4008 FULL Determinado, sero listadas as
licenas 4004 TOTVS Light ERP e/ou 4000 TOTVS Full, e no arquivo de licenas (TOTVSlic.key), na seo
LICENSES, dever existir a seguinte informao license<x>=7004;1.
Importante:
Um usurio determinado consome apenas licena Full ou Light ERP (slot solicitado 5999), logo, caso no haja licenas
deste tipo disponvel, o processo de execuo de aplicativos ser interrompida.
Mesmo que existam licenas Light disponveis, feito o login, porm, no ser possvel realizar a execuo de aplicativos.
A nica exceo de consumo de um Usurio Determinado vai ocorrer quando o ambiente utilizado estiver configurado
para ser um Ambiente de Teste, pois o consumo de uma licena Teste prevalece sobre uma licena de usurio determinado.

6.4. TOTVS Light


A licena TOTVS Light permite o acesso de um usurio ao Agrupador de Negcio definido na aquisio do Light TOTVS,
desta forma existe uma licena Light para cada Agrupador de Negcio. A natureza de controle desta licena concorrente e um
mesmo usurio pode acessar, simultaneamente, mais de uma funcionalidade do mesmo Agrupador de Negcio.
No monitor do License Server no ser utilizada a palavra light, pois entende-se por Light as licenas cuja descrio
refere-se a um segmento de negcio.

16

Verso 1.0

License Server TOTVS 11

6.5. TOTVS Light OnDemand


Com a licena OnDemand, o controle das licenas definido por uma determinada regra de negcio, sendo a execuo
das licenas ilimitado. O valor de licenas contratadas pode ser encontrada no monitor do License Server, onde, no campo
Limitante econtra-se um valor maior que zero (Figura 8).
Um exemplo o produto HCM, onde o controle das licenas feito pelo nmero de funcionrios ativos no produto, ou seja,
em um fechamento de folha, por exemplo, possvel realizar o processo de acordo com o valor da limitante contratado.
Figura 8 - Encontrar limitante no Monitor

6.6. Corporativo
A modalidade de licenciamento Corporativo permite acesso ilimitado a um conjunto de Agrupadores de Negcio definidos
nas licenas TOTVS Full. importante ressaltar que antes de ativar o License Server no produto, necessrio garantir que as
empresas estejam cadastradas no TOTVS 11 e relacionadas com CNPJ vlido para o arquivo de licenas. Lembrando que, para o
usurio acessar o sistema necessrio que ele tenha esta empresa relacionada ao seu Cadastro de Usurio no momento do login.
Caso seja necessrio consultar os CPNJs que constam no arquivo de licenas, nas licenas corporativas, basta verificar
no e-mail em que enviado o arquivo de licenas um campo chamado Ids corporativos:, com a listagem dos CNPJs vlidos para
a empresa.
Esto excludos do licenciamento Corporativo os componentes acessrios; software de parceiros e licenas de tecnologia.
Apesar de alguns softwares de parceiros possurem a mesma mtrica do licenciamento corporativo TOTVS, sua precificao e
controle separado do Corporativo TOTVS, sendo chamado de Corporativo de Parceiro.

6.7. TOTVS Dev Test


o tipo de licena utilizado para testes e/ou homologao. Assim, no h concorrncia de licenas entre a base de teste
e produo. Verifique mais informaes no captulo 9 deste documento.

Verso 1.0

17

License Server TOTVS 11

Ttulo do documento
6.8. EmergencialKey (Chave de Emergncia)
A chave de emergncia, ou emergencialkey, uma chave utilizada como contingncia quando ocorrer algum problema no
hardlock ou nos servios do Licnes. Esta chave vlida por 48 (dois dias).
Para que os clientes no sejam afetados, sempre que no for possvel a comunicao com o License Server, ser
apresentada uma mensagem de erro ao acessar o produto e em seguida, solicitada a chave de emergncia, composta por 8 (oito)
digitos. A chave emergencial criada de acordo com cada CNPJ enviado na solicitao de liberao especial, a fim de auxiliar, na
tela de liberao especial (Figura 9) encontra-se uma opo de Exportar CNPJs, para exportar todos os CNPJs que esto
cadastrados na base este documento deve ser anexado na solicitao de chave de emergncia (chamado).
Figura 9 - Tela de liberao especial

Ao receber a chave de emergncia, a mesma deve ser includa atravs do boto Selecionar e em seguida, deve-se aplicar
esta chave de emergncia no boto Aplicar, conforme Figura 9. Assim, o sistema estar liberado e funcionando normalmente caso
ocorra alguma falha com Hardlock ou servidor de Licenas.
A chave de emergncia pode ser obtida por dois meios:

URA, telefone 4003-0015, opes 4 e 4;

Portal de Clientes > opo CST (Relacionamento) > Gerao de Senhas > Senha/Chave de emergncia (License Server /
Hardlock).

18

Verso 1.0

License Server TOTVS 11

Importante:
caso seja apresentada a mensagem 36152 "Chave de emergncia invlida!" ao tentar aplicar a chave, os seguintes itens devem
ser verificados:
1. Deve ser instalado o java JRE 1.5 ou superior em todas as estaes;
2. A varivel de ambiente JAVA_HOME deve estar configurada.
Para configurao das variveis de ambiente, nas Propriedades do Sistema, localize a aba Avanado e clique no boto
Variveis de Ambiente, deve ser criada a varivel JAVA_HOME cujo contedo o diretrio de instalao do Java, por exemplo:
C:\Java\jre6.

6.9. Startkey (chave de inicializao)


A startkey uma chave composta por 20 dgitos que encontra-se junto a nota fiscal ao adquirir um software TOTVS.
utilizada para clientes que adquiriram o TOTVS 11 e ainda no concretizaram todo o contrato com a TOTVS. Com isso, ainda no
receberam todos os acessos (portal e suporte) e arquivos necessrios (hardlock e licenas). Esta chave possui validade de 20 dias
ou at que todos os acessos e arquivos sejam normalizados.
A Chave de Inicializao apresentada no momento em que for iniciada a primeira sesso do TOTVS 11. Para aplicar a
chave, deve-se inserir o CNPJ do contrato no campo CNPJ e a chave de inicializao que foi enviada junto a nota fiscal, no campo
de Chave de Inicializao, conforme Figura 10.
Figura 10 - Tela da Chave de Inicializao

Verso 1.0

19

License Server TOTVS 11

Ttulo do documento
6.10. Exemplo de Licenas
Este item visa apresentar alguns exemplos de contratos vistos a partir do License Monitor do License Server. Na funo
License Monitor (captulo 11) iremos abordar o funcionamento do monitor especificamente, nesta seo ser apenas representado
exemplos de licenas.
No exemplo da Figura 11 possvel verificar um contrato que possui 26 licenas do tipo Full, 3 licenas de Testes, 1 licena
Light de Comrcio Exterior, 10 licenas Light de CRM e Call Center e limitante de 250 de licena OnDemand para Gesto do Capital
Humano.
Figura 11 - Exemplo de licenas (Full, Light, Test e OnDemand)

No exemplo abaixo, apresentada a licena corporativa. Existem duas caractersticas que possvel observar no monitor
de licenas que indicam que a licena utilizada corporativa (Figura 12):
1. Na seo Licenas disponveis, a licena cujo o Id 4000 (TOTVS Full), possui o campo Qtd. total igual a 9000, este
o nmero mximo de usurios liberados, e indica acesso irrestrito ao produto, uma vez que pouco comum existir um
nmero superior a 9000 usurios acessando simultaneamente o produto.
2. Na seo Liberao corporativa existe uma listagem de CNPJs que fazem parte do grupo, esta caracterstica
especificamente para contratos coorporativos.
Figura 12 - Exemplo de Licena Corporativa

7. Consumo e Abono de Licenas


O consumo de licenas realizado, de maneira geral, na execuo de programas, porm, dependendo do tipo de licena
contratada, existem algumas particularidades.

20

Verso 1.0

License Server TOTVS 11

License Server
Execuo de programas

Consumo
Controle das licenas

Usurios x programas
Segmento contratato

Nomenclatura

ID do segmento (vrios mdulos)

A seguir ser explicado de forma tcnica como ocorre a escalao das licenas e os principais fatores que influenciam na
forma como feito o consumo. Atravs do License Server, que existe o conceito de segmentos, um mesmo programa pode consumir
licena de Lights diferentes, dependendo da regra de escalonamento definido pelo arquivo de licenas, como explicado
posteriormente.
Toda vez que ocorre o login no TOTVS 11 realizada uma requiquisio ao License Server (Figura 13), esta requisio
visa buscar informaes no License Server, tais como: existncia de licenas disponveis para demonstrao (caso de ambiente
esteja configurado para tal), compatibilidade da verso do Lincese Server e o ERP, prazo de vencimento da licena, se a empresa
do usurio est na lista de CNPJs (caso de corporativo), entre outras informaes.
Figura 13 - Momento de comunicao com o LS no Login

Feito o login, caso o usurio permanecer apenas com a interface do menu aberta (sem executar nenhum programa), no
ser consumida nenhuma licena. Em outras palavras, o consumo de licenas ir ocorrer apenas durante a execuo de um
programa. Portanto, ao iniciar um programa, o controle de licenas obtm o mdulo relacionado ao programa e ir consumir uma
licena para o slot equivalente a este mdulo no License Server, conforme a ilustrao da Figura 14.

Verso 1.0

21

License Server TOTVS 11

Ttulo do documento
Figura 14 - Fluxo de Login e Consumo

Importante:
cada mdulo possui um cdigo identificador, a saber, slot, que ser interpretado pelo License Server. Um mesmo programa
pode estar relacionado a mais de um mdulo, e como consequncia a mais de um cdigo, o que o caso de programas de cadastro
gerais (diretrio cdp), onde um mesmo programa utilizado por vrios mdulos.
Quando a mensagem de solicitao de consumo de licena chega ao License Server, ser feita uma leitura do arquivo de
licenas que contm as regras de consumo e havendo licena disponvel, far o consumo. O arquivo de licenas reflete o contrato
do cliente junto a TOTVS.
Exemplo de cenrio real de escalao e consumo de licenas
1) No arquivo de licenas deste exemplo, o cliente possui as licenas abaixo contradas (possvel verificar no License Monitor,
no primeiro browser)
[4001]
[4004]
[4007]
[4092]
[4118]
[4126]
[4133]
[4138]
[4145]
[4155]
[4171]
[4173]

TOTVS I
TOTVS Light ERP
TOTVS Dev Test
DbAccess User
Compras e Suprimentos
ECM / BPM
Financeiro
Frete embarcador
Gesto do Capital Humano
Manuteno de Ativos
TMS - Gesto de transportes
Vendas e Faturamento

2) O usurio acessa o produto, selecionando o mdulo de Faturamento. Solicita a execuo do programa de Atualizao
Parmetros Faturamento FT0301. Neste momento, ocorrero alguns passos para o consumo de licena.
3) O Datasul Interactive (DI) notificar o gerenciador de licenas sobre a execuo do programa FT0301.

22

Verso 1.0

License Server TOTVS 11

4) O gerenciador de licenas procura o slot que dever ser consumida a licena para o programa FT0301 e retorna ao License
Server o valor do slot para consumo, que segundo as regras para este programa seriam os slots 6989 e 6654, nesta ordem.
5) O License Server, por sua vez, verifica se ou no possvel consumir uma licena no primeiro slot.
6) Caso seja permitido, consumido o slot solicitado.
7) Seno, tenta o consumo do prximo slot.
8) Se o License Server estiver com o nvel de detalhes de log ativo, ser possvel verificar o recebimento do consumo de
licena, sendo que no item marcado abaixo o cdigo do slot que consumiu, no caso 6989:
[INFO ][LICENSESERVER] -------- LS_GetTotal (6989) 23/09/2014 14:5:20 -------[INFO ][LICENSESERVER] Server: 10.80.6.100 Port: 2234 ThreadID: 25404
[INFO ][LICENSESERVER] Module: 6989 Total: 26 Lasting 25
[INFO ][LICENSESERVER] Return: 26
[INFO ][LICENSESERVER] ---------------------------9) O consumo da licena tambm ser apresentado no License Monitor (ver funcionamento no captulo 11) o consumo de
qual ID e o produto que se consumiu a licena.
Para que o License Server identifique qual o slot a ser consumido, 6989 no caso do exemplo, so executadas algumas
verificaes. Para esta escalao, o License Server verifica no arquivo de licenas a regra relacionada para o slot 6898. Ou seja,
procura o totvslic.key, nas rules (regras) a que est relacionada ao slot 6898.
Para o exemplo do cenrio, a regra do arquivo de licenas a seguinte:
rule179=6980:6998;4173;4004;4000
Legenda: rule indica a regra, sinal de pontuao dois pontos indica intervalo de slots, sinal de pontuao ponto e vrgula indica
a sequncia de IDs de produto, sinal de pontuao vrgula indica sequncia de slots
Pela regra apresentada, o slot 6989 est contido no intervalo de 6980 a 6998. O License Server tentar consumir uma licena
inicialmente para o ID [4173] Vendas e Faturamento que, no exemplo em questo, consumiu deste ID.
Entretanto, supondo que todas as licenas do ID [4173] Vendas e Faturamento j estivessem sendo consumidas, ento o License
Server em seguida, buscaria o consumo para o prximo ID: [4004] TOTVS Light ERP. Se tambm no conseguisse consumir alguma
licena, por ltimo buscaria o consumo no ID [4000] TOTVS Full se o cliente possusse um contratado, no sendo possvel o
consumo para estas licenas, faria uma nova solicitao de consumo. Entretanto, seria para o segundo slot: 6654 que tem a seguinte
regra: rule94=6648:6701;4137;4145;4126;4173;4133;41184004;4000. Para este caso, o License Server buscaria o consumo de
licena conforme a sequncia de IDs de produto e no encontrando uma licena disponvel, retornaria a mensagem -20 que, nesse

Verso 1.0

23

License Server TOTVS 11

Ttulo do documento
momento, enviaria ao usurio final a mensagem de que no foi possvel consumir licena (no corpo da mensagem indicar nos
detalhes o erro -20).
Liberao das licenas
A liberao das licenas no TOTVS 11 pode ocorrer de diversas maneiras, sendo as mais comuns:

Fechar o produto (menu);

Fechar o programa;

Logoff no TOTVS 11;

Timeout do TOTVS 11;

Atualizao da pgina do TOTVS 11;

Queda do Servidor de Aplicao JBoss;

Queda no License Server;

Queda de rede.
Ou seja, todo momento que o programa que est consumindo licena for encerrado de alguma maneira, a licena deixa de

ser consumida no License Server.


Abono de Licenas
O conceito de abono de licenas consiste em consumir uma nica licena quando um usurio acessa mais de um programa da
mesma famlia na mesma sesso. Uma sesso refere-se ao acesso de um usurio uma instncia de menu. Por exemplo, se um
usurio estiver acessando o TOTVS 11 em um mesmo computador, porm, utilizando diferentes abas em seu navegador para cada
aplicativo em execuo, ser considerada a mesma sesso, visto que, os aplicativos foram executados a partir da mesma instncia
de menu. Para mais detalhes relacionados ao abono de licenas, entre em contato com seu EAR.

8. License Server x Hash


O Hash uma modalidade onde a controle das licenas feito sobre uma chave nica, que definida no arquivo de
licenas, na instalao e nos arquivos de configurao do License Server, por fim, no sendo necessrio o uso do hardlock.
Ou seja, uma modalidade utilizada especialmente para clientes ASP (que possuem seu ambiente hospedado em nosso
datacenter), ou para clientes onde crtico o uso do hardlock.
Clientes que utilizam esta modalidade, sempre que for feita uma alterao no servidor, ou at mesmo depois da atualizao
do LS, precisam que seja gerada uma nova licena e alterados os arquivos necessrios. Devido a esta complexidade na manuteno
do ambiente, que utilizado o hardlock.
A chave referenciada acima gerada ao acessar o monitor do License Server, teclando "Shift + F6", conforme Figura 15.

24

Verso 1.0

License Server TOTVS 11

Ser necessrio extrair o contedo do campo hash e enviado para o CST gerar uma nova licena. Feito isso, este mesmo
ID dever ser informado no campo "demonstration=" no arquivo BIN\appserver.ini.
Figura 15 - Sobre License Server

9. Funo de Ambiente de Teste no TOTVS 11


possvel configurar o ambiente do TOTVS 11 para testes. O ambiente configurado desta maneira consumir uma licena
especfica, do tipo TOTVS Dev Test, de acordo com a quantidade de programas abertos no ambiente. Por exemplo, na Figura 16
possvel verificar que na licena contratada possui quantidade total de 10 licenas TOTVS Dev Test. Portanto, possvel acessar
10 programas de maneira simultnea no ambiente. Quando essas licenas do tipo teste acabam, o sistema no interrompido, ele
apenas deixa de consumir uma prxima licena TOTVS Dev Test e consumir uma licena comum, de acordo com a regra de
escalao e consumo de licenas do contrato. Quando o usurio efetua logoff do produto, esta licena automaticamente liberada.
Figura 16 - Exemplo de licena TOTVS Dev Test

Importante

A configurao da base de testes realiza alteraes no banco de dados e no podem ser revertidas.

sugerida a realizao do backup destas bases de dados antes da execuo do procedimento.

Este procedimento deve ser feito em mono-usurio.

Verso 1.0

25

License Server TOTVS 11

Ttulo do documento

Base de testes e produo devem ter arquivos .ini e demais configuraes de banco de dados diferentes, e no momento

da parametrizao, deve certificar que o procedimento est sendo feito em base de testes.

No deve ser conectado os bancos de produo.


O TOTVS 11 precisa ser configurado para o tipo teste atravs do datasul_framework.properties, localizado no diretrio de

instalao do JBoss: <diretrio-de-instalacao-JBOSS>\server\<home-instancia>\conf\datasul\datasul_framework.properties. Ao


abrir este arquivo com um editor de texto deve-se alterar a propriedade license.ambient.type para test, conforme o exemplo abaixo:
license.server=10.80.6.100
license.port=5555
license.timeout=30
license.showlog=all
license.ambient.type=test

Importante
1) Quando a alterao no Datasul_framework.properties for realizada, o servio do JBoss precisa ser reiniciado.
2) Aps a alterao do arquivo e o JBoss reiciado nota-se que o produto assume uma cor diferenciada para identificao que
aquele um ambiente de testes. A tela do produto ter cor rosa e ao lado do nome da empresa aparecer a palavra
[TESTE], conforme Figura 17.
Figura 17 - Apresentao do TOTVS 11 num ambiente de Teste

26

Verso 1.0

License Server TOTVS 11

10. Funo de Ambiente de Demonstrao no TOTVS 11


Este tipo de ambiente configurado especialmente aos consultores, a fim de parametrizar uma base de demonstrao,
com o objetivo de fazer apresentaes e treinamentos a clientes. importante ressaltar que neste modo no h necessidade de um
servidor de licenas configurado, ou seja, um ambiente que funciona independente de License Server. Porm, h limite de 2
acessos simutneos neste tipo de ambiente, portanto, quando um terceiro usurio tenta conexo no ambiente de demonstrao seu
login interrompido. No haver consumo de licenas por programa, apenas o consumo no login, limitando-se a 2 usurios
sumultneos no ambiente, at a sada do mesmo do ambiente.
Importante

Um ambiente de demonstrao permite, no mximo, dois acessos simultneos.

No precisa de License Server.

A configurao da base de demonstrao realiza alteraes no banco de dados e no podem ser revertidas.

sugerido que seja feito o backup destas bases de dados antes da execuo do procedimento.

Este procedimento deve ser feito em mono-usurio.

Base de demonstrao e produo devem ter arquivos .ini e demais configuraes de banco de dados diferentes, e no

momento da parametrizao, deve certificar que o procedimento est sendo feito em base de demonstrao.

No deve ser conectado os bancos de produo.


O TOTVS 11 precisa ser configurado para o tipo demonstrao atravs do datasul_framework.properties, localizado no

diretrio de instalao do JBoss: <diretrio-JBOSS>\server\<home-instancia>\conf\datasul\datasul_framework.properties. Ao abrir


este arquivo com um editor de texto deve-se alterar a propriedade license.ambient.type para demonstration, conforme o exemplo
abaixo:
license.server=10.80.6.100
license.port=5555
license.timeout=30
license.showlog=all
license.ambient.type=demonstration

Importante
1) Quando a alterao no Datasul_framework.properties for realizada, o servio do JBoss precisa ser reiniciado.
2) Aps a alterao do arquivo e o JBoss reiciado nota-se que o produto assume uma cor diferenciada para identificao que
aquele um ambiente de testes. A tela do produto ter cor rosa e ao lado do nome da empresa aparecer a palavra
[DEMONSTRAO], conforme Figura 18.

Verso 1.0

27

License Server TOTVS 11

Ttulo do documento
Figura 18 - Apresentao do TOTVS 11 num ambiente de Demosntrao

11. License Monitor


Aps a instalao do License Server, possvel acessar o License Monitor (Figura 19), que uma ferramenta para
monitoramento do consumo das licenas do License Server.
O instalador do License Server realiza a instalao do License Monitor automaticamente. Na verso Windows ele est
disponvel no Menu de Programas do Windows. J no Linux, ele est disponvel no diretrio de instalao do License Server, no
diretrio Monitor.

28

Verso 1.0

License Server TOTVS 11

Figura 19 - TOTVS License Server Monitor

Seo Licenas disponveis

Seo Usurios Conectados

Seo Consumo

Seo Informaes Adicionais

A primeira rea a Seo de Licenas Disponveis (Figura 20).


Figura 20 Seo de Licenas disponveis

Verso 1.0

29

License Server TOTVS 11

Ttulo do documento
Nesta rea so listadas todas as licenas que foram contratadas, onde:

Id. Licena: indica o cdigo da licena, um cdigo utilizado para controle interno.

Qtd. Total: indica a quantidade de licenas contratadas para cada segmento. Para licena TOTVS FULL, se o campo
Qtd. total for igual a 9000, indica que se trata de uma licena corporativa.

Limitante: este campo utilizado para licenas do tipo ondemand, onde o controle feito por determinada regra de
negcio, o que ocorre com as licenas para o HCM (id. 4145 Gesto de Capital Humano), onde no campo limitante, sero
listados o nmero de funcionrio que podero estar ativos no sistema. Para visualizar corretamente o contedo do campo
limitante, necessrio estar com a verso de fevereiro de 2011 ou superior do LS.

Descrio: ser apresentada a descrio da licena para o id em questo, para licenas do tipo Light, ser apresentada
a descrio do segmento de negcio ao qual se destina determinada licena.

Liberao Corporativa: Esta seo ser utilizada por clientes cuja licena Corporativa e feito o controle dos CNPJs
cadastrados no ERP, sero listados todos os CNPJs das empresas do grupo.

Outras funcionalidades:

possvel ordenar as colunas de acordo com os campos disponveis, pressionado sobre o cabealho deste campo.

Com um duplo clique do mouse sobre a licena, o sistema apresenta os mdulos de todas as linhas de produto que aquela
licena habilita, se houver.

Pressionando o boto

, o sistema apresentada um grfico com o consumo da licena. O consumo coletado a cada

15 minutos e mantm um histrico dos ltimos trs meses de consumo. Os grficos apresentados mostram a quantidade
de licenas disponveis no momento da coleta. O primeiro acesso a esta funcionalidade somente estar disponvel aps
30 minutos de execuo do TOTVS License Server.

O boto

, utilizado para desconexo dos usurios, quando ocorre problemas de comunicao (rede) entre o client

e o servidor, ou ainda, quando existir falta de licena. A mensagem enviada ao clicar no boto desconectar pode demorar
cerca de 20 segundos at que se obtenha o retorno, este o tempo de pulse do LS para processar a informao. uma
opo disponvel a partir da verso de junho de 2011
A prxima seo a de Usurios Conectados, Figura 21. Nesta rea sero listados todos os usurios que esto utilizando o
ambiente e consumindo licenas.

30

Verso 1.0

License Server TOTVS 11

Figura 21 - Seo usurios conectados

Nesta seo so listados os seguintes campos:

IP AppServer: IP da estao cliente que est acessando o produto.

Porta: Porta utilizada para acesso, utilizada para controle interno.

Thread Id: Indica o processo que foi instanciado com o gerenciador de licena, tambm utilizada para controle interno.

Usurio: Usurio do ERP que est consumindo a licena.

Slot solicitado: Cdigo interno que representa um mdulo para o produto.

Id Licena: Licena do LS, o gerenciador recebe o slot proveniente do ERP (coluna slot solicitado) e faz o escalonamento
das licenas, ou seja, verifica entre as licenas disponveis, qual poder ser consumida para aquela solicitao.

Tipo de conexo: tipo de conexo utilizada entre o ERP e o LS que pode ser StateLess ou StateFull, para a linha Datasul
utilizado o tipo de comunicao StateLess.

Mdulo: Mdulo que foi acessado a partir do ERP. Cada mdulo do produto possui "slot" e, cada slot, possui uma
descrio, que ser listada no monitor.

Processo/Licena: o status da licena para aquele processo, que pode ser "Em Uso" ou "Livre". Exemplificando, para o
consumo de uma licena Light, onde o consumo das licenas na execuo do programa, caso o usurio acesse o produto
e execute 2 programas do mesmo mdulo/segmento, ser consumida apenas uma licena, porm sero listados dois
processos (duas linhas) no browser, uma "Em uso" e outra "Livre".

Outras funcionalidades:

Pressionando sobre o cabealho da tabela de licenas, o sistema ordena automaticamente a coluna.

Alterando-se a linha da tabela selecionada as tabelas de licena disponvel e consumo so sincronizadas automaticamente.

Na seo Informaes adicionais so demonstradas informaes sobre a verso do License Server e do hardlock (Figura 22).
Figura 22 - Seo Informaes Adicionais

Verso 1.0

31

License Server TOTVS 11

Ttulo do documento
Alguns campos importantes dessa seo:

Nro srie do HL: Corresponde ao nmero do hardlock utilizado.

Verso do LS: Verso do LS, para a linha Datasul a verso mnima a 2010.

Build: Atravs deste campo possvel obter a data de gerao do License Server, aps o hfen, possvel verificar a data
no formato AAAAMMDD.

A combinao das teclas [SHIFT]+[F6] executa o Sobre o Monitor, exportando dados de consumo e da licena em um formato XML.
A seo consumo funciona como um totalizador das licenas utilizadas por segmento (id da licena), sendo possvel
verificar a quantidade utilizada e o saldo para cada uma das licenas. Atravs do id, pode-se checar na seo Licenas disponveis
a que licena equivale (Figura 23).
Figura 23 - Seo Consumo

Erro que pode ocorrer

Esta mensagem pode ocorrer por dois motivos:


Servio do License Server no est ativo.
Servidor e Porta invlidos. Necessrio revisar IP e porta informados no arquivo
<diretorio_instalacao_ls>\monitor\smartclient\totvssmartclient.ini.

32

Verso 1.0

License Server TOTVS 11

12. Mensagens, dvidas e situaes comuns


A seguir sero apresentadas as pricipais dvidas e situaes comuns que podem gerar sobre o License Server. Alguns
itens podem ser encontradas na rea de FAQ no TDN. Acesse http://tdn.TOTVS.com/display/dts/FAQ+-+Atendimento ou ento, em
http://tdn.TOTVS.com > Datasul > Tecnologia > Framework > FAQ Atendimento.
possvel acompanhar o consumo das licenas utilizando o promon do Progress?
Com o License Server ativo, possvel que mesmo usurio esteja consumindo mais de uma licena simultaneamente, quando
estiver executando dois programas de segmentos diferentes por exemplo, e desta forma, como o promon do progress lista as
conexes ao banco, e o consumo das licenas pode ser por execuo de programas, no ser possvel acompanhar o consumo
utilizando este aplicativo, para acompanhamento do consumo das licenas, pode ser utilizado o TOTVS License Monitor.
O mesmo usurio pode consumir mais de uma licena com apenas uma seo do produto aberta?
Sim. Conforme regras de consumo passadas no item 7, caso estejam sendo utilizadas licenas Light, e forem executados dois
programas de segmentos diferentes (por exemplo, um programa do financeiro e um segundo programa de compras), sero
consumidas duas licenas, dos respectivos Lights.
Foram abertos trs programas do mesmo segmento na mesma seo do produto, e foram consumidas trs licenas, o que
verifico?
Indicamos nestes casos que seja regerado o arquivo de licenas (TOTVSlic.key) e atualizado em seu ambiente.
No arquivo de licenas so definidas regras para escalonamento das licenas, sendo que estas regras so passveis de aterao,
influenciando no consumo das licenas. Alm do arquivo de licenas, importante garantir que o License Server esteja atualizado,
sendo compatvel com a licena utilizada.
Estou acessando o produto, porm, na tentativa de abrir um novo programa, apresentada a mensagem 36155 [LS Error
-20] Excedeu nmero de licenas...
Supondo que se tenha apenas 5 licenas FULL, e 5 usurios estejam logados no produto e consumindo licena (executando um
programa cada), neste momento o saldo de licenas zero.
Se um dos usurios, o usurio joao fechar o programa e ficar apenas com o menu aberto, e neste mesmo momento um outro
usurio, o usurio maria acessar o produto e executar um programa, ir consumir a licena do usurio joao que fechou o programa
que estava em execuo, logo, quando o usurio joao tentar executar um novo programa, ser apresentada a mensagem de erro
36155, indicando que no h mais licenas disponveis.

Verso 1.0

33

License Server TOTVS 11

Ttulo do documento
Quando feito o acesso ao produto, no apresentada a mensagem 51157 indicando que no existem licenas disponveis,
porm na execuo de qualquer programa, apresentada a mensagem 36155, indicando que excedeu o nmero de licenas.
Isso ocorre pois no login feito um teste verificado se existem licenas disponveis, e a licena que est disponvel, no
necessariamente ser a licena que o usurio ir requisitar.
Esta situao comum para clientes que possuem os produtos EMS2 e HCM, o EMS2 controlado por licena light e o HCM
controlado por funcionrios (OnDemand), mesmo no tendo mais licenas do EMS2 disponvel, o usurio poder logar neste
produto, porm na execuo do programa, ser apresentada a mensagem erro 36155. No login do EMS2, foi considerado que
haviam licenas disponveis, e estas licenas eram apenas para o HCM, porm no feita esta validao.
Se for aplicada a chave de emergncia, ao restabelecer os servios do License Server, esta chave deixa de ser utilizada?
No, depois de aplicada a chave de emergncia, a mesma ser utilizada por dois dias. Ao terminar o prazo da chave, o produto
automaticamente passa a utilizar a licena oficial.
Como solicitar a chave de emergncia?
Esta chave pode ser obtida pelos seguintes meios:
- atravs do URA, telefone 4003-0015, opes 4 e 4;
- atravs do http://suporte.TOTVS.com.br, opo CST (Relacionamento) > Gerao de Senhas
Como solicitar uma nova licena (TOTVSlic.key)?
A licena pode ser obtida pelos seguintes meios:
- atravs do Portal de Clientes > opo AutoAtendimento CST > Gerao de Senhas > Liberao de licenas/senhas (License Server
/ Hardlock);
- no Portal de Cliente, atravs da abertura de um chamado para o CST, na pgina principal selecione Relacionamento > CST (Centro
Administrativo), selecione as opes Assunto: CST: Senhas e Produto: Liberao de Senhas.
possvel utilizar o License Server sem hardlock?
No recomendado.
Foi ativado o License Server, porm ao acessar o produto est sendo apresentada a mensagem 18235 indicando que o
produto ir expirar amanh, o que deve ser verificado?
Esta situao possivelmente ocorre pois foi aplicada a chave de emergncia no produto, e a mensagem apresentada com relao
a validao da chave de emergncia.

34

Verso 1.0

License Server TOTVS 11

Alm do Datasul, tenho outros produtos de outras linhas, posso utilizar o mesmo hardlock?
Sim.
Tenho uma base histrica cuja atualizao de pacotes foi congelada, como procedo para solicitao de novas licenas?
Ser necessrio entrar em contato com seu EAR para que o mesmo possa negociar o envio de novas licenas.
Est sendo apresentada a mensagem 36112 "Ocorreu um erro de conexo com o Gerenciador de Licenas." ao tentar iniciar
o RPW com o License Server ativo.
Causa: Ao efetuar login no produto, seja por um atalho padro ou um atalho RPW, realizada a leitura do arquivo "config\licenseserver.xml" a fim de buscar o IP e a Porta dos quais esto iniciados os servios do License Server e License Controller. Caso o
primeiro arquivo "license-serve.xml", localizado no propath, esteja em branco ou com IP e Porta invlidos, apresentada a
mensagem.
Soluo: Rever o propath do RPW para confirmar se o arquivo correto est na primeira entrada dele.
Observaes: Informaes adicionais podem ser obtidas no manual de referncia do Mdulo Bsico - BTB.
Por que o consumo das licenas, algumas vezes, no apresentado no License Monitor do License Server?
Possivelmente devido ao tipo de licena e/ou contrato.
Verificar dvida na FAQ: http://tdn.TOTVS.com/pages/viewpage.action?pageId=5255649
O License Server a ser utilizado pelo TOTVS 11 precisa ser instalado no mesmo servidor de banco de dados?
O License Server pode ser instalado no servidor de banco de dados ou em um servidor de aplicao. Entretanto, no servidor em
que for instalado o License Server, ser considerado um servidor de licenas e neste se exige a instalao do dispositivo fsico
(hardlock) na porta USB. O License Server um servio, logo, o TOTVS 11 deve conseguir visualizar este servio. Informaes
adicionais sobre a instalao do License Server, podem ser encontradas junto a mdia de instalao do License Server.
Erro 31985 Registro Produto Inexistente na ativao do RPW.
Causa: Esta mensagem ocorre porque a rea de programas do RPW est desatualizada; e os programas utilizados antes de conter
a lgica que contempla o License Server buscam dados da tabela de controle que foi eliminada durante a ativao do License
Server.
Soluo: Atualizar a rea de programas utilizada pelo RPW.
Observaes: Informaes adicionais sobre RPW podem ser encontradas no manual de referncia do mdulo Bsico.
No login do TOTVS 11 exibida a mensagem de erro Erro ao validar o CNPJ no servidor de licenas. No foi possvel
validar o CNPJ no servidor de licenas pois o mesmo no est respondendo. Tente acessar mais tarde ou entre em contato
com o administrador do sistema..

Verso 1.0

35

License Server TOTVS 11

Ttulo do documento
O servio do License Server no est ativo. Caso o JBoss tenha sido iniciado com o servio do License Server inativo, aps ativar
o servio, deve-se tambm reiniciar o JBoss.
No login do TOTVS 11 exibida a mensagem de erro Erro ao validar o CNPJ no servidor de licenas. O CNPJ XXXXXXXXX
no est disponvel na lista de empresas cadastradas no servidor de licenas. Entre em contato com o administrador do
sistema..
O usurio que est tentando logar no TOTVS 11 no possui a empresa do CNPJ da mensagem relacionada ao seu usurio. Esta
empresa deve estar associada ao usurio e ser a empresa corrente do usurio no momento.
No Login do TOTVS 11 exibida a mensagem de erro: Acesso no autorizado. Excedeu o nmero de licenas para acessar
o produto. Tente acessar mais tarde ou entre em contato com o administrador do sistema.
No h licenas disponveis para fazer login no produto. Espere at um dos usurios desconectar, ou, entrar em contato com o
administrador do ambiente.
Durante a execuo do produto ocorreu a mensagem de erro: Nenhuma ao realizada por tempo determinado. A sesso
foi encerrada automaticamente pela aplicao..
Sua sesso do TOTVS 11 ficou muito tempo inativa e ocorreu timeout da sesso. As licenas que estavam sendo consumidas,
foram automaticamente liberadas.
No Login do TOTVS 11 foi exibida uma mensagem de alerta: A licena de uso ir expirar em X dia(s).
A mensagem exibida quando faltam menos de 30 dias para o vencimento da licena. Entre em contato com a TOTVS atravs do
suporte (rea de senhas) para adquirir um novo arquivo de licenas.
Durante a execuo do TOTVS 11 ocorreu a mensagem de erro: Erro na comunicao com o servidor de licenas. A sesso
foi encerrada automaticamente pela aplicao.
O erro pode ter acontecido por diversos motivos: Servidor License Server fora do ar, JBoss no est respondendo, queda na rede,
problemas na estao de trabalho, por exemplo.
Durante o Login no TOTVS 11 exibida a mensagem de erro: Erro ao validar o CNPJ no servidor de licenas. O CNPJ no
est disponvel na lista de empresas cadastradas no servidor de licenas. Entre em contato com o administrador do
sistema.
O arquivo de licenas que est sendo utilizado pelo servidor do License Server no contm o CNPJ correto que est se comunicando
com o TOTVS 11. necessrio entrar em contato com a TOTVS para verificar seu arquivo de licenas.

36

Verso 1.0

License Server TOTVS 11

Durante o login ou execuo do TOTVS 11 exbida a mensagem de erro: A licena de uso expirou. O servidor de licenas
(License Server) requer que sua licena seja renovada agora.
A licena venceu e deve ser renovada. Pode-se entrar em contato com a TOTVS e solicitar a renovao da licena atravs do
suporte (rea de senhas).
Aps a aplicao de uma chave de emergncia exibida a mensagem de erro: Empresa vinculada ao usurio atual no
liberada para utilizao emergencial do sistema.
necessrio que o usurio que v aplicar a chave de emergncia tenha acesso a empresa que a chave de emergncia foi gerada.
Durante a execuo do TOTVS 11 exibida a mensagem: Problema na conexo com o LS.
possvel que seu License Server encontra-se inativo. necessrio reativar o servio, entre em contato com o administrador do
sistema.
Como acessar o monitor?
O instalador do TOTVS License Server realiza a instalao do TOTVS License Monitor automaticamente. Na verso Windows ele
est disponvel no Menu de Programas do Windows. J no Linux, ele est disponvel no diretrio de instalao do TOTVS License
Server, pasta Monitor.
Como acessar o monitor do License Server a partir de outras estaes (para instalao em um servidor Windows e Linux)?
Ser necessrio fazer uma nova instalao do License Server nas estaes. Durante a nova instalao, haver uma tela com o
seguinte questionamento "Habilitar o License Server neste Server?", onde para as estaes que apenas iro utilizar o monitor, devese escolher a opo "No".
Feita a nova instalao, ser necessrio alterar o arquivo <dir_instalacao_ls>\monitor\smartclient\TOTVSsmartclient.ini, seo
[tcp], onde o campo server deve apontar para o servidor onde foi instalado o LS, e caso tenha tenha sido alterada a porta default
da instalao (no servidor), nas novas intalaes (estaes), esta informao tambm deve ser alterada:
[tcp]
server=10.10.10.10
port=2234

Outras mensagens/cdigos de erros que podem acontecer no seu ERP:


Cdigo
-80
-70
-50
-40
-30

Verso 1.0

Descrio do Erro
Erro na tentativa de salvar arquivo de configurao.
Hasp no encontrado.
Erro no Checksum. Verifique se o ID informado o mesmo do documento e se os dados foram digitados
corretamente (data de expirao, nmero de licenas de cada mdulo e nmero do CheckSum).
Licena expirou (data).
Excedeu nmero de Processos.

37

License Server TOTVS 11

Ttulo do documento
-20
-13
-12
-11
-10
-9
-7
-6
-5
-3
-2
-1
-101
-102
-103
-104
-105
-106
-107
-108
-110
-111
-112
-200
-201
-202
-210
-211
-212
-1000
-303
-307

Excedeu nmero de licenas.


No existe nenhuma licena em uso para este 'Owner' (IP Server+ Porta+Nmero da thread).
(Numerador) Chave j existia.
(Numerador) Chave no encontrada.
No foi possvel mudar o tipo de licena, manteve a anterior.
Data do Servidor de Licenas difere da data do Servidor Protheus.
J existe licena em uso para este 'Owner' (IP Server+ Porta+Nmero da thread).
Erro interno inesperado.
Erro no ap7srv.ini (ou mp8srv.ini), seo LicenseServer.
Data de expirao invlida.
Erro nos parmetros.
Servidor de Licenas no est respondendo.
Time-out: erro na operao de escrita (HASP).
Endereo est fora dos limites.
Dispositivo de segurana HASP no est conectado ou o HASP no o fornecido pela Microsiga.
HASP foi encontrado, mas no um MemoHASP (que o tipo do Hasp utilizado pela Microsiga.).
Erro na operao de escrita (HASP).
Erro HASP: a porta paralela no est disponvel no momento. Outro dispositivo conectado a ela, como, por exemplo,
uma impressora, est ativa.
O tamanho do buffer muito pequeno. Este erro somente ocorre com servios que requerem um tamanho de buffer
mnimo.
O hardware no suporta o servio solicitado. Este servio requer um HASP4..
Acesso ao ID do Hasp est proibido porque a aplicao est rodando atravs de uma janela remota no 'Citrix
Mainframe' ou 'Windows Terminal Server' (por segurana, a aplicao s pode ser rodada na prpria mquina).
Acesso ao ID est proibido porque a aplicao est rodando no 'Citrix Mainframe' ou 'Windows Terminal Server'
('service pack' 4+ necessrio para detectar se est rodando na prpria mquina).
Um parmetro passado ao servio no vlido ou est fora dos limites.
No foi possvel abrir o driver do HASP. Instale o 'Hasp Device Driver' segundo o manual de instalao do Protheus,
no tpico 'Instalao do driver do HASP'.
No foi possvel ler o driver do HASP.
No foi possvel fechar o driver do HASP.
No foi possvel abrir o driver do HASP. Refere-se a aplicaes DOS.
No foi possvel ler o driver do HASP. Refere-se a aplicaes DOS.
No foi possvel fechar o driver do HASP. Refere-se a aplicaes DOS.
Servio invlido.
Driver Compact-500 no instalado
Plugue Compact-500 no encontrado na porta paralela e nem USB.

38

Verso 1.0

License Server TOTVS 11

13. Glossrio
License Server (LS): Gerenciador de Licenas TOTVS.
Hardlock: Dispositivo de segurana que pode ser conectado na porta paralela ou USB dependendo do modelo recebido. Pode ser
HASP ou Proteq/SafeNet.
EAR: Executivo de Atendimento e Relacionamento, responsvel pelas alteraes contratuais dos clientes TOTVS.
CST: Centro de Servios TOTVS, rea responsvel por assuntos administrativos e financeiros.
Slot: Cdigo utilizado para referenciar o mdulo onde ocorrer o consumo de licenas.
Rules: Regras para serem utilizadas no escalonamento de licenas.
Timeout: Inatividade da sesso por determinado tempo.
Datasul Interactive (DI): Tela de sesso Progress do TOTVS 11.

Verso 1.0

39