Manual Tecnico Ls Totvs11 v2

download Manual Tecnico Ls Totvs11 v2

of 39

Transcript of Manual Tecnico Ls Totvs11 v2

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    1/39

    18/09/2014

    License ServerTOTVS 11

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    2/39

    License ServerTOTVS 11

    2 Verso 1.0

    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

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    3/39

    3Verso 1.0

    License ServerTOTVS 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 opte-

    se por mais de uma instalao fsica do TOTVS License Server, ser necessrio o registro da diviso das l icenas 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 RequisitoProcessador Mnimo: 1 GHz

    Recomendado: 2 GHz Ideal: 3 GHz ou mais velozObservao:No utilizar um processador menor que o recomendado pelo fabricante dosistema operacional.

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

    Espao disponvel em disco Mnimo: 1GB (livre) Recomendado: 10 GB (considerando crescimento do banco de dados temporrio)

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    4/39

    License ServerTOTVS 11

    4 Verso 1.0

    Ttulo do documento

    Sistema Operacional VersoMicrosoft 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

    ohttp://suporte.TOTVS.com.br,opo CST (Relacionamento) > Gerao de Senhas. Ou ento, atravs do URA, telefone 4003-

    0015, opes 43.

    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

    http://suporte.totvs.com.br/http://suporte.totvs.com.br/http://suporte.totvs.com.br/http://www.totvs.com/suporte/central-de-download/seu-segmento/produto/tecnologiahttp://www.totvs.com/suporte/central-de-download/seu-segmento/produto/tecnologiahttp://www.totvs.com/suporte/central-de-download/seu-segmento/produto/tecnologiahttp://suporte.totvs.com.br/
  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    5/39

    5Verso 1.0

    License ServerTOTVS 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.

    http://tdn.totvs.com/pages/viewpage.action?pageId=6065890http://tdn.totvs.com/pages/viewpage.action?pageId=6065890http://tdn.totvs.com/pages/viewpage.action?pageId=6065890
  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    6/39

    License ServerTOTVS 11

    6 Verso 1.0

    Ttulo do documento

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

    4.

    Escolher o diretrio de instalao do License Server.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    7/39

    7Verso 1.0

    License ServerTOTVS 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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    8/39

    License ServerTOTVS 11

    8 Verso 1.0

    Ttulo do documento

    7. Verificar necessidade de habilitar controle de numerao automtica pelo HL.

    8.

    Verificar necessidade de instalao do driver do HL.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    9/39

    9Verso 1.0

    License ServerTOTVS 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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    10/39

    License ServerTOTVS 11

    10 Verso 1.0

    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 2Localizao do TOTVSlic.key

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

    Figura 3 - Servio do License Server

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    11/39

    11Verso 1.0

    License ServerTOTVS 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 \BIN\AppServer.exe -install. Caso queira iniciar o servio

    manualmente, pode ser utilizado um atalho com o seguinte comando \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 \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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    12/39

    License ServerTOTVS 11

    12 Verso 1.0

    Ttulo do documentoFigura 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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    13/39

    13Verso 1.0

    License ServerTOTVS 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 onome 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.serverdeve 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.timeoute o tipo de log permitido em license.showlog, que permite os valores: none, all, info, debuge

    error. 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).

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    14/39

    License ServerTOTVS 11

    14 Verso 1.0

    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 TOTVSDev 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 concorrentesso 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 OnDemandso aquelas cujo controle realizado pela contagem do volume de itens ativos deuma 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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    15/39

    15Verso 1.0

    License ServerTOTVS 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

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    16/39

    License ServerTOTVS 11

    16 Verso 1.0

    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=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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    17/39

    17Verso 1.0

    License ServerTOTVS 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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    18/39

    License ServerTOTVS 11

    18 Verso 1.0

    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 baseeste 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).

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    19/39

    19Verso 1.0

    License ServerTOTVS 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

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    20/39

    License ServerTOTVS 11

    20 Verso 1.0

    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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    21/39

    21Verso 1.0

    License ServerTOTVS 11

    License Server

    Consumo Execuo de programas

    Controle das licenas Usurios x programasSegmento 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 slotequivalente a este mdulo no License Server, conforme a ilustrao da Figura 14.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    22/39

    License ServerTOTVS 11

    22 Verso 1.0

    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] TOTVS I

    [4004] TOTVS Light ERP

    [4007] TOTVS Dev Test

    [4092] DbAccess User

    [4118] Compras e Suprimentos

    [4126] ECM / BPM

    [4133] Financeiro

    [4138] Frete embarcador

    [4145] Gesto do Capital Humano

    [4155] Manuteno de Ativos

    [4171] TMS - Gesto de transportes

    [4173] Vendas e Faturamento

    2) O usurio acessa o produto, selecionando o mdulo de Faturamento. Solicita a execuo do programa de AtualizaoParmetros FaturamentoFT0301. 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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    23/39

    23Verso 1.0

    License ServerTOTVS 11

    4) O gerenciador de licenas procura o slot que dever ser consumida a licena para o programa FT0301 e retorna ao LicenseServer 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 delicena, 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 dequal ID e o produto que se consumiu a licena.

    Para que o License Server identifique qual o slota 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 slot6898. Ou seja,

    procura o totvslic.key, nas rules (regras) a que est relacionada ao slot6898.

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

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    24/39

    License ServerTOTVS 11

    24 Verso 1.0

    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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    25/39

    25Verso 1.0

    License ServerTOTVS 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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    26/39

    License ServerTOTVS 11

    26 Verso 1.0

    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: \server\\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

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    27/39

    27Verso 1.0

    License ServerTOTVS 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: \server\\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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    28/39

    License ServerTOTVS 11

    28 Verso 1.0

    Ttulo do documentoFigura 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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    29/39

    29Verso 1.0

    License ServerTOTVS 11

    Figura 19 - TOTVS License Server Monitor

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

    Figura 20Seo de Licenas disponveis

    Seo Licenas disponveis

    Seo Usurios Conectados

    Seo Informaes Adicionais Seo Consumo

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    30/39

    License ServerTOTVS 11

    30 Verso 1.0

    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. 4145Gesto 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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    31/39

    31Verso 1.0

    License ServerTOTVS 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

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    32/39

    License ServerTOTVS 11

    32 Verso 1.0

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

    \monitor\smartclient\totvssmartclient.ini.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    33/39

    33Verso 1.0

    License ServerTOTVS 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. Acessehttp://tdn.TOTVS.com/display/dts/FAQ+-+Atendimentoou ento, em

    http://tdn.TOTVS.com> Datasul > Tecnologia > Framework > FAQAtendimento.

    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 novoprograma, ser apresentada a mensagem de erro

    36155, indicando que no h mais licenas disponveis.

    http://tdn.totvs.com/display/dts/FAQ+-+Atendimentohttp://tdn.totvs.com/display/dts/FAQ+-+Atendimentohttp://tdn.totvs.com/display/dts/FAQ+-+Atendimentohttp://tdn.totvs.com/http://tdn.totvs.com/http://tdn.totvs.com/http://tdn.totvs.com/display/dts/FAQ+-+Atendimento
  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    34/39

    License ServerTOTVS 11

    34 Verso 1.0

    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 dohttp://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.

    http://suporte.totvs.com.br/http://suporte.totvs.com.br/http://suporte.totvs.com.br/http://suporte.totvs.com.br/
  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    35/39

    35Verso 1.0

    License ServerTOTVS 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\license-

    server.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 contatocom o administrador do sistema..

    http://tdn.totvs.com/pages/viewpage.action?pageId=5255649http://tdn.totvs.com/pages/viewpage.action?pageId=5255649http://tdn.totvs.com/pages/viewpage.action?pageId=5255649http://tdn.totvs.com/pages/viewpage.action?pageId=5255649
  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    36/39

    License ServerTOTVS 11

    36 Verso 1.0

    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.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    37/39

    37Verso 1.0

    License ServerTOTVS 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, deve-

    se escolher a opo "No".

    Feita a nova instalao, ser necessrio alterar o arquivo \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 Descrio do Erro-80 Erro na tentativa de salvar arquivo de configurao.-70 Hasp no encontrado.-50 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).-40 Licena expirou (data).

    -30 Excedeu nmero de Processos.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    38/39

    License ServerTOTVS 11

    38 Verso 1.0

    Ttulo do documento

    -20 Excedeu nmero de licenas.

    -13 No existe nenhuma licena em uso para este 'Owner' (IP Server+ Porta+Nmero da thread).

    -12 (Numerador) Chave j existia.-11 (Numerador) Chave no encontrada.

    -10 No foi possvel mudar o tipo de licena, manteve a anterior.

    -9 Data do Servidor de Licenas difere da data do Servidor Protheus.

    -7 J existe licena em uso para este 'Owner' (IP Server+ Porta+Nmero da thread).-6 Erro interno inesperado.

    -5 Erro no ap7srv.ini (ou mp8srv.ini), seo LicenseServer.

    -3 Data de expirao invlida.-2 Erro nos parmetros.

    -1 Servidor de Licenas no est respondendo.-101 Time-out: erro na operao de escrita (HASP).-102 Endereo est fora dos limites.

    -103 Dispositivo de segurana HASP no est conectado ou o HASP no o fornecido pela Microsiga.

    -104 HASP foi encontrado, mas no um MemoHASP (que o tipo do Hasp utilizado pela Microsiga.).

    -105 Erro na operao de escrita (HASP).-106 Erro HASP: a porta paralela no est disponvel no momento. Outro dispositivo conectado a ela, como, por exemplo,

    uma impressora, est ativa.

    -107 O tamanho do buffer muito pequeno. Este erro somente ocorre com servios que requerem um tamanho de buffermnimo.

    -108 O hardware no suporta o servio solicitado. Este servio requer um HASP4..-110 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).

    -111 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).

    -112 Um parmetro passado ao servio no vlido ou est fora dos limites.

    -200 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'.

    -201 No foi possvel ler o driver do HASP.

    -202 No foi possvel fechar o driver do HASP.

    -210 No foi possvel abrir o driver do HASP. Refere-se a aplicaes DOS.-211 No foi possvel ler o driver do HASP. Refere-se a aplicaes DOS.-212 No foi possvel fechar o driver do HASP. Refere-se a aplicaes DOS.

    -1000 Servio invlido.

    -303 Driver Compact-500 no instalado-307 Plugue Compact-500 no encontrado na porta paralela e nem USB.

  • 7/23/2019 Manual Tecnico Ls Totvs11 v2

    39/39

    License ServerTOTVS 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.