윈디하나의 솔라나라: TOMCAT

• 분류: 어플리케이션
• 문서정보: TOMCAT의 설치방법과 실행에 대해 설명
• 업데이트: 2009-07-10
• 이 문서는 윈디하나의 솔라나라, http://www.solanara.net/에서 최근에 갱신된 문서를 찾을 수 있다.

목차

• 개요
• 설치
  • Java JDK
  • Tomcat
  • Tomcat - Connectors
  • Tomcat - Native library
• 설정
  • 아파치 웹 서버 설정
  • 톰캣 설정
  • 주의 사항
• 테스트
• λｐｒｏβｅ, Ψｐｒｏβｅ
  • 설치방법

개요

• 아파치 톰캣(Apache Tomcat)은 자바 서블릿과 자바 서버 페이지(JSP)를 구현한 자바 서블릿 컨테이너다.
• 처음에는 아파치 소프트웨어 재단에서 만든 자카르타 프로젝트에 속해 있었지만, 현재는 톱 레벨 프로젝트로 승격되었다. (자카르타 프로젝트는 아파치 소프트웨어 재단에서 지원하는 오픈 소스 자바 솔루션 프로젝트의 이름이다)
• 현재 톰캣은 자바 서블릿(Servlet) 2.5 와 자바 서비스 페이지(JSP) 2.1 스펙을 준수한다.
• 공식 홈페이지: Apache Tomcat
• 본 문서에서는 아파치 톰캣을 설치하고, 아파치 웹 서버와 연동시키며, 톰캣 네이티브 라이브러리까지 설치하는 것을 다룬다.

설치

1. Java JDK

   톰캣은 자바로 만들어져 있기 때문에 자바를 설치해야 한다. Java SE Downloads에서 [JDK 6 Update 14]를 받는다. (물론 솔라리스10의 /usr/java 디렉토리에 있는 자바를 사용해도 된다) 여기서는 JDK를 사용했지만 런타임만 필요하다.

   root@wl ~ # cd /usr/local
   root@wl /usr/local # ~/jdk-6u14-solaris-i586.sh
   root@wl /usr/local # ln -s jdk1.6.0_14 java
   root@wl /usr/local # vi /etc/profile
   # for Tomcat
   if [ -d /usr/local/tomcat ]
   then
     PATH=$PATH:/usr/local/tomcat/bin; export PATH;
   fi
   
   # for JAVA
   if [ -d /usr/local/java ]
   then
     PATH=/usr/local/java/bin:$PATH; export PATH;
     JAVA_HOME=/usr/local/java; export JAVA_HOME;
   fi
   root@wl /usr/local # . /etc/profile
   

2. Tomcat

   톰캣의 설치는 매우 간단하다. 파일을 받아 적당한 디렉토리에 풀어주면 된다.

   root@wl ~ # wget http://apache.mirror.cdnetworks.com/tomcat/tomcat-6/v6.0.20/bin/apache-tomcat-6.0.20.tar.gz
   root@wl ~ # cd /usr/local
   root@wl /usr/local # tar xvfz ~/apache-tomcat-6.0.20.tar.gz
   root@wl /usr/local # ln -s apache-tomcat-6.0.20 tomcat
   root@wl /usr/local # /usr/local/tomcat/bin/startup.sh 1)
   Using CATALINA_BASE:   /usr/local/apache-tomcat-6.0.20
   Using CATALINA_HOME:   /usr/local/apache-tomcat-6.0.20
   Using CATALINA_TMPDIR: /usr/local/apache-tomcat-6.0.20/temp
   Using JRE_HOME:        /usr/local/java
   root@wl /usr/local # 
   

   1) 스크립트를 실행하고 http://localhost:8080 에 접속해보면 아래와 비슷한 화면이 나온다. 8080 포트가 아닌 80 포트로 톰캣을 실행시키려면 /usr/local/tomcat/conf/server.xml 에 8080으로 된 문자를 전부 80으로 바꾸면 되며, 파일 이미지와 JSP파일은 /usr/local/tomcat/webapps/ROOT 아래에 넣으면 된다.
   

