전자정부 프레임워크 v5.0 교육자료 IDE, 다른 드라이브에 설치하는 완벽 가이드

 

전자정부 프레임워크 v5.0 교육자료 IDE, 다른 드라이브에 설치하는 완벽 가이드

한 달 전쯤 전자정부 프레임워크(eGovFrame) v4.3 교육을 들었을 때는,
설치 가이드에 나와 있는 대로 얌전하게 C 드라이브(C:\)에 설치했었습니다.
하지만 이번 최신 v5.0 교육을 들으면서는 조금 다른 시도를 해보기로 했죠.
바로 용량이 넉넉한 다른 드라이브(제 경우는 G:\)에 설치해보는 것입니다!

개발 프로그램들이 워낙 용량을 많이 차지하다 보니, 항상 C 드라이브 공간이 부족해 허덕이게 되더라고요.

저처럼 C 드라이브 용량 압박에 시달리시는 분들을 위해, 다른 드라이브에 전자정부 프레임워크 IDE를 세팅하는 과정을 꼼꼼히 정리해 보았습니다.

(💡 바쁘신 분들을 위해 글 맨 마지막에 '단 1초 만에 해결하는 초간단 꿀팁(정션 링크)'도 적어두었으니 참고해 주세요!)

📌 교육자료 다운로드 및 기본 경로 확인

👉 다운로드 링크: eGovFrame 다운로드 페이지

기본적으로 가이드에서는 아래와 같이 C:\ 하위에 압축을 풀게 되어 있습니다.

✔️ eclipse IDE: C:\eGovFrame-5.0.0\eclipse ✔️ maven: C:\eGovFrame-5.0.0\maven 　💡로컬 리포지토리 포함 (.m2) ✔️ 교재 자료 경로: C:\eGovFrame-5.0.0\textbook ✔️ 실습 자료 경로: 　📂 C:\eGovFrame-5.0.0\workspace-edu 　📂 C:\eGovFrame-5.0.0\workspace-mobile 　📂 C:\eGovFrame-5.0.0\workspace-vscode

하지만 저는 C:\ 대신 G:\ 드라이브에 압축을 풀고 세팅을 변경해 주었습니다.

📌 1. 로컬 메이븐 설정(settings.xml) 변경하기

가장 먼저 해야 할 일은 Maven의 로컬 리포지토리(Local Repository) 경로를 변경하는 것입니다.

G:\eGovFrame-5.0.0\maven\settings.xml 파일을 열어서 <localRepository> 부분을 찾아주세요. 원래 주석 처리 되어 있거나 C:/로 되어 있을 텐데, 이 부분을 아래처럼 G:/로 시작하도록 직접 명시해 줍니다.

<settings>
  <!-- 생략 -->
  <localRepository>G:/eGovFrame-5.0.0/maven/repository</localRepository>
  ...

📌 2. IDE 실행 및 Maven 설정 업데이트

1) 워크스페이스 경로 수정 IDE를 처음 실행하면 워크스페이스 경로를 묻는 팝업이 뜹니다.
여기서도 당연히 기본값인 C:\로 시작하는 경로를 G:\로 바꿔서 열어줍니다.

2) User Settings 경로 변경 IDE 메뉴에서 Preferences (설정) ➡️ Maven ➡️ User Settings에 들어갑니다.
User Settings 파일 경로를 새 드라이브(G:\)의 settings.xml에 맞춰 수정한 후, Update Settings버튼을 눌러줍니다. 이때 아래의 'Local Repository' 경로가 G:/로 잘 잡혀서 나온다면 성공입니다!


📌 3. Tomcat Server 경로 재설정

Preferences 설정 창을 연 김에 Tomcat 서버 설정도 같이 손봐줍니다. 서버 설정(Server ➡️ Runtime Environments)에 들어가 보면, 기존 C:\ 경로를 바라보고 있어서 톰캣 설치 디렉토리를 찾지 못한다는 오류가 떠 있을 겁니다.
우측의 Edit... 버튼을 눌러주세요.



톰캣 경로를 G:\ 기준으로 다시 잡아주면 오류가 사라집니다.

✨ 참고 꿀팁: JRE 설정 부분에서 Workbench default JRE를 사용하면 이클립스에 내장된 JRE 21을 쓰게 됩니다. 하지만 개발과 실행 환경의 동일성을 확실히 유지하려면, 로컬에 별도로 JDK(또는 JRE) 17 버전을 설치해서 프로젝트와 버전을 명시적으로 맞춰주는 것이 더 좋습니다.

위 그림처럼 G:\ 경로 기준으로 톰캣이 정상적으로 잡혔다면, 아무 프로젝트나(예: lab101-tutor) 하나 열어봅니다.


