mod_jk 사용법

Tomcat 배포판을 받았던 곳의 bin 디렉토리에서 Linux와 Win32용 Binaries 파일들 구할 수 있습니다. Linux 에서는 mod_jk.so 로, Win32에서는 mod_jk.dll 로 되어있습니다. 만들어진 mod_jk 가 없다면 손수 만드셔야죠. 소스로부터 직접 만들 수 있습니다. 먼저, Tomcat 용 Source 배포판을 다운받습니다. 다운로드 디렉토리가 무진장 많지만 jakarta-tomcat 만 찾아서 다운받으면 됩니다.

NT 에서

Visual C++ Ver.6.0으로 만듭니다. 직접 만들기 위해서는 이게 깔려있어야 됩니다.

순서는 다음과 같습니다.:

1. apache1.3/apache2.0 소스 디렉토리로 이동합니다. 도스창에서요.
2. APACHE1_HOME 환경변수를 Apache가 설치된 곳의 위치를 지정해줍니다.
3. 다음과 같이 Command 줄에 입력합니다.:
   
   MSDEV mod_jk.dsp /MAKE ALL
   
   msdev 가 path에 잡혀 있지 않다면, msdev.exe의 full path를 입력합니다. 그리고, ApacheCore.lib 파일이 컴파일 되기 전에 APACHE1_HOME\src\CoreD 와 APACHE1_HOME\src\CoreR 디렉토리에 각각 있어야 합니다. 이들 라이브러리를 생성하기 위해 충분한 Apache 소스를 build 할 필요가 있습니다.
4. 만들어진 mod_jk.dll 를 Apache의 modules 디렉토리에 복사합니다..

이것은 배포판과 디버그버전을 모두 만듭니다(mod_jk).

다른 방법: mod_jk.dsp 파일을 msdev에서 열어서 build 메뉴로 만들어도 됩니다.

UNIX 에서

Apache 용

