Apache Tomcat설치부터 Eclipse 연동, JSP 실행까지

Java 웹 개발 환경을 만들기 위해 Apache Tomcat을 내려받고 Eclipse에 서버를 등록한 뒤, Dynamic Web Project를 생성하여 index.jsp를 브라우저에서 실행하는 과정까지 정리했습니다.

실습 환경

Tomcat 10.1.57 · Eclipse IDE · HTTP Port 8090 · Dynamic Web Project(memberPjt)

목차

1. Apache Tomcat 공식 홈페이지 접속
2. Tomcat 10 ZIP 다운로드
3. Eclipse에서 Servers View 열기
4. Tomcat v10.1 Server 등록
5. Tomcat 설치 폴더 연결
6. Servers 탭에서 등록 결과 확인
7. Tomcat 서버 상세 설정
8. HTTP 포트 8080 → 8090 변경
9. 변경사항 Publish
10. Tomcat 서버 실행
11. Tomcat ROOT 기본 페이지 확인
12. ROOT/index.jsp 수정 테스트
13. Tomcat 서버 종료
14. Dynamic Web Project 생성
15. memberPjt 프로젝트 설정
16. 생성된 프로젝트 구조 확인
17. webapp에 index.jsp 생성
18. JSP 테스트 코드 작성
19. Run On Server로 프로젝트 실행
20. 브라우저에서 JSP 실행 확인

1. Apache Tomcat 공식 홈페이지 접속

먼저 Apache Tomcat 공식 홈페이지인 https://tomcat.apache.org/에 접속합니다.

Apache Tomcat 공식 홈페이지

왼쪽 Download 메뉴에서 이번에 사용할 Tomcat 10을 선택합니다.

Download 메뉴에서 Tomcat 10 선택

2. Tomcat 10 ZIP 다운로드

Tomcat 10 다운로드 페이지에서 Binary Distributions → Core → zip을 클릭합니다.

Tomcat 10.1.57 Core의 ZIP 파일 선택

다운로드가 완료되면 apache-tomcat-10.1.57.zip 파일을 확인할 수 있습니다.

apache-tomcat-10.1.57.zip 다운로드 완료

ZIP 파일의 압축을 풀어 apache-tomcat-10.1.57 폴더를 만듭니다.

Tomcat ZIP 압축 해제 완료

포인트

Tomcat ZIP 배포판은 별도의 설치 마법사를 실행하기보다 압축을 푼 폴더 자체를 서버 설치 경로로 사용합니다.

3. Eclipse에서 Servers View 열기

Eclipse 상단 메뉴에서 Window → Show View → Other...로 이동합니다.

Window → Show View → Other... 선택

검색창에 server를 입력한 후 Server → Servers를 선택하고 Open을 클릭합니다.

Show View에서 Servers 선택

4. Tomcat v10.1 Server 등록

Servers View에서 새 서버를 만들면 New Server 창이 열립니다.

새 서버를 추가하는 New Server 화면

이번에 설치한 버전이 Tomcat 10.1.57이므로 Eclipse에서도 Tomcat v10.1 Server를 선택합니다.

Apache → Tomcat v10.1 Server 선택

설치한 Tomcat의 버전 계열과 Eclipse에서 선택하는 Server Runtime의 버전 계열을 맞춰주는 것이 중요합니다.

5. Tomcat 설치 폴더 연결

Tomcat installation directory 옆의 Browse...를 클릭합니다.

Tomcat 설치 경로를 지정하는 화면

앞에서 압축을 풀어둔 apache-tomcat-10.1.57 폴더를 선택합니다.

압축 해제한 Tomcat 폴더 선택

경로가 입력되면 내용을 확인한 뒤 Finish를 클릭합니다.

Tomcat 설치 폴더 등록 후 Finish

주의

ZIP 파일 자체가 아니라 압축을 해제한 Tomcat 폴더를 선택해야 합니다.

6. Servers 탭에서 등록 결과 확인