캡처처럼 Maven Dependencies 하위의 라이브러리들이 변경한 Local Repository 위치(G:\)를 정상적으로 참조하고 있다면 완벽하게 설정된 것입니다!

 

📌 4. 프로젝트 및 로컬 DB 실행

프로젝트를 제대로 띄우려면 DB(MySQL) 실행이 필수입니다. 탐색기에서 G:\eGovFrame-5.0.0\bin\mysql-8.0.36\startup.bat 파일을 실행해 줍니다.

이제 프레임워크 IDE에서 서버를 등록하고 실행한 뒤, 웹 브라우저에서 http://localhost:8080/lab101-tutor/ 경로로 접속해 보면...


짜잔! 프레임워크 튜토리얼 화면이 정상적으로 나타납니다.

 

  

📌 5. Data Source Explorer 설정 (DB 연결 오류 해결)

교육 교재 IDE에는 실습 편의를 위한 DB 연결(com, sample HSQLDB)이 미리 세팅되어 있습니다. 당연히 이 설정들도 예전 C 드라이브를 가리키고 있으니 수정이 필요합니다. (이 작업을 하려면 조금 전에 실행한 MySQL이 켜져 있어야 합니다!)

5-1. MySQL (com) 연결 수정

Data Source Explorer 뷰에서 com에서 마우스 오른쪽 버튼을 클릭하여 Properties로 들어갑니다.


새로 뜬 창에서 우측 상단의 붉은 원으로 표시한 삼각형(△) 모양 아이콘을 클릭합니다.


JAR List 탭을 선택하고 Edit JAR/ZIP...을 눌러 Driver files의 경로를 새로운 드라이브(G:\)로 편집해 줍니다.



다시 돌아와서 Test Connection을 눌렀을 때 "Ping Succeeded!"라는 메시지가 뜬다면 연결이 정상 동작하는 것입니다.


5-2. HSQLDB 연결 수정

sample HSQLDB 역시 동일한 방법으로 들어가서, hsqldb-2.7.4.jar의 경로만 새로운 드라이브(G:\) 기준으로 맞춰주시면 됩니다.



HSQLDB 모델의 경우, 별도의 DB 실행 프로그램이 bin 폴더 아래에 있는 것이 아니라, 실습 예제 프로젝트 내부(workspace-edu\lab204-persistence\db)에 위치해 있습니다.
여기서 runHsqlDB.cmd를 실행하면 되는데, 실행 전 배치 파일 내용 수정이 꼭 필요합니다.

기본 상태는 교육 교재에 포함된 구버전 경로(Java 17)를 상대 경로로 찾도록 되어 있습니다. 

(수정 전)
..\..\..\bin\jdk-17.0.18+8\bin\java.exe -cp ./hsqldb-2.7.4.jar org.hsqldb.Server -database.0 sampledb -dbname.0 sampledb -port 9001

제 PC는 이미 환경 변수에 JAVA 17이 세팅되어 있기 때문에, 앞부분의 불필요한 상대 경로를 지우고 깔끔하게 환경변수 Java를 호출하도록 수정해 주었습니다.

(수정 후)
java -cp ./hsqldb-2.7.4.jar org.hsqldb.Server -database.0 sampledb -dbname.0 sampledb -port 9001

 

 

💡 결론: 단 1초 만에 해결하는 초간단 솔루션 (Junction Link)

지금까지 기나긴 설정 변경의 여정을 거쳐왔지만... 사실 이 모든 세팅을 한 번에 생략할 수 있는 허무할 정도로 간단한 꼼수가 있습니다. 😅

바로 윈도우의 디렉토리 정션(심볼릭 링크)을 활용하는 것입니다!

NodeJS 관련 프로그램이나 Jetty Maven 플러그인 같은 일부 환경에서는 윈도우 정션 링크를 제대로 인식하지 못해 무조건 실제 경로를 써야 하는 이슈가 종종 발생합니다.

하지만 전자정부 프레임워크는 Maven과 Tomcat 서버를 사용하고 있어서, 정션을 사용해도 충돌 없이 정상 동작하는 것을 확인했습니다.

명령 프롬프트(CMD)를 켜고 딱 한 줄만 입력해 보세요.

C:\>mklink /j C:\eGovFrame-5.0.0 G:\eGovFrame-5.0.0
Junction created for C:\eGovFrame-5.0.0 <<===>> G:\eGovFrame-5.0.0

이렇게 정션 연결만 해 주면, G 드라이브에 설치했어도 시스템은 C 드라이브에 설치된 것처럼 감쪽같이 인식합니다.
지금까지 했던 복잡한 설정들을 하나도 안 건드려도 된다는 뜻이죠.

물론 하나하나 설정을 바꿔보면서 IDE 파일 구조와 프레임워크 참조 경로의 원리를 파악해 본 것도 상당히 유익한 경험이었습니다! 😂
여유가 되시는 분들은 직접 경로를 수정하며 실습 구성을 이해해 보시고, 설정 하나하나 바꾸는 것이 번거로우신 분들은 정션 링크 기능을 적극 활용해 보시길 강력하게 추천합니다!


