** Windows(윈도우) XP/2000 과 Apache(아파치) 2.x Tomcat(톰캣) 4.x 의 mod_jk2를 이용한 연동
http://www.okjsp.pe.kr 에 올라왔던 글들과 이것저것을 참고하여 ..

Apache와 Tomcat은 준비되어 있다고 간주.

* Apache와 Tomcat을 설치한다.

* mod_jk2-*.dll 을 다운로드한다.

다음 링크에서 적당한것으로 골라잡는다.
http://mirror.apache.or.kr/jakarta/tomcat-connectors/jk2/binaries/win32/
나는 jakarta-tomcat-connectors-jk2.0.2-win32-apache2.0.43.zip 를 선택했다.

* 아파치설치디렉토리\modules 에 mod_jk2-2.0.43.dll 을 복사한다.

* 아파치설치디렉토리\conf\httpd.conf 파일에 다음을 추가한다.

LoadModule jk2_module modules/mod_jk2-2.0.43.dll

* 아파치설치디렉토리\conf\httpd.conf 파일에서 다음 두 줄을 찾아 편집한다.
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
DocumentRoot "C:/Program Files/Apache Group/Tomcat 4.1/webapps/ROOT"

<Directory "C:/Program Files/Apache Group/Tomcat 4.1/webapps/ROOT/">
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
당연한 얘기지만 C:\Program Files\Apache Group\Tomcat 4.1\webapps\ROOT"는
톰캣 4.1을 기본적으로 깔면 지정되는 톰캣의 / 컨텍스트이다.
만약 톰캣 설치 경로가 다르거나 / 컨텍스트의 경로를 바꿨다면, 자기가
지정한 경로를 이용하면 된다.

* 아파치설치디렉토리\conf\httpd.conf 파일에서 다음을 추가한다.
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Alias /examples/ "C:/Program Files/Apache Group/Tomcat 4.1/webapps/examples"

<Directory "C:/Program Files/Apache Group/Tomcat 4.1/webapps/examples/">
Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all
</Directory>
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
주의! examples/ 맨 끝의 / 를 빼먹지 말것!

Alias 는 DocumentRoot에 관계없이 URL을 서버의 전혀 다른 디렉토리에 매핑시키는
방법이다.
이것은 또한 톰캣의 컨텍스트와 아파치를 연동하는데도 필요하다.
즉, 위와 같이 하고서 http://localhost/examples 를 요청하면
DocumentRoot로 지정된
C:\Program Files\Apache Group\Tomcat 4.1\webapps\ROOT\examples\ 가 아니라
C:\Program Files\Apache Group\Tomcat 4.1\webapps\examples\ 에서 파일을
찾는다.

여기서 예로든 examples 는 또안 톰캣의 웹 컨텍스트이기도 한데, 이것을 톰캣에서
처리하게 하려면 또 다른 설정이 필요하다. 계속 읽어나갈 것.

* 아파치설치디렉토리\conf\httpd.conf 파일에서 다음부분을 찾아서 index.jsp를
추가한다.
http://localhost/ 처럼 호출했을 경우 자동으로 http://localhost/index.jsp 를
보여준다.

DirectoryIndex index.html index.html.var index.jsp

* 아파치설치디렉토리\conf\workers2.properties 을 생성하고 다음을 추가한다.
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
[logger.apache2]
level=DEBUG

[shm]
file=${serverRoot}/logs/shm.file
size=1048576
debug=0
disabled=0

# Example socket channel, override port and host.
[channel.socket:localhost:8009]
port=8009
host=127.0.0.1

# define the worker
[ajp13:localhost:8009]
channel=channel.socket:localhost:8009

