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

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

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

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및 연결 커넥터를 포함하고 있어, 가볍고 빠르게 서버를 구동할 수 있는 환경을 제공합니다.

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를 클릭합니다.

Installation Guide

Confidential Page 7 5/2/2013

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

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%\share\apache-tomcat-

7.0.30/bin 폴더로 이동하여 다음의 명령 – startup.bat 를 실행합니다.

Installation Guide

Confidential Page 9 5/2/2013

정상적인 서비스 구동 확인을 위해서 Browser에 다음의 URL 를 입력하여 실제 tomcat index 페이지가

호출되는지를 확인합니다.

http://localhost:8080/index.jsp

위의 화면이 정상적으로 보인다면 실제 JbossEWS의 초기 설정은 완료된 상태입니다.

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

Installation Guide

Confidential Page 11 5/2/2013

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 파일 선택후 다운로드

Installation Guide

Confidential Page 13 5/2/2013

윈도우 시스템의 경우는 binary 파일을 받는 것이 큰 문제 사항이 없으며, 기타 linux 혹은 unix 시스템에

설치를 하는 경우에는 source code compile 설치를 권장합니다.

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에 심어지는 파일입니다.

실제 연동이 원활하게 하기 위해서는 다음의 세가지 설정 파일을 생성하여야 합니다.

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:\Dev\web\isapi\logs\isapi_redirect2.log

# 로그레벨. 연동 설치중에는 일단 debug. 연동 완료 되면 error 정도로 변경. (debug, info, warn,

error, trace) log_level=info

# 워커파일과 워커마운트 파일 Full Path. 본인 설치폴더에 맞게 변경 필요.

worker_file=D:\Dev\web\isapi\workers.properties worker_mount_file=D:\Dev\web\isapi\uriworkermap.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

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

Installation Guide

Confidential Page 17 5/2/2013

4 IIS 설정

4.1 IIS 서비스 설치

운영 체제가 Windows Server System 이 아닌 경우에는 IIS 서비스를 별도로 로딩하여야 합니다. 아래

내용은 윈도우 시스템에 IIS 설정을 하기 위한 과정을 담고 있습니다.

4.1.1 IIS 서비스 기능 활성화

먼저 제어판의 프로그램 및 기능 항목을 선택합니다.

Installation Guide

Confidential Page 18 5/2/2013

왼쪽 부분의 Windows 기능 사용/사용 안함을 선택합니다.

Windows 기능 사용/사용 안함 항목중 인터넷 정보 서비스 ( IIS ) 부분의 World Wide Web 서비스를

선택합니다.

실제 윈도우 기능 활성화를 위해 윈도우 시스템을 재기동 합니다.

Installation Guide

Confidential Page 19 5/2/2013

4.1.2 IIS 서비스 정상 동작 확인

다음의 서버 상태가 시작 상태인지를 확인합니다.

시작 상태를 확인한 후 실제 browser 상에서 다음의 url를 입력하여 IIS 서비스가 활성화 되었는지를

확인합니다.

Installation Guide

Confidential Page 20 5/2/2013

Installation Guide

Confidential Page 21 5/2/2013

4.2 IIS 에 Tomcat 연동 isapi module 설정

실제 연동에 필요한 내용을 IIS 에 설정을 합니다.

4.2.1 ISAPI 및 CGI 제한 설정

1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > ISAPI 및 CGI 제한 이라는 아이콘을

선택

2. 오른쪽 화면의 기능 열기 선택

2 1

Installation Guide

Confidential Page 22 5/2/2013

3. 우측의 작업 영역에서 추가를 눌러서 ISAPI 및 CGI 제한 부분을 추가해준다.

4. ISAPI 또는 CGI 경로 부분의 경로 부분은 isapi_redirect.dll 를 선택한 후 확장경로 실행

부분을 체크한다.

3

4

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

Installation Guide

Confidential Page 24 5/2/2013

4.2.3 처리기 Mapping 설정의 ISAPI 부분 활성화

1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > 처리기 맵핑 아이콘을 선택

2. 오른쪽 화면의 기능 열기 선택

3. 중앙의 ISAPI-dll 부분을 선택합니다.

4. 기능 사용 권한 편집 부분을 선택합니다.

5. 기능 사용 권한 편집 부분의 읽기, 스크립트, 실행 부분을 모두 선택한 후 확인을 선택합니다.

4 3

2

1

Installation Guide

Confidential Page 25 5/2/2013

5

Installation Guide

Confidential Page 26 5/2/2013

4.2.4 가상 디렉토리 설정

1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > 사이트 > Default Web Site

아이콘을 선택

2. 오른쪽 화면의 가상 디렉토리 보기 선택

1

2

Installation Guide

Confidential Page 27 5/2/2013

3. 오른쪽 화면의 가상 디렉토리 추가 선택

4. 가상 경로의 isapi_redirect.properties파일의 extension_uri 에서 사용된 Jakarta 입력

실제 경로는 isapi_redirect.dll 파일이 실제 존재하는 물리 directory 선택

3

4

Installation Guide

Confidential Page 28 5/2/2013

4.2.5 IIS Context Root 변경

1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > 사이트 > Default Web Site

아이콘을 선택

2. 오른쪽 화면의 사이트 편집의 기본 설정 선택

3. 사이트 편집 팝업창의 실제 경로 부분을 tomcat에서 사용되는 경로로 변경

( 이미지 부분을 위한 내용입니다.)

2

1

3

Installation Guide

Confidential Page 29 5/2/2013

5 IIS + Jboss EWS Tomcat Connector 최종 연결 확인

browser 상에서 http://localhost/index.jsp 를 호출한 경우 기존의 톰캣 서버의 동작 확인을 위한 페이지인

http://localhost:8080/index.jsp 와 동일한 페이지가 보인다면 정상 동작

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