BX Framework(BXM) Center-Cut 처리 서비스 인스턴스 WAS 환경설정

BX Framework(BXM) Center-Cut 처리 서비스 인스턴스를 위하여 전용 tomcat을 설치한다
tomcat 의 설치위치는 $BXM_HOME과 동일한 레벨의 디렉토리로 tomcat9_centercut02라는 디렉토리를 사용한다.

BX Framework(BXM)의 Center-Cut 을 사용하기 위하여 Tomcat에 BXM library에 대한 classpath, Datasource, Service port, Context를 설정한다.

BXM 라이브러리에 대한 classpath 설정한다.
- tomcat9_centercut02/conf 디렉토리로 이동한다.
  
  catalina.properties의 common.loader항목에 BXM 라이브러리에 대한 classpath를 추가한다.
  
  common.loader=${catalina.base}/lib,${catalina.base}/lib/*.jar,${catalina.home}/lib,${catalina.home}/lib/*.jar,<<BXM_HOME>>/lib/bxm/*.jar,<<BXM_HOME>>/lib/deps/*.jar,<<BXM_HOME>>/lib/ext/*.jar,<<BXM_HOME>>/lib/jta/*.jar
BXM_HOME은 BX Framework(BXM)을 설치한 경로로 수정한다.

BX framework Center-Cut과 Application에서 사용할 Datasource를 설정한다.

tomcat9_centercut02/conf 디렉토리로 이동한다.
server.xml을 수정하여 datasource설정을 추가한다.

BXM Framework , Application 사용 NonXA , XA (2개) 의 Datasource 필요

BXMNXA : BXM Framework 사용 NonXA Datasource 이름

APPNXA : Application 사용 NonXA Datasource 이름

APPXA : Application 사용 XA Datasource 이름

추가한 설정은 아래와 같다.

<GlobalNamingResources>
    <Resource type="javax.sql.DataSource"
                name="BXMNXA"
                auth="Container"
                maxActive="20"
                minIdle="1"
                maxIdle="1"
                maxWait="10000"
                factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
                driverClassName="oracle.jdbc.OracleDriver"
                url="<<DB JDBC URL>>"
                username="bxm"
                password="<<bxm 계정 password>>"
         />
    <Resource type="javax.sql.DataSource"
                name="APPNXA"
                auth="Container"
                maxActive="20"
                minIdle="1"
                maxIdle="1"
                maxWait="10000"
                factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
                driverClassName="oracle.jdbc.OracleDriver"
                url="<<DB JDBC URL>>"
                username="bxm"
                password="<<bxm 계정 password>>"
         />
    <Resource
                name="APPXA"
                auth="Container"
                type="com.atomikos.jdbc.AtomikosDataSourceBean"
                factory="com.atomikos.tomcat.EnhancedTomcatAtomikosBeanFactory"
                uniqueResourceName="APPXA"
                maxPoolSize="20"
                minPoolSize="1"
                xaDataSourceClassName="oracle.jdbc.xa.client.OracleXADataSource"
                xaProperties.databaseName="<<oracle sid>>"
                xaProperties.serverName="<<db server ip>>"
                xaProperties.portNumber="<<oracle port>>"
                xaProperties.user="bxm"
                xaProperties.password="<<bxm 계정 password>>"
                xaProperties.URL="<<DB JDBC URL>>"
        />
</GlobalNamingResources>

<<…>>부분과 Pool의 설정값(maxActive, minIdle등)은 사용자환경에 맞는 적절한 값으로 수정한다.

cc service endpoint가 사용하는 HTTP service port를 설정한다.
- tomcat9_centercut02/conf 디렉토리로 이동한다.
server.xml을 수정하여 service port설정을 수정한다.
- 추가한 설정은 아래와 같다.
  
  <Connector port="28081" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
  
  port에 지정된 값은 본 문서에서 예시한 값이며 사용자환경에 맞는 적절한 값으로 수정가능하다.

cc service endpoint web application context환경을 설정한다.

tomcat9_centercut02/conf 디렉토리로 이동한다.

context.xml을 수정한다.

추가한 설정은 아래와 같다.

<Context reloadable = "false">
    <ResourceLink global="BXMNXA" name="BXMNXA" type="javax.sql.DataSource"/>
    <ResourceLink global="APPNXA" name="APPNXA" type="javax.sql.DataSource"/>
    <ResourceLink global="APPXA" name="APPXA" type="com.atomikos.jdbc.AtomikosDataSourceBean"/>

    <Transaction factory="com.atomikos.icatch.jta.UserTransactionFactory" />
    <Resource name="TransactionManager"
            auth="Container"
            type="com.atomikos.icatch.jta.UserTransactionManager"
            factory="org.apache.naming.factory.BeanFactory"
            />
</Context>

ResourceLink에 지정된 값은 본 문서에서 예시한 값이며 사용자환경에 맞는 적절한 값으로 수정가능하다.

Transaction, Resource에 지정된 값은 그대로 사용하며 Transaction Manager(atomikos)를 익숙한 사용자만 사용자환경에 맞는 적절한 값으로 수정가능하다.

cc service endpoint tomcat instance의 JVM옵션을 설정한다.
- tomcat9_centercut02/bin 디렉토리로 이동한다.
  
  setenv.sh을 수정한다.
- 추가한 설정은 아래와 같다.
  
  if [ "$1" = "start" ] ; then JAVA_OPTS="$JAVA_OPTS -Dbxm.node.name=DFT1 -Dbxm.instance.name=Emerald_ccProc01" #Tomcat사용시에만 추가. JAVA_OPTS="$JAVA_OPTS -Dcom.atomikos.icatch.file=<<BXM_HOME>>/lib/deps/jta.properties" JAVA_OPTS="$JAVA_OPTS –Xms1024m –Xmx1024m -XX:MaxPermSize=256m" fi
  
  bxm.node.name 값은 BX Framework(BXM)이 설치된 host별로 유일한 값으로 부여한다. 서버가 여러대 존재할 때 중복되지 않도록 설정한다.
  
  bxm.instance.name 값은 tomcat instance간 중복되지 않도록 한다.
  
  JVM 메모리설정(Xms, Xmx, MaxPermSize)는 사용자환경에 맞는 적절한 값으로 수정해야한다.
  
  << BXM_HOME >>은 BX Framework(BXM)이 설치된 디렉토리로 수정한다.