쓰리래빗츠와 웹 서버를 연동하려면 아파치 톰캣 커넥터를 사용합니다. 쓰리래빗츠가 아파치 톰캣을 이용하기 때문입니다.

isapi_redirect.dll 설치

IIS와 연동하려면 isapi_redirect.dll를 설치합니다. 설치 파일은 아파치 톰캣 커넥터 페이지에서 받습니다. 1 링크를 이용하여 사용하는 OS에 맞는 파일을 받습니다.

받은 압축 파일을 풀어서 isapi_redirect.dll을 쓰리래빗츠 설치 위치 아래 iss 디렉터리(기본 설치시 C:\3rabbitz\iis)로 복사합니다. iss 디렉터리는 설치 후 별도로 만들어야 합니다.

isapi_redirect.dll 설정

• 디렉터리

  • logs

• 파일

  • isapi_redirect.properties

  • uriworkermap.properties

  • workers.properties

# Configuration file for the Jakarta ISAPI Redirector

# The path to the ISAPI Redirector Extension, relative to the website
# This must be in a virtual directory with execute privileges
extension_uri=/3rabbitz/isapi_redirect.dll

# Full path to the log file for the ISAPI Redirector
log_file=C:\3rabbitz\iis\logs\isapi_redirect.%Y-%m-%d.log

# Log level (debug, info, warn, error or trace)
log_level=info

# Rotate the log file every day
log_rotationtime=86400

# Full path to the workers.properties file
worker_file=C:\3rabbitz\iis\workers.properties

# Full path to the uriworkermap.properties file
worker_mount_file=C:\3rabbitz\iis\uriworkermap.properties

# Include default
/*=ajp13_worker

# Exclude the static files
!/resource/*=*

# workers.properties -
#
# This file is a simplified version of the workers.properties supplied
# with the upstream sources. The jni inprocess worker (not build in the
# debian package) section and the ajp12 (deprecated) section are removed.
#
# As a general note, the characters $( and ) are used internally to define
# macros. Do not use them in your own configuration!!!
#
# Whenever you see a set of lines such as:
# x=value
# y=$(x)\something
#
# the final value for y will be value\something
#
# Normaly all you will need to do is un-comment and modify the first three
# properties, i.e. workers.tomcat_home, workers.java_home and ps.
# Most of the configuration is derived from these.
#
# When you are done updating workers.tomcat_home, workers.java_home and ps
# you should have 3 workers configured:
#
# - An ajp13 worker that connects to localhost:8009
# - A load balancer worker
#
#

# OPTIONS ( very important for jni mode )

#
# workers.tomcat_home should point to the location where you
# installed tomcat. This is where you have your conf, webapps and lib
# directories.
#
workers.tomcat_home=C:\3rabbitz\tomcat쓰리래빗츠가 설치된 경로 아래의 tomcat 디렉터리를 입력합니다.

#
# workers.java_home should point to your Java installation. Normally
# you should have a bin and lib directories beneath it.
#
workers.java_home=C:\Program Files\Java\jdk1.7.0_55JDK가 설치된 위치를 입력합니다. JRE를 이용하여 설치한 경우 시스템 속성의 환경 변수에 있는 JRE_HOME 경로를 입력합니다.  

#
# You should configure your environment slash... ps=\ on NT and / on UNIX
# and maybe something different elsewhere.
#
ps=\

#
#------ ADVANCED MODE ------------------------------------------------
#---------------------------------------------------------------------
#

#
#------ worker list ------------------------------------------
#---------------------------------------------------------------------
#
#
# The workers that your plugins should create and work with
#
worker.list=ajp13_worker

#
#------ ajp13_worker WORKER DEFINITION ------------------------------
#---------------------------------------------------------------------
#

#
# Defining a worker named ajp13_worker and of type ajp13
# Note that the name and the type do not have to match.
#
worker.ajp13_worker.port=8009
worker.ajp13_worker.host=localhost
worker.ajp13_worker.type=ajp13
#
# Specifies the load balance factor when used with
# a load balancing worker.
# Note:
#  ----> lbfactor must be > 0
#  ----> Low lbfactor means less work done by the worker.
worker.ajp13_worker.lbfactor=1

#
# Specify the size of the open connection cache.
#worker.ajp13_worker.cachesize

#
#------ DEFAULT LOAD BALANCER WORKER DEFINITION ----------------------
#---------------------------------------------------------------------
#

#
# The loadbalancer (type lb) workers perform wighted round-robin
# load balancing with sticky sessions.
# Note:
#  ----> If a worker dies, the load balancer will check its state
#        once in a while. Until then all work is redirected to peer
#        workers.
worker.loadbalancer.type=lb
worker.loadbalancer.balance_workers=ajp13_worker

ISS 관리자 설정

isapi_redirect.dll를 IIS에서 사용하기 위해 ISS(인터넷 정보 서비스) 관리자를 이용하여 다음처럼 설정합니다.

ISAPI 또는 CGI 경로는 isapi_redirect.dll를 선택하고 설명은 3rabbitz¹를 입력합니다.

필터 이름은 3rabbitz을 실행 파일은 isapi_redirect.dll를 입력합니다.

톰캣 설정

3RABBITZ_HOME/tomcat/conf/server.xml 파일을 열어서 다음과 같이 내용을 바꿉니다.

<Server port="5791" shutdown="SHUTDOWN">

  <Service name="Catalina">

    <Connector port="8009" protocol="AJP/1.3"
               redirectPort="8443" URIEncoding="UTF-8"  />

    <!--
    <Connector port="1975" protocol="HTTP/1.1"
      connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" />
    -->

    <!-- 이하 생략 -->

  </Service>

</Server>

1. 다른 이름을 입력하여도 괜찮습니다.