Web Admin WAS Installation

Use tomcat9_admin 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_admin.

classpath settings
1. Open the tomcat9_admin/conf/catalina.properties file.
2. Add the classpath for BXM libraries to the common.loader entry as shown below. At this time, modify BXM HOME to the path where BXM is installed.
  common.loader=${catalina.base}/lib,${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 settings

Open the tomcat9_admin/conf/server.xml file.

Add the Datasource settings as follows. At this time, set BXM HOME to the BXM installation path, and modify the parts enclosed with <<…>> such as ip, port, account name, and the Pool configuration values (maxActive, minIdle, etc.) to appropriate values for the user environment.

BXMNXA: NonXA Datasource name used by BXM

APPNXA: NonXA Datasource name used by Application

APPXA: XA Datasource name used by 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
                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="<<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 settings
1. Open tomcat9_admin/conf/server.xml.
2. Find the HTTP Connector entry and modify it as follows. The value specified in port is an example in this document and can be modified to suit the user environment.
  ... <Connector port="18090" 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 in this document and can be modified to suit the user environment.
  ... <Server port="8007" shutdown="SHUTDOWN"> <Listener className="org.apache.catalina.startup.VersionLoggerListener" /> ...

Context settings

Open tomcat9_admin/conf/context.xml.

Find the Context entry and add the following contents. The values specified in ResourceLink are examples in this document and can be modified to appropriate values for the user environment. However, the values specified for Transaction and Resource should be used as-is, and only users who are familiar with the Transaction Manager (Atomikos) may modify them to appropriate values for their environment.

...

<Context reloadable = "false">

    <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 settings

Open tomcat9_admin/bin/setenv.sh. If the file does not exist, create a new one.

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

if [ "$1" = "start" ] ; then
    JAVA_OPTS="$JAVA_OPTS -Dbxm.node.name=DFT1 -Dbxm.instance.name=webadm1"
    JAVA_OPTS="$JAVA_OPTS -Dlogback.configurationFile=<<BXM HOME>>/admin/bxmAdmin/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