Base de conhecimento
Encontre respostas para suas dúvidas em quatro fontes de conhecimento diferentes ao mesmo tempo, simplificando o processo de pesquisa.

Alteração da pasta de geração de logs dos serviços Suricato

Descrição:

Orientar os procedimentos para alterar a pasta de geração dos arquivos de log dos principais serviços do Suricato, mantendo a configuração do serviço e da aplicação apontadas para o novo diretório.

 


 

⚠️ Importante
O usuário utilizado pelo serviço deve possuir permissão de escrita no novo diretório de logs.


 


📌 2. Visão geral do procedimento

  • GerServ: alterar o LogPath no instalador, reinstalar o serviço e ajustar o log4j.xml.
  • Suricato REP: alterar o LogPath no install.bat, reinstalar e ajustar o log4j2.xml dentro do JAR.
  • Suricato Face: alterar o LogPath no install.bat, reinstalar e ajustar log4j2.xml e log4j2-mgr.xml.
  • Suricato REPACESSO: seguir o mesmo processo do Suricato REP, ajustando os JARs indicados.
  • Suricato Middleware: alterar o LogPath no install.bat e reinstalar o serviço.
  • Matriz de Acesso: seguir o mesmo procedimento do Middleware.
  • Suricato TOTVS Envio de Marcação: seguir o mesmo procedimento do Middleware.
  • Suricato WS TOTVS: alterar LOGPATH e os parâmetros do WildFly e reinstalar o serviço.


 

💡 Atenção
Os caminhos apresentados neste manual usam C:\Telematica\logsSuricato como exemplo. Substitua pelo diretório definido para o ambiente.


 


⚙️ 3. GerServ

1. Pare o serviço Suricato Service Manager.

2. Acesse a pasta onde está localizado o instalador do serviço:

C:\Telematica\Suricato\services\auxs

3. Abra o arquivo InstallGerenciadorProcessos-NT.bat com o Notepad++.

4. Localize o parâmetro LogPath, altere para o caminho desejado e salve o arquivo.
 

--LogPath="%SURICATO_GERSERV_HOME%"\logs --LogPath="C:\Telematica\logsSuricato"\logs

5. Após a alteração, é necessário reinstalar o serviço.

6. Abra o CMD como ADMINISTRADOR.

7. Acesse o mesmo diretório do instalador.

8. Execute UninstallGerenciadorProcessos-NT.bat e verifique se o serviço foi removido.

9. Execute InstallGerenciadorProcessos-NT.bat para instalar novamente o serviço.
 

10. Agora localize o arquivo log4j.xml na pasta de configuração:

C:\Telematica\Suricato\services\conf

11. Abra o arquivo com o Notepad++ e altere a propriedade do arquivo de log.

log4j.appender.fileOut.File=./logs/GerenciadorProcessos.log log4j.appender.fileOut.File=C:/Telematica/logsSuricato/logs/GerenciadorProcessos.log

12. Inicie o serviço e verifique se os logs foram gerados no novo diretório.

Manual de referência: GerServ


🖥️ 4. Suricato REP

 

1. Pare o serviço Suricato REP.

2. Acesse a pasta do serviço:

C:\Telematica\Suricato\suricato_rep

3. Abra o arquivo install.bat com o Notepad++.

4. Altere a linha do LogPath.

--LogPath="%CD%\log" --LogPath="C:\Telematica\logsSuricato\logSuricatoREP"

5. Realize a reinstalação conforme indicado no manual do Suricato REP.

> Manual - Suricato REP

6. Abra o arquivo suricato_rep.jar como WinRAR.

7. Dentro do JAR, procure o arquivo log4j2.xml no diretório BOOT-INF/classes/.

8. Abra o arquivo com o Notepad++ e altere a propriedade log-path. Salve o arquivo e confirme a alteração no WinRAR.

<Property name="log-path">./log/</Property> <Property name="log-path">C:/Telematica/logsSuricato/logs-SuricatoRep/</Property>

9. Inicie o serviço novamente.

10. Valide a geração dos logs no novo diretório.

Manual de referência: Suricato REP


