3.설치

Edit

3.1시스템 요구사항

Nex-UP 서버 설치를 위한 시스템 요구사항은 다음과 같습니다.

name

description

OS

Windows, Unix, Linux (Nex-UP Editor의 경우 Windows만 지원)

JVM

JAVA 1.6+ 지원

WAS

JAVA 1.6+ 지원하는 WAS는 기본적으로 지원

Apache Tomcat, IBM Websphere, Oracle WebLogic, TmaxSoft JEUS

Database

SQLServer 2000, 2005, 2008, ORACLE 8i, 9i, 10g, 11g, MySQL 5.0

3.2Nex-UP 설치

3.2.1Nex-UP 서버 설치

1

Nex-UP 서버를 만들기 위한 WAS를 설치합니다.

테스트에서는 apache-tomcat-7.0.79 을 사용했습니다.

2

다운로드 받은 apache-tomcat-7.0.79.zip 파일은 C: 드라이브 아래 C:/apache-tomact-7.0.79 경로에 압축을 풉니다.

3

nexup-distribution-1.0.0-bin.zip 파일 내에 있는 nexup.war 파일을 C:/apache-tomcat-7.0.79/webapps 경로에 복사합니다.

4

Tomcat을 재시작하면 webapps 폴더 아래 nexup 폴더가 생성됩니다.

5

서버 라이선스를 등록합니다.

서버 라이선스 등록 방법은 아래 라이선스 등록을 참조하세요.

3.2.2Nex-UP Editor 설치

1

Nex-UP 서버가 설치 된 WAS를 구동합니다.

2

Internet Explorer에서 서버 url를 입력합니다.

http://localhost:8080/nexup

3

아래와 같이 Nex-UP Editor 설치 화면이 로드되고, 설치를 시작합니다.

4

설치가 완료된 후 바탕화면에 Nex-UP Editor 아이콘이 생성됩니다. 아이콘을 더블클릭합니다.

5

Nex-UP 서버가 설치된 url을 입력 합니다.

3.3라이선스 등록

Nex-UP 기능을 정상적으로 사용하기 위해서는 라이선스를 등록해야 합니다. Tomcat, Weblogic등 WAS 위에 설치된 Nex-UP 서버의 라이선스 적용에 관해 설명합니다.

아래와 같이 두가지 라이선스를 등록합니다.

3.3.1Nex-UP 라이선스 등록

1

WAS에 Nex-UP을 설치합니다.

2

제품구매 시 발급받은 라이선스 파일(Nex-UP_License.xml)을 nexup/WEB-INF/classes 폴더에 복사합니다.

3

WAS를 재기동합니다.

3.4환경 설정

Nex-UP 서버를 설정하기 위해서 여러 가지 환경설정 파일을 제공합니다. Nex-UP 서버를 설치했다는 가정하에 환경설정 관련 파일에 대한 설명입니다.

WAS 설치 경로에서 [webapps > nexup > WEB-INF > classes > conf] 경로로 가면 아래 그림과 같이 여러 환경 설정 파일이 존재합니다.

Name

Description

config.properties

Nex-UP 서버의 환경 설정에 대한 정보를 가진 파일입니다.

jdbcs.properties

Nex-UP 서버에서 구동되는 DBMS 데이터소스 설정에 대한 정보를 가진 파일입니다.

3.4.1config.properties (환경설정)

config.properties 파일에서 Nex-UP 서버에 대한 아래와 같은 환경설정 정보를 가지고 있습니다.

운영환경에서 반드시 설정해야 하는 항목은 다음과 같습니다.


bean.sqlSessionFactory.refreshable=false 설정

bean.exceptionResolver.shouldSendStackTrace=false 설정

session 설정

표 3-1component 설정

Name

Type

Description

component.serviceManager.servicePath

String

Nex-UP 서비스 파일이 위치하는 디렉토리 입니다.

표 3-2mybatis

Name

Type

Description

bean.sqlSessionFactory.refreshable

Boolean

mybatis의 실행 파일 갱신 여부입니다. 운영환경에서는 false로 설정하여 사용합니다.

bean.sqlSessionFactory.serviceLocation

String

mybatis의 실행 파일이 위치하는 디렉토리 설정입니다. 해당 위치에 있는 mapper 파일은 'bean.sqlSessionFactory.refreshable' 설정에 따라 갱신 됩니다.

bean.sqlSessionFactory.serviceTestLocation

