초보자를 위한 개발자 PC에서의 기본적인 Tomcat 설치방법입니다.

작성자 : shin-gosoo(hchshin@chol.com)
작성일 : 2007.04.09


새창 보기

초보자를 위한 개발자 PC에서의 기본적인 Tomcat 설치방법입니다.

목차

1. JDK 설치 (JDK 1.6)
2. TOMCAT 설치 (Tomcat 5.0.28)
3. TOMCAT 환경설정
   • 톰캣 기본 포트변경 및 GET 방식 한글깨짐 방지 방법
   • 디렉토리 리스팅 방지 방법
   • ROOT.xml 설정방법
   • POST 방식 한글깨짐 방지 방법

1. JDK 설치

• 최신 버전인 JDK 1.6 으로 설치하도록 한다.
• 다운로드 위치 : http://java.sun.com/javase/downloads/index.jsp
• JDK 6u1(jdk-6u1-windows-i586-p.exe) - JDK 6 Update 1 버젼
• 설치 예)
  • 설치디렉토리 : D:\dev\jdk1.6
  • 윈도우 환경변수 설정
    • Path : D:\dev\jdk1.6\bin 추가
    • JAVA_HOME : D:\dev\jdk1.6 새로 만들기
• 도스 프롬프트에서 C:/>java 로 테스트해서 성공하면 OK.

2. TOMCAT 설치

• 가장 안정적인(?) 버전인 Tomcat 5.0.28 으로 설치하도록 한다.
• 다운로드 위치 : http://tomcat.apache.org/download-55.cgi
• 5.0.28 - Core - Zip 버전을 다운로드 받는다. (인스톨버전 보다 압축해제버전(?)을 선호함.)
• 설치 예)
  • Zip 버전은 압축풀기만 하면 됨.
  • 설치디렉토리 : D:\dev\jakarta-tomcat-5.0.28
  • 톰캣을 위한 윈도우 환경변수 설정은 필요 없음.
• 윈도우 탐색기를 통해 D:\dev\jakarta-tomcat-5.0.28\bin\startup.bat 실행
• 브라우저를 통해 http://localhost:8080/ 실행해서 성공하면 OK.

3. TOMCAT 환경설정

• 톰캣 기본 포트변경 및 GET 방식 한글깨짐 방지 방법
  
  D:\dev\jakarta-tomcat-5.0.28\conf\server.xml
  92. <Connector port="8080"  
  93.            maxThreads="150" minSpareThreads="25" maxSpareThreads="75"  
  94.            enableLookups="false" redirectPort="8443" acceptCount="100"  
  95.            debug="0" connectionTimeout="20000"    
  96.            disableUploadTimeout="true" URIEncoding="UTF-8"/>  
  <Connector port="8080" maxThreads="150" minSpareThreads="25" maxSpareThreads="75" enableLookups="false" redirectPort="8443" acceptCount="100" debug="0" connectionTimeout="20000" disableUploadTimeout="true" URIEncoding="UTF-8"/> server.xml 파일의 92 라인에서 port="8080"를 원하는 포트로 변경하면 됨.
  96라인의 URIEncoding="UTF-8" (한글 환경일 경우 EUC-KR 이나 MS-949로 설정)로 설정하면 GET 방식으로 넘어오는 한글문자값(UTF-8로 설정하면 모든 다국어 포함)을 특별한 처리 필요없이 파라미터 값이 깨지지 않도록 해줌.
  
  
  
• 디렉토리 리스팅 방지 방법
  
  D:\dev\jakarta-tomcat-5.0.28\conf\web.xml
  60. <servlet>  
  61.     <servlet-name>default</servlet-name>  
  62.     <servlet-class>  
  63.       org.apache.catalina.servlets.DefaultServlet   
  64.     </servlet-class>  
  65.     <init-param>  
  66.         <param-name>debug</param-name>  
  67.         <param-value>0</param-value>  
  68.     </init-param>  
  69.     <init-param>  
  70.         <param-name>listings</param-name>  
  71.         <param-value>true</param-value>  
  72.     </init-param>  
  73.     <load-on-startup>1</load-on-startup>  
  74. </servlet>     
  <servlet> <servlet-name>default</servlet-name> <servlet-class> org.apache.catalina.servlets.DefaultServlet </servlet-class> <init-param> <param-name>debug</param-name> <param-value>0</param-value> </init-param> <init-param> <param-name>listings</param-name> <param-value>true</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> 파일의 71 라인에서 true를 false 로 고치면 됨.
  
  
  