🙂 5. Suricato Face

 

1. Pare o serviço Suricato Face.

2. Acesse a pasta do serviço:

C:\Telematica\Suricato\suricato-face

3. Abra o arquivo install.bat com o Notepad++.

4. Altere a linha do LogPath.

--LogPath="%CD%\log" --LogPath="C:\Telematica\logsSuricato\logs-SuricatoFace"

5. Realize a reinstalação conforme indicado no manual do Suricato Face.

Suricato Face

6. Abra os seguintes arquivos com o Notepad++: log4j2.xml e log4j2-mgr.xml.

7. Em cada arquivo, altere a propriedade log-path e salve.

<Property name="log-path">./log/</Property> <Property name="log-path">C:/Telematica/logsSuricato/logs-SuricatoFace/</Property>

8. Inicie o serviço novamente e valide os arquivos gerados.

 

Manual de referência: Suricato Face


🔐 6. Suricato REPACESSO

 

O procedimento do Suricato REPACESSO segue o mesmo processo utilizado no Suricato REP.Pare o serviço.

  1. Acesse a pasta do serviço e altere o LogPath no install.bat.
  2. Reinstale o serviço conforme o procedimento do Suricato REP.
  3. Ajuste o log4j2.xml nos arquivos suricato_repacesso.jar e suricato_repacesso-mgr.jar.
  4. Ajuste também o arquivo de configuração correspondente existente na pasta do serviço, conforme a estrutura do ambiente.
  5. Inicie o serviço e valide a geração dos logs no novo diretório.
     


 

⚠️ Atenção
Os nomes dos JARs que devem ser ajustados são: suricato_repacesso.jar e suricato_repacesso-mgr.jar. O caminho exato do arquivo de configuração da pasta deve ser validado na instalação do ambiente.


 

Manual de Referência: Suricato Repacesso


🔄 7. Suricato Middleware

 

1. Pare o serviço Suricato Middleware.

2. Acesse a pasta do serviço e localize o instalador:

C:\Telematica\Suricato\SuricatoMiddleware

3. Abra o arquivo install.bat com o Notepad++.

4. Localize o LogPath, altere para o caminho desejado e salve.

--LogPath="%CD%"\logs --LogPath="C:/Telematica/logsSuricato/logs-SuricatoMiddleware/"

5. Reinstale o serviço.

6. Para remover o serviço, utilize SC DELETE no CMD e instale novamente seguindo o manual do Middleware.

7. Abra o suricato.middleware.jar como Winrar

8. Com notepad++ altere o arquivo log4j2.xml

10. Salve e confirme a alteração no Winrar

 

Manual de referência: Middleware


🧩 8. Matriz de Acesso

 

1. Pare o serviço Suricato Matriz de Acesso.

2. Acesse a pasta do serviço e localize o instalador:

C:\Telematica\Suricato\Suricato-TOTVS\SuricatoTotvsMA

3. Abra o arquivo install.bat com o Notepad++.

4. Localize o LogPath, altere para o caminho desejado e salve.

--LogPath="%CD%"\logs --LogPath="C:/Telematica/logsSuricato/logs-SuricatoMatrizAcesso/"

5. Reinstale o serviço.

6. Para remover o serviço, utilize SC DELETE no CMD e instale novamente seguindo o manual da Matriz de Acesso.

7. Abra o suricato-ma.jar como Winrar.

8. Com notepad++ altere o arquivo log4j2.xml.

10. Salve e confirme a alteração no Winrar

 

Manual de referência: Matriz de Acesso


📨 9. Suricato TOTVS | Envio de Marcação

 

1. Pare o serviço Suricato Totvs | Envio de Marcacao.

2. Acesse a pasta do serviço e localize o instalador:

C:\Telematica\Suricato\Suricato-TOTVS\SuricatoTotvsMarcacao

3. Abra o arquivo install.bat com o Notepad++.

4. Localize o LogPath, altere para o caminho desejado e salve.

--LogPath="%CD%"\logs --LogPath="C:/Telematica/logsSuricato/logs-SuricatoMatrizAcesso/"

5. Reinstale o serviço.

