10/3/2021 How to configure T24 browser with Jboss 6 EAP version

Temenos Support Forum (/SitePages/tsf.aspx)  Portal Help tuannt3

Customer Support
Portal
(/SitePages/Home.aspx)

 MENU Entire Site Enter your keywords here 

TOCF (EE) R14 on JBOSS EAP 6.2

Here is the short description of T24 Browser configuration using TOCF(EE) with JBOSS EAP 6.2 as application server.

Software specifications:

jBoss EAP Application Server - 6.2.0

 (/SitePages/Home.aspx)
Temenos T24 Browser - R14.0.0
 (/SitePages/supportinterface.aspx)
TOCF(EE) - R14.0.0.0

TAFC - R14.0.0
 (/TCSPProfileCenter/infodefault.aspx)
Internet Explorer
 (/Support/DashBoard.aspx)  

Google Chrome
 (/OpenSourcePortal/SitePages/Home.aspx)  

Pre-requisite: 
R14 installed in the system.

Product Installation:
Usually jBoss EAP setup comes as jboss-eap-Version.tar package which can be extracted using tar utility on UNIX and
Windows platforms. jBoss EAP 6.2.0 can be downloaded from the jboss.org website.

http://www.jboss.org/products/eap/download (http://www.jboss.org/products/eap/download/)/

or http://jbossas.jboss.org/downloads.htm (http://jbossas.jboss.org/downloads.html)l

Download the TOCF(EE)-R14.0.0.1.zip file from the Temenos group website (or you can place a request to distribution
team)

System Setup & Configurations for jBoss EAP 6.2:

Extract the jboss-eap-6.2.zip file in a local directory; copy and paste jboss-eap-6.2 folder in
D:\Temenos\ModelBank-R14\Infra path 

Was this page

Yes

https://tcsp.temenos.com/HowTo/EAPVersion.aspx 1/12
10/3/2021 How to configure T24 browser with Jboss 6 EAP version

 (/SitePages/Home.aspx)
 
 (/SitePages/supportinterface.aspx)
 Extract TOCF(EE)-R14.0.0.1.zip file in a local directory ; copy and paste tocfee.ear and tocfT24ra-ra.ear in
deployments folder - D:\Temenos\ModelBank-R14\Infra\jboss-eap-6.2\standalone\deployments path 
 (/TCSPProfileCenter/infodefault.aspx)
 (/Support/DashBoard.aspx)
 (/OpenSourcePortal/SitePages/Home.aspx)

NOTE: BrowserWeb.war is the web component.; an interface designed in html, css and servlets, to T24 system. So for this
interface to connect to our system we need resource adapter( i.e. tocfT24ra-ra.rar). This is enough for AGENT mode of
connection. But if you are using JMS mode then we need to deploy (tocfee.ear) also in addition to tocfT24ra-ra.rar

standalone-full.xml:
We need to edit the standalone-full.xml for our deployments.

jboss-eap-6.2\standalone\configuration\standalone-full.xml: Do following modification whenever required.

*Adding Resource adapter connection factory settings (in place of t24-ds.xml). Was this page

In BrowserWeb:
*Adding<jndi-name>java:/jca/t24ConnectionFactory</jndi-name>in jboss-web.xml Yes

https://tcsp.temenos.com/HowTo/EAPVersion.aspx 2/12
10/3/2021 How to configure T24 browser with Jboss 6 EAP version

*Adding parent-first="false" & export-all="NON_EMPTY" in jboss-classloading.xml

For adding connection factory settings, you have to look for tag:

<subsystem xmlns="urn:jboss:domain:resource-adapters:1.1">

Inside the element inside <subsystem>, you need to modify under <resource-adapters>

In this section we need to add new <resource-adapter id="tocfT24ra-ra.rar">

*************************************

<resource-adapter id="tocfT24ra-ra.rar"> <archive>tocfT24ra-ra.rar</archive> <transaction-

support>XATransaction</transaction-support> <config-property name="listenPort">0</config-property> <config-
property name="listenHost">127.0.0.1</config-property> <connection-definitions>

<connection-definition class-name="com.temenos.tocf.t24ra.outbound.T24ManagedConnectionFactory" jndi-

