시스템 요구사항
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 |
Nex-UP 설치
Nex-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
서버 라이선스를 등록합니다.
서버 라이선스 등록 방법은 아래 라이선스 등록을 참조하세요.
Nex-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을 입력 합니다.
라이선스 등록
Nex-UP 기능을 정상적으로 사용하기 위해서는 라이선스를 등록해야 합니다. Tomcat, Weblogic등 WAS 위에 설치된 Nex-UP 서버의 라이선스 적용에 관해 설명합니다.
아래와 같이 두가지 라이선스를 등록합니다.
Nex-UP 서버 라이선스
Nex-UP Editor 라이선스
Nex-UP 라이선스 등록
1
WAS에 Nex-UP을 설치합니다.
2
제품구매 시 발급받은 라이선스 파일(Nex-UP_License.xml)을 nexup/WEB-INF/classes 폴더에 복사합니다.
3
WAS를 재기동합니다.
환경 설정
Nex-UP 서버를 설정하기 위해서 여러 가지 환경설정 파일을 제공합니다. Nex-UP 서버를 설치했다는 가정하에 환경설정 관련 파일에 대한 설명입니다.
WAS 설치 경로에서 [webapps > nexup > WEB-INF > classes > conf] 경로로 가면 아래 그림과 같이 여러 환경 설정 파일이 존재합니다.
Name | Description |
|---|---|
config.properties | Nex-UP 서버의 환경 설정에 대한 정보를 가진 파일입니다. |
jdbcs.properties | Nex-UP 서버에서 구동되는 DBMS 데이터소스 설정에 대한 정보를 가진 파일입니다. |
config.properties (환경설정)
config.properties 파일에서 Nex-UP 서버에 대한 아래와 같은 환경설정 정보를 가지고 있습니다.
운영환경에서 반드시 설정해야 하는 항목은 다음과 같습니다.
bean.sqlSessionFactory.refreshable=false 설정
bean.exceptionResolver.shouldSendStackTrace=false 설정
session 설정
Name | Type | Description |
|---|---|---|
component.serviceManager.servicePath | String | Nex-UP 서비스 파일이 위치하는 디렉토리 입니다. |
Name | Type | Description |
|---|---|---|
bean.sqlSessionFactory.refreshable | Boolean | mybatis의 실행 파일 갱신 여부입니다. 운영환경에서는 false로 설정하여 사용합니다. |
bean.sqlSessionFactory.serviceLocation | String | mybatis의 실행 파일이 위치하는 디렉토리 설정입니다. 해당 위치에 있는 mapper 파일은 'bean.sqlSessionFactory.refreshable' 설정에 따라 갱신 됩니다. |
bean.sqlSessionFactory.serviceTestLocation | String | 서비스 테스트를 위한 mybatis 실행 파일이 위치하는 디렉토리 설정입니다. |
Name | Type | Description |
|---|---|---|
bean.exceptionResolver.shouldLogStackTrace | Boolean | 예외가 발생했을 경우에 예외 정보를 로깅할지에 대한 설정입니다. |
bean.exceptionResolver.shouldSendStackTrace | Boolean | 예외가 발생했을때 예외의 정보를 응답으로 전송할지에 대한 설정입니다. 예외의 실제 메시지를 응답으로 전송할 경우 보안상의 문제가 있을 수 있습니다. 반드시 운영시에는 false로 설정합니다. |
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' 보다 우선시 하여 처리 됩니다. |
jdbcs.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 (,로 구분하여 명시)