등록이 끝나면 Servers 탭에 Tomcat v10.1 Server at loca lhost가 나타납니다.

Servers 탭에 등록된 Tomcat v10.1 Server

 

 

Stopped → 서버가 현재 정지된 상태
Republish → 서버에 다시 반영할 변경사항이 있는 상태

 

7. Tomcat 서버 상세 설정

Servers 탭의 Tomcat v10.1 Server at localhost를 더블클릭하면 Overview 화면이 열립니다.

Tomcat Server Overview 화면

Server Locations

Use Tomcat installation (takes control of Tomcat installation)을 선택합니다.

Server Locations에서 Use Tomcat installation 선택

Server Options

Publish module contexts to separate XML files를 체크합니다. 화면에서는 Modules auto reload by default도 체크되어 있습니다.

Server Options에서 Publish module contexts 설정

8. HTTP 포트 8080 → 8090 변경

Tomcat의 기본 HTTP/1.1 포트는 8080입니다.

기본 HTTP/1.1 포트 8080

8080은 개발 환경에서 자주 사용되어 다른 프로그램과 충돌할 수 있기 때문에, 이번 실습에서는 8090으로 변경했습니다.

HTTP/1.1 포트를 8090으로 변경

기존 접속 주소 : http://localhost:8080
변경 후 주소 : http://localhost:8090

9. 변경사항 Publish

설정 변경이 끝났다면 Servers 탭 오른쪽의 Publish 버튼을 눌러 변경사항을 Tomcat에 반영합니다.

Servers View에서 Publish 버튼 클릭

정상적으로 동기화되면 상태가 [Stopped, Synchronized]로 변경됩니다.

Publish 완료 후 Stopped, Synchronized 상태

10. Tomcat 서버 실행

Tomcat 서버를 마우스 오른쪽 클릭한 뒤 Start를 선택합니다.

Tomcat 서버 우클릭 → Start

Console 탭에서 서버 시작 로그를 확인합니다. 로그에 http-nio-8090이 보이면 설정한 8090 포트로 서버가 실행된 것입니다.

Console에서 Tomcat 서버 실행 로그 확인

11. Tomcat ROOT 기본 페이지 확인

Tomcat 설치 폴더를 보면 bin, conf, lib, logs, webapps 등의 폴더가 있습니다.

Tomcat 설치 폴더의 기본 디렉터리 구조

webapps 폴더 안의 ROOT는 Tomcat의 기본 웹 애플리케이션입니다.

webapps 폴더 내부의 ROOT 애플리케이션

ROOT 안에는 Tomcat 기본 홈페이지를 구성하는 index.jsp가 있습니다.

ROOT 폴더의 index.jsp 파일

12. ROOT/index.jsp 수정 테스트

index.jsp를 VS Code로 열어 기본 코드를 확인합니다.

VS Code에서 Tomcat ROOT/index.jsp 열기

<h2>test homepage</h2>

index.jsp에 test homepage 문구 추가

브라우저에서 http://localhost:8090으로 접속하여 상단에 test homepage가 표시되는지 확인합니다.

localhost:8090에서 수정된 Tomcat 기본 페이지 확인

여기까지 확인되면

Tomcat 서버 실행 → ROOT 애플리케이션 → JSP 처리 → 브라우저 출력 흐름이 정상적으로 동작하는 상태입니다.

13. Tomcat 서버 종료

서버 사용이 끝났다면 Servers 탭에서 서버를 우클릭하고 Stop을 선택합니다.

Tomcat 서버 우클릭 → Stop

Start → 서버 실행
Stop → 서버 종료

14. Dynamic Web Project 생성

이제 직접 웹 프로젝트를 생성합니다. Eclipse 상단에서 File → New → Project...를 선택합니다.

File → New → Project... 선택

검색창에 web을 입력하고 Web → Dynamic Web Project를 선택합니다.

Web → Dynamic Web Project 선택

15. memberPjt 프로젝트 설정

