전자정부 프레임워크(egov framework) 설치하기(1)

전자정부 표준프레임워크 설치하고 개발환경 구축하는 방법에 대하여 설명하는 글을 써봅니다.

보통 설치하고 이클립스를 구동하고 웹서비스를 테스트 하기 위해서 자바(java), 아파치 톰캣(Apache Tomcat) 을 설치하는 작업을 하게 되지만 자바, 아파치톰캣을 설치하지 않고 전자정부 프레임워크 디렉토리에 복사해 넣어두고 언제든지 다른 PC에 복사만 해서 별도의 환경 설정 없이 개발환경을 만드는 방법에 대해서 설명하고자 합니다.

제일 먼저 http://www.egovframe.go.kr/에서 프레임워크를 다운로드 하고 압축을 풀어주시기 바랍니다.
다운로드하기 위해서는 로그인이 필요합니다.

egovframe 사이트에 접속해 보면 아래와 같은 화면이 눈에 들어옵니다.

개발환경, 실행환경, 운영환경, 공통컴포넌트 로컬에서 개발환경을 구축할려면 개발환경을 클릭해서 다운로드 해주시면 되겠죠? 그런데 실행환경, 운영환경, 공통컴포넌트는 도대체 머지? 라는 궁금함이 생기실겁니다.
개발환경은 이클립스 자체라고 보시면 되고 이클립스에 표준프레임워크만의 플러그인이 추가된 것입니다.
실행환경은 표준프레임워크 기반의 어플리케이션을 실행하기 위해 필요한 jar 파일을 말합니다. 자바 jar 라이브러리라고 보시면 됩니다.
운영환경이란 표준프레임워크 기반으로 개발된 어플리케이션 웹사이트등을 운영할 수 있도록 제공하는 모니터링 도구, 배치운영환경, 의사소통관리 라는 도구를 제공하는데 추후에 실행환경 및 운영환경에 관련되서 자세한 포스팅을 해보록 하고 환경에 관련된 내용은 다음으로 미루겠습니다.

스터디용으로 개발환경 설치를 위해 모든 설치 프로그램을 최신으로 받아서 하도록 하겠습니다. 만약 프로젝트를 위해서 개발환경을 구축하게 된다면 운영서버에 설치된 java 버전 등을 확인하여 서버 환경에 맞는 버전으로 개발환경을 구성해야 합니다. 운영서버와 버전이 상이 할 경우 운영서버에서 문제가 발생 할 수도 있습니다.

전자정부 프레임워크는 "표준프레임워크 개발자 교육 교재 및 실습" 파일을 다운로드 하거나 필요한 소프트웨어를 개별적으로 다운로드 하여 구성하면 됩니다. 교재 및 실습용은 apache-tomcat-7.0.59, apache-tomcat-8.0.24 버전과, jdk 1.7.0_80, jdk 1.8.0_45 버전과 android-sdk-windows 안드로이드 개발 도구, mysql-5.6.21 버전이 포함되어 있습니다.

* 표준프레임워크 개발자 교육 교재 및 실습 다운로드
개발자 교육 > 교육자료에서 "표준프레임워크 개발자 교육 교재 및 실습 (V3.6.0)을 다운로드합니다.
다운로드한 exe파일을 실행하여 C:\에 압축을 해제하고 "C:\eGovFrame-3.6.0"에서 eclipse 바로가기를 실행하면 됩니다.

교육 실습용 프로젝트 및 Servers에 톰캣이 기본으로 설정되어 있습니다.
"C:\eGovFrame-3.6.0\textbook"에는 실습 교재 및 각종 PDF 문서가 있으니 한 번씩 읽어보면 좋을 듯 합니다.

* 개발환경 개별 다운로드 환경 구성
1. 프레임워크 다운로드
개발환경 이미지에 마우스를 대면 [가이드] [다운로드] 버튼이 보여질 것입니다. 그럼 우리는 [다운로드]를 클릭을 해야겠죠?
3.6.0   개발자용 개발환경 32bit/64bit(Implementation Tool) Full Version 3.6.0 을 다운로드 해서 진행하겠습니다.
버전이 높아질수록 이클립스 버전이 높아질수록 고사양을 요구함으로 컴퓨터 사양이 낮은편이라면 3.5 이하의 버전을 권장합니다.
다음의 JDK 버전을 확인하여 사용하는 JDK 버전에 맞춰 다운로드 해야 할 듯 합니다.
2.7 미만 : JavaEE(J2EE) 5 혹은 JDK1.5 이상의 환경
2.7 이상 : JavaEE(J2EE) 6 혹은 JDK1.6 이상의 환경
3.0 이상 : JavaEE(J2EE) 6 혹은 JDK1.6 이상의 환경
3.5 이상 : JavaEE(J2EE) 7 혹은 JDK1.7 이상의 환경(단, 개발환경 3.5.1 부터 JDK8 적용 가능)  
3.6 이상 : JavaEE(J2EE) 7 혹은 JDK1.7 이상의 환경

다운로드 게시물로 들어가 보면 eGovFrameDev-3.6.0-64bit.exe[672,580,172 byte], eGovFrameDev-3.6.0-32bit.exe[672,600,064 byte] 두 가지를 다운로드 할 수 있습니다. 사용하는 PC의 윈도우 버전에 맞게 다운로드 합니다. 다운로드 한 파일을 실행하여 C:\에 풉니다.

