Glue Master – 설치 가이드

설치 가이드

  ■ SqlDeveloper , Toad 등의 tool을 이용하여 script 파일 안의 내용을 직접 복사하여 실행하는 것을 권장한다

  ■ OS나 DB의 설정의 차이에 의해 DB setup 후 입력한 다국어가 바르게 표시되지 않을 수 있다.

  ■ Linux/Unix 계열에서 실행할 경우 script file의 EOL을 UNIX형으로 변환해야 한다.

2. DB Setup(Oracle script)

DDL,DML Script 를 이용한 DB 구성

  ■ DB 정보 :  Database 10g Enterprise Edition Release 10.2.0.1.0
   
  ■ Script file 이름 : GlueMaster_Oracle.sql
  
  ■ Data Script file 이름 : GlueMaster_Data.sql
  
  ■ 테이블 스페이스 : ts_gluemaster 사용권장 (변경가능)
  
  ■ 사용자 계정 : gluemast

사용자 생성 및 권한 부여

  ■ sqlplus / as sysdba
  
  ■ create user gluemast identified by gluemast default tablespace ts_gluemaster quota unlimited on ts_gluemaster;
  
  ■ grant create table, create view, create session, create sequence, connect, resource to gluemast;
  
  ■ exit

실행명령어 : 콘솔에서 sqlplus 실행 후 script file 실행

  ■ sqlplus gluemast/gluemast@orcl
  
  ■ @GlueMaster_Oracle.sql
  
  ■ @GlueMaster_Data.sql
  
  ■ exit

기타

사용자 삭제

  ■ drop user gluemast cascade;
  
  ■ exit

Dump 파일 이용 방법

  1. Dump 파일 생성 Export : 테이블스페이스(users)
        exp system/manager owner=gluemast file=GlueMaster.dmp statistics=none

  2. Dump 파일을 이용한 Import :콘솔에서 Admin 계정으로 실행
        imp userid=system/manager file=GlueMaster.dmp fromuser=gluemast touser=gluemast

3. DB Setup(DB2 script)

DDL,DML Script 를 이용한 DB 구성 : CLP보다는 DB GUI나 tool 사용을 권장.

  ■ DB 정보 : IBM DB2 Universal
  
  ■ Script file 이름 : GlueMaster_DB2.sql
  
  ■ Data Script file 이름 : GlueMaster_Data.sql

사용자 생성 및 권한 부여

  ■ OS별로 gluemast user를 생성한다. (OS user = DB user)
  
  ■ 사용하고자 하는 TABLESPACE 와 DATABASE 에 권한을 부여한다.(DB2 site 참조)
  
  ■ > db2 "create tablespace ts_gmaster managed by system using ('(디렉토리명)')"
  
  ■ > db2 "create db GMASTER using CODESET UTF-8 TERRITORY KR"
  
  ■ > db2 "activate db GMASTER "
  
  ■ > db2 "GRANT USE OF TABLESPACE GMASTER  TO USER gluemast"

실행명령어 : 콘솔에서 sqlplus 실행 후 script file 실행

  ■ > db2 Connect to GMASTER  user gluemast using gluemast
  
  ■ > db2 -vf GlueMaster_DB2.sql -t
  
  ■ > db2 -vf GlueMaster_Data.sql -t

주의 : Linux/Unix 계열에서 실행할 경우 script file의 EOL을 UNIX형으로 변환해야 함.

기타

사용자 삭제

  ■ drop user gluemast cascade;
  
  ■ exit

Dump 파일 이용 방법

  1. Dump 파일 생성 Export : 테이블스페이스(USERS)
        exp system/manager owner=gluemast file=GlueMaster.dmp statistics=none

  2. Dump 파일을 이용한 Import :콘솔에서 Admin 계정으로 실행
        imp userid=system/manager file=GlueMaster.dmp fromuser=gluemast touser=gluemast

4. WAS Setup (Tomcat)

Tomcat 설치

Tomcat

  ■ http://tomcat.apache.org
  
  ■ Download >> Core >> apache-tomcat-7.0.x.zip

  ※ GlueMaster ver.1.3.4 부터 Java는 1.6 이상이어야 하므로 Tomcat 7.0 이상을 설치한다.

