Árvore de páginas

FAQ: Datasul_EMS2/EMS5/HCM/Start/SOP/Dataviewer com License Server, compreendendo a escalação do consumo do ID do produto.
Produto:Datasul
Ambiente:Unspecified
Versão:Datasul_EMS204, Datasul_EMS206b, Datasul_204_Start, Datasul_HCM209_Start, Datasul_HCM201A, Datasul_HCM201A_Start, Datasul_EMS506, Dataul_EMS505, Dataviewer 3.0 e Screen Optimizer.
Sintoma

 

 - O produto Datasul_EMS2/EMS5/HCM/Start/SOP/Dataviewer encontra-se parametrizado para utilizar o License Server (LS).
- O tipo de controle do License Server é por programa (mais informações podem ser encontradas no manual de referencia do módulo Básico, função License Server).
Causa

 

Dúvida sobre a regra existente no arquivo de licenças quando há diversos IDs de produto contratado e o tipo de controle do License Server (LS) é por programa ou o usuário está utilizando o recurso de full determinado.
Solução

 

Quando o tipo de controle do License Server utilizado no produto for por programa, no momento da execução do programa, será enviada uma solicitação para o License Controller (LC) com um uma lista de slots (código) correspondente ao programa, que enviará para o License Server (LS) a solicitação onde será lido o arquivo de licenças que contém as regras de consumo de licenças e havendo licença disponível, fará o consumo. Se o usuário estiver com o recurso de full determinado ativo, o consumo da licença ocorre no momento do login do produto, ou seja, no login do produto é enviada uma solicitação para o License Controller (LC) com o slot 5999 correspondente ao recursos, que enviará para o License Server (LS) a solicitação onde será lido o arquivo de licenças que contém as regras de consumo de licenças e havendo licença disponível, fará o consumo.
 
O arquivo de licenças reflete o contrato do cliente junto a Totvs.
 
A seguir, será ilustrado um cenário de escalação e consumo de licença é por programa e utilizando o produto Datasul_EMS204 (atualizado até o pacote 2.04.F.75), lembrando que as regras e produtos contratados diferem para cada cliente.
 
1.     Licenças contratadas (no Monitor do License Server, são apresentadas no primeiro quadro/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] Gestão do Capital Humano
[4155] Manutenção de Ativos    
[4171] TMS - Gestão de transportes
[4173] Vendas e Faturamento   
 
2.   O usuário acessa o produto, selecionando o módulo de Faturamento. Solicita a execução do programa de “Atualização Parâmetros Faturamento – FT0301”.
 
Neste momento, é enviado, para o LC, a seguinte solicitação (no arquivo de log do LC, a informação é visível):
INFO 110613 13:19:02: >>OP=CONSUMESLOTLIST#PARENTTHREADID=141#PSID=141_2694_141#CUSRNAME=SUPER#MODULE=6989,6654#FEDERALID=
Nota-se que são enviados dois slots na tag MODULE: 6989 e 6654. Neste caso, se para o primeiro slot não existir uma licença disponível, será buscada uma no slot 6654 seguindo as regras de escalação.
 
3.     Se o LS tiver o nível de detalhes de log ativo, será possível também identificar no arquivo de log o recebimento da solicitação do LC e o consumo da licença(mais informações podem ser encontradas na FAQ no site do TDN no caminho Tecnologia TOTVS -> Plataforma TOTVS Tec -> Como Fazer -> TOTVS License Server -> Como fazer para monitorar o consumo de licenças  (link direto http://tdn.totvs.com/kbm#22990)):
 
[INFO ][LICENSESERVER] -------- LS_GetLicenseStateless (6989) 13/06/2011 13:19:2 --------
[INFO ][LICENSESERVER] Server: 10.80.17.44 Port: 2669 ThreadID: 1438712127
[INFO ][LICENSESERVER] Module: 6989 Total: 0 Lasting 0
[INFO ][LICENSESERVER] Return: 5
[INFO ][LICENSESERVER] ----------------------------
 
O consumo da licença também se apresenta no Monitor do License Server (segundo e terceiro quadro/browser) o consumo e de qual ID e produto que se consumiu a licença.
 
Para esta escalação, o LS verifica no arquivo de licenças a regra relacionada para o slot 6898: rule179=6980:6998;4173;4004;4000 (legenda: rule indica a regra, sinal de pontuação dois pontos indica intervalo de slots, sinal de pontuação ponto e vírgula indica a sequência de IDs de produto, sinal de pontuação vírgula indica sequência de slots).
 
Pela regra apresentada, o slot 6989 está contido no intervalo de 6980 a 6998. O LS tentará consumir uma licença inicialmente para o ID [4173] Vendas e Faturamento que, no exemplo em questão, consumiu deste ID.
Entretanto, supondo que todas as licenças do ID [4173] Vendas e Faturamento já estivessem sendo consumidas, então o LS em seguida, buscaria o consumo para o próximo ID: [4004] TOTVS Light ERP. Se também não conseguisse consumir alguma licença, por último buscaria o consumo no ID [4000] Totvs Full se o cliente possuísse um contratado; como não há, o LS retornaria ao LC a mensagem de erro -20, mas como LC recebeu para a solicitação dois slots, faria uma nova solicitação 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 LS buscaria o consumo de licença conforme a sequência de IDs de produto e não encontrando uma licença disponível, retornaria ao LC a mensagem -20 que, nesse momento, enviaria ao usuário final a mensagem de que não foi possível consumir licença (no corpo da mensagem indicará nos detalhes o erro -20).
 
4.     Nota-se que no log do LC, após a solicitação enviada para o LC, há em seguida o retorno de qual slot que foi utilizado para o consumo (no exemplo foi o 6989):
 
INFO 110613 13:19:03: << VALUE=5#MESSAGE=#SLOT=6989|
 
O slot utilizado para o consumo também é apresentado no monitor do License Controller no segundo quadro, campo “Slot solicitado” e na coluna “ID Licença” o ID de produto consumido.
 

 

Observações

Mais informações podem ser obtidas no manual de referência do módulo Básico, função License Server.