OS X에 전자정부프레임워크 setting 하기
금번에 자바프로젝트를 2년만에 시작하면서 맥북에 전자정부프레임워크를 설치하게 되었습니다. 국내의 웹 환경이 대부분 윈도우 위주라서 실제로 전자정부 프레임워크도 윈도우의 경우에는 exe파일로 설치할 수 있게 간단히 제공하지만, 맥에서는 그 설치방법에 있어 레퍼런스가 친절하지 않으므로 제가 삽질한 과정을 한번 정리해 볼까 합니다.
- 이클립스 다운로드
자바 개발자라면 모를 수가 없는 이클립스를 먼저 다운로드 받아야합니다. 현재 제공되는 버전은 Neon 까지 나왔으나 우린 전자정부프레임워크를 설치해야합니다. 고로 예전 버전을 설치해야 합니다.
여기서 Eclipse IDE for Java Developers 이녀석을 선택해서 컴퓨터에 설치해 주세요. 설치 후 적당히 workspace를 지정해 줍니다.
2. 플러그인 설치지옥 시작 !
이클립스를 실행 시킨 후에 상단 줄에서 Help — Install New Software… 를 들어가 줍니다.
그러면 이런 아주 깜찍한(?) 새 창이 뜹니다. 이제부터 시작입니다. 설치하고 약관동의하고 이클립스 재시작의 무한루프가………
3. 전자정부프레임워크 설치
위의 경로로 들어갑니다.
우리가 주목해야 할 부분은 바로 이 부분입니다.
자동설치/업데이트주소 아래에 있는 url 을 Work with 에 넣고 add를 누르거나 엔터를 치면 아래창에 다운로드 받을 수 있는 모듈의 리스트가 뜹니다.
위의 설치가이드를 보면서 차례대로 설치해 주면 됩니다. 동시에 여러개를 설치할 수 없어서 다운로드 -> 설치 -> 재부팅 의 무한루프가 됩니다.
여기서 주의하셔야 할 점은 꼭 순서대로 설치해주세요. 의존성이 걸려있는 모듈들이 있어서 맘대로 설치하면 난리납니다.
4. 메이븐 설치하기
플러그인에 메이븐이 자동으로 딸려오는 줄 알았는데, 그게 아닙니다. 설치 모듈 관리를 편하게 하기위해서 저는 Homebrew 를 사용합니다.
터미널을 실행한 후 brew install maven 을 입력합니다.
cf. http://brew.sh/ 여기서 Homebrew 를 설치하고 이용하세요.
이렇게 설치만 하면 되는 줄 알았는데 .bash_profile 에 우린 입력을 해야합니다. 이것을….
export M3_HOME=/usr/local/Cellar/maven/3.3.9
export M3=$M3_HOME/bin
3.x 버전이라고 M3 이래요…
입력하고 백번을 source .bash_profile 을 해도 … touch .bash_profile 을 해도 mvn 명령어가 먹지않아요. 이럴땐? 쿨하게 그냥 터미널 껐다 켜줘요.
5. 설치가 잘 되었는가 예제 파일을 받아서 실행시켜봅시다.
전자정부 프레임워크 웹프로젝트 만들어줘요.
저는 3번의 삽질 끝에 성공해서 가이드는 4번째로 할거에요. 프로젝트 이름 저렇게 써주면 버전도 알아서 잘 붙는대요.
참고로 전 자바 7, 톰캣 8.0 으로 돌릴거에요. 설정 따라서 해주시구요. next > 를 누르면 아래와 같은 창이 뜨죠
체크박스 체크 후 그냥 finish 눌러줘요.
만들어진 프로젝트위에 마우스오른쪽버튼 -> Run As -> Run on Server 눌러주세요.
알아서 톰캣 8.0이 설정되어있지요. 안되어있으면 다른 친절한 가이드를 보시고 설치 후 설정하시면 됩니다.
그리고 실행시키면 ?
콘솔 속의 에러가 우릴 반기죠…… 이제 에러를 잡아봅시다.
6. 에러를 잡아보자 !
Problems 탭을 보면 현기증이 나기 시작합니다. 에러 5건에 (… 아마6건이 뜰수도 있죠… 그건 나중에 추가하구요.) 리소스 탭을 보아하니 상관없는 플젝도있어요. 그럼 에러가 4개. 모두 pom.xml 에서 난거에요. 설명을 보아하니 메이븐 네이놈… 하 …
경로 찾아가세요. 그러고보니까 프로젝트명 오타가 났지만 그건 중요한게 아니고…; mvn install 명령어를 입력합니다.
뭐 이런 유사한 로그를 남기며 설치가 됩니다.
그래도 아마 프로젝트는 안돌아가고 에러는 더욱 더 무궁무진 해질거에요.
pom.xml 을 열어서 에러나는 부분을 보면 저렇게 빨갛게 밑줄이 생겨있는데요. 그 위에 커서를 올리고 기다리면 노랗게 툴팁이 뜹니다.
Permanently mark goal compile in pom.xml as ignored in Eclipse build
이걸 에러가 사라질때까지 몇번 눌러주세요.
그리고 메이븐을 업데이트해주고요. 서버를 다시 실행해줍니다.
아아.. 이 화면을 만나기 위해 얼마나 고생을 했는지…T_T …
혹시라도 이렇게 했는데 안되면 자바버전, 톰캣 확인을 하시구요. 자꾸 Servlet 관련 에러가 난다! Error creating bean with name ‘egovSampleController’: Injection of resource dependencies failed; nested exception is ~~~~ 하는 에러를 띄우면 다음을 따라하시면됩니다.
(원인은 빌드시에 resources 폴더를 빼놓고 빌드해서 에러가 난다고 합니다.)
프로젝트 프로퍼티 메뉴를 실행시켜줍니다.
빨간색으로 선택되어있는 부분을 추가해주고 나면 아주 잘… 화면이 나옵니다.
이제 로컬 셋팅이 되었으니 관련 자료를 찾아보면서 열심히 공부하시면 됩니다!