String

서비스 테스트를 위한 mybatis 실행 파일이 위치하는 디렉토리 설정입니다.

표 3-3exception

Name

Type

Description

bean.exceptionResolver.shouldLogStackTrace

Boolean

예외가 발생했을 경우에 예외 정보를 로깅할지에 대한 설정입니다.

bean.exceptionResolver.shouldSendStackTrace

Boolean

예외가 발생했을때 예외의 정보를 응답으로 전송할지에 대한 설정입니다. 예외의 실제 메시지를 응답으로 전송할 경우 보안상의 문제가 있을 수 있습니다. 반드시 운영시에는 false로 설정합니다.

표 3-4session (authentication)

Name

Type

Description

bean.sessionHandler.useSession

Boolean

세션 처리를 수행 할지에 대한 설정입니다. 개발 편의상 사용하지 않을수는 있으나, 가능한 한 반드시 사용합니다.

bean.sessionHandler.sessionName

String

세션에 저장되는 객체의 이름입니다.

bean.sessionHandler.login

String

로그인을 수행할 가상의 서비스 이름입니다. 해당 이름은 넥사크로 플랫폼에서 addService(' ')에 사용되는 서비스 명칭입니다.

로그인이 성공적으로 수행되게 되면 세션 정보를 생성합니다.

bean.sessionHandler.loginSuccessCondition

String

인증 처리를 위한 조건을 설정합니다. mybatis에서의 dynamic query에서 사용하는 조건과 동일하게 설정할 수 있습니다.

(예 : #{dsAuthenticated.id} != null)

해당 조건에서 사용되는 데이터는 addService('login') 이전에 addService 된 서비스들의 데이터를 사용하여 조건을 설정합니다.

bean.sessionHandler.loginErrorCode

Integer

로그인이 실패하였을 경우 응답으로 전송할 에러 코드를 설정합니다.

bean.sessionHandler.loginErrorMsg

String

로그인이 실패하였을 경우 응답으로 전송할 에러 메시지를 설정합니다.

bean.sessionHandler.logout

String

로그아웃을 수행할 가상의 서비스 이름입니다. 로그아웃을 하고난 뒤 세션 정보를 파기 합니다.

bean.sessionHandler.includePatterns

String

인증이 필요한 서비스의 패턴을 설정합니다. 복수개를 지정하는 경우 콤마(,)를 기준으로 설정합니다. (예 : account.*,sales.* 혹은 **.* 을 설정하여 모든 서비스를 대상으로 지정할 수 있습니다.) 가능한 **.*를 설정하여 모든 서비스가 인증이 필요하도록 합니다.

bean.sessionHandler.excludePatterns

String

인증이 필요하지 않은 서비스의 패턴을 설정합니다. 'includePatterns' 보다 우선시 하여 처리 됩니다.

3.4.2jdbcs.properties (데이터소스 설정)

jdbcs.properties 파일에서 Nex-UP 서버의 아래와 같은 DBMS 데이터소스 설정 정보를 가지고 있습니다.

Name

Type

Description

jdbc.driverClassName

String

드라이버 이름입니다. 로깅을 위해 'log4jdbc'에서 제공하는 'net.sf.log4jdbc.DriverSpy'를 사용합니다.

jdbc.url

String

connection url 입니다. (예 : jdbc:oracle:thin:@127.0.0.1:1521:dbms)

jdbc.username

String

접속할 계정 정보입니다.

jdbc.password

String

접속할 계정의 패스워드 정보입니다.

log4jdbc의 DriverSpy가 지원하는 Driver 목록은 아래와 같습니다.


oracle.jdbc.driver.OracleDriver

com.sybase.jdbc2.jdbc.SybDriver

net.sourceforge.jtds.jdbc.Driver

com.microsoft.jdbc.sqlserver.SQLServerDriver

com.microsoft.sqlserver.jdbc.SQLServerDriver

weblogic.jdbc.sqlserver.SQLServerDriver

com.informix.jdbc.IfxDriver

org.apache.derby.jdbc.ClientDriver

org.apache.derby.jdbc.EmbeddedDriver

com.mysql.jdbc.Driver

org.postgresql.Driver

org.hsqldb.jdbcDriver

org.h2.Driver


그 외 드라이버의 경우 시스템 프로퍼티(-D옵션) 설정을 통해 처리가능합니다.

log4jdbc.drivers=xxxDriver (,로 구분하여 명시)