T24 Installation guide on AIX

T24 Installation
Guide
On
AIX 5L
(Ver 1)
Written by: Syed Ali Ahmad
Dated : 27-Sept-2007

T24 Installation guide on AIX

T24 Installation guide on AIX

Setting up T24 Application Core Server

The following document shows the installation of T24 with JBASE at the
backend only. This document may require the user to read the JBASE to
Oracle Conversion Process document in case if the final installation is on oracle
at the back end.
Initial Setup
1. Login to the T24 Application core server as <root>
2. Create main installation directory named <temenos> on the partition
allocated.
3. With in the <temenos> directory create three more sub-directories namely
<bnk>, <jbase50>, <tcserver>
4. Copy the Zipped installation sources (from DVD or other media) in each
of the above respective directories.
Installing JBase50
1. Unzip the installation source into the <jbase50> directory
2. Enter the licensing information in the system.properties file located at
/jbase50/config directory
Installing the core T24 Application:
1. Unzip the installation source into the <bnk> directory.
2. Create User using command
a. Mkuser a home='/temenos/t24<env name>/bnk/bnk.run'
shell='/bin/ksh' pgrp='system' admgroups='system' t24<env
name>
where <env name may> be one of ref,dev or tmp etc.
3. Set the .profile parameters of HOME and JBCRELEASEDIR
4. Set the home directory of the user as /bnk/bnk.run.
5. Set permission of 775 on directories for user t24<env name>
Testing the T24 App Command Line mode
1. Login to the machine with username of the respective environment.

T24 Installation guide on AIX

2. In case of successful login the user will be asked if T24 command line
environment be loaded or not by asking START GLOBUS Y/N. On
pressing Y the user will be taken to the T24 Command line login prompt. On
pressing N the user will be taken to the <bnk.run> directory associated with
the current environment.

Exporting the MQSERVER Variable

1. Make sure that the MQSERVER variable is defined and the WMQ Client can
communicate using the sample programs provided. This can be done by using
the following command
a. EXPORT
MQSERVER=CHANNELNAME/TRANSPORTTYPE/CONNNAME
2. Other settings relevant to the MQ server are described in the section Setting
up MQ server.
Installing TCServer
1. Unzip the installation source (from DVD or other media) into the <tcserver>
sub-directory of the current environment.
2. Run the SETUP_TCSERVER.sh
3. Specify the correct tcserver installation path, bnk.run path, the jbase path,
and the RECORD source id which should be BROWSERTC respectively.
4. After the the installation is complete edit the tcserver.xml as located in
/tcserver/tcserver/conf directory. Change the Default Adapter ID and
Default Listener. A sample snippet of tcserver.xml is given on the last page.
5. Set the correct java path and permissions i.e. the JAVA_HOME should be set
to point at the /java/bin path.
6. Test the TCServer by running the TCServer.sh shell file. Make sure that all the
services run give an ok status.

T24 Installation guide on AIX

Setting up MQ Server
Setting up WMQ to run with T24 Application core server
1. Login to the server using root priveledge.
2. On the WMQ server machine make sure that :
a. A queue manager is defined and running
b. A Channel is defined and running
c. Two local queues are defined and running
Detailed commands for the above process are defined as following
1. At AIX shell create a default Queue Manager by executing command
a. crtmqm q abl.qm
2. At AIX shell start the queue manager by executing command
a. Strmqm
3. Start the MQ shell from AIX shell
a. Runmqsc
4. At MQ shell define Local queues, two for each (in and out) t24 Environment
a. Define qlocal( tmp.in)
5. At MQ shell define Listener on server
a. DEFINE LISTENER (abllistener1) TRPTYPE (TCP) CONTROL
(QMGR) PORT (1414)
6. At MQ shell define channel on server
a. DEFINE CHANNEL (CHANNEL1) CHLTYPE (SVRCONN)
TRPTYPE (TCP) MCAUSER (abl.qm)

T24 Installation guide on AIX

Installing the Web Browser Module on Web Server

1. T24 Browser is provided in a packed WAR deployment file.
2. This WAR file contains some important configuration files like channels.xml,
Browserparameters.xml, browserconnection.xml and web.xml. Details of
configuration of each files are at the last section of this document
3. Once configurations are set repack these files in the T24 browser deployment
war file.
4. Make sure that the WAS server is up and running on the web layer server.
Check by running the command serverStatus.sh
5. Open the Admin console of websphere and log in.
6. Click on Install new Application and select the war file you just updated.
7. Select the context root which will be the name of the browser site.
8. Select all the default option and click finish. Websphere will deploy the
Browser application/module on the specified context root.
9. Finally open the browser and test the t24 Application.

