[오픈소스컨설팅] Configuring JBoss EWS(Tomcat) with IIS Web Server

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]

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

Installation Guide
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

Installation Guide
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

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

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

Installation Guide
필요한 OS 에 맞는 EWS 를 선택하여 다운로드를 받습니다.

Installation Guide
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 를 실행합니다.

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

Installation Guide
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 선택

Installation Guide

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

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

Installation Guide
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 에 심어지는 파일입니다.
실제 연동이 원활하게 하기 위해서는 다음의 세가지 설정 파일을 생성하여야 합니다.

Installation Guide
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

Installation Guide
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 최종 폴더 내용

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

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

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

Installation Guide

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

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

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

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

Installation Guide
5

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

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

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

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

Installation Guide
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

[오픈소스컨설팅] Configuring JBoss EWS(Tomcat) with IIS Web Server

More Related Content

What's hot

Viewers also liked

Similar to [오픈소스컨설팅] Configuring JBoss EWS(Tomcat) with IIS Web Server

More from Ji-Woong Choi

[오픈소스컨설팅] Configuring JBoss EWS(Tomcat) with IIS Web Server