Post on 12-Jan-2015
description
transcript
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