CONTEÚDO
- Visão Geral
- Configurando
- Windows
- Linux
- Como Avaliar o Funcionamento
01. VISÃO GERAL
Esse documento descreve como configurar o produto para acertar o controle de log em debug que, em alguns clientes, muda para modo debug em runtime e compromete em muito o uso do disco nos ambientes dos clientes com produto Datasul DTS4THF.
Isso ocorre devido a migração ao produto para libs centralizadas, o qual, não possui a configuração explicita do logback. Esse falta de configuração leva o sistema a assumir uma configuração padrão e essa muda o log para modo debug. Vale ressaltar que, esse procedimento será liberado em futuras releases.
02. Configurando
Para controlar o log no modelo de lib centralizadas é preciso criar o arquivo abaixo dentro da pasta $CATALINA_BASE/lib/logback. Caso o a pasta não exista, deve-se criar a mesma e criar um arquivo chamado logback.xml dentro dela. O Arquivo logback.xml deve ser aberto e o conteúdo abaixo deve ser adicionado como conteúdo do arquivo e salvar.
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<appender name="Console"
class="ch.qos.logback.core.ConsoleAppender">
<layout class="ch.qos.logback.classic.PatternLayout">
<Pattern>
%d{ISO8601} %-5level [%t] [%C{10}:%line] %msg%n%throwable
</Pattern>
</layout>
</appender>
<!-- LOG everything at INFO level -->
<root level="error">
<appender-ref ref="Console" />
</root>
</configuration>
A configuração deve ser feita nos arquivos de carga do tomcat tanto em linux como windows. Abaixo segue o processo para ambas as plataformas.
Windows
Configurando DTS4THF no Windows
Para a configuração ter efeito no DTS4THF no windows, é preciso abrir o arquivo $CATALINA_BASE/bin/catalina.bat
Uma vez aberto deve-se encontrar a linha abaixo:
CATALINA_LOGGING_CONFIG=-Djava.util.logging.config.file="%CATALINA_BASE%\conf\logging.properties"
E fazer a alteração adicionando a configuração no final da linha
CATALINA_LOGGING_CONFIG=-Djava.util.logging.config.file="%CATALINA_BASE%\conf\logging.properties" -Dlogback.configurationFile="%CATALINA_BASE%\lib\logback\logback.xml"
Linux
Configurando DTS4THF Linux
Para a configuração ter efeito no DTS4THF no linux, é preciso abrir o arquivo $CATALINA_BASE/bin/catalina.sh
Uma vez aberto deve-se encontrar a linha abaixo:
CATALINA_LOGGING_CONFIG=-Djava.util.logging.config.file="$CATALINA_BASE/conf/logging.properties"
E fazer a alteração adicionando a configuração no final da linha
CATALINA_LOGGING_CONFIG=-Djava.util.logging.config.file="$CATALINA_BASE/conf/logging.properties" -Dlogback.configurationFile="$CATALINA_BASE/lib/logback/logback.xml"
IMPORTANTE!
Em ambas as plataformas será necessário reinicar o DTS4THF, portanto, é importante avaliar o melhor momento para essa alteração.
03. Como avaliar o funcionamento
Para avaliar se a configuração surtiu efeito basta analisar o arquivo de log catalina.out (linux) ou catalina.log(Windows) e procurar pela informação abaixo. Notar que o bloco abaixo é o exemplo para encontrar no log, visto que, o path e a versão do tomcat podem ser diferentes.
06-Mar-2024 14:47:48.478 INFORMAÇÕES [main] org.apache.catalina.startup.VersionLoggerListener.log Command line argument: -Djava.util.logging.config.file=C:\desenv\servers\tomcat-9.0.80\conf\logging.properties
06-Mar-2024 14:47:48.478 INFORMAÇÕES [main] org.apache.catalina.startup.VersionLoggerListener.log Command line argument: -Dlogback.configurationFile=C:\desenv\servers\tomcat-9.0.80/lib/logback/logback.xml
Onde: o caminho deve corresponder a instalação da instância do tomcat que representa o DTS4THF.