주요 경로

  ■ WAS_INSTALL_ROOT : D:\apache-tomcat-7.0.x
  
  ■ Binaries         : WAS_INSTALL_ROOT\bin
  
  ■ Configurations   : WAS_INSTALL_ROOT\conf
  
  ■ Web Application deploy root : WAS_INSTALL_ROOT\webapps

옵션 추가

catalina.bat 수정 (JAVA 옵션)

WAS_INSTALL_ROOT \bin

  ■ 추가 옵션
      - 메모리 사이즈 조정 옵션 추가
      - CONFIG_PATH : GlueMaster.properties 파일 위치 지정 옵션 추가
       
       set JAVA_OPTS=%JAVA_OPTS%
        -server -Xms512m -Xmx1024m 
        -DCONFIG_PATH=“WAS_INSTALL_ROOT /gluemaster"

  ※ 한 줄로 표현되며, 리눅스(유닉스) 등은 set 대신에 export를 사용하므로 
      tomcat site 참고 한다.

server.xml 수정 (encoding set 옵션)

    <Connector port=“xxx" protocol=“xxx"
               connectionTimeout=“xxx"
               redirectPort=“xxx"  URIEncoding="UTF-8"/>

기타 (리눅스일경우)

    Catalina.sh 파일에서 JAVA 옵션을 추가한다. 
    export JAVA_OPTS="$JAVA_OPTS -DCONFIG_PATH=\"/apache-tomcat-7.0.12\""

    How do I set system properties at startup? 
    Set JAVA_OPTS to be something BEFORE calling startup.bat or before calling catalina.bat.
        (or you can edit those files, but it isn't advised) 
    Example (windows): SET JAVA_OPTS='-DpropName=propValue'
    Example (UNIX): export JAVA_OPTS='-DpropName=propValue'

JNDI 설정

context.xml, server.xml 수정

WAS_INSTALL_ROOT\conf

  ■ server.xml에 Resource 추가
   
  ■ context.xml 에 ResourceLink 추가
  
  ※ GlueMaster.properties 참고.

그림 : server.xml에 Resource 추가

    <Resource
        name="jdbc/oracle/GlueMaster"
        type="javax.sql.DataSource"
        driverClassName="oracle.jdbc.driver.OracleDriver"
        maxIdle="2"
        maxActive="4"
        maxWait="5000"
        username="gluemast"
        password="gluemast"
        url="jdbc:oracle:thin:@127.0.0.1:1521:ORCL"
    />

그림 : context.xml 에 ResourceLink 추가

    <ResourceLink 
        global="jdbc/oracle/GlueMaster" 
        name="jdbc/oracle/GlueMaster" 
        type="javax.sql.DataSource"
    />

Web Application Copy

GlueMaster.war 추가

WAS_INSTALL_ROOT\webapps

그림 : Web Application Copy

5. WAS Setup (WebLogic)

WebLogic 설치

  ■ WebLogic 버전 : WebLogic Server 10.3.5.0
  
  ■ JVM : java version "1.6.0_24"
  
  ■ 주요 경로
      - WAS_INSTALL_ROOT : D:\Oracle\Middleware\user_projects\domains
      - WAS_INSTALL_ROOT\base_domain\bin
      - WAS_INSTALL_ROOT\gluemaster
      - WAS_INSTALL_ROOT\APP
      - WAS_INSTALL_ROOT\APP\ROOT

옵션 추가

setDomainEnv.cmd 수정 (JAVA 옵션)

WAS_INSTALL_ROOT\base_domain\bin

  ■ 추가 옵션
      - 메모리 사이즈 조정 옵션 추가
      - CONFIG_PATH : GlueMaster.properties 파일 위치 지정 옵션 추가
       
       set JAVA_OPTIONS=%JAVA_OPTIONS% 
          -DCONFIG_PATH="D:/Oracle/Middleware/user_projects/domains/gluemaster" 

  ※ 한 줄로 표현되며, oracle weblogic admin guide를 참고한다.

weblogic.xml 수정 (encoding 옵션)

    <wls:charset-params>
        <wls:input-charset>
            <wls:resource-path>xxx</wls:resource-path>
            <wls:java-charset-name>UTF-8</wls:java-charset-name>
        </wls:input-charset>
    </wls:charset-params>

JNDI 설정

WebLogic Console 이용

http:\hostname:port\console

■ JNDI 등록 : jdbc/oracle/GlueMaster

그림 : JNDI 설정

Web Application Deploy

WebLogic Console 이용

http:\hostname:port\console

    ■ Web Resource Appliction (ROOT)

    ■ GlueMaster Web Application (GlueMaster.war)

그림 : Web Application Deploy

6. WAS Setup (WebSphere)

WebSphere 설치

  ■ WebSphere 버전 : IBM WebSphere Application Server 7.0.0.21
  
  ■ JVM : java version "1.6.0_24"
  
  ■ 주요 경로
      - Product Directory :/opt/IBM/WebSphere/AppServer
      - DTD Directory     :/opt/IBM/WebSphere/AppServer/properties/version/dtd
      - Log Directory     :/opt/IBM/WebSphere/AppServer/logs

Property 설정

WebSphere Admin console 이용

■ https://hostname:port/ibm/console/logon.jsp

JAVA 옵션

- 설정경로

 Servers -> WebSphere application servers -> Server Name Link -> Configuration ->
 Server Infrastructure -> Java and Process Management -> Process Definition ->
 Additional Properties -> Java Virtual Machine -> Generic JVM arguments

- CONFIG_PATH : GlueMaster.properties 파일 위치 지정 옵션 추가

 -DCONFIG_PATH= /opt/IBM/WebSphere/AppServer/gluemaster

Encoding set 옵션

- 설정경로

 Servers -> WebSphere application servers -> Server Name Link -> Configuration ->
 Server Infrastructure -> Java and Process Management -> Process Definition ->
 Additional Properties -> Java Virtual Machine -> Custom properties

 - file.encoding : UTF-8
    
 - client.encoding.override : UTF-8

JNDI 설정

■ 설정 경로

  - Resources -> JDBC -> Data Sources -> DB2 Universal Driver Datasource
  
  - DataSource가 없을 경우 추가한다.
    Jdbc/GlueMaster 로 설정.

Web Application Deploy

WebSphere Console 이용

  ■ GlueMaster Web Application (GlueMaster.war)
  
  ■ Deploy 실행 경로 : Applications -> Application Types -> WebSphere enterprise applications -> Install
  
  ■ Fast Path로 선택하여 deploy.
  
  ■ Context Root 입력 : GlueMaster

그림 : Web Application Deploy

7. WAS Setup (공통)

property 파일 추가

■ GlueMaster.properties 추가
경로 : WAS_INSTALL_ROOT/gluemaster
(※ JAVA옵션 [CONFIG_PATH]에 파일 경로에 지정한 경로와 동일 해야 함.)

■ glue.properties 추가 (빈 파일 생성하기)

※ 각 property의 자세한 설명은 별첨 참고.

그림 : property의 추가

property 파일 설정 예 1

그림 : property 파일 설정 예 1

property 파일 설정 예2

그림 : property 파일 설정 예2

8. Library 설치

Glue Master WAR에 포함되지 않는 library 파일 설치

WAS에서 지정한 classpath 경로에 아래 파일을 배치 한다.

■ jxl-2.6.12.jar : Excel export, import 사용
(http://jexcelapi.sourceforge.net/)

■ servlet-api.jar (optional) : servlet 호출 시 사용
(WAS에 기본 설치되어 있으나 없는 제품의 경우 타 WAS 참조.)

■ JDBC driver (ojdbc, db2jcc_xxx.jar 등 ) : DB 연결 시 사용
(DB vendor 에서 제공받음 )

9. 별첨(accompanying)

제공 파일

■ DB별 schema 생성 script : GlueMaster_XXX.sql

■ 초기 데이터 script : GlueMaster_Data.sql

■ Glue Master 실행 파일 : GlueMaster.war (v2.0.0)

■ Glue Master 환경 파일 : GlueMaster.properties

GlueMaster.properties

기본 properties

Property	설명	Value 또는 사용 예
manager/access.querypath	Query File Path 정보 설정	DB에 따라 ORACLE : query/oracle DB2 : query/db2 mySQL : query/mysql
access.rmi.registryPort	Access RMI Port 설정	1099
manager.ismain	원장 여부	true-원장, false-원장 아님
manager.ismasterhistory	마스터 이력 여부	true-이력 사용함 false-이력 사용 안함(Default)

JNDI를 사용시 관련 properties

Property	설명	Value 또는 사용 예
manager.datasource.name	Manager Data Source Name	managerJndiDS(수정불가)
access.datasource.name	Access Data Source Name	accessJndiDS(수정불가)
manager/access .datasource.jndiname	Manager/access Data Source JNDI name	WAS에 설정된 JNDI name. false-이력 사용 안함(Default)\| 예) java:comp/env/jdbc/oracle/ GlueMaster jdbc/gluemasterDs Tomcat의 경우 JNDI 사용시 [java:comp/env/]가 추가됨.

JDBC driver 사용시 관련 properties

Property	설명	Value 또는 사용 예
manager.datasource.name	Manager Data Source Name	managerDS(수정불가)
access.datasource.name	Manager Data Source Name	accessDS(수정불가)
manager/access.jdbc.driver .datasource.jndiname	DB별 JDBC Driver class 명	oracle.jdbc.driver. OracleDriver, com.mysql.jdbc.Driver 등
manager/access.jdbc.url	JDBC connection url	jdbc:oracle:thin:@127.0.0.1 :1521:orcl, jdbc:mysql://127.0.0.1:3306/ GlueMaster 등
manager/access.jdbc.username	JDBC connection User Name	DB 에 설정된 username. 예)gluemast,glueuser
manager/access.jdbc.password	JDBC connection password	DB 에 설정된 password. 예)gluemast,glueuser

 Data Source를 직접 설정할 경우
    #GlueMaster Manager Setting
    manager.datasource.name=managerDS
    manager.jdbc.driver=oracle.jdbc.driver.OracleDriver
    manager.jdbc.url=jdbc:oracle:thin:@127.0.0.1:1521:orcl
    manager.jdbc.username=gluemast
    manager.jdbc.password=gluemast
 Data Source를 WAS에서 설정한 JNDI로 사용할 경우
    #GlueMaster Manager Setting JNDI
    manager.datasource.name=managerJndiDS
    manager.datasource.jndiname=java:comp/env/jdbc/oracle/GlueMaster

    #Is Master History
    manager.ismasterhistory=true