name="java:/jca/t24ConnectionFactory" pool-name="T24ConnectionFactory">

<config-property name="ports">10014</config-property> <config-property name="allowInput">false</config-

property> <config-property name="actionTimeout">30</config-property>

<config-property name="envVariables">OFS_SOURCE=BROWSERTC</config-property> <config-property

name="compressionThreshold">2048</config-property> <config-property name="hosts">127.0.0.1</config-property>
 (/SitePages/Home.aspx)
 (/SitePages/supportinterface.aspx)
<config-property name="charset">ISO-8859-1</config-property> <config-property name="compression">true</config-
property> <config-property name="loadBalancing">false</config-property>

</connection-definition> </connection-definitions> </resource-adapter>
 (/TCSPProfileCenter/infodefault.aspx)
</resource-adapters>
 (/Support/DashBoard.aspx)
*************************************
 (/OpenSourcePortal/SitePages/Home.aspx)

T24 Browser ( BrowserWeb.war )

Edit xml files and change configuration on: jboss-web.xml & jboss-classloading.xml

a)  jboss-web.xml

Modify jndi name for jca/t24ConnectionFactory resource reference (add: java:/ ) <resource-ref>

<res-ref-name>jca/t24ConnectionFactory</res-ref-name> <res-type>com.jbase.jremote.JConnectionFactory</res-type>
<jndi-name>java:/jca/t24ConnectionFactory</jndi-name>

</resource-ref>

b) jboss-classloading.xml

We have to add:
<?xml version="1.0" encoding="UTF-8"?> <classloading xmlns="urn:jboss:classloading:1.0"

name="BrowserWeb.war"

domain="DefaultDomain" parent-first="false" export-all="NON_EMPTY"

import-all="true"> </classloading>

AGENT/JMS connection methods Was this page

After successful installation of the application server the user can deploy and configure T24 Browser to use one of the two
types of supported connection methods: AGENT or JMS. Yes

https://tcsp.temenos.com/HowTo/EAPVersion.aspx 3/12
10/3/2021 How to configure T24 browser with Jboss 6 EAP version

AGENT Architecture
To install T24 Browser using AGENT architecture the user needs to make sure that the browserParameters.xml file
in BrowserWeb.war has got the following parameter set:

<Parameter>

<parameterName>Server Connection Method</parameterName>

<parameterValue>AGENT</parameterValue>

<!-- Options: INSTANCE / AGENT / AGENT_JREMOTE / JMS -->

</parameter>

JMS Architecture & Configurations

Adding Queues in jboss-eap-6.2\standalone\configuration\standalone-full.xml: Under <Hornetq-server> tag:

**********************************
<jms-destinations>

<jms-queue name="t24OFSQueue"> <entry name="queue/t24OFSQueue"/>

 (/SitePages/Home.aspx)
 </jms-queue>
 (/SitePages/supportinterface.aspx)
  <jms-queue name="t24OFSReplyQueue"> <entry name="queue/t24OFSReplyQueue"/>

 (/TCSPProfileCenter/infodefault.aspx)
 </jms-queue>

 (/Support/DashBoard.aspx)
<jms-queue name="requestQueue"> <entry name="queue/requestQueue"/>
 (/OpenSourcePortal/SitePages/Home.aspx)
</jms-queue>

 <jms-queue name="responseQueue"> <entry name="queue/responseQueue"/>

 </jms-queue>

 </jms-destinations>

*************************************
To install T24 Browser using JMS architecture the user needs to make sure that the browserParameters.xml file in
BrowserWeb.war has got the following parameter set:

<Parameter>
<parameterName>Server Connection Method</parameterName>
<parameterValue>JMS</parameterValue>
<!-- Options: INSTANCE / AGENT / AGENT_JREMOTE / JMS -->
</parameter>

Important Note:
The graphDisplayType parameter value in BrowserWeb.war/browserParameters.xml should be set to pngImage to
display graphs if T24 Browser is opened on different Web browsers like Chrome 35.0x, and Internet Explorer 10: 
 *****************************************
<parameter>
<parameterName>graphDisplayType</parameterName>
Was this page
<parameterValue>pngImage</parameterValue>
 <!--