1. Perl 5 설치되어 있어야 합니다. 모듈을 만드는 apxs 스크립트가 Perl로 짜져있습니다.
2. jakarta-tomcat/src/native/apache1.3 (또는 apache2.0) 로 이동합니다.
3. apache 배포판에 있는 apxs 명령을 돌립니다. (hint: /usr/local/apache/bin, /usr/sbin, 또는 Apache 인스톨 된 곳을 찾아보세요.). 한줄로 아래 명령을 다 칩니다.
   
   Solaris :
   

   apxs -o mod_jk.so -DSOLARIS -I../jk -I/usr/java/include -I/usr/java/include/solaris -c *.c ../jk/*.c

   시스템별로 잘 되겠지만, 만일 "symbol "fdatasync" not found" 에러가 날 때가 있습니다. 수정하려면, -lposix4 를 -c 앞에 추가해 주시면 됩니다.
   
   Linux:

   apxs -o mod_jk.so -I../jk -I/usr/local/jdk/include -I/usr/local/jdk/include/linux -c *.c ../jk/*.c

   소스 디렉토리가 아닌 ../jk 디렉토리에서 나온 objects 파일들이 현재 디렉토리에 컴파일되기 때문에 실패할 수도 있습니다. 그 때는 gcc -shared -o mod_jk.so *.o 를 돌려서 build 를 마쳐야 합니다.
   
   (다른 디렉토리에 Java를 인스톨했다면 거기에 맞춰주세요.). 끝마쳐야 합니다만 기억할 것은 apxs 에 있는 arguments들의 순서는 중요하다!는 것입니다. For other *nixes you should be able to work it out, but remember that the order of the arguments to apxs is important!.
4. mod_jk.so 를 Apache의 libexec 디렉토리에 복사합니다.

다른 웹서버들

여러가지 Makefiles 이 jakarta-tomcat/src/native 디렉토리의 하부 디렉토리에 있습니다.

mod_jk 는 원본 Ajpv12 protocol 또는 새로운 Ajpv13 protocol 양쪽다 사용할 수 있습니다. 후자를 선택했다면, "Ajp13" 커넥션핸들러를 톰캣에서 동작시켜야 합니다. 이로인해 빨라진 프로토콜의 잇점과 HTTPS를 통한 요청을 구분해낼 수 있는 능력을 갖게 됩니다.

아래 코드를 TOMCAT_HOME/conf/server.xml 파일에 추가해 주십시오.

<Connector className="org.apache.tomcat.service.PoolTcpConnector">
  <Parameter name="handler" value="org.apache.tomcat.service.connector.Ajp13ConnectionHandler"/>
  <Parameter name="port" value="8009"/>
</Connector>

이미 servlet.xml 파일은 이 부분과 유사한 8007포트를 사용하는 Ajp12 connections 을 포함하고 있습니다(mod_jserv 에 의해 전달됨). Ajp13만 사용하고 싶어도, Ajp12 커넥터를 지우지 마시죠(?) - Tomcat의 shutdown에 필요하댑니다.

대부분 단순한 경우 Tomcat은 Apache에 필요한 환경설정 파일들을 생성합니다. Tomcat 이 구동할 때 Apache 를 위해 TOMCAT_HOME/conf/mod_jk.conf-auto 파일을 자동으로 생성합니다. 우리가 할 일은 단지 이 파일을 httpd.conf 파일에 다음과 같이 한줄을 첨가하는 것 뿐입니다.
"Include TOMCAT_HOME/conf/mod_jk.conf-auto"
Ok, 이제 Tomcat 과 Apache를 시작하면 Apache서버에서 Tomcat에 접근할 수 있습니다.

특별한 경우, 예를 들면 기본값이 아닌 URL prefixes 마운팅 시에 이 파일을 커스터마이즈된 설정의 기반으로 삼고, 다른 파일 이름으로 저장합니다. Apache를 직접 관리한다면 새로운 컨텍스트가 추가될 때마다 Apache를 Update해야합니다.

Tomcat 3.2: 새 context 를 추가한 뒤에 tomcat과 apache 모두 재시작해야합니다; Apache는 재시작해야만 변화된 설정값이 적용됩니다.
또한, TOMCAT_HOME/conf/mod_jk.conf-auto 파일은 tomcat이 시작할 때 생성되므로, Apache를 시작하기 전에 Tomcat을 시작해야합니다. Tomcat은 매번 새로 시작할 때마다 TOMCAT_HOME/conf/mod_jk.conf-auto 파일을 덮어씁니다.

Worker는 TOMCAT_HOME/conf/workers.properties 파일로 설정됩니다. workers.properties howto 문서에는 상당한 분량의 정보가 있고, 먼저 알고 있어야 합니다. 그러나, 급하시다면 workers.properties 파일을 편집하고 workers.tomcat_home, workers.java_home 파일과 시스템에 맞는 ps 변수값들을 세팅하지 않아도 됩니다.

mod_jk를 사용하기 위한 Apache 설정법은 Apache 서버 설정 지시자를 통해 이루어진다; 시작하려면 자동 생성된 Tomcat 의 conf 폴더에 있는 mod_jk.conf-auto 파일을 본다.

• Apache 가 Tomcat을 불러오도록 지시해야 한다. Apache의 LoadModule 과 AddModule 설정지시자를이용한다.
• mod_jk 가 workers.properties 파일의 위치를 알고 있어야 한다. mod_jk의 JkWorkersFile 설정지시자를 사용한다.
• mod_jk가 사용할 log 파일의 위치와 로그 수준을 정해주어야 합니다. JkLogFile 과 JkLogLevel 설정지시자를 사용합니다. 로그 레벨의 종류는 debug, warn, error, emerg 이며 warn은 기본값입니다.

httpd.conf 파일에서 다음과 같은 형태로 작성해주면 됩니다:

LoadModule    jk_module  libexec/mod_jk.so
AddModule     mod_jk.c
JkWorkersFile /usr/local/jakarta-tomcat/conf/workers.properties
JkLogFile     /usr/local/apache/logs/mod_jk.log
JkLogLevel    warn

mod_jk의 JkMount 지시자를 사용해 지정된 URL 들을 Tomcat으로 할당할 수 있습니다. 일반적으로 JkMount 지시자의 구조는 다음과 같습니다:

JkMount <URL prefix> <Worker name>

예를 들어 다음의 지시자들은 .jsp로 끝나는 요청들이나 /servlet 으로 시작하는 모든 요청들은 "ajp13" worker로 보냅니다. 그러나 /otherworker 에 있는 .jsp 요청은 "remoteworker" 로 보냅니다.

JkMount /*.jsp ajp13
JkMount /servlet/* ajp13
JkMount /otherworker/*.jsp remoteworker

httpd.conf 파일에서 JkMount 지시자를 Top레벨 이나 <VirtualHost> 섹션 내부에 둠으로 사용할 수 있습니다.