Deploying TAFJ Module

This section shows the deployment of TAFJ module. This helps you to declare the JAR files you want to deploy and the dependencies you need to define on other modules.

To deploy the TAFJ module,

1. Create a global module com/temenos/tafj/main under JBOSS_HOME/modules.
2. Create a symbolic link lib pointing to TAFJ_HOME/lib from JBOSS_HOME/modules com/temenos/tafj/main. Below is the command to create a symbolic link based on your operating system:
   • Windows: mklink /D lib %TAFJ_HOME%\lib
   • Unix: ln -s $TAFJ_HOME/lib lib
3. Create a symbolic link ext pointing to TAFJ_HOME/ext from JBOSS_HOME/modules com/temenos/tafj/main. Below is the command to create a symbolic link based on your operating system:
   • Windows: mklink /D ext %TAFJ_HOME%\ext
   • Unix: ln -s $TAFJ_HOME/ext ext
4. Copy the following to the global module that you created in step 1:
   • The module.xml file from %TAFJ_HOME%\appserver\jboss\jboss7eap\modules\com\temenos\tafj available in %JBOSS_HOME%\modules com/temenos/tafj/main.
   • The symbolic link lib created in step 2.
   • The symbolic link ext created in step 3.

The sample below contains a dependency on a user defined oracle drivers’ module. If you don’t use oracle database or other oracle drivers’ version you will have to remove this dependency and add the dependency corresponding to the database driver module you want to use.

<module xmlns="urn:jboss:module:1.0" name="com.temenos.tafj">
  <resources>
	<!-- Insert resources here -->
	<resource-root path="/lib/antlr.jar"/>
	<resource-root path="/lib/icu4j-light.jar"/>
	<resource-root path="/lib/jremote.jar"/>
<resource-root path="/lib/log4j-api.jar"/>
<resource-root path="/lib/log4j-core.jar"/>
<resource-root path="/lib/cache-api.jar"/>
    	<resource-root path="/lib/T24CollectorClient.jar"/>	
<resource-root path="/lib/TemenosSecurity.jar"/>
	<resource-root path="/lib/TAFJClient.jar"/>
	<resource-root path="/lib/TAFJCommon.jar"/>
<resource-root path="/lib/TAFJCache.jar"/>
	<resource-root path="/lib/TAFJCompiler.jar"/>	
	<resource-root path="/lib/TAFJCore.jar"/>	
	<resource-root path="/lib/TAFJLocking.jar"/>
<resource-root path="/lib/TAFJLogging.jar"/>
	<resource-root path="/lib/TAFJTelnetD.jar"/>
	<resource-root path="/lib/TAFJVersion.jar"/>	
	<resource-root path="/ext/TAFJBASIC.jar"/>	
	<resource-root path="/ext/tComponentFramework.jar"/>	
  </resources>
  <dependencies>	
	<module name="com.temenos.t24"/>	
<module name="com.oracle.12c"/>	
    	<module name="javax.api"/>
	<module name="javaee.api"/>
	<module name="javax.jms.api"/>
  </dependencies> 
</module>

Backward Compatibility

Since PB201607 the logging API being used is Log4j 2. To continue using former Log4j 1.2 version and existing TAFJTrace configuration, you need to replace the module setup log4j-api.jar and log4j-core.jar with log4j 1.2 version from $TAFJ_HOME/3rdParty/logging/log4j12/log4j.jar.

<module xmlns="urn:jboss:module:1.0" name="com.temenos.tafj">
  <resources>
	<!-- Insert resources here -->
	<resource-root path="/lib/antlr.jar"/>
	<resource-root path="/lib/icu4j-light.jar"/>
	<resource-root path="/lib/jremote.jar"/>
<resource-root path="/lib/log4j.jar"/>
<resource-root path="/lib/cache-api.jar"/>	
    	<resource-root path="/lib/T24CollectorClient.jar"/>
<resource-root path="/lib/TemenosSecurity.jar"/>	
	<resource-root path="/lib/TAFJClient.jar"/>
	<resource-root path="/lib/TAFJCommon.jar"/>
<resource-root path="/lib/TAFJCache.jar"/>
	<resource-root path="/lib/TAFJCompiler.jar"/>	
	<resource-root path="/lib/TAFJCore.jar"/>	
	<resource-root path="/lib/TAFJLocking.jar"/>
<resource-root path="/lib/TAFJLogging.jar"/>
	<resource-root path="/lib/TAFJTelnetD.jar"/>
	<resource-root path="/lib/TAFJVersion.jar"/>	
	<resource-root path="/ext/TAFJBASIC.jar"/>	
	<resource-root path="/ext/tComponentFramework.jar"/>	
  </resources>
  <dependencies>	
	<module name="com.temenos.t24"/>	
<module name="com.oracle.12c"/>	
    	<module name="javax.api"/>
	<module name="javaee.api"/>
	<module name="javax.jms.api"/>
  </dependencies> 
</module>

You will also need to provide as a server JVM argument the logging api to use.

-Dtemenos.log.api=LOG4J

Alternative Deployment

TAFJ can also be configured to use SLF4J instead of the default log4j 2 configuration. This can be done by modifying the module to use SLF4J version and the desired SLF4J to back-end bridge. That is, to use both SLF4J and Log4j 1.2.

<module xmlns="urn:jboss:module:1.0" name="com.temenos.tafj">
  <resources>
	<!-- Insert resources here -->
	<resource-root path="/lib/antlr.jar"/>
	<resource-root path="/lib/icu4j-light.jar"/>
	<resource-root path="/lib/jremote.jar"/>
<resource-root path="/lib/slf4j-api.jar"/>
<resource-root path="/lib/slf4j-log4j12.jar"/>
<resource-root path="/lib/log4j.jar"/>
<resource-root path="/lib/ cache-api.jar"/>
    	<resource-root path="/lib/T24CollectorClient.jar"/>	
<resource-root path="/lib/TemenosSecurity.jar"/>
	<resource-root path="/lib/TAFJClient.jar"/>
	<resource-root path="/lib/TAFJCommon.jar"/>
<resource-root path="/lib/TAFJCache.jar"/>
	<resource-root path="/lib/TAFJCompiler.jar"/>	
	<resource-root path="/lib/TAFJCore.jar"/>	
	<resource-root path="/lib/TAFJLocking.jar"/>
<resource-root path="/lib/TAFJLogging.jar"/>
	<resource-root path="/lib/TAFJTelnetD.jar"/>
	<resource-root path="/lib/TAFJVersion.jar"/>	
	<resource-root path="/ext/TAFJBASIC.jar"/>	
	<resource-root path="/ext/tComponentFramework.jar"/>	
  </resources>
  <dependencies>	
	<module name="com.temenos.t24"/>	
<module name="com.oracle.12c"/>	
    	<module name="javax.api"/>
	<module name="javaee.api"/>
	<module name="javax.jms.api"/>
  </dependencies> 
</module>

You will also need to provide as a server JVM argument the logging api to use (-Dtemenos.log.api=SLF4J) and the logging back-end to use (-Dtemenos.log.backend=LOG4J).

For more information, see TAFJ Logging.