Options are: svgObject, pngImage
Determines whether charts will be displayed as an SVG graphic or as a PNG image. The SVG graphic supports drilldowns
Yes
but requires the user to have an SVG viewer installed.The PNG image supports less functionality but can be displayed in
https://tcsp.temenos.com/HowTo/EAPVersion.aspx 4/12
10/3/2021 How to configure T24 browser with Jboss 6 EAP version

browsers that don't have an SVG viewer.

-->
</parameter> 

*************************************

T24 Browser ( BrowserWeb.war )

Launch T24 Browser:

Start the jBoss, by running the following command from JBOSS_HOME/bin:

standalone.bat --server-config=standalone-full.xml -b 0.0.0.0

NOTE: Use standalone.sh for windows environment.

 T24 Configuration
After setting up the required architecture the setup phase is almost completed. Execute 'jbase_agent' on your T24 server
and start using Temenos T24.

Starting the agent using the below command from jsh>:

 (/SitePages/Home.aspx)
jbase_agent –p 40100
 (/SitePages/supportinterface.aspx)
Browser is launched successfully using TOCF(EE) in jboss EAP 6.2:

 (/TCSPProfileCenter/infodefault.aspx)
 (/Support/DashBoard.aspx)
 (/OpenSourcePortal/SitePages/Home.aspx)

Was this page

 

Bulk file upload Yes

https://tcsp.temenos.com/HowTo/EAPVersion.aspx 5/12
10/3/2021 How to configure T24 browser with Jboss 6 EAP version

New functionality created for corporate internet banking environment where a single person will represent the entity like
company for internet banking. He will Upload the files containing bulk data like salary information to the bank in one of
the file format supported (.csv,.txt, .xls etc…) via the arc-ib interface provided. This will be picked up and processed by the
service called T24.UPLOAD.PROCESS and the accounting entries will be raised accordingly.

From the browser team perspective these are things that are done.

1. EB.FILE.UPLOAD.PARAM
Has one record SYSTEM which will contain the path to where the tcserver/tocf will upload the file to the T24.
The path specified here has to be the same with tcserver listener <UPLOAD_PATH> tag.
 
2. EB.FILE.UPLOAD.TYPE
This template contains the information like file extension, maximum file size etc.
 
3. EB.FILE.UPLOAD
Template provides the interface for user to upload the file.

Note: The file upload functionality works only for TOCFEE releases R14.0.0.1 and above.
In the T24 Browser/ARC-IB war files, kindly do the below modifications,

1. browserParameters.xml – "fileuploadchannel" parameter points to channel used for upload specified in

channels.xml. 
 (/SitePages/Home.aspx)
 (/SitePages/supportinterface.aspx)

 (/TCSPProfileCenter/infodefault.aspx)
 (/Support/DashBoard.aspx)
 (/OpenSourcePortal/SitePages/Home.aspx)

2. channels.xml – Please specify channel for file upload here. The <NAME> tag should have the parameter value of
the parameter "fileuploadchannel" mentioned in browserParameters.xml. The port number mentioned in the
<PORT> tag here should be provided in tcserver.xml(…tocfee.ear\tocfplugin-ra.rar\) 

Was this page

Yes

https://tcsp.temenos.com/HowTo/EAPVersion.aspx 6/12
10/3/2021 How to configure T24 browser with Jboss 6 EAP version

 
 (/SitePages/Home.aspx)
3. browserConnection.xml – The channel "FileUploadDownloadChannel" should be defined in the <channel> tag of
 (/SitePages/supportinterface.aspx)
browserConnection.xml file. 

 (/TCSPProfileCenter/infodefault.aspx)
 (/Support/DashBoard.aspx)
 (/OpenSourcePortal/SitePages/Home.aspx)

4. tcserver.xml– Open the tocfplugin-ra.rar inside /jboss-eap-6.2/standalone/deployments/tocfee.ear provided and

define a listener for the channel "FileUploadDownloadChannel"(which is defined in channels.xml in step 2) in the
tcserver.xml(which is inside the Inside the tocfplugin-ra.rar) as below

Was this page

Yes

https://tcsp.temenos.com/HowTo/EAPVersion.aspx 7/12
10/3/2021 How to configure T24 browser with Jboss 6 EAP version

