IBM WAS v8.5 egovframe 연동가이드 (2013.10.)
목차 1 전자정부프레임워크연동고려사항...3 1.1 실행환경...3 1.2 개발환경...3 1.3 어플리케이션배포...3 2 개발환경구성...4 2.1 Liberty profile 설치...4 2.1.1 Liberty profile v8.5.5 다운로드...4 2.1.2 Liberty profile v8.5.5 설치및설치확인...4 2.2 Liberty profile 을이용한개발환경...5 2.2.1 WebSphere Developer Tools 설치...5 2.2.2 Liberty profile 설정...6 3 참조링크...8
1 전자정부프레임워크연동고려사항 전자정부표준프레임워크호환성인증을위한테스트환경은다음과같습니다. (Liberty profile 의경우 IBM WAS v8.5 와함께제공되는, 개발환경구성에용이한경량화 WAS 입니다.) 1. WAS - IBM WebSphere Application Server v8.5 Network Deployment - IBM WebSphere Application Server Liberty profile 2. Web Server - IBM HTTP Server 1.1 실행환경 실행환경은 IBM WAS v8.5 ND 와 Liberty profile 에공통테스트하였습니다. 1.2 개발환경 IBM WebSphere Application Server v8.5 ND와 Liberty profile 모두 Eclipse 플러그인 (WebSphere Developer Tools) 을제공하여개발환경을구성할수있도록지원하고있습니다. Eclipse Marketplace를통해쉽게플러그인설치가가능합니다. 호환성테스트에사용한개발환경은다음과같습니다. - 전자정부프레임워크개발환경 2.6 ( Eclipse 4.2.2 Juno 기반 ) 이문서가작성되는시점에 WDT가지원되는 Eclipse 버전은 Eclipse 4.2.2 Juno 까지지원합니다. 개발환경구성은 Liberty profile을이용하여구성및테스트하였습니다. 전자정부프레임워크개발환경 2.6 에대해서는 Liberty profile 의 WDT 만지원됩니다. 1.3 어플리케이션배포 전자정부표준프레임워크개발환경에서생성한프로젝트를기준으로테스트한결과 ( 호환성체크 항목 ), 설정변경없이어플리케이션배포및구동가능합니다.
2 개발환경구성 Liberty profile을이용한전자정부표준프레임워크개발환경구성에대해서설명합니다. Liberty profile은별도의복잡한설치과정이없이쉽게설치되며, 빠른서버시작과적은메모리풋프린트를가지는게큰특징입니다. Eclipse 의 Plugin을통해개발을위한 WAS 로사용하기좋으며, Liberty profile 에서개발된어플리케이션은마이그레이션작업없이 IBM WAS v8.5 ND 등 full profile 에서도 100% 동작됩니다. IBM WAS v8.5 ND 의설치및운영방법등더욱상세한정보에대해서는참조링크의 Information Center 또는 Redbook 을이용하여확인하시기바랍니다. 2.1 Liberty profile 설치 2.1.1 Liberty profile v8.5.5 다운로드 1. WASDev 사이트를접속하여 Download 의메뉴로들어갑니다. 2. WASDev URL : https://www.ibmdw.net/wasdev/downloads/websphere-application-server-liberty-profile/ 3. 그림 2-1과같이 WebSphere Application Server Liberty Profile 을선택하여다운로드합니다. wlp-developers-runtime-8.5.5.0.jar 그림 2-1 Liberty profile v8.5.5 다운로드 2.1.2 Liberty profile v8.5.5 설치및설치확인 1. 설치파일을다운로드한위치에서다음의명령어를통해설치합니다. java -jar wlp-developers-runtime-8.5.5.0.jar 2. 명령을수행하시면그림 2-2 와같이라이센스동의여부확인과설치경로를입력하게됩 니다. 설치원하는경로로입력하시면설치가완료됩니다.
그림 2-2 Liberty profile v8.5.5 설치 2.2 Liberty profile 을이용한개발환경 2.2.1 WebSphere Developer Tools설치 Eclipse Marketplace나다운로드한설치파일을이용하여사용하고있는 Eclipse에 IBM WebSphere Application Server Developer Tools for Eclipse(WDT) 의설치방법에대해서설명합니다. Eclipse 워크벤치는 Eclipse IDE for Java EE Developers 4.2.2 이어야하며, WDT 설치를위한시스템요구사항은다음에서확인하시기바랍니다. http://pic.dhe.ibm.com/infocenter/radhelp/v9/index.jsp?topic=%2fcom.ibm.rad.install.doc%2ftopics %2Fr_wdt_reqs.html 전자정부표준프레임워크를위한개발환경을구성하기위해서는전자정부표준프레임워크개발 IDE를기준으로 WDT를설치하면됩니다. 2.2.1.1 WDT 설치 Eclipse의 Marketplace를이용한설치에대해서설명합니다. 1. Eclipse 실행 2. Help Eclipse Marketplace 메뉴를선택 3. WebSphere 의키워드로검색 4. Marketplace 로검색된리스트중 IBM WebSphere Application Server V8.5.5 Liberty Profile Developer Tools for Eclipse Juno 를선택하여설치합니다.
그림 2-3 WDT(WAS Developer Tools) 설치 2.2.2 Liberty profile 설정이번항목에서는 Liberty profile을이용한개발시필요한기능에대해서 server.xml 의설정방법에대해서설명합니다. 참고로 WASdev 에도다양한샘플을제공하고있으므로참조하시어개발에도움이되었으면합니다. WASdev : https://www.ibmdw.net/wasdev/repo/#category:all_tag:all_page:1 2.2.2.1 일반적인설정 Liberty profile 에서 Log 및 Trace 설정을위한항목만설명합니다. 보다자세한내용은참조링크 의 Information Center, WASDev 사이트를통해확인하시기바랍니다. Bootstrap properties 설정 Bootstrap properties 는서버인스턴스가시작할시점에반영되는정보를설정하기위한목적으로사용됩니다. 파일은텍스트타입의 bootstrap.properties 파일명으로관리되며, 각서버의 root 즉, server.xml 과동일한위치에넣으시면됩니다. 프로퍼티설정은두가지타입으로가능합니다. 1. Trace 및 log를위한 Pre-defined property 예를들어 trace의파일명변경을위해선다음과같이 bootstrap.properties에설정합니다. com.ibm.ws.logging.trace.file.name = trace.log 더욱자세한 Trace 및 Log 를위한 pre-defined property 는 0 에서확인바랍니다.
2. Custom property 다양한환경정보들을설정하여 server.xml 또는 XML 설정파일들에서사용가능하며예를들어 http 기본포트설정은다음과같이가능합니다. 1) default.http.port, default.https.port 의설정을 bootstrap.properties에설정합니다. default.http.port = 9081 default.https.port = 9444 2) bootstrap.properties 에서선언한 port 정보를 server.xml 에서사용합니다. <httpendpoint id="defaulthttpendpoint" host="*" httpport="${default.http.port}" httpsport="${default.https.port}" /> Log 및 trace 설정 다음은 Log 및 Trace를위한 bootstrap.properties 설정을위한속성값들입니다. 속성 프로퍼티 설명 logdirectory com.ibm.ws.logging.log.directory FFDC를포함한모든로그파일의위치를지정하기위한프로퍼티입니다. 8.5.5.0 LOG_DIR 환경 변수에 의해 logdirectory 설정되면 기본값으로 WLP_OUTPUT_DIR/serverName/logs 로설정됩니다. maxfilesize com.ibm.ws.logging.max.file.size Liberty profile 은사이즈기준의로그파일 rolling 만지원합니다. rolling을사용하지않기위해선이속성의값을 0으로셋팅합니다. maxfiles com.ibm.ws.logging.max.files maxfilesize 가설정되어있으면 maxfiles의설정에의해최대보관하는로그파일수를지정합니다. 기본값은 0 입니다. consoleloglevel com.ibm.ws.logging.console.log.level console.log 파일에대한로그레벨을지정합니다. INFO, AUDIT, WARNING, ERROR, OFF 지정가능하며, 기본값은 AUDIT입니다. copysystemstreams com.ibm.ws.logging.copy.system.streams True 이면 System output stream에대해서 System.out, System.err 로로그를기록합니 다. False 이면 설정된 로그파일 (messages.log 또는 trace.log) 에기록됩니 다. 기본값은 True 입니다. messagefilename com.ibm.ws.logging.message.file.name messages.log 파일은 INFO외에 AUDIT, WARNING, ERROR, FAILURE 및 System.out, System.err 등의모든로그정보를포함하고 있습니다. 해달 messages.log 파일의이름을
지정할수있습니다. tracefilename com.ibm.ws.logging.trace.file.name Trace 로그파일의이름을지정할수있습니다. tracespecification com.ibm.ws.logging.trace.specification 기본값은 *=info 입니다. traceformat com.ibm.ws.logging.trace.format Trace 로그의포맷을지정하기위한속성입 니다. 기본 포멧은 ENHANCED 이며 BASIC, ADVANCED 를선택하여설정할수 있습니다. 2.2.2.2 알려진이슈및제한사항 Eclipse 개발중 Restart 속도가느림 Eclipse에서 WDT 를이용하여 Liberty profile 기반으로개발할경우, 서버시작시간이많이걸리는경우에대한일반적인해결방법입니다. 1. 어플리케이션정보를명시적으로선언 Server.xml 에 Application Mapping 정보가없는경우다음과같이명시적으로선언해줍니다. 2. Liberty profile v8.5.0.2 으로 fix( Liberty profile v8.5.0.2 이하의버전사용시 ) Liberty profile v8.5.x.x 버전사용시 v8.5.0.2 이상의 fixpack 을적용합니다. 3. JVM option 변경개발환경의메모리용량에따라변경이필요하나일반적으로 4G 이상의메모리사용기준값이며메모리용량에따라값조정해서사용바랍니다. <application location="[application path]" context-root="[context-root]" type="[application-type, ex: war]"/> -Xverify:none Xms512m Xmx1024m 3 참조링크 1. IBM WebSphere Application Server v8.5 Information Center http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/index.jsp 2. Redbook http://www.redbooks.ibm.com/ 3. WebSphere 한글자료 http://websphere.pe.kr