Home

Main

문서

모듈

프로젝트 문서화

설치 가이드

목차

1. DB Setup(공통 주의 사항)

Script 파일을 콘솔에서 직접 실행 할 경우 아래의 사항을 주의한다.

2. DB Setup(Oracle script)

DDL,DML Script 를 이용한 DB 구성

사용자 생성 및 권한 부여

실행명령어 : 콘솔에서 sqlplus 실행 후 script file 실행

기타

사용자 삭제

Dump 파일 이용 방법

3. DB Setup(DB2 script)

DDL,DML Script 를 이용한 DB 구성 : CLP보다는 DB GUI나 tool 사용을 권장.

사용자 생성 및 권한 부여

실행명령어 : 콘솔에서 sqlplus 실행 후 script file 실행

주의 : Linux/Unix 계열에서 실행할 경우 script file의 EOL을 UNIX형으로 변환해야 함.

기타

사용자 삭제

Dump 파일 이용 방법

4. WAS Setup (Tomcat)

Tomcat 설치

Tomcat

주요 경로

옵션 추가

catalina.bat 수정 (JAVA 옵션)

server.xml 수정 (encoding set 옵션)

기타 (리눅스일경우)

JNDI 설정

context.xml, server.xml 수정

Web Application Copy

GlueMaster.war 추가

5. WAS Setup (WebLogic)

WebLogic 설치

옵션 추가

setDomainEnv.cmd 수정 (JAVA 옵션)

weblogic.xml 수정 (encoding 옵션)

JNDI 설정

WebLogic Console 이용

Web Application Deploy

WebLogic Console 이용

6. WAS Setup (WebSphere)

WebSphere 설치

Property 설정

WebSphere Admin console 이용

JAVA 옵션

Encoding set 옵션

JNDI 설정

Web Application Deploy

WebSphere Console 이용

7. WAS Setup (공통)

property 파일 추가

property 파일 설정 예 1

property 파일 설정 예2

8. Library 설치

Glue Master WAR에 포함되지 않는 library 파일 설치

9. 별첨(accompanying)

제공 파일

GlueMaster.properties

기본 properties

JNDI를 사용시 관련 properties

JDBC driver 사용시 관련 properties