2. JAVA 다운로드
아래의 오라클 사이트에 접속하여 알맞은 버전을 선택하여 다운로드 합니다.
만약 스터디용이 아니라 실전 프로젝트에 사용하기 위해서 로컬 개발환경을 구축하고 있다면 서버에 설치된 java 버전과 같은 버전을 다운로드하여 사용해야 합니다. 호환성 문제가 발생할 수 있기 때문에 로컬에서는 잘 실행되지만 서버에서 실행할 때 문제가 생길 수도 있습니다.

http://www.oracle.com/technetwork/java/javase/archive-139210.html

"Java SE 8"을 클릭하여 OS 버전에 맞는 JDK 버전을 다운로드 해주세요.
Java SE Development Kit 부분에서 다운로드 해주세요. 아무 생각 없이 Runtime 버전을 다운로드 하면 안된답니다.
JDK도 다운로드 할려면 로그인이 필요하네요. 이메일 주소로 가입하고 오라클에서 받은 메일을 확인하여 로그인 계정을 활성화 해주어야 합니다. 귀찮네요...
JDK를 설치합니다. 저는 jdk를 전자정부 프레임워크 폴더로 복사한 후 JDK를 설치 제거 할 것입니다. java를 필요로 하는 어플리케이션이 없기 때문에.
미설치 버전 위치를 못찾아서 설치 버전으로 설치합니다. 혹시 미설치 버전 링크가 있으면 댓글로 알려주세요~

3. 아파치 톰캣 다운로드
아파치 톰캣을 다운로드 합니다. 이클립스에서만 실행할 것이기 때문에 설치 버전이 아니라 zip으로 압축된 파일을 다운로드 합니다.
윈도우 버전에 맞게 파일을 다운로드 합니다.
운영서버의 WAS가 제우스 1.6(Jeus 1.6) 버전대이면 아파치 톰캣은 6.0으로 해주셔야만 합니다.
현재(2017-07-02) 최신 버전인 Tomcat 9.0의 버전은 M22이고 알파 버전입니다.
[IT만들기/Java] - JEUS에서 지원하는 Specification 제우스의 상세 스펙은 이 글을 참조해주세요. JSP, JSTL버전이 톰캣 6.0의 사용버전입니다.

http://mirror.navercorp.com/apache/tomcat/tomcat-8/v8.0.45/bin/ 에서 아파치 톰캣 8.0버전을 다운로드 하시면 됩니다.
전자정부 프레임워크에서

 

4. 디렉토리 구조 및 환경 파일 수정
설치한 java의 jdk 디렉토리와 압축을 푼 아파치 톰캣을 전자정부 프레임워크에 다음 모양과 같이 복사해 넣습니다.
workspace라는 디렉토리를 만들어 주세요.

eGovFrameDev-3.6.0-64bti
  └ bin
      └ apache-tomcat-8.0.45
      └ jdk1.8.0_121
  └ eclipse 
  └ workspace

"eclipse.exe 바로가기"를 만들고 바로가기의 속성을 다음과 같이 만들어 주거나

C:\eGovFrameDev-3.6.0-64bit\eclipse\eclipse.exe -vm C:\eGovFrameDev-3.6.0-64bit\bin\jdk1.8.0_121\bin\javaw.exe -data C:\eGovFrameDev-3.6.0-64bit\workspace

다음과 같이 C:\eGovFrameDev-3.6.0-64bit\eclipse\eclipse.ini 파일을 수정해 주면 됩니다.
-vm 부분인 굵게 빨간색 문장을 넣습니다. 이때 --launcher.appendVmargs 바로 아래에 위치시켜야 합니다.

-startup plugins/org.eclipse.equinox.launcher_1.3.100.v20150511-1540.jar --launcher.library plugins/org.eclipse.equinox.launcher.win32.win32.x86_64_1.1.300.v20150602-1417 -product org.eclipse.epp.package.jee.product --launcher.defaultAction openFile --launcher.XXMaxPermSize 256M -showsplash org.eclipse.platform --launcher.XXMaxPermSize 256m --launcher.defaultAction openFile --launcher.appendVmargs -vm C:/eGovFrameDev-3.6.0-64bit/bin/jdk1.8.0_121/bin/javaw.exe -vmargs -Dfile.encoding=UTF-8 -Dosgi.requiredJavaVersion=1.7 -Xms40m -Xmx512m -Duser.name="겨울향처럼"

위에서 Duser.name 부분은 이클립스에서 java 파일 등에 파일에 주석을 넣을 시 code templates의  author ${user}에 사용자 이름을 넣을 때 사용 하기위해서 넣어주는 부분입니다. 사용하는 개발자마다 저 파일에 자신의 이름을 넣으면 됩니다. 

/**
 * 
 * @since ${date}
 * @author ${user}
 * <PRE>
 * ------------------------ 
 * 개정이력
 * ${date} ${user} : 최초작성
 * </PRE>
 */

"C:\eGovFrameDev-3.6.0-64bit\eclipse\eclipse.exe"를 실행합니다.

workspace 위치는 "C:\eGovFrameDev-3.6.0-64bit\workspace"으로 설정합니다.