Linux용 전자정부 표준프레임워크 v4.1.0 설치하기

개발환경을 리눅스로 옮겨서 개발 도구들을 모두 다시 설치하고 있습니다. 이번에는 전자정부 표준프레임워크를 Linux에 설치합니다. 사용하고 있는 리눅스 종류는 Fedora 38 Workstation 입니다.

 

 

1. 개발환경 다운로드

표준프레임워크 포털에 들어가서 리눅스용 개발환경을 다운로드 합니다. 리눅스에 설치한 크롬으로 접속하여 다운로드 받았습니다. URL을 안다면 wget으로 다운받아도 되겠습니다. 다운로드 받은 파일명은 eGovFrameDev-4.1.0-Linux-64bit.tar.xz 입니다. 사이트에 적혀있는 파일 사이즈는  1,639,310,324 Byte 인데 실제는 1,653,023,848 Byte 였습니다. 왜 다른 걸까요? 그리고 개발환경 설명에는 .gz 로 나와 있는데, 다운받은 파일은 .xz이네요. xz가 zip 보다 압축률이 좋다고 하던데, 그래서 xz가 사용된것 같습니다. 설명도 통일되었으면 좋았겠습니다.

 

전자정부 표준프레임워크 v4.1.0은 JDK 17을 필수로 사용한다고 되어 있습니다. Fedora 설치시 OpenJDK17이 기본설치되어 있었지만 이것을 사용하지 않고 표준프레임워크에 미리 포함되어 있는 JDK를 사용하였습니다.

 

 

2. 압축풀기

전자정부 표준프레임워크는 원하는 폴더에 압축을 풀면 설치가 된것입니다. 설치 위치는 /opt 폴더에 했습니다. xz로 푼 다음에 tar로 풀어도 되지만, tar만으로도 압축이 풀립니다.

 

$ sudo tar -xvf eGovFrameDev-4.1.0-Linux-64fbit.tar.xz -C /opt

 

설치 위치는 /opt/eGovFrameDev-4.1.0-Linux-64bit 입니다. 하위에 eclipse폴더와 workspace폴더가 있습니다.

 

 

3. 실행파일 심볼릭 링크 만들기

사용 편의를 위해 실행파일을 /usr/bin에 심볼릭 링크를 만듭니다. 

 

$ sudo ln -sf /opt/eGovFrameDev-4.1.0-Linux-64bit/eclipse/eclipse /usr/bin/eclipse

 

4. 실행시 에러 발생

설치가 되었으므로 실행을 해보니 설치된 폴더내에서 실행을하면 잘 되는데, 다른 위치에서 실행을 하면 다음의 에러가 발생하였습니다.

 

$ eclipse
Error opening zip file or JAR manifest missing : plugins/org.projectlombok.agent_1.18.26/lombok.jar
Error occurred during initialization of VM
agent library failed to init: instrument

 

plugins 폴더내에 lombok.jar 파일을 찾지 못하고 있습니다. lombok 관련 설정이 eclipse.ini 파일의 -javaagent 항목에 있습니다. javaagent는 JVM 내에서 특정 작업을 수행하는 프로그램입니다. JVM의 이벤트를 받거나 실행되는 바이트 코드를 제어하는 등의 작업을 할 수 있습니다. Lombok는 바이트 코드를 제어하여 getter와 setter를 자동으로 만들어 주는 역할을 합니다.

 

eclipse.ini파일내의 -javaagent 항목의 lombok.jar 파일의 위치를 전체 경로로 수정하면 정상적으로 실행됩니다.

 

# 원래 내용
-javaagent:plugins/org.projectlombok.agent_1.18.26/lombok.jar

# 전체 경로로 수정된 내용 
-javaagent:/opt/eGovFrameDev-4.1.0-Linux-64bit/eclipse/plugins/org.projectlombok.agent_1.18.26/lombok.jar

 

5. 그놈에 아이콘 등록하기

명령행에서 실행할 수도 있지만, GUI 환경이므로 아이콘을 등록해서 사용하는게 편리하겠습니다. /usr/share/applications 폴더에 egovframedev.desktop 파일을 만듭니다.

 

$ sudo vi /usr/share/applications/egovframedev.desktop

 

파일 내용입니다.

 

[Desktop Entry]
Encoding=UTF-8
Name=eGovFrameDev
Comment=전자정부 표준프레임워크
Exec=/usr/bin/eclipse
Icon=/opt/eGovFrameDev-4.1.0-Linux-64bit/eclipse/icon.xpm
Categories=Application;Development;Java;IDE
Type=Application
Terminal=0

 

전자정부 표준프레임워크 개발환경을 설치해 보았습니다. 중간에 에러가 한번 발생한것 빼고는 무난하게 설치가 된 것 같습니다. 개개인의 환경이 모두 다르기 때문인지 개발 관련해서는 뭘하던 한번에 되는 경우는 거의 없는것 같습니다.T.T