Windows에 Tomcat 8.5 + Log4j2 설치 삽질

윈도우 환경에서 Tomcat 8.5와 Log4j2 설치를 하며 몇일간 삽질한 끝에 정상적으로 굴리는 환경을 기록한다.

1. 설치환경 :

 - OS : Windows 10

 - JAVA : OpenJDK 1.8.0-312-1.b07

 - Tomcat : 8.5.70

 - Log4j : 2.13.3

 

2. 설치순서 :

 1) Apache Tomcat과 Log4j 라이브러리 파일을 공홈에서 적절히 다운 받음. (구버전이라 아카이브에서 찾아받아야 됨)

  ※ 물론 JDK는 사전에 설치되어야 하며 이전 포스팅 글 중 LENA WAS 설치기에 위치한 깃허브 저장소에서 받으면 된다.

 2) 우선 Tomcat은 install 버전이 아닌 zip으로 진행했으며, 설치를 원하는 위치에 압축을 해제한다.

 3) Log4j2를 설치하고 설정 해야한다.

   - 마찬가지로 압축을 해제 후 사용이 필요한 라이브러리 파일을 적절한 위치에 이동

     (포스팅은 3가지 파일을 올림)

• log4j-api-2.10.0.jar
• log4j-core-2.10.0.jar
• log4j-jul-2.10.0.jar

   - catalina.bat 또는 setenv.bat에서 classpath를 지정해준다.

set "JRE_HOME=C:\Program Files\openjdk-debug-1.8.0\jre" set "CLASSPATH=%CLASSPATH%%CATALINA_BASE%\bin;%CATALINA_BASE%\bin\log4j-core-2.13.3.jar;%CATALINA_BASE%\bin\log4j-api-2.13.3.jar;%CATALINA_BASE%\bin\log4j-jul-2.13.3.jar;" exit /b 0

 

   - log4j2.xml을 작성하고 JVM 구동 옵션에서 로그 설정을 변경해준다. (굵게 칠해진 부분이 추가된 설정)

if not "%CATALINA_LOGGING_CONFIG%" == "" goto noJuliConfig set CATALINA_LOGGING_CONFIG=-Dnop if not exist "%CATALINA_BASE%\conf\logging.properties" goto noJuliConfig set CATALINA_LOGGING_CONFIG=-Djava.util.logging.config.file="%CATALINA_BASE%\conf\logging.properties" :noJuliConfig set CATALINA_LOGGING_CONFIG=-Dlog4j.configurationFile="%CATALINA_BASE%\conf\log4j2.xml" set "JAVA_OPTS=%JAVA_OPTS%;"  if not "%LOGGING_MANAGER%" == "" goto noJuliManager set LOGGING_MANAGER=-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager :noJuliManager set LOGGING_MANAGER=-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager

 

   - 구동 배치파일의 IF문을 보면 알겠지만 기본 로그의 설정 파일이 존재하지 않으면 log4j.xml을 불러오도록 설정 하였다. 또한 기본 로그가 아닌 log4j의 로그 매니저를 사용하도록 해주었다.

 Tomcat의 기본 홈 경로에서 conf 폴더 내 logging.properties 파일의 이름을 바꾸거나 제거해야 된다.

 

   - bin 폴더에서 CMD 창을 열고 서비스를 구동한다.

catalina start

 

 

정상적으로 설정이 완료되었다면 log4j2.xml 파일에 설정된 경로대로 로그 파일이 생성된다.