Windows 10 환경에서 Java 기반 웹 애플리케이션 서버인 Apache Tomcat 9을 설치하는 과정을 정리합니다. JDK 설치 확인부터 다운로드, 압축 해제, 그리고 주요 디렉토리(bin, conf, logs)의 역할과 구동 테스트까지 다룹니다.
0. 사전 준비 (Prerequisites)
Tomcat은 Java로 구동되므로 JDK(Java Development Kit)가 필수입니다. 설치 전 반드시 Java 환경 변수가 설정되어 있는지 확인해야 합니다.
Java 설치 확인
:: CMD 창에서 확인
java -version
javac -version
Check Point: 버전 정보가 출력되지 않는다면 JDK를 먼저 설치하고, 시스템 환경 변수(
JAVA_HOME, PATH)를 설정해야 합니다. Tomcat은 실행 시 JAVA_HOME을 참조합니다.
1. 다운로드 및 설치 (Download & Install)
설치형(Installer)보다는 압축형(Zip)을 사용하는 것이 디렉토리 관리가 용이하고, 여러 버전을 동시에 관리하기 좋습니다.
다운로드
- 공식 사이트: http://tomcat.apache.org/
- 버전 선택: Tomcat 9 (Latest Stable) > Binary Distributions > Core: zip (64-bit/32-bit Windows)
설치 (압축 해제)
다운로드한 Zip 파일을 원하는 경로에 압축 해제하는 것만으로 설치는 끝납니다.
- 설치 경로 예시:
E:\APP\WAS\TOMCAT9
2. 주요 디렉토리 구조 (Directory Structure)
압축을 해제하면 다음과 같은 폴더 구조를 볼 수 있습니다. 각 폴더의 역할을 이해하는 것이 WAS 운영의 첫걸음입니다.
| 디렉토리 | 역할 및 주요 파일 |
|---|---|
| /bin |
서버 실행 및 종료 스크립트가 위치합니다. - startup.bat: 서버 시작 (Windows)- shutdown.bat: 서버 중지 (Windows)- catalina.bat: 실행 환경 변수 및 옵션 설정
|
| /conf |
서버 전체 설정 파일이 위치합니다. - server.xml: 포트(8080, 8009), 엔진 설정- web.xml: 세션 타임아웃, MIME 타입 등 공통 설정
|
| /lib | Tomcat 구동에 필요한 라이브러리(Jar) 저장소 (JDBC 드라이버 등 포함) |
| /logs |
서버 로그가 저장됩니다. - catalina.yyyy-mm-dd.log: 엔진 로그- localhost_access_log: 접속 로그
|
| /webapps | 웹 애플리케이션(WAR 파일)을 배포하는 기본 경로입니다. |
3. 구동 및 검증 (Start & Verify)
설치가 제대로 되었는지 서버를 켜서 확인합니다.
서버 구동
:: bin 디렉토리로 이동
cd E:\APP\WAS\TOMCAT9\bin
:: 실행 스크립트 동작
startup.bat새로운 CMD 창이 뜨면서 로그가 올라가고, 마지막에 Server startup in [xxx] ms 메시지가 보이면 구동 성공입니다.
접속 테스트
브라우저를 열고 http://localhost:8080 에 접속합니다. 고양이 그림이 있는 Tomcat 기본 페이지가 뜬다면 정상적으로 설치된 것입니다.
Next Step:
기본 설치가 완료되었습니다. 다음 포스팅에서는 server.xml을 수정하여 HTTP 포트를 변경하거나, 인코딩 설정을 추가하는 Tomcat 기본 설정 튜닝에 대해 알아보겠습니다.