This document explains how to set up IIS to cooperate with Tomcat.

1. Confidential
Last printed on 5/2/2013 1:33:00 PM
JBoss EWS + IIS 연동 Guide
Project Name:
Department:
Focus Area: JBoss EWS
Product/Process: IIS 7.5 , JBoss Enterprise Web Server(EWS) 2.0
Prepared By:
Document Owner(s) Project/Organization Role
Man-Woong Choi Technical Assistance
Project Status Report Version Control
Version Date Author Change Description
[Version #] [mm/dd/yy] [Change owner]
 [Change 1]
 [Change 2]
 [Change n]

2. Installation Guide
Confidential Page 2 5/2/2013
TABLE OF CONTENTS
1 본 문서의 목적............................................................................................................................... 4
1.1 디렉토리 구조 아키텍처 ...................................................................................................... 4
1.2 JBoss EWS 구성 정보..................................................................................................... 4
2 JBOSS EWS 엔진의 설치............................................................................................................ 6
2.1 Jboss EWS 엔진 다운로드 ............................................................................................... 6
2.2 Jboss EWS 엔진 설치..................................................................................................... 8
2.2.1 Jboss EWS Tomcat 의 구동 ..................................................................................... 8
3 IIS 연동을 위한 TOMCAT CONNECTOR 설정 ........................................................................... 10
3.1 Tomcat Connector 다운로드......................................................................................... 10
3.2 IIS 연동을 위한 Tomcat Connector 사전 설정.................................................................. 14
3.2.1 압축 해제................................................................................................................. 14
3.2.2 isapi_redirect.properties 설정 ................................................................................ 15
3.2.3 uriworkermap.properties 설정................................................................................ 15
3.2.4 worker.properties 설정........................................................................................... 16
3.2.5 tomcat connector 최종 폴더 내용 ............................................................................. 16
4 IIS 설정..................................................................................................................................... 17
4.1 IIS 서비스 설치 .............................................................................................................. 17
4.1.1 IIS 서비스 기능 활성화............................................................................................... 17
4.1.2 IIS 서비스 정상 동작 확인........................................................................................... 19
4.2 IIS 에 Tomcat 연동 isapi module 설정........................................................................... 21
4.2.1 ISAPI 및 CGI 제한 설정 ....................................................................................... 21
4.2.2 ISAPI 필터 설정....................................................................................................... 23

3. Installation Guide
Confidential Page 3 5/2/2013
4.2.3 처리기 Mapping 설정의 ISAPI 부분 활성화........................................................ 24
4.2.4 가상 디렉토리 설정.............................................................................................. 26
4.2.5 IIS Context Root 변경.......................................................................................... 28
5 IIS + JBOSS EWS TOMCAT CONNECTOR 최종 연결 확인..................................................... 29
6 참고자료 .................................................................................................................................... 30

4. Installation Guide
Confidential Page 4 5/2/2013
1 본 문서의 목적
본 문서의 목적은 JBoss EWS 와 IIS WebServer 연동을 위한 설치 및 설정 문서입니다.
JBoss EWS 는 Apache HTTPD Server 및 Tomcat 컨테이너를 포함하고 있는 소프트웨어 제품입니다.
IIS 는 MicroSoft 사에서 제공하는 WebServer 제품입니다.
1.1 디렉토리 구조 아키텍처
EWS 를 설치할 경우 엔진과 애플리케이션을 위한 인스턴스 디렉토리로 나뉘며, 보통의 경우 엔진은 아래의
디렉토리에 설치를 진행합니다.
JBoss EWS 엔진 설치 위치: /opt/jboss-ews-2.0
애플리케이션을 위한 인스턴스 설치 위치: /biz/servers/admin
표 – 인스턴스 디렉토리 구성
bin 시작, 종료, 덤프 등의 운영 관련 스크립트 존재
conf EWS(Tomcat) 관련 인스턴스 환경 설정
logs 서버 로그 기록 디렉토리
webapps 웹 애플리케이션 디플로이 디렉토리
1.2 JBoss EWS 구성 정보
JBoss Enterprise Web Server 는 아래와 같은 하부 컴포넌트를 가지고 있습니다.
https://access.redhat.com/knowledge/articles/111723
Component JBoss EWS 2.0.0
Apache Web Server (httpd) 2.2.22
Apache Tomcat 7 7.0.30
Apache Tomcat 6 6.0.35
Apache Tomcat Native 1.1.24
mod_jk 1.2.36
mod_cluster 1.2.1.Final

5. Installation Guide
Confidential Page 5 5/2/2013
Component JBoss EWS 2.0.0
Hibernate 4.1.3-Final
JBoss EWS 는 웹서버인 HTTPD 뿐만 아니라 서블릿 컨테이너의 역할을 수행하는 Tomcat 6 ,
Tomcat7 및 연결 커넥터를 포함하고 있어, 가볍고 빠르게 서버를 구동할 수 있는 환경을 제공합니다.

6. Installation Guide
Confidential Page 6 5/2/2013
2 JBoss EWS 엔진의 설치
2.1 Jboss EWS 엔진 다운로드
고객께서 직접 설치시 아래의 URL 을 통해 다운로드를 받으실 수 있습니다.
http://access.redhat.com
다운로드JBOSS ENTERPRISE MIDDLEWARE다운로드를 선택합니다.
링크 왼쪽 메뉴의 Web Server 를 클릭합니다.

7. Installation Guide
Confidential Page 7 5/2/2013
필요한 OS 에 맞는 EWS 를 선택하여 다운로드를 받습니다.

8. Installation Guide
Confidential Page 8 5/2/2013
2.2 Jboss EWS 엔진 설치
다운로드한 파일을 지정된 엔진 디렉토리 위치로 이동하여 압축을 해제합니다.
unzip -zxvf jboss-ews-application-servers-2.0.0-win6.x86_64.zip
JBoss 가 컴파일되는 버전으로 설치될 경우 공식적으로 기술지원이 되지 않습니다.
2.2.1 Jboss EWS Tomcat 의 구동
압축이 해제된 서버의 엔진 디렉토리 위치 %JBOSS_EWS_HOME%shareapache-tomcat-
7.0.30/bin 폴더로 이동하여 다음의 명령 – startup.bat 를 실행합니다.

9. Installation Guide
Confidential Page 9 5/2/2013
정상적인 서비스 구동 확인을 위해서 Browser 에 다음의 URL 를 입력하여 실제 tomcat index 페이지가
호출되는지를 확인합니다.
http://localhost:8080/index.jsp
위의 화면이 정상적으로 보인다면 실제 JbossEWS 의 초기 설정은 완료된 상태입니다.

10. Installation Guide
Confidential Page 10 5/2/2013
3 IIS 연동을 위한 Tomcat Connector 설정
IIS 와 JBoss 는 mod_jk 를 이용하여서 연동을 합니다. 연동 방식은 패턴 방식과 확장자 방식이 있으며,
확장자 방식은 확장자의 형식에 따라서, 패턴 방식은 URL 의 특정 패턴에 따라서 Apache 또는 JBoss
EWS 에서 서비스를 처리합니다.
웹서버인 IIS 를 통하여 JBoss EWS 로 연결하기 위해서는 IIS Connector 연결 설정인 isapi_redirect ,
후단의 JBoss 에 대한 인스턴스 연결을 위한 worker, 그리고 특정 패턴의 확인을 위한 uri map 설정이
존재합니다
아래에서는 mod_jk 설정과 workers 설정에서 사용하는 프로퍼티에 대한 내용을 기술합니다.
Mod_jk 에 대한 자세한 설정 내용은 아래의 URL 을 참조하도록 합니다.
http://tomcat.apache.org/connectors-doc/webserver_howto/iis.html
workers 프로퍼티에 대한 자세한 내용은 아래의 URL 을 참조하도록 합니다.
http://tomcat.apache.org/connectors-doc/reference/workers.html
3.1 Tomcat Connector 다운로드
아래의 URL 을 통해 iis + tomcat Connector 를 다운로드 받으실 수 있습니다.
http://tomcat.apache.org/download-connectors.cgi
Download > Tomcat Connectors 선택

11. Installation Guide
Confidential Page 11 5/2/2013

12. Installation Guide
Confidential Page 12 5/2/2013
Tomcat Connectors JK 1.2 > Binary Releases 선택
Windows 폴더 선택
tomcat-connectors-1.2.37-windows-x86_64-iis.zip 파일 선택후 다운로드

13. Installation Guide
Confidential Page 13 5/2/2013
윈도우 시스템의 경우는 binary 파일을 받는 것이 큰 문제 사항이 없으며, 기타 linux 혹은 unix 시스템에
설치를 하는 경우에는 source code compile 설치를 권장합니다.

14. Installation Guide
Confidential Page 14 5/2/2013
3.2 IIS 연동을 위한 Tomcat Connector 사전 설정
3.2.1 압축 해제
다운로드한 파일을 원하는 위치에서 압축해제 합니다.
unzip -zxvf tomcat-connectors-1.2.37-windows-x86_64-iis.zip
초기 압축을 해제하게 되면 isapi_redirect.dll 파일만이 존재를 하게 됩니다.
Isapi_redirect.dll 파일은 IIS + tomcat 과의 연동을 위해서 plugin 모듈 형태로 IIS 에 심어지는 파일입니다.
실제 연동이 원활하게 하기 위해서는 다음의 세가지 설정 파일을 생성하여야 합니다.

15. Installation Guide
Confidential Page 15 5/2/2013
3.2.2 isapi_redirect.properties 설정
IIS 연동에 필요한 필수 정보를 가지게 되는 isapi_redirect.properties 파일입니다.
# ISAPI redirector 의 path. /jakarta 는 IIS 에 등록하게 되는 가상디렉터리 이름입니다.
extension_uri=/jakarta/isapi_redirect.dll
# 로그파일 Full path. 본인 설치폴더에 맞게 변경 필요합니다.
log_file=D:Devwebisapilogsisapi_redirect2.log
# 로그레벨. 연동 설치중에는 일단 debug. 연동 완료 되면 error 정도로 변경. (debug, info, warn,
error, trace)
log_level=info
# 워커파일과 워커마운트 파일 Full Path. 본인 설치폴더에 맞게 변경 필요.
worker_file=D:Devwebisapiworkers.properties
worker_mount_file=D:Devwebisapiuriworkermap.properties
3.2.3 uriworkermap.properties 설정
request 요청 패턴에 따라 worker 를 정하게 하는 uriworkmap 파일를 설정합니다.
# uriworkermap.properties - IIS
#
# This file provides sample mappings for example wlb
# worker defined in workermap.properties.minimal
# The general syntax for this file is:
# [URL]=[Worker name]
/=wlb
/*.jsp=wlb
/*.do=wlb
# Optionally filter out all .jpeg files inside that context
# For no mapping the url has to start with exclamation (!)
!/servlets-examples/*.jpeg=wlb
# Mount jkstatus to /jkmanager
# For production servers you will need to
# secure the access to the /jkmanager url
/jkmanager=jkstatus

16. Installation Guide
Confidential Page 16 5/2/2013
3.2.4 worker.properties 설정
아래의 내용을 사용하여 후단부의 Tomcat 과 연결합니다.
#worker list 파일 생성 및 내용 추가
worker.list=wlb
worker.wlb.host=127.0.0.1
worker.wlb.port=8009
worker.wlb.type=ajp13
3.2.5 tomcat connector 최종 폴더 내용

17. Installation Guide
Confidential Page 17 5/2/2013
4 IIS 설정
4.1 IIS 서비스 설치
운영 체제가 Windows Server System 이 아닌 경우에는 IIS 서비스를 별도로 로딩하여야 합니다. 아래
내용은 윈도우 시스템에 IIS 설정을 하기 위한 과정을 담고 있습니다.
4.1.1 IIS 서비스 기능 활성화
먼저 제어판의 프로그램 및 기능 항목을 선택합니다.

18. Installation Guide
Confidential Page 18 5/2/2013
왼쪽 부분의 Windows 기능 사용/사용 안함을 선택합니다.
Windows 기능 사용/사용 안함 항목중 인터넷 정보 서비스 ( IIS ) 부분의 World Wide Web 서비스를
선택합니다.
실제 윈도우 기능 활성화를 위해 윈도우 시스템을 재기동 합니다.

19. Installation Guide
Confidential Page 19 5/2/2013
4.1.2 IIS 서비스 정상 동작 확인
다음의 서버 상태가 시작 상태인지를 확인합니다.
시작 상태를 확인한 후 실제 browser 상에서 다음의 url 를 입력하여 IIS 서비스가 활성화 되었는지를
확인합니다.

20. Installation Guide
Confidential Page 20 5/2/2013

21. Installation Guide
Confidential Page 21 5/2/2013
4.2 IIS 에 Tomcat 연동 isapi module 설정
실제 연동에 필요한 내용을 IIS 에 설정을 합니다.
4.2.1 ISAPI 및 CGI 제한 설정
1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > ISAPI 및 CGI 제한 이라는 아이콘을
선택
2. 오른쪽 화면의 기능 열기 선택
21

22. Installation Guide
Confidential Page 22 5/2/2013
3. 우측의 작업 영역에서 추가를 눌러서 ISAPI 및 CGI 제한 부분을 추가해준다.
4. ISAPI 또는 CGI 경로 부분의 경로 부분은 isapi_redirect.dll 를 선택한 후 확장경로 실행
부분을 체크한다.
3
4

23. Installation Guide
Confidential Page 23 5/2/2013
4.2.2 ISAPI 필터 설정
1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > ISAPI 필터 라는 아이콘을 선택
2. 오른쪽 화면의 기능 열기 선택
3. 오른쪽 화면의 작업 영역에서 추가를 눌러서 ISAPI 필터를 추가한다.
4. 위의 내용과 동일하게 경로 부분은 isapi_redirect.dll 를 선택 한 후 확인을 클릭합니다.
4
3
2
1

24. Installation Guide
Confidential Page 24 5/2/2013
4.2.3 처리기 Mapping 설정의 ISAPI 부분 활성화
1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > 처리기 맵핑 아이콘을 선택
2. 오른쪽 화면의 기능 열기 선택
3. 중앙의 ISAPI-dll 부분을 선택합니다.
4. 기능 사용 권한 편집 부분을 선택합니다.
5. 기능 사용 권한 편집 부분의 읽기, 스크립트, 실행 부분을 모두 선택한 후 확인을 선택합니다.
43
2
1

25. Installation Guide
Confidential Page 25 5/2/2013
5

26. Installation Guide
Confidential Page 26 5/2/2013
4.2.4 가상 디렉토리 설정
1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > 사이트 > Default Web Site
아이콘을 선택
2. 오른쪽 화면의 가상 디렉토리 보기 선택
1
2

27. Installation Guide
Confidential Page 27 5/2/2013
3. 오른쪽 화면의 가상 디렉토리 추가 선택
4. 가상 경로의 isapi_redirect.properties 파일의 extension_uri 에서 사용된 Jakarta 입력
실제 경로는 isapi_redirect.dll 파일이 실제 존재하는 물리 directory 선택
3
4

28. Installation Guide
Confidential Page 28 5/2/2013
4.2.5 IIS Context Root 변경
1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > 사이트 > Default Web Site
아이콘을 선택
2. 오른쪽 화면의 사이트 편집의 기본 설정 선택
3. 사이트 편집 팝업창의 실제 경로 부분을 tomcat 에서 사용되는 경로로 변경
( 이미지 부분을 위한 내용입니다.)
2
1
3

29. Installation Guide
Confidential Page 29 5/2/2013
5 IIS + Jboss EWS Tomcat Connector 최종 연결 확인
browser 상에서 http://localhost/index.jsp 를 호출한 경우 기존의 톰캣 서버의 동작 확인을 위한 페이지인
http://localhost:8080/index.jsp 와 동일한 페이지가 보인다면 정상 동작

30. Installation Guide
Confidential Page 30 5/2/2013
6 참고자료
JBoss EWS: http://www.redhat.com/products/jbossenterprisemiddleware/web-server/
JBoss EWS Component Detail: https://access.redhat.com/knowledge/ko/articles/297683
Tomcat 7 Configuration Attributes: http://tomcat.apache.org/tomcat-7.0-doc/config/http.html
Tomcat 7 System Properties: http://tomcat.apache.org/tomcat-7.0-
doc/config/systemprops.html