6. Para remover o serviço, utilize SC DELETE no CMD e instale novamente rodando o install.bat.

7. Abra o suricato-totvs-marcacao.jar como Winrar.

8. Com notepad++ altere o arquivo log4j2.xml.

10. Salve o arquivo e confirme a alteração no Winrar


🌐 10. Suricato WS TOTVS

 

1. Pare o serviço Suricato WS Totvs.

2. Acesse a pasta do instalador:

C:\Telematica\Suricato\wildfly\docs\contrib\scripts\service

3. Abra o arquivo service.bat com o Notepad++.

4. Localize set LOGPATH= e informe o novo caminho dos logs. Por padrão, esse caminho vem vazio.

set LOGPATH= set LOGPATH=C:/Telematica/logsSuricato/logs-WebService/

5. Localize as duas linhas que possuem STARTPARAM.

6. Adicione a string -Djboss.server.log.dir= com o novo caminho após !BASE!.

#-Djboss.server.log.dir=ADICIONEOCAMINHODOLOG #-Djboss.server.log.dir=C:/Telematica/logsSuricato/logs-WebService

7. Reinstale o serviço. Remova o serviço no CMD com SC DELETE e instale novamente executando o service.bat.

8. Inicie o serviço e valide se os logs do WildFly foram direcionados ao novo diretório.

⚠️ Atenção
No parâmetro -Djboss.server.log.dir, utilize o caminho definido para o diretório de logs do WebService. O parâmetro deve ser aplicado nas duas linhas com STARTPARAM mencionadas neste procedimento.

Manual de referência: Wildfly


✅ 11. Validação após a alteração

 

Após configurar cada serviço, confirme os seguintes pontos:

  • O serviço está instalado e iniciado corretamente.
  • O usuário do serviço possui permissão de escrita no novo diretório.
  • Os arquivos de log estão sendo criados no novo caminho.
  • O diretório anterior deixou de receber novos logs do serviço alterado.
  • Não há erros de inicialização relacionados à configuração do logger.
  • Para serviços que utilizam JARs, a alteração foi salva dentro do arquivo e confirmada pelo WinRAR.
  • Para o WildFly, o LOGPATH e o -Djboss.server.log.dir foram configurados, salvo e o serviço foi reinstalado.

 

Exemplo das pastas alteradas:

 


 

💡 Boa prática
Recomenda-se realizar a alteração com os serviços parados e validar a geração dos logs imediatamente após a inicialização.


 


Link do Manual Oficial do Suricato : Manual - Suricato

Criado por Matheus Nascimento.

 

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

0 Comentários

Por favor, entre para comentar.
X Fechar

Olá ,

Há pendência referente a um de seus produtos contratados para a empresa ().

Entre em contato com o Centro de Serviços TOTVS para tratativa.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cobrança – Verificação de pendências financeiras . clique aqui.

TOTVS

X Fechar

Olá ,

Seu contato não está cadastrado no Portal do Cliente como um perfil autorizado a solicitar consultoria telefônica.

Por gentileza, acione o administrador do Portal de sua empresa para: (1)configurar o seu acesso ou (2)buscar um perfil autorizado para registro desse atendimento.

Em caso de dúvidas sobre a identificação do contato administrador do Portal, ligue (11) 4003-0015, opção 7 e, em seguida, opção 4 para buscar o suporte com o time de Assessoria ao Portal do Cliente. . clique aqui.

TOTVS

X Fechar

Olá ,

Para o atendimento de "Consultoria Telefônica" você deverá estar de acordo com o Faturamento.

TOTVS

X Fechar

Olá,

Algo inesperado ocorreu, e o usuario nao foi reconhecido ou você nao se encontra logado

Por favor realize um novo login

Em caso de dúvidas, entre em contato com o administrador do Portal de Clientes de sua empresa para verificação do seu usuário, ou Centro de Serviços TOTVS.

Ligue! 4003-0015 opção 4 e 9 ou registre uma solicitação para CST – Cadastros . clique aqui.

TOTVS

Chat _

Preencha os campos abaixo para iniciar o atendimento:

Chat _