Framework - Linha RM - Frame - Como habilitar trace do License Server

Tempo aproximado para leitura: 00:08:00 min

Dúvida
Como habilitar trace do License Server?

Ambiente
Framework - Linha RM - Frame - Todas as versões do sistema RM

Solução
Para habilitar o trace do License Server, necessitamos habilitar a tag tracels no arquivo do RM Host e as tags FWFRAME_TRACELOG e LSDebug no arquivo appserver.ini no servidor de licenças (License Server). Para tanto, realize os seguintes passos:

1.  Acesse o diretório UNIDADE:\totvs\CorporeRM\RM.Net;
2.  Edite o arquivo RM.Host.Service.exe.config utilizando o bloco de notas;
   Caso utilize múltiplos hosts, habilite a tag em todos os arquivos de configuração
   Exemplo: RM.Host.Service.exe.config , RM.Host.Service1.exe.config , RM.Host.Service2.exe.config , RM.Host.Service3.exe.config, etc.
3.  Inclua no contexto do arquivo a tag <add key="tracels" value="true" />, vide exemplo abaixo:
   
   
   
   
4.  Reinicie o serviço do RM Host para que esta alteração seja computada;
   
   
   
   
5. Após realizar essa configuração no RM, acesse o servidor de licenças (License Server);
6. Abra o arquivo appserver.ini (UNIDADE:\totvs\TOTVSLicenseVirtual\bin\appserver);
7. Na seção environment, altere o valor da tag FWFRAME_TRACELOG para o valor 1;
8. Ainda no arquivo appserver.ini, na seção environment, adicione a chave LSDebug=2;
9. Salve o arquivo appserver.ini; 
10. Renomeie o arquivo console.log (UNIDADE:\totvs\TOTVSLicenseVirtual\bin\appserver);
11. Reinicie o serviço do License Server nos serviços do Windows.
    
12. Segue abaixo conteúdo original e alterado do arquivo appserver.ini: 
    
    Alterado \ Original
    
        
    
13. Após habilitar a tag tracels no Host e as tags FWFRAME_TRACELOG e LSDebug no appserver.ini, assim que ocorrer a inconsistência (ou simule a inconsistência), localize o arquivo de log do host na pasta Log (UNIDADE:\totvs\CorporeRM\RM.Net\Processos\Logs) e envie-nos uma cópia para análise via Ticket.
    
    
    
    
    
14. Se não forem localizados os logs na pasta UNIDADE:\totvs\CorporeRM\RM.Net\Processos\Logs, certifique-se se o ambiente está configurado a tag LogPath, caso esteja, gentileza acessar o diretório configurado e avaliar se os logs estão sendo gerados no caminho informado;
15.  Além do arquivo de log do host, nos envie o log do License Server para melhor análise. O arquivo de log do License Server é o arquivo console.log (localizado em: UNIDADE:\totvs\TOTVSLicenseVirtual\bin\appserver) na máquina na qual o License Server está instalado. 

O que devo enviar para análise do suporte?

A análise do log do License Server envolve vários arquivos e é realizada validando a correspondência de informações de um log no outro. Dessa forma, para sermos mais assertivos na análise, necessitamos que sejam encaminhados a maior quantidade possível de detalhes. Nesse sentido, gentileza anexar ao ticket:

1. Print do Totvs License Monitor (print da versão do License Server, print da aba monitoramento, print da aba conexões) evidenciando o erro/inconsistência;
2. Print tela inteira da tela do usuário com o erro apresentado no RM (com informações de nome do usuário, data e hora);
3. Cópia dos logs gerados após a simulação do erro/inconsistência localizados em UNIDADE:\totvs\CorporeRM\RM.Net\Processos\Logs
4. Cópia dos arquivos console.log e console.bak (localizados em: UNIDADE:\totvs\TOTVSLicenseVirtual\bin\appserver) na máquina na qual o License Server está instalado.
   
   É de extrema importância que todos os arquivos sejam coletados ao mesmo tempo (o mais próximo do horário do erro/inconsistência) para garantir que existirá correspondência de informações em ambos os logs, uma vez que o arquivo console.log é substituído após atingir certo tamanho. 

Importante
A tag tracels deve ser habilitada em todos os hosts do ambiente (todas as máquinas que possuem host), pois o server é stateless. 

Após enviar-nos os arquivos de log, pode-se deletar as tags dos arquivos para não gerar perda de performance em seu ambiente.