댓글

댓글 쓰기

이 블로그의 인기 게시물

한글 2005 가정용

이미지
가격 : 옆에 살짝 보이는 한글815판의 2배정도 가격 가정용으로 쓰는데는 문제없어 보이지만, 판매처에 대한 제한이 있군요. 상업용에 비해서 사용자 설명서가 간단하지만,  (상업용의 경우 설명서가 190페이지정도의 책입니다.) DVD케이스에 설치시디를 넣어준 것은 잘한 것 같습니다. (상업용은 일반 더블시디 플라스틱 투명 케이스 ) 한컴사전, 타자연습 기타 등등... 2개의 시디 구성은 상업용 제품과 동일합니다. 원래 설치하자마자 [한글 2005의 정보]를 보면 이곳에서도 가정용 마크가 붙어 있지만, [한컴업데이트]를 통한 인터넷 업데이트 후에는 상업용과 마찬가지로 가정용 이미지가 없어집니다. (가정용이라고 따로 패치를 만들면 번거롭겠지요.) 현재 최신버전은 6.7.7.1020 이군요. 장점 : 상업용 정품에 비해 무척이나 저렴한 가격. 상업용 정품과 같은 시디 구성 단점 : 가정에서만 사용가능. 판매처를 제한해 둔 것. 한컴에서 공식적으로 판매하지 않는 것.    구매사이트에서 보니, 구매한 사용자가 꽤 많았습니다. 가정사용자용으로, 어느정도 가격만 맞다면, 정품사용자도 충분히 증가할 수 있다는 생각이 드네요, 이런 가정용 판매가 공식적, 일반적으로 잘 이루어졌으면 좋겠습니다. 작성일 : 2007-06-09 22:26:05 링크 : http://keben.kbench.com/photo/?bc=67&pg=1&total=21&sb=3&sp=0&sc=lantool&code=2255378 Kbench 갤러리 백업 지금은 한컴도 한컴오피스2010 Home Edtion(가정용)을 판매처 제한 없이 팔고있으니 예전에 비해 구입여건이 좋아졌다.  
자세한 내용 보기

V3Pro 2002 Deluxe

이미지
ESD보단 패키지가 좋더군요. 작성일 : 2007-05-15 03:49:10 링크 : http://keben.kbench.com/photo/?bc=67&pg=1&total=21&sb=3&sp=0&sc=lantool&code=2251265 Kbench 갤러리 백업 ESD는 그냥 다운로드 방식인데, 내가 왜이렇게 썼지? DSP 잘못 쓴건가.. 거의 1년 마다 갱신하는 백신 제품은 그냥 ESD 사용하는 것이 나을 것 같다. 몇년 갱신하다보면 패키지가 쌓여감.. 현재는 V3 365클리닉으로 사용
자세한 내용 보기

bigmail 사람 많을 때 다운로드.

이미지
bigmail파일 다운로드 받을 때 사람 많아 나오는 메시지... 프로그래밍 잘하시는 분은 문제 없겠지만, 나처럼 잘 모르는 사람은... 아래 내용의 배치파일 만듦.  (예: run.bat) :Loop ping -n 15 127.0.0.1 wget http://bigmail.... goto Loop 2번째 줄의 청색 으로 된 숫자로 잠시 대기하는 시간을 정해줌 15초마다 대기하면서 다운로드를 시도하는 구조. 적색 부분에 bigmail 주소 입력해둠. wget은 아래 사이트에서 받을 수 있음. wget.exe과 run.bat는 같은 디렉터리에 있어야함. http://users.ugent.be/~bpuype/wget/ 단일 파일로 wget.exe이고 현재 버전 1.11.4, 크기는 401408byte 장점 : 시간이 걸리긴 하지만 다운로드 횟수가 남아있다면 왠만하면 받게됨. 단점 : 다운로드 완료 후, 배치파일을 종료하는 코드가 없어 재 다운로드 하게되는 문제가 있음. 사람이 워낙 많으면 재다운로드 하는 경우는 거의 없지만, 다른 이에게 폐가 될 수 있을 것 같음..   다운로드한 파일 명을 수동으로 바꿔줘야함. 위의 문제를 조금이라도 해결하고 싶어서... VBScript 코드를 작성해봤다. 엉터리이긴 하지만... Dim WshShell, objFSO, objFile, objRandom Dim Str, Addr, strFile Str = "wget.exe" Addr = InputBox ( "Daum bigmail 주소 입력" ) If Addr = "" Then WScript.Quit() '취소 버튼누르면 스크립트 종료 End If Addr = replace (Addr, ...
자세한 내용 보기