3. Tomcat - Connectors

   • 톰캣만으로도 웹 서비스를 하는데에는 지장 없지만, 정적 컨텐츠(예를 들어 이미지들)의 효율적인 전송이나 rewrite와 같은 기능, php의 연동을 위해 아파치 웹 서버가 필요할 때가 있다. 웹서비스시, 톰캣은 JSP와 서블릿을 실행하기 위한 용도로만 사용하고, 나머지(이미지 전송, PHP/CGI실행 등등)는 아파치 웹 서버에 맡기는 방법이다. 여기서는 아파치 웹 서버가 /usr/local/apache2 에 설치되었다고 가정한다. 아파치 웹 서버의 설치방법은 윈디하나의 솔라나라: SAMP를 참고한다.
   • 80 포트로 오는 요청은 아파치 웹서버가 받아 처리하는데, JSP/서블릿에 대한 요청은 다시 톰캣에게 주어 톰캣이 처리한 결과를 받아 아파치 웹 서버가 클라이언트에 전송하는 방식이다. 여기서 톰캣과 아파치 웹 서버를 연결해주는 프로토콜은 현재 AJP v1.3이 많이 사용되고 있으며 이를 구현한 것이, mod_jk 이라는 모듈이다.
   • Apache Tomcat - Tomcat Connectors (mod_jk) Downloads

   root@wl ~ # wget http://apache.mirror.cdnetworks.com/tomcat/tomcat-connectors/jk/source/jk-1.2.28/tomcat-connectors-1.2.28-src.tar.gz
   root@wl ~ # tar xvfz tomcat-connectors-1.2.28-src.tar.gz
   root@wl ~ # cd tomcat-connectors-1.2.28-src/native
   root@wl ~/tomcat-connectors-1.2.28-src/native # ./configure --with-apxs=/usr/local/apache2/bin/apxs
   root@wl ~/tomcat-connectors-1.2.28-src/native # /usr/sfw/bin/gmake
   root@wl ~/tomcat-connectors-1.2.28-src/native # /usr/sfw/bin/gmake install
   root@wl ~/tomcat-connectors-1.2.28-src/native # cd ../conf
   root@wl ~/tomcat-connectors-1.2.28-src/conf # cp workers.properties /usr/local/tomcat/conf/workers.properties
   

4. Tomcat - Native library

   톰캣을 실행시킨후 CATALINA_HOME/logs/catalina.out 을 살펴보면 톰캣을 시작할때 아래와 같은 메시지가 나오는 것을 확인할 수 있다.
   
   정보: The APR based Apache Tomcat Native library which allows optimal performance in production environments was not found on the java.library.path: ... (이하생략)
   
   이 메시지는 톰캣 네이티브 라이브러리를 사용하지 않았을때 나오는 안내문구이다. 성능을 위해서는 네이티브 라이브러리를 사용하라는 것이다. 이는 http://tomcat.apache.org/tomcat-6.0-doc/apr.html 의 문서를 보면 더 많은 정보를 얻을 수 있다. 이 네이티브 라이브러리를 컴파일해 설치하기 위해서는 APR 1.2+(아파치2를 설치할때 같이 설치된다), OpenSSL 0.9.7+, JDK 1.4+ 가 필요하다. 단순히 아래와 같이 설치해주면 된다.
   

   root@wl ~ # cd /usr/local/tomcat/bin
   root@wl /usr/local/tomcat/bin # tar xvfz tomcat-native.tar.gz
   root@wl /usr/local/tomcat/bin # cd tomcat-native-1.1.14-src/jni/native
   root@wl /usr/local/tomcat/bin/tomcat-native-1.1.14-src/jni/native # ./configure --prefix=/usr/local --with-apr=/usr/local/apache2 1)
   root@wl /usr/local/tomcat/bin/tomcat-native-1.1.14-src/jni/native # make
   root@wl /usr/local/tomcat/bin/tomcat-native-1.1.14-src/jni/native # make install 2)
   

   1) 아파치2의 APR 라이브러리를 사용하고, /usr/local에 설치한다.
   2) 설치한 후, 톰캣을 재시작하면 네이티브 라이브러리를 로드하면서 기동할 것이다.

설정

