Apache 설정 및 톰캣 연동

1. 아파치, 톰캣 설치

1.1 윈도우에서 설치

Tomcat 설치

• Tomcat 5.5 Download (zip 파일로 다운로드)
• URL : http://tomcat.apache.org/download-55.cgi

Apache 설치

• Apache HTTP Server 2.0.xx 버전으로 다운로드
• URL : http://httpd.apache.org/download.cgi
• 파일다운

mod_jk 다운로드

• apache, tomcat 버전에 맞게 다운 받아야 한다.
• URL : http://tomcat.apache.org/dev/dist/tomcat-connectors/jk/binaries/win32/jk-1.2.23/
• 파일다운

1.2 리눅스에서 설치

리눅스 아파치 설치

• http://httpd.apache.org/docs/2.0/install.html

linux 에서 mod_jk 생성

• URL : http://tomcat.apache.org/connectors-doc/
• download : http://www.apache.org/dist/tomcat/tomcat-connectors/jk/source/jk-1.2.26/tomcat-connectors-1.2.26-src.tar.gz
• 설치순서
  • gzip -d tomcat-connectors-1.2.26-src.tar.gz
  • tar -xvf tomcat-connectors-1.2.26-src.tar
  • cd native
  • ./configure --with-apxs=/usr/local/apache2/bin/apxs
  • make
  • make install

2. 아파치, 톰캣 연동

<Server>
      |     
      +---<Service>
                  |
                  +---<Connector>
                  |
                  +---<Engine>
                              |
                              +---<DefaultContext>
                              |
                              +---<Realm>
                              |
                              +---<Logger>
                              |
                              +---<Host>
                                          |
                                          +---<Context>
                                          |
                                          +---<Value>
                                          |
                                          +---<Realm>
                                          |
                                          +---<Logger>

2.1 Tomcat Connectors 복사

• 다운로드한 mod_jk(mod_jk.so)파일을 %APACHE_HOME%/modules 안에 복사한다.

2.2 workers.properties 파일 설정

참고2. Tomcat Worker 톰캣 워커는(Tomcat worker) 웹서버로부터의 서블릿 요청을 톰캣 프로세스(Worker)에게 전달하여 요청을 처리하는 톰캣 인스턴스이다. 대부분 하나의 worker를 사용하나, load 밸런싱이나 site 파티셔닝을 위해 여러개의 worker를 사용 할 수 있다. 서로 다른 톰캣 워커에 의해 서로 다른 context를 서비스 할 수 있다. 워커 타입에는 ajp12, ajp13, jni, lb 등이 있다. http://tomcat.apache.org/connectors-doc/reference/workers.html

• apache와 tomcat를 연동하기위해서는 workers.properties 파일을 설정해야 한다.
• %APACHE_HOME%/conf/workers.properties

workers.tomcat_home=D:\tomcat5.5
workers.java_home=C:\jdk1.5
ps=/

worker.list=oracleclub, wiki, dev

#local.oracleclub.com
worker.oracleclub.port=7003
worker.oracleclub.host=localhost
worker.oracleclub.type=ajp13

#wiki.oracleclub.com
worker.wiki.port=7004
worker.wiki.host=localhost
worker.wiki.type=ajp13

#dev.oracleclub.com
worker.dev.port=7005
worker.dev.host=localhost
worker.dev.type=ajp13

참고3. 톰캣의 <Connector> 요소 사용자의 요청을 <Engine>에 보내주는 역할을 하는것이 <Connector>이다. <Service>는 하나 이상의 <Connector>를 가져야 한다. 사용자는 HTTP 또는 HTTPS/SSL등 여러가지 방법으로 <Engine>에 요청을 보내는데, 이들의 접속 처리는 <Connector>에 맡겨진다. 각 프로토콜에 대해 복수의 <Connector>를 가지며, 어떤 요청이 와도 <Engine>이 동일하게 처리하고, 응답을 <Connector>에 맡길 수 있다.

2.3 httpd.conf 파일 설정

• %APACHE_HOME%/conf/httpd.conf 파일을 수정
  • jk_module 추가
  • workers.properties 파일 추가
  • virtualhost 설정 추가 (이 문서에서는 "conf/vhosts/*.conf" 파일로 추가 하였음)

# jk_module 추가
LoadModule jk_module modules/mod_jk-apache-2.0.58.so

# workers.properties 파일 추가
JkWorkersFile "C:\Program Files\Apache Group\Apache2\conf\workers.properties"

# virtualhost 설정 추가 
include "conf/vhosts/*.conf"

2.4 가상 호스트 설정

• %APACHE_HOME%/conf/vhosts/dev.conf 파일을 생성 한 후 아래의 내용을 추가한다.