T24 Installation guide on AIX

XML Oracle Driver Installation and Jbase to Oracle

Data Conversion
Prerequisites
Make sure that the following files are available to you at CD or some other location
1. XML driver .so and .el files
2. config-file program
3. SELECT.FILES.TO.CONVERT.JBASE program for selecting files for conversion
4. SESSION.CONVERT.TO.JBASE program for doing the actual conversion.
Driver Installation
1. First copy the package.sql file on to the Aix system and run this sql script from
oracle SQL prompt
2. Copy the files from the lib directory of driver installation to the lib directory of
the Jbase root directory.
3. Copy the files from the bin directory of driver installation to the bin directory of
the jbase bin directory
4. Make sure that the permissions are correctly set (775)
5. Now login to the AIX system as jbase user
6. Now create the file jedi_config using the CREATE-FILE command
7. Run the program config-file and configure the oracle DB settings that the jbase
will use to communicate with Oracle.
8. Now test the driver installation by creating a file of type=XMLORACLE add data
to this file. If driver is successfully installed then this data will be saved in the
Oracle DB as XML.
Conversion Process
1.
2.
3.
4.
5.

Run the SELECT.FILES.TO.CONVERT.JBASE

Enter the directory of the files that will be converted to Oracle
Enter the driver name
The list of files that would be processed is then written to a file.
Lastly run the program SESSION.CONVERT.TO.JBASE to convert all the flat
file based data to the oracle based data.

T24 Installation guide on AIX

T24 Installation guide on AIX

TCSERVER.XML sample Code

<!--================================================
Default T24 Adapter
=================================================-->
<ADAPTER id="T24REF">
<MAX_SESSION> 5 </MAX_SESSION>
<MIN_SESSION> 1 </MIN_SESSION>
<TIMEOUT>30</TIMEOUT>
<LOGIN_CONTEXT></LOGIN_CONTEXT>
<STARTIN>/temenos/t24ref/bnk/bnk.run</STARTIN>
<JBASEPATH>/temenos/t24ref/jbase50</JBASEPATH>
<PROGRAM>tSS</PROGRAM>
<PARAMETER>BROWSERTC</PARAMETER>
</ADAPTER>
</ADAPTERS>
<LISTENERS>
<!--================================================
Default Listeners for Temenos Browser
=================================================-->
<LISTENER Name="mqref" type="mqseries" active="true">
<ADAPTERID>T24REF</ADAPTERID>
<MQHOST>10.103.1.36(1414)</MQHOST>
<MQCHANNEL>ch.abl</MQCHANNEL>
<MQMANAGER>qm.abl</MQMANAGER>
<MQQUEUE>ref.in</MQQUEUE>
<NBTHREADS>5</NBTHREADS>
<CONSUMER>
<MQQUEUE>ref.out</MQQUEUE>
<DEADLETTERQUEUE>SYSTEM.DEAD.LETTER.QUEUE</DEADLETTERQUEUE>
</CONSUMER>
</LISTENER>
</LISTENERS>

T24 Installation guide on AIX

Miscellaneous Configuration of files in Web Module

Web.xml
.<web-app id="WebApp">
<display-name>ABLTEST</display-name>

Channels.xml
<CHANNEL>
<NAME> mqabltest </NAME>
<TIMEOUT> 15 </TIMEOUT>
<ADAPTER>
<TYPE> mqseries </TYPE>
<MQHOST>10.103.1.36(1414)</MQHOST>
<MQMANAGER>qm.abl</MQMANAGER>
<MQQUEUE>atest.in</MQQUEUE>
<MQCHANNEL>ch.abl</MQCHANNEL>
<CONSUMER>

<REPLYQUEUEPARAMETERS>QUEUE</REPLYQUEUEPARAMETERS>
<MQHOST>10.103.1.36(1414)</MQHOST>
<MQMANAGER>qm.abl</MQMANAGER>
<MQQUEUE>atest.out</MQQUEUE>
<MQCHANNEL>ch.abl</MQCHANNEL>
</CONSUMER>
</ADAPTER>
</CHANNEL>

Browserparameters.xml
<parameter>
<parameterName>TC_CHANNEL</parameterName>
<parameterValue>mqabltest</parameterValue>
</parameter>

BrowserConnection.xml
<channels>
<channel>mqabltest</channel>
</channels>

T24 Installation guide on AIX