1. 아파치 웹 서버 설정

   root@wl ~ # vi /usr/local/apache2/conf/httpd.conf 1)
   LoadModule jk_module modules/mod_jk.so
   JkWorkersFile "/usr/local/tomcat/conf/workers.properties"
   JkLogFile "logs/mod_jk.log"
   JkLogLevel warn
   JkMount /*.jsp ajp13
   root@wl ~ # vi /usr/local/tomcat/conf/workers.properties 2)
   workers.tomcat_home=/usr/local/tomcat
   workers.java_home=/usr/local/jdk
   

   1) 아파치 웹 서버의 설정 파일을 변경한다. 만약 가상 호스트를 사용하고 있다면, [JkMount /*.jsp ajp13]부분은 각각의 가상호스트세팅(<VirtualHost> ~ </VirtualHost>)에 모두 넣어주어야 한다.
   2) JNI를 사용하기 위해서는 반드시 아래 두 태그를 설정해야 한다.
   

2. 톰캣 설정

   root@wl ~ # vi /usr/local/tomcat/conf/tomcat-users.xml
   <?xml version='1.0' encoding='utf-8'?>
   <tomcat-users>
     <role rolename="standard" />
     <role rolename="manager"/>
     <user username="tomcat" password="s3cret" roles="standard,manager"/>
   </tomcat-users>
   root@wl ~ # vi /usr/local/tomcat/conf/server.xml 1)
   <!-- Connector 태그에 useBodyEncodingForURI="true" 또는 URIEncoding="UTF-8" 속성을 추가한다.  -->
   <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" useBodyEncodingForURI="true"/>
   <!-- 아래의 내용을 <Engine>과 </Engine>사이에 넣어야 한다. -->
   <Host name="APACHE_SERVER_NAME" appBase="APACHE_DOCUMENT_HOME"
      unpackWARs="true" autoDeploy="true"
      xmlValidation="false" xmlNamespaceAware="false">
   </Host>
   root@wl ~ # mkdir -p APACHE_DOCUMENT_HOME/ROOT/WEB-INF
   root@wl ~ # /usr/local/tomcat/bin/startup.sh
   root@wl ~ # /usr/local/apache2/bin/apachectl restart
   

   1) server.xml을 아파치의 설정에 맞게 바꿔야 한다. APACHE_SERVER_NAME, APACHE_DOCUMENT_HOME은 아파치의 설정에 맞게바꿔야 한다. APACHE_SERVER_NAME은 httpd.conf의 ServerName과 동일하게 해야 하며, APACHE_DOCUMENT_HOME은 httpd.conf의 DocumentRoot와 동일하게 값을 넣어야 한다.
   

3. 주의 사항

   • 위와 같이 하면 Apache HTTPD의 루트와 Apache Tomcat의 루트가 같아진다. 문서 루트를 직접 설정하는 예시를 보인것으로 별로 권장하는 설정은 아니다.
   • Context를 정해주지 않으면 400: No Host matches server name xxxx 를 보게 될 것이다. 톰캣 5.5부터 context는 WEB-INF에서 설정할 수 있다.
   • http://APACHE_SERVER_NAME/manager/html/ 으로 접속후 tomcat / s3cret (tomcat-users.xml에 설정되어있다) 를 사용해 접속하면 톰캣 관리자 페이지가 나온다. 자세한 사항은 Apache Tomcat 6.0 - Manager App HOW-TO를 참조한다.

테스트

root@wl ~ # vi $APACHE_DOCUMENT_HOME/ROOT/test.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<html>
<head><title>JSP TEST</title></head>
<body><pre>
클래스경로: <%=System.getProperty("java.class.path",".")%>
라이브러리경로: <%=System.getProperty("java.library.path", ".")%>
파라메터: <%=request.getParameter("param")%> (일치해야함)

파일인코딩: <%=System.getProperty("file.encoding")%>
시스템캐릭터셋: <%=java.nio.charset.Charset.defaultCharset().name()%>
페이지캐릭터셋: <%=response.getCharacterEncoding()%>

서블릿 경로: <%=application.getRealPath("")%>
</pre></body>
</html>
root@wl ~ # http://localhost/test.jsp?param=%ED%95%9C%EA%B8%80 를 확인해보면 된다

λｐｒｏβｅ, Ψｐｒｏβｅ

• 톰캣 5.5까지만 해도 Tomcat Admin 이라 하여 JNDI나 Deploy를 쉽게 설정할 수 있도록 만든 툴이 있었는데, 현재는 없다. 톰캣 6에서는 개발이 중단되었다. (개발 계획도 없다) 현재 톰캣 어드민으로 널리 사용되는 Lambda Probe라는 툴을 소개하고자 한다.
• 문제는 이 툴도 2008년 이후 개발이 중단되어있다는 사실이다. Lambda Probe를 이어받은 Psi Probe가 나왔긴 하지만 아직 배포버전을 만든것은 아니다.

• 설치방법

  1. 공식홈페이지에 가서 probe.1.7b.zip를 다운로드 받는다.
  2. probe.1.7b.zip 파일의 압축을 푼다. probe.war 파일 하나가 나온다.
  3. Tomcat Manager에 접속(http://localhost:8080/manager/html, 암호는 tomcat-users.xml 에서 설정해준 암호를 넣으면 된다. 솔라나라에서는 tomcat / s3cret 를 사용한다)해서 화면 하단의 [WAR file to deploy]에서 파일을 선택하고 Deploy를 클릭한다.
  4. 상단의Applications에 /probe 가 추가되었을 것이다. http://localhost:8080/probe 에 접속한다. 암호는 Tomcat Manager 암호와 같다.
  5. 아래와 같은 화면을 볼 수 있을 것이다.

Copyright © 2004-2010 Jo HoSeok. All rights reserved.