• ROOT.xml 설정방법 (ROOT Context)
  
  D:\dev\jakarta-tomcat-5.0.28\conf\Catalina\localhost\ROOT.xml 생성
  1. <Context path="" docBase="ROOT" debug="0" reloadable="true" crossContext="true">  
  2.     <Logger className="org.apache.catalina.logger.FileLogger"  
  3.         prefix="localhost_ROOT_log." suffix=".txt"  
  4.         timestamp="true"/>  
  5. </Context>  
  6.   
  <Context path="" docBase="ROOT" debug="0" reloadable="true" crossContext="true"> <Logger className="org.apache.catalina.logger.FileLogger" prefix="localhost_ROOT_log." suffix=".txt" timestamp="true"/> </Context> 1 라인의 docBase="ROOT" 는 D:\dev\jakarta-tomcat-5.0.28\webapps\ROOT를 의미함.
  예를 들어 docBase="D:/webapps/ROOT" 이런식으로 다른 위치를 잡을 수도 있음.
  debug="0"는 로그레벨을 의미하며, 9까지 설정할 수 있고 숫자가 높을수록 자세한 로그가 기록됨.
  reloadable="true" 는 class 및 기본 설정(각종 주요 xml 설정들)이 변경되었을때 자동으로 리로딩되는 옵션임.
  crossContext="true"로 설정하면 컨텍스트간의 세션을 공유할 수 있음.
  <Logger 는 prefix 이름으로 D:\dev\jakarta-tomcat-5.0.28\logs 디렉토리에 해당 컨텍스트의 로그가 기록됨
  
  
  
• POST 방식 한글깨짐 방지 방법
  
  기본적으로 설치 되어 있는 D:\dev\jakarta-tomcat-5.0.28\webapps\jsp-examples\WEB-INF\classes\filters\ 디렉토리의 SetCharacterEncodingFilter.class를 이용하여 ROOT 콘텍스트에 적용해 보자.
  위의 class를 D:\webapps\ROOT\WEB-INF\class\filters 에 카피한다.(ROOT 컨텍스트의 docBase="D:/webapps/ROOT" 로 설정했을 경우)
  D:\webapps\ROOT\WEB-INF\class\web.xml 를 아래와 같이 설정을 추가 한다.(UTF-8 환경의 예)
  (한글 환경일 경우 13라인에 UTF-8대신 EUC-KR 이나 MS-949로 설정)
  1. <?xml version="1.0" encoding="UTF-8"?>  
  2. <web-app>  
  3.        
  4.     ...   
  5.        
  6.     <filter>  
  7.         <filter-name>Set Character Encoding</filter-name>  
  8.         <filter-class>  
  9.             filters.SetCharacterEncodingFilter   
  10.         </filter-class>  
  11.         <init-param>  
  12.             <param-name>encoding</param-name>  
  13.             <param-value>UTF-8</param-value>  
  14.         </init-param>  
  15.     </filter>  
  16.   
  17.     <filter-mapping>  
  18.         <filter-name>Set Character Encoding</filter-name>  
  19.         <url-pattern>/*</url-pattern>  
  20.     </filter-mapping>  
  21.        
  22.     ...   
  23.        
  24. </web-app>     
  <?xml version="1.0" encoding="UTF-8"?> <web-app> ... <filter> <filter-name>Set Character Encoding</filter-name> <filter-class> filters.SetCharacterEncodingFilter </filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>Set Character Encoding</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> ... </web-app> server.xml의 GET방식 한글처리(URIEncoding="UTF-8")와 POST방식을 위한 filter를 이용하면 파라미터의 한글처리는 더 이상 생각할 필요 없음.