WAS Installation for online use

Use tomcat9_online as the Tomcat installation directory at the same level as $BXM_HOME.

Example) If $BXM_HOME is /home/bxmv5/bxm, install it in /home/bxmv5/tomcat9_online.

classpath configuration

Open tomcat9_online/conf/catalina.properties.

Find the common.loader item and add the classpath for the BXM libraries as follows. At this time, modify BXM HOME to the path where BXM is installed.

...

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

...

Datasource configuration

Open tomcat9_online/conf/server.xml.

Add the following three Datasources as in the example below. At this time, modify the parts enclosed with <<…>>, such as IP, port, account name, and the pool configuration values (such as maxActive, minIdle) to appropriate values that match the user environment.

BXMNXA: NonXA Datasource name used by BXM Framework

APPNXA: NonXA Datasource name used by the application

APPXA: XA Datasource name used by the application

...

<GlobalNamingResources>
    <Resource
                name="UserDatabase" auth="Container"
                type="org.apache.catalina.UserDatabase"
                description="User database that can be updated and saved"
                factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
                pathname="conf/tomcat-users.xml" />
    <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="bxmv5"
                password="<<DB 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="bxmv5"
                password="<<DB PASSWORD>>" />
    <Resource
                type="com.atomikos.jdbc.AtomikosDataSourceBean"
                name="APPXA"
                auth="Container"
                factory="com.atomikos.tomcat.EnhancedTomcatAtomikosBeanFactory"
                uniqueResourceName="APPXA"
                maxPoolSize="20"
                minPoolSize="1"
                xaDataSourceClassName="oracle.jdbc.xa.client.OracleXADataSource"
                xaProperties.databaseName="<<DB SID>>"
                xaProperties.serverName="<<DB SERVER IP>>"
                xaProperties.portNumber="<<DB PORT>>"
                xaProperties.user="bxmv5"
                xaProperties.password="<<DB PASSWORD>>"
                xaProperties.URL="<<DB JDBC URL>>" />
</GlobalNamingResources>

...

Service port configuration
1. Open tomcat9_online/conf/server.xml.
2. Find the HTTP Connector entry and change the port. The value specified in port is an example value in this document and can be modified to an appropriate value according to the user environment.
  ... <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" /> ...
3. Since the AJP Connector is not used, comment out the AJP Connector entry as follows to prevent port conflicts.
  ...   ...
4. Change the Tomcat shutdown port so that it does not conflict with other instances. The value specified in port is an example value in this document and can be modified according to the user environment.
  ... <Server port="8005" shutdown="SHUTDOWN"> <Listener className="org.apache.catalina.startup.VersionLoggerListener" /> ...

Context configuration

Open tomcat9_online/conf/context.xml.

Find the Context entry and add the following content. The values specified in ResourceLink are example values in this document and can be modified to appropriate values that match the user environment. However, the values specified for Transaction and Resource should be used as they are, and only users familiar with the Transaction Manager (Atomikos) can modify them to appropriate values for their environment.

...
<Context>

    <WatchedResource>WEB-INF/web.xml</WatchedResource>

    <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" />

...

JVM option configuration

Open tomcat9_online/bin/setenv.sh.

If this file does not exist, create a new one.

Add the following content. At this time, modify BXM HOME to the directory where BXM is installed. However, the value of bxm.node.name must be unique for each host where BXM is installed and must not be duplicated between servers. Also, bxm.instance.name must not be duplicated among Tomcat instances.

if [ "$1" = "start" ] ; then
    JAVA_OPTS="$JAVA_OPTS -Dbxm.node.name=DFT1 -Dbxm.instance.name=online1 -Dlog.level.layer.file=<<BXM HOME>>/online/serviceEndpoint/WEB-INF/classes/logLayer.properties"
    JAVA_OPTS="$JAVA_OPTS -Dlogback.configurationFile=<<BXM HOME>>/online/serviceEndpoint/WEB-INF/classes/logback.xml"
    # Add only when using Tomcat.
    JAVA_OPTS="$JAVA_OPTS -Dcom.atomikos.icatch.file=<<BXM HOME>>/lib/jta/jta.properties"
    JAVA_OPTS="$JAVA_OPTS -Xms1024m -Xmx1024m -XX:MaxPermSize=256m"
    #OJDBC7 AutoCommit Error validate option false
    JAVA_OPTS="$JAVA_OPTS -Doracle.jdbc.autoCommitSpecCompliant=false"
fi