Tomcat 설치
JSP 개발을 위한 환경 설정에 관한 글입니다.
테스트에 성공한 각각의 프로그램 버전은 아래와 같습니다.
- Apache : Apache HTTP Server 2.0.63 Download
- Tomcat : apache-tomcat-5.5.26.exe Download
- jk-1.2.26 Binary Releases : mod_jk-1.2.26-httpd-2.0.59.so Download
1. Apache 설치
위 링크에서 Apache HTTP Server 2.0.63 이나 Apache HTTP Server 2.0.5x 대의 최신 버전을 다운로드하여 설치를 시작합니다.
(윈도우 서버의 IIS서버가 가동중이라면 가동을 중단하고 설치해야 합니다.)
(1) Server Information
아파치 설치 시작하면 보이는 첫번째 화면에서 서버의 정보를 기입합니다.
개발용 테스트 웹서버로 사용할 것이므로 아래 그림처럼 Network Domain 에 localhost,
Server Name 에 localhost 로 주고 Administrator's Email Address 는 자신의 이메일을 입력합니다.
(2) Setup Type
설치중 디폴트로 설치하지 말고 Custom 을 선택합니다.
(3) Custom Setup
Change 를 눌러 설치 디렉토리를 변경합니다.
(3)-1 Change Current Destination Folder
D:\apps 과 같이 입력합니다.
apps는 아파치와 Tomcat을 함께 설치할 디렉토리입니다.
아파치는 설치때 자신의 설치 디렉토리를 Apache2라고 만들고 그 안에 설치를 합니다.
따라서 아파치를 위한 디렉토리를 따로 만들지 마세요.
(3)-2
설치 디렉토리를 결정했으면 Next > 를 클릭합니다.
(4) Installing Apache HTTP Server 2.0.58
설치가 진행됩니다
설치중 중간에 명령 프롬프트가 보이면 일부러 명령 프롬프트를 닫지 마세요
(5) 테스트
설치가 완료되면 시스템 트레이 메뉴에 Apache Monitor 를 볼 수 있습니다.
웹브라우저에서 http://localhost 로 방문하여 아래 페이지가 보이는지 확인합니다.
httpd.conf 편집
설치과정에서 설치 디렉토리를 D:\apps 에 설치했다면 apps 디렉토리에 Apache2 라는 서브 디렉토리가 만들어지고 이 곳에 아파치가 설치 됩니다. 이럴 경우 아파치 설정파일은 D:\apps\Apache2\conf\httpd.conf 입니다. httpd.conf 파일을 자신이 테스트 환경에 맞게 고칩니다.
DocumentRoot 변경
httpd.conf 에서 DocumentRoot 를 찾아서 해당하는 내용을 원하는 디렉토리로 설정합니다.
...
228줄
DocumentRoot "D:/www/bbs"
...
253줄
<Directory "D:/www/bbs">
...
DefaultLanguage
한글사이트이므로 DefaultLanguage ko 로 변경합니다.
LanguagePriority
LanguagePriority 항목은 ko가 제일 먼저 나오도록 변경합니다.
2. Tomcat 설치
Tomcat 5.5.x 버전을 설치합니다. 5.5 버전 부터는 JDK 1.5 이상이 설치되어 있어야 합니다.
(1) Setup Wizard
(2) License agreement
(3) Choose Components
디폴트로 두고 Next 를 클릭합니다.
(4) Choose Install Location
설치 디렉토리를 C:\Program Files 와 같이 사이가 벌어진 디렉토리는 되도록 피합니다.
Browse... 를 눌러 새로운 설치 디렉토리를 찾습니다.
(4)-1 설치 디렉토리 찾기
아파치가 설치되어 있는 상위 디렉토리에 설치하겠습니다.
D:\apps 를 선택합니다.
(4)-2 설치 디렉토리 확인
D:\apps 를 선택하면 설치 위저드가 D:\apps\Tomcat 5.5 에 Tomcat를 설치한다고 나타냅니다.
하지만 이 역시 디렉토리명에 공백이 있습니다. 공백을 지우거나 아래와 같이 공백이 없는 새로운 이름을 정해주고 Next를 클릭합니다.
(5) Configuration
Http/1.1 Connector Port 는 디폴트 값이 8080 입니다.
만약 8080 포트를 다른 프로그램이 사용하고 있다면 적당한 다른 포트 번호를 부여합니다.
Tomcat admin 의 비밀번호를 부여합니다.
(6) Java Virtual Machine path select
Java Virtual Machine 에 대한 경로를 묻고 있습니다.
Java Virtual Machine 이 여러 개 설치 되어 있다면, 경로가 현재 사용하고 있는 버전이 맞는지 확인합니다.
만약 맞지 않다면 ... 버튼을 클릭하여 맞는 버전을 선택하고 Next 를 클릭합니다.
(7) Installing
(8) Completing Apache Tomcat Setup Wizard
설치가 완료되었습니다.
Finish 를 클릭합니다.
(9) Tomcat Startup
Tomcat 이 startup 합니다.
(10) Tomcat Monitor
Tomcat이 서비스를 시작하면 시스템 트레이 메뉴에 Tomcat Monitor 아이콘이 나타납니다.
(11) Tomcat Properties
Tomcat Monitor 아이콘을 클릭하면 Tomcat 속성 창을 볼 수 있습니다.
3. Apache Tomcat 연동
(1) mod_jk2.so 복사
윈도우용 jk-1.2.26 Binary Releases 인
mod_jk-1.2.26-httpd-2.0.59.so 를 다운로드 합니다.
만억 링크가 깨졌다면 http://tomcat.apache.org/index.html 에서 Downloads, Tomcat Connectors 메뉴를 이용하면 됩니다.
다운로드 받은 mod_jk-1.2.26-httpd-2.0.59.so 를 {아파치홈}/modules 에 복사하고 이름을 mod_jk.so 라고 바꿉니다.
(2) httpd.conf 파일 편집
# LoadModule foo_module modules/mod_foo.so 부분의 가장 아래에 다음 코드를 추가합니다.
LoadModule jk_module modules/mod_jk.so JkWorkersFile conf/workers.properties JkLogFile logs/mod_jk.log JkLogLevel info
DocumentRoot 라인(DocumentRoot "D:/www/bbs") 아래에 다음을 추가합니다.
JkMount /*.jsp tomcat1 JkMount /servlet/* tomcat1
(3) workers.properties 생성
{아파치 홈}/conf 디렉토리 안에 workers.properties 파일을 아래와 같이 생성합니다.
workers.properties
worker.list=tomcat1 worker.tomcat1.port=8009 worker.tomcat1.host=localhost worker.tomcat1.type=ajp13
(4) 연동 테스트와 확인
Tomcat을 실행하고 아파치를 실행합니다. http://localhost/index.jsp 을 방문하여 고양이를 확인합니다. 이때 이미지가 나오지 않는 것이 정상입니다. 톰캣의 ROOT 애플리케이션의 index.jsp 페이지가 보인다면 연동에 성공한 것입니다.
이미지가 나오지 않는 이유
httpd.conf 설정파일에서 아래 코드를 추가했습니다.
JkMount /*.jsp tomcat1
JkMount /servet/* tomcat1
여기서 JkMount /*.jsp tomcat1 은 클라이언트의 요청 중에 확장자가 jsp 인 것은 Tomcat 에게 처리를 위임한다는 의미입니다.
요청을 위임받은 톰캣은 서비스를 할 웹 애플리케이션을 선택합니다. 그리고 경로에 해당하는 자원을 찾아 클라이언트의 요청에 응답하도록 합니다.
위의 연동 테스트에서는 http://localhost/index.jsp 로 요청했으므로 ROOT 애플리케이션의 루트 디렉토리에 있는 index.jsp 가
톰캣의 호출을 받게 됩니다.
그 결과 http://localhost/index.jsp 의 해석결과가 웹브라우저에서 확인할 수 있었습니다.
다음으로 웹브라우저는 html 문서에 이미지 태그가 있으면 해당 이미지 파일을 웹서버에 요청합니다.
위의 경우는 웹브라우저가 http://localhost/tomcat.gif 로 요청을 보내게 됩니다.
언제나 앞선에는 웹서버가 요청을 먼저 받습니다.
아파치 웹서버의 설정파일에 JkMount /*.gif tomcat1와 같이 설정되어 있지 않기 때문에
확장자가 gif 인 것은 아파치 자신이 직접 처리하려고 합니다. 그래서 httpd.conf 에서 DocumentRoot 로 정해진
디렉토리부터 시작하여 tomcat.gif 이미지 파일의 경로를 찾아서 서비스하려고 시도합니다.
하지만 D:\www\bbs 디렉토리에는 tomcat.gif 파일이 없습니다. 이것이 그림이 나오지 않는 이유입니다.
확실하게 아파치, Tomcat 연동을 하려면 아래와 같이 설정하면 됩니다.
- {Tomcat 홈}/webapps/ROOT 모두 지우고 WEB-INF 폴더를 생성합니다.
- {Tomcat 홈}/webapps/ROOT/WEB-INF/ 에 web.xml 파일을 가장 기본적인 내용으로 만듭니다.
- {아파치 홈}/conf/httpd.conf 파일을 열고 DocumentRoot 부분을 {Tomcat 홈}/webapps/ROOT 으로 설정합니다.
- {아파치 홈}/conf/httpd.conf 파일을 열고 DirectoryIndex 에 index.jsp 를 추가합니다.
- {Tomcat 홈}/webapps/ROOT 에 index.jsp 이름으로 간단한 테스트 파일을 만들고 Tomcat을 시작하고 아파치를 시작하여 테스트 합니다.
참고문서
http://raibledesigns.com/tomcat/
- 다음 강좌 : 자바 웹 애플리케이션이란?