<VirtualHost 127.0.0.1:80>
  ServerName dev.oracleclub.com
  ServerAlias oracleclub.com
  ServerAlias web.oracleclub.com

  DocumentRoot C:\struts2\webapp
    
  ErrorLog logs/dev.oracleclub.com-error.log
  CustomLog logs/dev.oracleclub.com-access.log common

  JkMount /*.ok  dev
</VirtualHost>

• mod_jk의 JkMount 지시자를 사용해 지정된 URL 들을 Tomcat으로 할당할 수 있다.
• JkMount /*.ok dev URI에 .ok로 오는 요청은 workers.properties에 설정된 dev worker로 보낸다.

2.5 톰캣 server.xml 파일 수정

• workers.properties의 AJP/1.3 포트와 톰캣 Connector의 포트를 일치 시킨다.

 
 <?xml version="1.0" encoding="UTF-8"?>

<Server port="20005" shutdown="SHUTDOWN">
  <Service name="Tomcat-Apache-mod_jk">

    <Connector port="7005"
               enableLookups="false" redirectPort="10445" 
               protocol="AJP/1.3" URIEncoding="euc-kr"  />

    <Engine name="webhosting" defaultHost="localhost">

      <Host name="dev.oracleclub.com" appBase="oracleclub"
       unpackWARs="true" autoDeploy="true" xmlValidation="false" xmlNamespaceAware="false">
       
      <Alias>oracleclub.com</Alias>
      <Alias>web.oracleclub.com</Alias>

       <Context path="" docBase="C:/struts2/webapp" reloadable="true" workDir="C:/struts2/webapp/WEB-INF/work" />

      </Host>

    </Engine>

  </Service>
</Server>

2.6 hosts 파일 변경

• 127.0.0.1 dev.oracleclub.com

3. 가상 호스트 예제

하나의 IP로 여러개의 가상 호스트를 설정하는 방법을 알아보도록 하자.

3.1 이름 기반 가상 호스트 설정

• Apache는 HTTP의 Host 헤더를 이용하여 여러개의 호스트명을 하나의 IP 주소로 사용하는 것을 가능하게 한다.
• httpd.conf파일에 NameVirtualHost 를 설정하여 이름기반의 가상 호스트를 사용 할 수 있다.(꼭 설정해야 함)
• 아래 코드는 이름기반 가상 호스트 설정 예제이다.

# 127.0.0.1에 연결되는 모든 요청을 Host 헤더의 내용을 기준으로 처리한다. 
NameVirtualHost 127.0.0.1:80
Listen 80

<VirtualHost 127.0.0.1:80>
  ServerName dev.oracleclub.com
  DocumentRoot C:\struts2\webapp
</VirtualHost>

<VirtualHost 127.0.0.1:80>
  ServerName local.oracleclub.com
  DocumentRoot C:\oracleclub\webapp
</VirtualHost>

<VirtualHost 127.0.0.1:80>
  ServerName wiki.oracleclub.com
  DocumentRoot D:\confluence-2.7-std\confluence
</VirtualHost>

3.2 IP 기반 가상 호스트 설정

• 각 호스트별로 하나의 IP 주소를 할당하는 방법.

 
 Listen 192.168.1.1:80
 Listen 192.168.1.2:80

<VirtualHost 192.168.1.1:80>
  DocumentRoot C:\struts2\webapp
</VirtualHost>

<VirtualHost 192.168.1.2:80>
  DocumentRoot C:\oracleclub\webapp
</VirtualHost> 

4. Rewrite Rule

• mod_rewrite module은 주소 재작성 패턴을 URL에 적용한다.
• 패턴은 정규 표현식(regular expression)을 의미하며 이 정규식에 match가 되는 pattern을 요청한 url에서 출력 하게 된다.

4.1 mod_rewrite 설치

• apache 설치시 Configure 실행시에 --enable-rewrite 옵션을 추가한다.
• apache 설치 이후 추가 설치시
  • 아파치 압축 푼 디렉토리로 이동 : cd /usr/local/httpd-2.0.63/modules/mappers
  • apxs를 이용해 새 모듈 추가 : /usr/local/apache2/bin/apxs -aic mod_rewrite.c

4.2 Rewrite 모듈 지시자

RewriteEngine

• Rewriteing 엔진을 사용할지 여부를 설정
• 디폴트 설정은 Off, RewriteEngine On 으로 설정하지 않는 이상 Rewritng 엔진을 사용할 수 없다.
• 설정문법 : RewriteEngine On|Off

RewriteRule

• Rewrite 모듈의 실질적인 Rewrite 규칙들을 적용 한다.
• Input URL을 Return URL로 변경하기 위한 규칙들을 설정 한다.
• 아래는 RewriteRule을 이용해 퍼머링크를 만드는 예제다.

 <IfModule mod_rewrite.c>  
  RewriteEngine On
  RewriteRule ^/$ /main.ok [R]  
  RewriteRule ^/community/([0-9]+)$ /articlelist.ok?article.communityId=$1 [PT]
  RewriteRule ^/article/([0-9]+)$  /articleview.ok?article.articleId=$1 [PT]
</IfModule>

• RewriteRule 플래그
  • F(forbidden) : 요청하는 페이지를 403 에러로 redirect 시킵니다.
  • G(gone) : 요청하는 페이지를 410 에러로 redirect 시킵니다.
  • R(redirect) : Return URL로 redirect 한다.
  • PT(passthrough) : Input URL을 그대로 유지하며 Return URL을 실행한다.
  • http://httpd.apache.org/docs/2.2/mod/mod_rewrite.html

RewriteCond

• RewriteCond 지시자는 RewriteRule 과 함께 사용된다.
• RewriteCond 다음에 오는 RewriteRule은 RewrieteCond 에서 설정한 패턴과 일치해야지만 RewriteRule들을 실행한다.
• 주로 서브도메인을 생성할 때 사용한다.
• http://system.neulwon.com/bbs/?mid=linux_dns&page=1&document_srl=202

참고4. 정규표현식 기초 . : 다수의 한문자 ? : 0개 이상의 한문자 * : 0개 이상의 문자 또는 문자열 + : 1개 이상의 문자 또는 문자열 ^ : 문자열의 첫문(열)을 지정합니다. $ : 문자열의 끝 문자(열)을 지정합니다. (역슬래쉬) : 정규표현식에서 특별한 의미로 사용되는 문자의 특수기능을 제거합니다.(예:(, ), [, ] . 등) {n} : 정확히 n번 반복 {n,} : n번 이상 반복 {n,m} : n 이상 m 이하 반복 [chars] : 문자들의 범위 또는 표현할 수 있는 문자들을 설정합니다. 예) [a-z] : a 부터 z 까지의 소문자, [tT] : 소문자 t 또는 대문자 T 정규표현식 단축표현들 [:alpha:] : 알파벳. [a-zA-Z] 와 같은 표현 [:alnum:] : 알파벳과 숫자. [a-zA-Z0-9] 와 같은 표현 [:digit:] : 숫자 [0-9] 와 같은 표현 [:upper:] : 대문자. [A-Z] 와 같은 표현

5. 데모 및 실습

문서에 대하여

• 작성일자 : 김정식
• 작성자 : 2008년 7월 28일
• 참고자료: http://www.mojily.com/bbs/view.php?id=apm&no=12
• 이 문서는 오라클클럽 자바 웹 개발 스터디모임에서 작성하였습니다.
• 이 문서를 다른 블로그나 홈페이지에 게재할 경우에는 출처를 꼭 밝혀 주시면 고맙겠습니다.

 1  Apache 2.0
http://httpd.apache.org 에서 httpd-2.0.49.tar.gz 받아서 푼다.

$ tar xvfz httpd-2.0.49.tar.gz

INSTALL 파일을 참고하여 apache를 설치하고 실행한다.

$ ./configure --prefix=PREFIX $ make $ make install $ PREFIX/bin/apachectl start
여기서 PREFIX는 apache가 설치될 디렉토리이다. --prefix=PREFIX를 생략하면 /usr/local/apache2에 설치된다.
2003년경의 모 아티클에는 아파치 인스톨시에 configure --prefix=/usr/local/apache --enable-module=so 와 같이
모듈 옵션을 주라고 하는데 최근 문서로 확인 해 봐야 할 듯.

이하의 설명에서 PREFIX는 아파치가 설치된 디렉토리를 뜻한다.

--------------------------------------------------------------------------------

브라우저를 열고 http://127.0.0.1/을 입력하였을 때, apache web server가 설치되었다는 메시지가 나오면 성공.

아파치 서버를 끝내려면

$ PREFIX/bin/apachectl stop
2 J2SE
http://java.sun.com에서 J2SE 1.4.2 를 받아 설치한다. SDK를 받아야 된다. JRE만 받으면 안 됨.

확장자가 bin인데 실행권한을 주고 실행시키면 license에 동의하는지를 묻고 이에 대하여 y를 눌러 대답하면 설치가 된다.

아래와 같이 심볼릭 링크를 한다.

$ ln -s /usr/java/j2sdk1.4.2_04 /usr/local/java

/etc/profile.d/java.sh를 아래의 내용으로 만들어 넣는다. (실행 퍼미션으로 넣어야 한다.)

JAVA_HOME=/usr/local/java export JAVA_HOME

3  Tomcat 5
http://jakarta.apache.org에서 jakarta-tomcat-5.0.19.tar.gz를 받아서 푼다. (5.5.x 버전도 잘 동작함을 확인 함.)

$ tar xvfz jakarta-tomcat-5.0.19.tar.gz

RUNNING.txt 파일을 참고하여 tomcat을 실행시킨다.

$ $CATALINA_HOME/bin/startup.sh여기서 $CATALINA_HOME은 tomcat이 설치된 디렉토리이다.

아래와 같이 심볼릭 링크를 한다.

$ ln -s /usr/jakarta-tomcat-5.0.19 /usr/local/tomcat

브라우저를 열고 http://127.0.0.1:8080/을 입력하였을 때, tomcat이 설치되었다는 메시지가 나오면 성공. tomcat을 끝내려면

$ $CATALINA_HOME/bin/shutdown.sh

4  mod_jk2.so

http://jakarta.apache.org 에서 jakarta-tomcat-connectors-jk2-src-current.tar.gz를 받아서 푼다.

jk/native2/INSTALL.txt를 참고하여 mod_jk2.so를 만든다.

$ ./configure --with-apxs2=PREFIX/bin/apxs $ make $ cd ../build/jk2/apache2 $ PREFIX/bin/apxs -n jk2 -i mod_jk2.so* PREFIX는 apache가 설치된 경로로 대개 /usr/local/apache 혹은 /usr/local/apache2 에 위치한다.

5  httpd.conf
위에서 만든 mod_jk2.so를 PREFIX/modules/에 복사한 다음, PREFIX/conf/httpd.conf 에서

#LoadModule foo_module modules/mod_foo.so
 와 같은 형식으로 되어 있는 곳을 찾아 그 아래에

LoadModule jk2_module modules/mod_jk2.so
를 추가한다.

DirectoryIndex를 찾아 그 줄에 index.jsp를 추가한다.

Alias /icons/ "/usr/local/apache2/icons/"와 같은 형식의 행을 찾아 그 아래에

Alias /jsp-examples/ "/usr/local/tomcat/webapps/jsp-examples/" Alias /servlets-examples/ "/usr/local/tomcat/webapps/servlets-examples/"
를 추가한다.

DocumentRoot 행을 찾아

DocumentRoot "/www"
로 바꾸고 저장하고 아래와 같이 심볼릭 링크를 한다.

$ ln -s /usr/jakarta-tomcat-5.0.19/webapps/ROOT /www
* 이렇게 아파치의 DocumentRoot 와 톰캣의 DocRoot를 바로 연결 하기보단 톰캣의 가상호스트 설정으로 돌리는 쪽이 훨씬
  나은 방법이라고 생각 함.
*위 방법대로 설정 시 ContextRoot가 / 가 되는 것은 위에 설정한 톰캣 ROOT밖에 없다.
*위 설명에서와 같이 아파치의 DocumentRoot 와 톰캣의 DocRoot 심볼릭 링크로 걸지 않고 톰캣의 Host설정만으로도 충분함.

6 workers2.properties
PREFIX/conf/에 workers2.properties를 아래의 내용으로 만들어 저장한다. ( jk/native2/INSTALL.txt 참고 )
[channel.socket:localhost:8009] port=8009 host=127.0.0.1  [ajp13:localhost:8009] channel=channel.socket:localhost:8009  [uri:/*.jsp] worker=ajp13:localhost:8009  [uri:/servlets-examples/*] worker=ajp13:localhost:8009
* 위 5번 httpd.conf 수정시 제 방식대로(아파치 DocumentRoot와 톰캣의 ROOT를 심볼릭으로 엮지않는 방법) 톰캣의 HOST를
설정하는 방식을 따른다면 아래의 내용을 추가하여 모든 uri에 대해 톰켓이 알 수 있도록 다음을 추가 합니다.

[uri:/*] worker=ajp13:localhost:8009
 

7  Virtual Host
# Virtual Host의 경우 아래 URI에서 호스트 명을 넣어야 하고요. server.xml에서 host명을 넣으시면 됩니다.
[uri:www.kldp.net/*.jsp] worker=ajp13:localhost:8009  [uri:www.kldp.net/servlets-examples/*] worker=ajp13:localhost:8009  [uri:www.kldp.org/*] worker=ajp13:localhost:8009

8  LB(로드 발란서)
-- :> 내일 올릴게요.

9  apache 실행
$ PREFIX/bin/apachectl start

10  tomcat 실행
$ $CATALINA_HOME/bin/startup.sh  또는  $ $CATALINA_HOME/bin/catalina.sh start

11  확인
브라우저에서 http://127.0.0.1을 입력하면 톰캣 화면이 나온다. (8080을 입력하지 않은 것을 주목)

http://127.0.0.1/jsp-examples/을 입력하여 그곳에 있는 jsp 예제를 클릭하여 실행결과가 나타나면 jsp 성공.

http://127.0.0.1/servlets-examples/를 입력하여 그곳에 있는 servlet 예제를 클릭하여 실행결과가 나타나면 servlet 성공.
2008/03/07 01:26 2008/03/07 01:26