프로젝트 이름은 memberPjt, Target runtime은 Apache Tomcat v10.1로 설정합니다. 실습 화면에서는 Dynamic web module version을 3.1로 설정했습니다.

memberPjt Dynamic Web Project 기본 설정

프로젝트 명을 정해주면 됩니다. 저는 memberPjt로 하겠습니다. 그리고 version 6.0 --> 3.1로 해보겠습니다.

memberPjt Dynamic Web Project 기본 설정

다음 화면에서 Java 소스 폴더가 src/main/java, 출력 폴더가 build/classes인지 확인합니다.

Java Source Folder와 Default output folder 확인

Web Module 화면에서는 Context root를 memberPjt, Content directory를 src/main/webapp으로 확인하고 Generate web.xml deployment descriptor를 체크합니다.

Web Module 설정 및 web.xml 생성 옵션 체크

16. 생성된 프로젝트 구조 확인

Finish를 누르면 memberPjt 프로젝트가 생성됩니다.

memberPjt Dynamic Web Project 생성 결과

memberPjt
└── src
    └── main
        ├── java		-> Java 소스 코드
        │
        └── webapp		-> JSP / HTML / CSS / JS
            │
            └── WEB-INF
                ├── lib		-> 외부 JAR 라이브러리
                │
                └── web.xml

17. webapp에 index.jsp 생성

src/main/webapp을 마우스 오른쪽 클릭하고 New → JSP File을 선택합니다.

webapp 우클릭 → New → JSP File

파일 이름을 index.jsp로 입력합니다.

New JSP File에서 index.jsp 입력

템플릿은 New JSP File (html 5)를 선택하고 Finish를 클릭합니다.

New JSP File (html 5) 템플릿 선택

HTML5 기본 구조를 포함한 index.jsp 파일이 생성됩니다.

생성된 index.jsp 기본 코드

18. JSP 테스트 코드 작성

<body> 안에 다음 코드를 작성합니다.

<h1>MY HOME</h1>

index.jsp에 MY HOME 작성

19. Run On Server로 프로젝트 실행

작성한 웹 프로젝트는 일반 Java 프로그램처럼 단독 실행하는 것이 아니라 Tomcat 서버에 배포하여 실행합니다. 상단의 Run 버튼을 클릭합니다.

Eclipse 상단 Run 버튼 클릭

Run On Server 창에서 기존에 등록한 Tomcat v10.1 Server at localhost를 선택하고 Finish를 클릭합니다.

Run On Server에서 Tomcat v10.1 Server 선택

20. 브라우저에서 JSP 실행 확인

실행이 완료되면 브라우저에서 다음 주소로 접속됩니다.

http://localhost:8090/memberPjt/index.jsp

memberPjt/index.jsp에서 MY HOME 출력 성공

URL 구조

localhost  = 현재 내 컴퓨터

8090  = Tomcat HTTP Port

memberPjt  = Context Root

index.jsp  = 실행한 JSP 파일

핵심 개념 정리

• Tomcat : Java Servlet/JSP 기반 웹 애플리케이션을 실행하는 서버
• localhost : 현재 사용 중인 내 컴퓨터
• Port : 한 컴퓨터에서 여러 네트워크 프로그램을 구분하는 번호
• Context Root : 웹 애플리케이션을 구분하는 URL 경로
• src/main/java : Java 소스 코드 작성 위치
• src/main/webapp : JSP, HTML, CSS, JavaScript 등 웹 리소스 위치
• WEB-INF/web.xml : 웹 애플리케이션 배포 설정 파일
• Publish : Eclipse의 서버/프로젝트 변경사항을 Tomcat에 반영하는 과정

마무리

이번 실습에서는 Tomcat 10.1.57을 설치하고 Eclipse에 연동한 뒤, 직접 만든 Dynamic Web Project를 Tomcat에 배포하여 JSP 페이지가 브라우저에 출력되는 것까지 확인했습니다.

 

이걸로 Tomcat 설치연동이였습니다.