# Uri mapping
[uri:/*.jsp]
worker=ajp13:localhost:8009

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

* 톰캣설치디렉토리\conf\server.xml 을 편집한다.
<Connector> 태그로 시작하는 것은 다음의 것을 제외하고는 모두 불필요하다.
다음이 없다면 추가해주고 나머지는 주석처리한다.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

<Connector className="org.apache.coyote.tomcat4.CoyoteConnector"
port="8009" minProcessors="5"maxProcessors="75" enableLookups="true"
redirectPort="8443" acceptCount="10" debug="0"
connectionTimeout="20000" useURIValidationHack="false"
protocolHandlerClassName="org.apache.jk.server.JkCoyoteHandler"/>
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

<Connector> 태그를 추가할 때 주의점은 저 태그는 <Service>태그의 자식으로
와야 한다는 것이다. 그렇지 않으면 톰캣 서버가 실행되지 않을 것이다.

* 톰캣설치디렉토리\conf\jk2.properties 생성
이미 존재하는 파일이라면 무시하고 모두 다음과 같은 내용으로 채운다.
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
handler.list=apr,channelSocket,request,shm
channelSocket.port=8009
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

* workers2.properties 의 uri 에 대한 간단한 설명
아파치가 어떤 정보는 톰캣이 처리하게 하고 어떤 정보는 자신이 처리하는지
결정하는 기준은 workers2.properties의 uri 항목에 달려있다.

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

위의 것은 / 이하에 나오는 모든 *.jsp 파일의 처리를 톰캣에게 위임한다는 뜻이다.
http://hostname.com/a.jsp 든 http://hostname.com/bbs/list.jsp 든 모두 톰캣이
처리한다.
만약에 저것을 [uri:/*] 라고 지정한다면 사실상 아파치는 아무 일도 안하고
정적(*.html, 이미지, 디렉토리 리스팅 등)인 것과 동적인것(*.jsp, 서블릿) 등
모든 처리를 톰캣이 위임받게 된다. 이것은 톰캣을 단독으로 띄우는것과 다름없다.
이것은 우리의 목적에 위배된다. 아파치와 톰캣을 연동하는 이유는 정적 컨텐츠는는
아파치가 동적 컨텐츠는 톰캣이 나눠 맞게 하려는 것이기 때문이다.

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

이것은 /examples/ 이하의 모든 정적/동적 처리를 톰캣이 맡는다.
저렇게 쓰기보다는

[uri:/examples/*.jsp]
worker=ajp13:localhost:8009

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

위와 같이 하여 *.jsp 와 서블릿들(서블릿은 모두 /examples/servets/ 에서 호출된다고 가정)만
톰캣이 제어토록 한다.
안타깝게도.. 톰캣의 examples 컨텍스트는 *Example 이라는 이름의 서블릿을 사용하는데
[uri:/examples/*Example] 이라는 패턴은 적용되지 않았다.

* 톰캣 웹 컨텍스트의 추가와 URL의 연결
톰캣에 웹 컨텍스트를 추가 했다고 해서 아파치가 자동으로 그것을 인식하지는 않는다.
서로 연결해 주어야 하는데 그 기법은 이미 위에 다 나왔다. 간단한 예를 하나만 더 보인다.

톰캣의 server.xml 에서 다음과 같은 웹 컨텍스트를 추가했다고 하자.

<Context path="/EclipseTest" reloadable="true" docBase="C:\WorkSpace\EclipseTest"/>
저것은 http://hostname/EclipseTest/ 에서 요청되는 파일을 C:\WorkSpace\EclipseTest 라는
디렉토리에서 찾아서 처리해주라는 뜻이된다.
톰캣이 단독으로 움직일때는 당연히 그렇게 되지만 아파치의 입장에서 보면
http://hostname/EclipseTest 는 DocumentRoot아래의 EclipseTest 라는 디렉토리에 있는
파일들을 요청하는 것으로 보인다.
즉, 위에서 아파치를 설정한 대로라면
C:/Program Files/Apache Group/Tomcat 4.1/webapps/ROOT/EclipseTest 가 되는 것이다.
고로 아파치와 톰캣이 핀트가 안맞으므로 서로 맞춰줄 필요가 있다. (/examples/ 처럼)

톰캣에 컨텍스트를 추가하고서 아파치의 conf/httpd.conf 에 Alias 와 디렉토리 설정을
추가한다.

또한 디렉토리 설정에서 WEB-INF 디렉토리를 액세스 못하게 만들어줄 필요가 있다.
보통 그곳에 중요한 설정 파일등을 넣어두기 때문에 톰캣이 단독으로 뜰때는
WEB-INF를 액세스 할 수 없게 하지만 아파치는 그런사실을 모르기 때문에
직접 지정해줘야만 한다.

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
Alias /EclipseTest/ "C:/WorkSpace/EclipseTest/"

<Directory "C:/WorkSpace/EclipseTest/">
Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all
</Directory>

# WEB-INF 접근을 못하게 막음
<Directory "C:/WorkSpace/EclipseTest/WEB-INF/">
Order allow,deny
Deny from all
</Directory>

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

workers2.poperties에 uri 패턴을 설정한다.
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
# jsp 설정
[uri:/EclipseTest/*.jsp]
worker=ajp13:localhost:8009

# 서블릿 설정
[uri:/EclipseTest/servlet/*]
worker=ajp13:localhost:8009
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

아파치를 재실행하고 http://hostname/EclipseTest 를 요청해본다.
참고로 나의 테스트 결과로는 이미 /example/*.jsp 가 설정되어 있을 경우
/EclipseTest/*.jsp 를 설정하지 않아도 /EclipseTest/*.jsp 들이 톰캣에
의해 실행되어졌었다. 버그인가?
모르겠다...

손권남(kwon37xi_a#T_yahoo.co.kr)

Windows XP/2000 과 Apache 2.x Tomcat 4.x 의 mod_jk2를 이용한 연동 (윈도우, 아파치, 톰캣)