Note: The port number provided here in <PORT> tag should be same as the port number provided in channels.xml.

In the <UPLOAD_PATH> tag give the path where the files are needed to be uploaded.

<LISTENER id="FileUploadDownloadChannel" type="tcp" active="true">

<ADAPTERID>T24</ADAPTERID>

<PORT>10003</PORT>

 (/SitePages/Home.aspx)
<UPLOAD_PATH>D:\Temenos\ModelBank-R14\T24\Env\MB\bnk\bnk.run\tcupload</UPLOAD_PATH>
 (/SitePages/supportinterface.aspx)
<STREAM_WRITER>FileOutputStreamWriter</STREAM_WRITER> </LISTENER>
 Note: If the upload path is not in the same server as the Web Application Server then kindly provide the mapped path in
the <UPLOAD_PATH> tag.
 (/TCSPProfileCenter/infodefault.aspx)
 (/Support/DashBoard.aspx)
5. Inside the tocflistener-ejb.jar pack find the META-INF/ejb-jar.xml file where we need to give the listener id which
we created for file upload. For the 'CustomDownloadListenerMDB' ejb for the activation-config-property 'listener',
 (/OpenSourcePortal/SitePages/Home.aspx)
kindly specify the "FileUploadDownloadChannel" listener which we defined in tcserver.xml. 

6. Similarly inside the tocflistener-ejb.jar pack find the META-INF/ jboss-ejb3.xml file and define the above listener
for the CustomDownloadListerMDB ejb. 

Was this page

Yes

https://tcsp.temenos.com/HowTo/EAPVersion.aspx 8/12
10/3/2021 How to configure T24 browser with Jboss 6 EAP version

7. bnk.run directory structure where the file gets uploaded. 

 (/SitePages/Home.aspx)
 
 (/SitePages/supportinterface.aspx)
8. Sample EB.FILE.UPLOAD.PARAM record. Please mention the upload path in the field TC.UPLOAD.PATH: 

 (/TCSPProfileCenter/infodefault.aspx)
 (/Support/DashBoard.aspx)
 (/OpenSourcePortal/SitePages/Home.aspx)

9. Sample EB.FILE.UPLOAD.TYPE record

Was this page

Yes

https://tcsp.temenos.com/HowTo/EAPVersion.aspx 9/12
10/3/2021 How to configure T24 browser with Jboss 6 EAP version

 (/SitePages/Home.aspx)
 (/SitePages/supportinterface.aspx)

 (/TCSPProfileCenter/infodefault.aspx)
 (/Support/DashBoard.aspx)
 (/OpenSourcePortal/SitePages/Home.aspx)
10. EB.FILE.UPLOAD in T24 Browser

i. Select the file to be uploaded in the field FILE.NAME 

Was this page

Yes

https://tcsp.temenos.com/HowTo/EAPVersion.aspx 10/12
10/3/2021 How to configure T24 browser with Jboss 6 EAP version

ii. Before committing or validating kindly click the upload button which is right of Browser button. 

 (/SitePages/Home.aspx)
 (/SitePages/supportinterface.aspx)
 

 (/TCSPProfileCenter/infodefault.aspx)
 (/Support/DashBoard.aspx)
 (/OpenSourcePortal/SitePages/Home.aspx)

iii. On validating the record: 

iv. On committing, the transaction is completed: 

Was this page

 

Yes

https://tcsp.temenos.com/HowTo/EAPVersion.aspx 11/12
10/3/2021 How to configure T24 browser with Jboss 6 EAP version

v. Checking in window explorer in the upload path, we can see the selected file has been uploaded: 

COPYRIGHT © 2018 TEMENOS HEADQUARTERS SA

(http://www.temenos.com/)
Best viewed in Internet Explorer 10 & above

 (/SitePages/Home.aspx)
 (/SitePages/supportinterface.aspx)

 (/TCSPProfileCenter/infodefault.aspx)
 (/Support/DashBoard.aspx)
 (/OpenSourcePortal/SitePages/Home.aspx)

Was this page

Yes

https://tcsp.temenos.com/HowTo/EAPVersion.aspx 12/12