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

1,972 views

Published on

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

Published in: Technology
0 Comments
3 Likes
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total views
1,972
On SlideShare
0
From Embeds
0
Number of Embeds
8
Actions
Shares
0
Downloads
53
Comments
0
Likes
3
Embeds 0
No embeds

No notes for slide

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

  1. 1. ConfidentialLast printed on 5/2/2013 1:33:00 PMJBoss EWS + IIS 연동 GuideProject Name:Department:Focus Area: JBoss EWSProduct/Process: IIS 7.5 , JBoss Enterprise Web Server(EWS) 2.0Prepared By:Document Owner(s) Project/Organization RoleMan-Woong Choi Technical AssistanceProject Status Report Version ControlVersion Date Author Change Description[Version #] [mm/dd/yy] [Change owner] [Change 1] [Change 2] [Change n]
  2. 2. Installation GuideConfidential Page 2 5/2/2013TABLE OF CONTENTS1 본 문서의 목적............................................................................................................................... 41.1 디렉토리 구조 아키텍처 ...................................................................................................... 41.2 JBoss EWS 구성 정보..................................................................................................... 42 JBOSS EWS 엔진의 설치............................................................................................................ 62.1 Jboss EWS 엔진 다운로드 ............................................................................................... 62.2 Jboss EWS 엔진 설치..................................................................................................... 82.2.1 Jboss EWS Tomcat 의 구동 ..................................................................................... 83 IIS 연동을 위한 TOMCAT CONNECTOR 설정 ........................................................................... 103.1 Tomcat Connector 다운로드......................................................................................... 103.2 IIS 연동을 위한 Tomcat Connector 사전 설정.................................................................. 143.2.1 압축 해제................................................................................................................. 143.2.2 isapi_redirect.properties 설정 ................................................................................ 153.2.3 uriworkermap.properties 설정................................................................................ 153.2.4 worker.properties 설정........................................................................................... 163.2.5 tomcat connector 최종 폴더 내용 ............................................................................. 164 IIS 설정..................................................................................................................................... 174.1 IIS 서비스 설치 .............................................................................................................. 174.1.1 IIS 서비스 기능 활성화............................................................................................... 174.1.2 IIS 서비스 정상 동작 확인........................................................................................... 194.2 IIS 에 Tomcat 연동 isapi module 설정........................................................................... 214.2.1 ISAPI 및 CGI 제한 설정 ....................................................................................... 214.2.2 ISAPI 필터 설정....................................................................................................... 23
  3. 3. Installation GuideConfidential Page 3 5/2/20134.2.3 처리기 Mapping 설정의 ISAPI 부분 활성화........................................................ 244.2.4 가상 디렉토리 설정.............................................................................................. 264.2.5 IIS Context Root 변경.......................................................................................... 285 IIS + JBOSS EWS TOMCAT CONNECTOR 최종 연결 확인..................................................... 296 참고자료 .................................................................................................................................... 30
  4. 4. Installation GuideConfidential Page 4 5/2/20131 본 문서의 목적본 문서의 목적은 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/111723Component JBoss EWS 2.0.0Apache Web Server (httpd) 2.2.22Apache Tomcat 7 7.0.30Apache Tomcat 6 6.0.35Apache Tomcat Native 1.1.24mod_jk 1.2.36mod_cluster 1.2.1.Final
  5. 5. Installation GuideConfidential Page 5 5/2/2013Component JBoss EWS 2.0.0Hibernate 4.1.3-FinalJBoss EWS 는 웹서버인 HTTPD 뿐만 아니라 서블릿 컨테이너의 역할을 수행하는 Tomcat 6 ,Tomcat7 및 연결 커넥터를 포함하고 있어, 가볍고 빠르게 서버를 구동할 수 있는 환경을 제공합니다.
  6. 6. Installation GuideConfidential Page 6 5/2/20132 JBoss EWS 엔진의 설치2.1 Jboss EWS 엔진 다운로드고객께서 직접 설치시 아래의 URL 을 통해 다운로드를 받으실 수 있습니다.http://access.redhat.com다운로드JBOSS ENTERPRISE MIDDLEWARE다운로드를 선택합니다.링크 왼쪽 메뉴의 Web Server 를 클릭합니다.
  7. 7. Installation GuideConfidential Page 7 5/2/2013필요한 OS 에 맞는 EWS 를 선택하여 다운로드를 받습니다.
  8. 8. Installation GuideConfidential Page 8 5/2/20132.2 Jboss EWS 엔진 설치다운로드한 파일을 지정된 엔진 디렉토리 위치로 이동하여 압축을 해제합니다.unzip -zxvf jboss-ews-application-servers-2.0.0-win6.x86_64.zipJBoss 가 컴파일되는 버전으로 설치될 경우 공식적으로 기술지원이 되지 않습니다.2.2.1 Jboss EWS Tomcat 의 구동압축이 해제된 서버의 엔진 디렉토리 위치 %JBOSS_EWS_HOME%shareapache-tomcat-7.0.30/bin 폴더로 이동하여 다음의 명령 – startup.bat 를 실행합니다.
  9. 9. Installation GuideConfidential Page 9 5/2/2013정상적인 서비스 구동 확인을 위해서 Browser 에 다음의 URL 를 입력하여 실제 tomcat index 페이지가호출되는지를 확인합니다.http://localhost:8080/index.jsp위의 화면이 정상적으로 보인다면 실제 JbossEWS 의 초기 설정은 완료된 상태입니다.
  10. 10. Installation GuideConfidential Page 10 5/2/20133 IIS 연동을 위한 Tomcat Connector 설정IIS 와 JBoss 는 mod_jk 를 이용하여서 연동을 합니다. 연동 방식은 패턴 방식과 확장자 방식이 있으며,확장자 방식은 확장자의 형식에 따라서, 패턴 방식은 URL 의 특정 패턴에 따라서 Apache 또는 JBossEWS 에서 서비스를 처리합니다.웹서버인 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.htmlworkers 프로퍼티에 대한 자세한 내용은 아래의 URL 을 참조하도록 합니다.http://tomcat.apache.org/connectors-doc/reference/workers.html3.1 Tomcat Connector 다운로드아래의 URL 을 통해 iis + tomcat Connector 를 다운로드 받으실 수 있습니다.http://tomcat.apache.org/download-connectors.cgiDownload > Tomcat Connectors 선택
  11. 11. Installation GuideConfidential Page 11 5/2/2013
  12. 12. Installation GuideConfidential Page 12 5/2/2013Tomcat Connectors JK 1.2 > Binary Releases 선택Windows 폴더 선택tomcat-connectors-1.2.37-windows-x86_64-iis.zip 파일 선택후 다운로드
  13. 13. Installation GuideConfidential Page 13 5/2/2013윈도우 시스템의 경우는 binary 파일을 받는 것이 큰 문제 사항이 없으며, 기타 linux 혹은 unix 시스템에설치를 하는 경우에는 source code compile 설치를 권장합니다.
  14. 14. Installation GuideConfidential Page 14 5/2/20133.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. 15. Installation GuideConfidential Page 15 5/2/20133.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.propertiesworker_mount_file=D:Devwebisapiuriworkermap.properties3.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. 16. Installation GuideConfidential Page 16 5/2/20133.2.4 worker.properties 설정아래의 내용을 사용하여 후단부의 Tomcat 과 연결합니다.#worker list 파일 생성 및 내용 추가worker.list=wlbworker.wlb.host=127.0.0.1worker.wlb.port=8009worker.wlb.type=ajp133.2.5 tomcat connector 최종 폴더 내용
  17. 17. Installation GuideConfidential Page 17 5/2/20134 IIS 설정4.1 IIS 서비스 설치운영 체제가 Windows Server System 이 아닌 경우에는 IIS 서비스를 별도로 로딩하여야 합니다. 아래내용은 윈도우 시스템에 IIS 설정을 하기 위한 과정을 담고 있습니다.4.1.1 IIS 서비스 기능 활성화먼저 제어판의 프로그램 및 기능 항목을 선택합니다.
  18. 18. Installation GuideConfidential Page 18 5/2/2013왼쪽 부분의 Windows 기능 사용/사용 안함을 선택합니다.Windows 기능 사용/사용 안함 항목중 인터넷 정보 서비스 ( IIS ) 부분의 World Wide Web 서비스를선택합니다.실제 윈도우 기능 활성화를 위해 윈도우 시스템을 재기동 합니다.
  19. 19. Installation GuideConfidential Page 19 5/2/20134.1.2 IIS 서비스 정상 동작 확인다음의 서버 상태가 시작 상태인지를 확인합니다.시작 상태를 확인한 후 실제 browser 상에서 다음의 url 를 입력하여 IIS 서비스가 활성화 되었는지를확인합니다.
  20. 20. Installation GuideConfidential Page 20 5/2/2013
  21. 21. Installation GuideConfidential Page 21 5/2/20134.2 IIS 에 Tomcat 연동 isapi module 설정실제 연동에 필요한 내용을 IIS 에 설정을 합니다.4.2.1 ISAPI 및 CGI 제한 설정1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > ISAPI 및 CGI 제한 이라는 아이콘을선택2. 오른쪽 화면의 기능 열기 선택21
  22. 22. Installation GuideConfidential Page 22 5/2/20133. 우측의 작업 영역에서 추가를 눌러서 ISAPI 및 CGI 제한 부분을 추가해준다.4. ISAPI 또는 CGI 경로 부분의 경로 부분은 isapi_redirect.dll 를 선택한 후 확장경로 실행부분을 체크한다.34
  23. 23. Installation GuideConfidential Page 23 5/2/20134.2.2 ISAPI 필터 설정1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > ISAPI 필터 라는 아이콘을 선택2. 오른쪽 화면의 기능 열기 선택3. 오른쪽 화면의 작업 영역에서 추가를 눌러서 ISAPI 필터를 추가한다.4. 위의 내용과 동일하게 경로 부분은 isapi_redirect.dll 를 선택 한 후 확인을 클릭합니다.4321
  24. 24. Installation GuideConfidential Page 24 5/2/20134.2.3 처리기 Mapping 설정의 ISAPI 부분 활성화1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > 처리기 맵핑 아이콘을 선택2. 오른쪽 화면의 기능 열기 선택3. 중앙의 ISAPI-dll 부분을 선택합니다.4. 기능 사용 권한 편집 부분을 선택합니다.5. 기능 사용 권한 편집 부분의 읽기, 스크립트, 실행 부분을 모두 선택한 후 확인을 선택합니다.4321
  25. 25. Installation GuideConfidential Page 25 5/2/20135
  26. 26. Installation GuideConfidential Page 26 5/2/20134.2.4 가상 디렉토리 설정1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > 사이트 > Default Web Site아이콘을 선택2. 오른쪽 화면의 가상 디렉토리 보기 선택12
  27. 27. Installation GuideConfidential Page 27 5/2/20133. 오른쪽 화면의 가상 디렉토리 추가 선택4. 가상 경로의 isapi_redirect.properties 파일의 extension_uri 에서 사용된 Jakarta 입력실제 경로는 isapi_redirect.dll 파일이 실제 존재하는 물리 directory 선택34
  28. 28. Installation GuideConfidential Page 28 5/2/20134.2.5 IIS Context Root 변경1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > 사이트 > Default Web Site아이콘을 선택2. 오른쪽 화면의 사이트 편집의 기본 설정 선택3. 사이트 편집 팝업창의 실제 경로 부분을 tomcat 에서 사용되는 경로로 변경( 이미지 부분을 위한 내용입니다.)213
  29. 29. Installation GuideConfidential Page 29 5/2/20135 IIS + Jboss EWS Tomcat Connector 최종 연결 확인browser 상에서 http://localhost/index.jsp 를 호출한 경우 기존의 톰캣 서버의 동작 확인을 위한 페이지인http://localhost:8080/index.jsp 와 동일한 페이지가 보인다면 정상 동작
  30. 30. Installation GuideConfidential Page 30 5/2/20136 참고자료JBoss EWS: http://www.redhat.com/products/jbossenterprisemiddleware/web-server/JBoss EWS Component Detail: https://access.redhat.com/knowledge/ko/articles/297683Tomcat 7 Configuration Attributes: http://tomcat.apache.org/tomcat-7.0-doc/config/http.htmlTomcat 7 System Properties: http://tomcat.apache.org/tomcat-7.0-doc/config/systemprops.html

×