관련 문서

• http://tomcat.apache.org/connectors-doc/webserver_howto/apache.html
• http://www.easywayserver.com/apache-tomcat-integration.html
• http://wiki.gurubee.net/pages/viewpage.action?pageId=1507883
• http://wiki.gurubee.net/pages/viewpage.action?pageId=26739703
• http://www.lesstif.com/pages/viewpage.action?pageId=12943367
• http://joont.tistory.com/55
• http://httpd.apache.org/docs/2.4/ko/vhosts/examples.html
• http://httpd.apache.org/docs/2.4/ko/vhosts/mass.html
•  Apache & Tomcat 설치 및 연동.pdf

테스트 환경

• apache 2.4.20
• tomcat 8.x

조건:

• 아파치와 톰캣은 설치되어 있다 가정
• 두 개의 호스트를 각각의 WAS로 구동(하나의 아파치에 톰캣 둘)

TODO: mod_jk.so 설치방법 추가

TODO: VirtualHost 설정방법 추가

Apache Tomcat Connectors

우선 JK 모듈이 필요한데 JK 모듈은 The Apache Tomcat Connectors를 지칭하는 말로 아파치-톰캣 연동에 필요한 모듈이며 AJP로 통신한다.

mod_jk.so를 아파치설치경로/modules 아래에 위치시킨다. mod_jk.so는 OS에 따라 적합한 파일이 다르다. 리눅스 환경이라면 컴파일을 직접 해야 할 수도 있다. 만약 아파치 구동 중 'invalid ELF header' 에러가 발생하면 mod_jk.so가 잘못된 것이다. (컴파일 버전이 다르다던지)

JK 모듈 설치를 완료했으면 /httpd/conf/httpd.conf에 다음을 추가한다:

Listen 80

Include conf.modules.d/*.conf

# 아래를 추가
LoadModule jk_module modules/mod_jk.so
JkWorkersFile conf/workers.properties
JkLogFile logs/mod_jk.log
JkLogLevel info
JkMount /bo/* worker1
JkMount /* worker2

JkMount는 요청을 처리할 WAS를 의미하는데 위의 경우 요청된 주소의 PATH가 /bo/로 시작하면 worker1에, 그 외 모든 주소는 worker2에 포워딩 된다. JkMount 설정이 여러개 있을때는 상단에 있는 것이 우선순위가 높다.

현재까진 JkMount로 명시한 worker1과 worker2를 찾을 수 없다. 따라서 /httpd/conf/workers.properties를 다음처럼 작성한다:

# HTTPD Web Server and Apache Tomcat(ajp) Connector
# the loadbalancer configuration of the Server
#
# Include workers.properties by conf/extra/httpd-modjk.conf
#
# Define loadbalancer 2 worker node using ajp13
# admin Cluster Group 1 #############################################
#
# configuration template
worker.template.type=ajp13
#worker.template.lbfactor=1
#worker.template.socket_timeout=30
#worker.template.socket_keepalive=true
#worker.template.recovery_options=7
#worker.template.ping_mode=A
#worker.template.ping_timeout=10000
#worker.template.connection_pool_size=25
#worker.template.connection_pool_minsize=25
#worker.template.connection_pool_timeout=60

worker.list=worker1, worker2

worker.worker1.reference=worker.template
worker.worker1.port=8009
worker.worker1.host=localhost

worker.worker2.reference=worker.template
worker.worker2.port=8010
worker.worker2.host=localhost

#worker.wlb.type=lb
#worker.wlb.retries=2
#worker.wlb.method=Session
#worker.wlb.sticky_session=True
#worker.wlb.balance_workers=worker1, worker2

각 톰캣의 설치경로/conf/server.xml의 설정을 다음처럼 수정한다:

bo(worker1) server.xml:

<Connector port="8009" protocol="AJP/1.3" redirectPort="8443"/>
<!-- 생략 -->
<Context docBase="back-web" path="/bo" reloadable="false"/>

fo(worker2) server.xml:

<Connector port="8010" protocol="AJP/1.3" redirectPort="8443"/>
<!-- 생략 -->
<Context docBase="front-web" path="/" reloadable="false"/>

여기서 docBase는 톰캣의 webapps 아래에 위치한 폴더 혹은 WAR파일을 말한다.

아파치 구동

httpd -k start

톰캣 구동

startup.bat  # 혹은 startup.sh

에러 없이 구동에 성공하면 아래 주소로 테스트

http://localhost/bo/
http://localhost

VirtualHost

아래처럼만 해도 돌아감ㅋ

LoadModule jk_module modules/mod_jk.so
JkWorkersFile conf/workers.properties
JkLogFile logs/mod_jk.log
JkLogLevel info

<virtualhost *:80>
    ServerName bo.test.com
    DocumentRoot /home/user1/was/bo/webapps/back-web/
    JkMount /* worker1
</virtualhost>

<virtualhost *:80>
    ServerName fo.test.com
    DocumentRoot /home/user1/was/fo/webapps/front-web/
    JkMount /* worker2
</virtualhost>

hosts 설정하고 아래 주소로 테스트

http://bo.test.com
http://fo.test.com