테스트 서버 환경 설정

넥사크로플랫폼 애플리케이션을 웹브라우저에서 직접 실행하기 위해서는 실행 환경을 만들어주어야 합니다. 넥사크로 스튜디오에서 Windows Runtime으로 테스트해볼 수 있지만 다양한 웹브라우저에서 실제 동작하는 내용을 점검해보고 싶다면 각 개발환경에서 별도의 실행 환경을 만들어주어야 합니다.

넥사크로플랫폼 애플리케이션이 동작하기 위해서는 웹서버만 설치해도 무관하지만, 데이터 트랜잭션까지 테스트해보고자 한다면 웹 애플리케이션 서버(WAS, Web Application Server)를 설정해야 합니다. 아래에서는 간단한 테스트를 위해 경량 웹서버인 몽구스(mongoose)를 사용하는 방법과 WAS 설치를 위한 JDK 설치와 아파치 톰캣 설정에 대해 설명합니다.

몽구스와 아파치 톰캣은 아래와 같은 차이가 있습니다. 사용하려는 목적에 맞게 선택하세요.


mongoose

Apache Tomcat

설치파일

없음

(별도 설치 파일 없이 실행파일만 제공되며 더블클릭으로 바로 실행)

설치 파일 제공

(바이너리 소스로 받아서 직접 배치 파일을 실행시킬 수도 있음)

JDK 설치

필요 없음

JDK 설치 후 사용 가능

Context 설정

없음

(실행파일이 실행되는 폴더가 웹서버 root로 지정)

정해진 절차에 따라 컨텍스트를 추가하거나 war 파일을 디플로이해서 컨텍스트 생성

X-API 지원

사용할 수 없음

사용 가능

(별도 설정)

엑스플랫폼

9.2

사용할 수 없음

(9.2는 JSP 환경을 지원해야 함)

사용 가능

이번 장에서 설명하는 각 서비스에 대한 문제나 세부적인 사용 방법은 해당 제품 프로젝트 사이트를 참조하세요.

경량 웹서버 사용하기

몽구스(mongoose)

넥사크로플랫폼 애플리케이션을 PC에서 간단하게 테스트해보기 위해 경량 웹서버인 몽구스를 사용합니다. 몽구스는 별도의 설치 과정 없이 웹서버 root로 동작할 위치에 실행 파일을 복사해서 실행하기만 하면 됩니다.

내려받기

아래 사이트에서 시스템 환경에 맞는 실행파일을 내려받을 수 있습니다. 윈도우 사용자라면 exe 확장자를 가진 파일을 내려받으면 됩니다.

https://code.google.com/p/mongoose/

내려 받은 파일을 넥사크로 스튜디오에서 지정한 Generate Path에 가져다 놓습니다. 넥사크로 스튜디오에서 Options > Generate Path를 지정해주면 애플리케이션 자바스크립트 코드가 지정된 폴더에 생성됩니다.

이번 장에서는 mongoose-3.7.exe 파일을 내려 받아 사용했습니다. 해당 프로젝트 업데이트에 따라 일부 내용이 변경될 수 있습니다.

라이선스 정책 변경으로 mongoose 5.0 이상 버전은 비상업적인 사용자만 무료로 제공됩니다.

테스트용으로 사용할 수 있는 이전 버전 실행 파일은 아래 링크에서 내려 받을 수 있습니다.

https://code.google.com/p/mongoose/downloads/list?can=4

웹서버 실행

몽구스 실행 파일을 더블클릭해 실행해줍니다. 더블클릭하는 순간 몽구스 웹서버가 실행되고 아래와 같이 하단 윈도우 트레이 영역에 아이콘이 추가됩니다.

오른쪽 마우스를 클릭해 컨텍스트 메뉴를 열면 설정할 수 있는 메뉴가 보입니다. 이번 장에서는 바로 웹브라우저에서 확인할 수 있는 'Start browser'와 웹서버 종료 시 사용하는 'Exit' 항목만 설명합니다. 기타 세부적인 설명은 몽구스 프로젝트 사이트의 설명을 참조하세요.

'Start browser'를 선택하면 기본으로 설정된 웹브라우저가 실행되며 몽구스 실행 파일을 복사해놓은 곳이 웹서버의 root가 되어 사용할 수 있는 디렉터리의 목록이 표시됩니다.

사용하는 몽구스 버전에 따라 디렉터리 목록 표시가 제한될 수 있습니다.

넥사크로플랫폼 애플리케이션 확인

생성된 프로젝트 디렉터리(Hello)을 클릭하면 생성된 넥사크로플랫폼 애플리케이션을 확인할 수 있습니다.

넥사크로 스튜디오에서 웹브라우저로 바로 애플리케이션을 실행하려면 빌드 툴바에서 웹브라우저를 선택하고 URL을 아래와 같이 입력해줍니다.

윈도우 트레이 영역에서 'Exit' 항목을 선택해주면 웹서버가 종료됩니다.

웹 애플리케이션 서버 사용하기

JDK(Java SE Development Kit)

웹 애플리케이션 서버는 톰캣(Tomcat)이나 제티(Jetty), 윈스턴(Winstone)과 같이 무료로 공개된 것을 사용하거나 상용 제품을 사용할 수 있습니다. 여기에서는 간단하게 사용할 수 있는 톰캣을 설치하는 기준으로 설명하겠습니다.

톰캣은 자바 기반으로 만들어졌기 때문에 실행하기 위해서는 JDK(Java SE Development Kit) 환경이 설정되어 있어야 합니다. JDK는 무료로 제공되고 있으며 간단하게 설치할 수 있습니다.

내려 받기

