App Builder 설치 전 필요한 작업

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

App Builder 설치 공통

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

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

Android

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

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

iOS, macOS

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

본문에서는 Xcode(Build 15C500b), iOS SDK(17.2), OS X SDK(14.2) 버전을 사용했습니다.

App Builder 설치

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

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

WAR 파일 배포

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

관리 콘솔 설정

[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");

H2 Database 시작

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

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

인코딩 설정

일부 환경에서 한국어가 정상적으로 표기되지 않을 수 있습니다. 그런 경우에는 인코딩 설정을 추가합니다. [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" 항목을 추가합니다.

서버 시작

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

관리 콘솔 접근

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

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