15.App Builder 설치

Edit

15.1App Builder 설치 전 필요한 작업

App Builder를 서버에 설치하기 전에 필요한 작업입니다. App Builder를 설치하기 위한 공통 작업과 배포 대상에 따라 추가 작업이 필요합니다.

15.1.1App Builder 설치 공통

JDK 설치 후 Tomcat(WAS)을 설치합니다.

본문에서는 JDK 1.6, Tomcat 7 버전을 사용했습니다.

설치파일은 아래 링크에서 내려받을 수 있습니다.

https://www.oracle.com/java/technologies/javase-downloads.html

http://tomcat.apache.org/download-70.cgi

15.1.2Android

Android SDK를 설치합니다. 안드로이드 스튜디오 설치 후 SDK Manager를 실행하거나 명령행 도구를 내려받아 SDK를 설치할 수 있습니다.

본문에서는 Android 9.0(API 28) 버전을 사용했습니다.

설치파일은 아래 링크에서 내려받을 수 있습니다.

https://developer.android.com/studio/index.html#downloads

15.1.3iOS, macOS

Xcode를 설치하고 필요한 SDK를 설치합니다. Xcode는 macOS 이외의 운영체제에는 설치할 수 없으므로 masOS 운영체제를 사용할 수 있는 장비가 필요합니다.

본문에서는 Xcode(Build 11N132i), iOS SDK(13.4), OS X SDK(10.15) 버전을 사용했습니다.

설치파일은 Mac App Store에서 내려받을 수 있습니다.

15.2App Builder 설치

App Builder는 WAR(Web application ARchive) 파일로 제공됩니다. 제공된 WAR 파일(appbuilder.war)을 각 WAS 환경에 따라 배포합니다.

본문에서는 Tomcat 7 버전을 사용했습니다. 해당 버전 기준으로 설명합니다.

1

WAR 파일 배포

[webapps] 폴더에 appbuilder.war 파일을 복사해놓고 Tomcat 서버를 시작합니다. webapps 경로에 appbuilder 폴더가 생성된 것을 확인하고 Tomcat 서버를 중지합니다.

2

관리 콘솔 설정

[webapps\appbuilder\nexacro_ui] 폴더에서 environment.xml.js 파일을 텍스트 편집기로 열고 "HOST:PORT"로 표기된 부분을 사용할 URL로 수정합니다.

nexacro._addService("svcUrl", "JSP", "http://HOST:PORT/appbuilder", "none", null, "", "0", "0");
nexacro._addService("svcUrl", "JSP", "http://127.0.0.1:8080/appbuilder", "none", null, "", "0", "0");

3

H2 Database 시작

[webapps/appbuilder/WEB-INF/package/h2/bin] 폴더에서 runH2DB 배치 파일을 실행하면 H2 Database가 시작되고 관리 콘솔이 표시됩니다. 관리 콘솔창은 사용하지 않습니다. 열린 웹브라우저 창을 닫습니다.

H2 Database를 처음 시작했을 때 해당 폴더에 필요한 파일을 생성하는데 윈도우 운영체제를 사용하는 경우에는 Tomcat 설치 경로에 따라 관리자 권한이 없으면 오류가 발생하는 경우가 있습니다. 오류가 발생하는 경우에는 관리자 권한으로 배치 파일을 실행해야 합니다.

4

인코딩 설정

일부 환경에서 한국어가 정상적으로 표기되지 않을 수 있습니다. 그런 경우에는 인코딩 설정을 추가합니다. [bin] 폴더 아래 catalina.bat 파일을 열어 아래와 같이 수정합니다.

set "JAVA_OPTS=%JAVA_OPTS% %LOGGING_CONFIG% -Dfile.encoding=UTF8"

Tomcat 버전에 따라 catalina.bat 파일을 사용하지 않는 경우가 있습니다. 그런 경우에는 [bin] 폴더 아래에서 실행파일인 Tomcat7w.exe을 실행하면 Tomcat 속성을 설정할 수 있는 창이 나타납니다. 해당 창에서 [Java > Java Options] 항목에 "-Dfile.encoding=UTF8" 항목을 추가합니다.

5

서버 시작

[webapps] 폴더에 복사해놓은 appbuilder.war 파일을 삭제하고 Tomcat 서버를 다시 시작합니다.

6

관리 콘솔 접근

웹브라우저를 열어 아래 URL을 입력 후 관리 콘솔에 접근할 수 있는지 확인합니다. 입력할 URL은 pbuilder_ui.xadl.js 파일에서 수정한 URL입니다.

http://xxx.xxx.xxx.xxx:8080/appbuilder