아래 사이트에서 시스템 환경에 맞는 JDK를 내려받을 수 있습니다.

http://www.oracle.com/technetwork/java/javase/downloads/index.html

이번 장에서는 jdk-7u17-windows-i586.exe (version 1.7.0_17) 파일을 내려 받아 사용했습니다. JDK 버전이 다른 경우 설치 및 설정 내용이 다를 수 있습니다.

JDK나 톰캣 설치 파일은 윈도우 운영체제를 사용하는 경우 32비트와 64비트 설치 파일을 제공합니다. 운영체제 버전 확인은 아래 링크를 참고하세요.

http://support.microsoft.com/kb/958406/ko

설치 확인

내려받은 설치파일을 실행하면 자동으로 필요한 환경설정과 설치과정을 진행합니다. 설치가 완료되면 커멘드창에서 정상적으로 설치되었는지 확인합니다.

java -version

JDK 1.5 이상 버전을 설치하는 경우에는 실행에 필요한 환경 변수(JAVA_HOME)를 따로 설정해주지 않아도 시스템 경로에 자동으로 실행 파일을 복사해 접근할 수 있습니다.

아파치 톰캣(Apache Tomcat)

넥사크로플랫폼 애플리케이션을 웹브라우저에서 동작하게 하려면 웹서버 환경을 만들어주어야 합니다. 아파치 톰캣은 간단한 설치만으로 이런 환경을 만들 수 있습니다.

내려받기

아래 사이트에서 실행 환경에 맞는 톰캣을 내려받을 수 있습니다.

http://tomcat.apache.org

톰캣은 압축된 바이너리 파일을 내려받아 직접 실행하거나 별도로 제공되는 인스톨 파일을 사용할 수 있습니다. 여기에서는 인스톨 파일로 설치하도록 하겠습니다.

내려받은 파일을 실행하게 되면 설치 마법사가 필요한 설정 과정을 진행하며 JRE 경로도 자동으로 인식해 처리해줍니다.

이번 장에서는 apache-tomcat-7.0.39.exe 파일을 내려 받아 사용했습니다. 해당 프로젝트 업데이트에 따라 일부 내용이 변경될 수 있습니다.

설치 확인

설치가 완료되면 윈도우 서비스로 등록되면서 자동으로 서버를 실행시켜줍니다. 윈도우 하단 트레이에서 오른쪽 마우스를 클릭해 컨텍스트 메뉴를 확인하면 서비스 상태 정보를 확인하거나 다른 설정을 할 수 있습니다.

웹브라우저에서 로컬 주소에 설정된 URL값을 입력해 정상 설치 여부를 확인합니다.

http://127.0.0.1:8080

컨텍스트 설정

톰캣에서 애플리케이션을 실행하기 위해서는 컨텍스트를 추가해주어야 합니다. 컨텍스트를 추가하는 방법은 몇 가지가 있지만 이번 장에서는 webapps 폴더 아래에 설정하는 방법과 임의의 폴더에 설정하는 방법을 살펴보겠습니다.

새로운 파일을 추가하거나 수정하기 위해 운영체제 설정에 따라 관리자 권한이 필요합니다. webapps 설정에서는 넥사크로 스튜디오가 관리자 권한으로 실행되지 않았다면 애플리케이션 파일이 생성되지 않을 수 있습니다.

webapps 설정

톰캣이 설치된 폴더 아래에 webapps 폴더가 있습니다. 다른 설정 없이 설치했다면 아래와 같은 경로에 설정됩니다. 기본적으로 docs, manger, ROOT 폴더가 설정되어 있습니다.

C:\Program Files\Apache Software Foundation\Tomcat 7.0\webapps\

파일 탐색기에서 webapps 폴더 아래 원하는 이름으로 새로운 폴더를 추가합니다. 그리고 그 아래에 WEB-INF라는 이름으로 폴더를 추가합니다.

WEB-INF 폴더 아래에는 web.xml파일이 있어야 합니다. web.xml파일은 아래와 같이 생성합니다.

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
  http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
  version="3.0"
  metadata-complete="true">
</web-app>

넥사크로 스튜디오에서 Options > Generate Path를 지정해주면 애플리케이션 자바스크립트 코드가 지정된 폴더에 생성됩니다.

외부 컨텍스트 추가

webapps 설정 방식은 지정된 경로만을 사용해야 하는 제약이 있습니다. 예를 들어 윈도우 D 드라이브에 지정된 폴더를 사용하고 싶다면 외부 컨텍스트 추가 방식을 사용합니다.

톰캣이 설치된 경로 아래에 지정된 폴더에 XML 파일로 만든 애플리케이션 컨텍스트 파일을 추가해줍니다.

C:\Program Files\Apache Software Foundation\Tomcat 7.0\conf\Catalina\localhost

원하는 컨텍스트명으로 xml 파일 아래와 같이 생성합니다.

<Context path="/Hello" docBase="D:\03_TEST\XP\BUILD\Hello"
  debug="0" prvileged="true" reloadable="true">
  <Logger className="org.apache.catalina.logger.FileLogger"
    directory="logs" prefix="localhost_log." suffix=".txt"
    timestame="true"/>
</Context>

넥사크로플랫폼 애플리케이션 확인

생성된 경로를 웹브라우저에 입력해주면 넥사크로플랫폼 애플리케이션을 확인할 수 있습니다.

넥사크로 스튜디오에서 웹브라우저로 바로 애플리케이션을 실행하려면 빌드 툴바에서 웹브라우저를 선택하고 URL을 아래와 같이 입력해줍니다.

윈도우 트레이 영역에서 'Exit' 항목을 선택해주면 톰캣 서비스가 종료됩니다.