(OSC) Configuring JBoss EWS(Tomcat) with IIS Web Server

  • 935 views
Uploaded on

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

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

More in: Technology
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Be the first to comment
No Downloads

Views

Total Views
935
On Slideshare
0
From Embeds
0
Number of Embeds
0

Actions

Shares
Downloads
30
Comments
0
Likes
2

Embeds 0

No embeds

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
    No notes for slide

Transcript

  • 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. 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. 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. 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. Installation GuideConfidential Page 5 5/2/2013Component JBoss EWS 2.0.0Hibernate 4.1.3-FinalJBoss EWS 는 웹서버인 HTTPD 뿐만 아니라 서블릿 컨테이너의 역할을 수행하는 Tomcat 6 ,Tomcat7 및 연결 커넥터를 포함하고 있어, 가볍고 빠르게 서버를 구동할 수 있는 환경을 제공합니다.
  • 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. Installation GuideConfidential Page 7 5/2/2013필요한 OS 에 맞는 EWS 를 선택하여 다운로드를 받습니다.
  • 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. Installation GuideConfidential Page 9 5/2/2013정상적인 서비스 구동 확인을 위해서 Browser 에 다음의 URL 를 입력하여 실제 tomcat index 페이지가호출되는지를 확인합니다.http://localhost:8080/index.jsp위의 화면이 정상적으로 보인다면 실제 JbossEWS 의 초기 설정은 완료된 상태입니다.
  • 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. Installation GuideConfidential Page 11 5/2/2013
  • 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. Installation GuideConfidential Page 13 5/2/2013윈도우 시스템의 경우는 binary 파일을 받는 것이 큰 문제 사항이 없으며, 기타 linux 혹은 unix 시스템에설치를 하는 경우에는 source code compile 설치를 권장합니다.
  • 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. 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. 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. Installation GuideConfidential Page 17 5/2/20134 IIS 설정4.1 IIS 서비스 설치운영 체제가 Windows Server System 이 아닌 경우에는 IIS 서비스를 별도로 로딩하여야 합니다. 아래내용은 윈도우 시스템에 IIS 설정을 하기 위한 과정을 담고 있습니다.4.1.1 IIS 서비스 기능 활성화먼저 제어판의 프로그램 및 기능 항목을 선택합니다.
  • 18. Installation GuideConfidential Page 18 5/2/2013왼쪽 부분의 Windows 기능 사용/사용 안함을 선택합니다.Windows 기능 사용/사용 안함 항목중 인터넷 정보 서비스 ( IIS ) 부분의 World Wide Web 서비스를선택합니다.실제 윈도우 기능 활성화를 위해 윈도우 시스템을 재기동 합니다.
  • 19. Installation GuideConfidential Page 19 5/2/20134.1.2 IIS 서비스 정상 동작 확인다음의 서버 상태가 시작 상태인지를 확인합니다.시작 상태를 확인한 후 실제 browser 상에서 다음의 url 를 입력하여 IIS 서비스가 활성화 되었는지를확인합니다.
  • 20. Installation GuideConfidential Page 20 5/2/2013
  • 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. Installation GuideConfidential Page 22 5/2/20133. 우측의 작업 영역에서 추가를 눌러서 ISAPI 및 CGI 제한 부분을 추가해준다.4. ISAPI 또는 CGI 경로 부분의 경로 부분은 isapi_redirect.dll 를 선택한 후 확장경로 실행부분을 체크한다.34
  • 23. Installation GuideConfidential Page 23 5/2/20134.2.2 ISAPI 필터 설정1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > ISAPI 필터 라는 아이콘을 선택2. 오른쪽 화면의 기능 열기 선택3. 오른쪽 화면의 작업 영역에서 추가를 눌러서 ISAPI 필터를 추가한다.4. 위의 내용과 동일하게 경로 부분은 isapi_redirect.dll 를 선택 한 후 확인을 클릭합니다.4321
  • 24. Installation GuideConfidential Page 24 5/2/20134.2.3 처리기 Mapping 설정의 ISAPI 부분 활성화1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > 처리기 맵핑 아이콘을 선택2. 오른쪽 화면의 기능 열기 선택3. 중앙의 ISAPI-dll 부분을 선택합니다.4. 기능 사용 권한 편집 부분을 선택합니다.5. 기능 사용 권한 편집 부분의 읽기, 스크립트, 실행 부분을 모두 선택한 후 확인을 선택합니다.4321
  • 25. Installation GuideConfidential Page 25 5/2/20135
  • 26. Installation GuideConfidential Page 26 5/2/20134.2.4 가상 디렉토리 설정1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > 사이트 > Default Web Site아이콘을 선택2. 오른쪽 화면의 가상 디렉토리 보기 선택12
  • 27. Installation GuideConfidential Page 27 5/2/20133. 오른쪽 화면의 가상 디렉토리 추가 선택4. 가상 경로의 isapi_redirect.properties 파일의 extension_uri 에서 사용된 Jakarta 입력실제 경로는 isapi_redirect.dll 파일이 실제 존재하는 물리 directory 선택34
  • 28. Installation GuideConfidential Page 28 5/2/20134.2.5 IIS Context Root 변경1. 서비스 및 응용 프로그램 ->인터넷 정보 서비스 관리자 선택 > 사이트 > Default Web Site아이콘을 선택2. 오른쪽 화면의 사이트 편집의 기본 설정 선택3. 사이트 편집 팝업창의 실제 경로 부분을 tomcat 에서 사용되는 경로로 변경( 이미지 부분을 위한 내용입니다.)213
  • 29. Installation GuideConfidential Page 29 5/2/20135 IIS + Jboss EWS Tomcat Connector 최종 연결 확인browser 상에서 http://localhost/index.jsp 를 호출한 경우 기존의 톰캣 서버의 동작 확인을 위한 페이지인http://localhost:8080/index.jsp 와 동일한 페이지가 보인다면 정상 동작
  • 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