TAFJ U p g r a d e
R19
TAFJ U p g r a d e
Amendment History:
Revisio
Date Amended Name Description
n
1 2012 TAFJ Team Initial version
th
16 January
2 M. Kumar R13GA review
2013
3 25th Feb 2013 M. Kumar Added the missing parameter for upgrade service.
Correction in document to run conversion in T24
4 26th April 2013 M. Kumar
before Authorizing Exceptions.
5 10th March 2015 H. Aubert R15 AMR review
6 15th March 2016 M. Kumar R16 AMR review
22nd October Correction in document to run TAFJ Upgrade through
7 Siranjeevi M
2018 App server
8 27th Feb 2019 M. Kumar Adding Module upgrade section
9 21st March 2019 [Link] R19 AMR review
23rd September H Sanofar
10 Create views during upgrade
2019 Nisha
Page 2
TAFJ U p g r a d e
Copyri g h t
Copyright © Temenos Headquarters SA 2009-2019. All rights reserved.
This document contains proprietary information that is protected by copyright. No part of this document may
be reproduced, transmitted, or made available directly or indirectly to a third party without the express
written agreement of TEMENOS UK Limited. Receipt of this material directly TEMENOS UK Limited
constitutes its express permission to copy. Permission to use or copy this document expressly excludes
modifying it for any purpose, or using it to create a derivative therefrom.
Errat a and Com m e n t s
If you have any comments regarding this manual or wish to report any errors in the
documentation, please document them and send them to the address below:
Technology Department
Temenos Headquarters SA
2 Rue de l’Ecole-de-Chimie,
CH - 1205 Geneva,
Switzerland
Tel SB: +41 (0) 22 708 1150
Fax: +41 (0) 22 708 1160
Please include your name, company, address, and telephone and fax numbers, and email
address if applicable. TAFJdev@[Link]
Page 3
TAFJ U p g r a d e
Table of Contents
Copyright................................................................................................................................................ 3
Errata and Comments............................................................................................................................ 3
Overview................................................................................................................................................ 5
Pre requisite: Existing TAFJ area.......................................................................................................... 5
TAFJ UPGRADE.................................................................................................................................... 5
T24 UPGRADE....................................................................................................................................... 8
[Link].................................................................................................................................... 8
MODULE UPGRADE........................................................................................................................... 11
[Link]............................................................................................................................. 12
[Link]............................................................................................................................. 18
ENQUIRY EXCEPTION....................................................................................................................... 21
[Link].............................................................................................................................. 22
Change column STRRECORD to XMLRECORD (H2 & NuoDB).........................................................23
Page 4
TAFJ U p g r a d e
Overvi e w
The primary Objective of this document is to provide guidance regarding the upgrade of T24
release and TAFJ release on existing TAFJ areas.
Pre req u i s i t e : Existi n g TAFJ are a
TAFJ UPGRADE
Following is the procedure to upgrade TAFJ libraries in the existing area.
Please get the latest TAFJ version .zip file (e.g. [Link] ) from
Distribution Team
Once downloaded, please unzip the file into a folder and you should be able to see the
following files inside the folder.
For upgrading, we make use of Patch_TAFJxxx.bat on windows and Patch_TAFJxxx.sh for
other operating systems.
Before launching the Patch_TAFJxxx.bat, make sure we have the following environment
variables set
Launch a Command Prompt (CMD) to set the following Environment variables temporarily.
Page 5
TAFJ U p g r a d e
JAVA_HOME
The minimum requirement for R18 branch is java 1.8
For 64 bit machines
SET JAVA_HOME=C:\Temenos\Development\3rdParty\jdk\jdk1.8.0_121
For 32 bit machines
SET JAVA_HOME=C:\Temenos\Development\3rdParty\jdk\jdk1.8.0_32bit
TAFJ_HOME
Set TAFJ_HOME=C:\LocalArea\201806\TAFJ
ECLIPSE_HOME
SET ECLIPSE_HOME= C:\LocalArea\201806\TAFJ\ECLIPSE
Once set, we can run the Patch_TAFJxxx.bat/sh.
Page 6
TAFJ U p g r a d e
This will upgrade the necessary folders with the new contents from the new release.
Now you can restart your Eclipse for your new jars to be loaded for use.
Note : For Application Servers like Jboss , the following files should be replaced with the
existing files under JBOSS_HOME/server/<context>/deploy folder. Where context can be
default or a specific folder. (i.e for modelbank_tafj , context is R12)
TAFJJEE_EAR.ear file
The above files can be found under TAFJ_HOME/appserver folder.
Note : It might be necessary to replace your database java stored functions if a bug has
been found or an enhancement has been added to them. Please check the release notes.
As well, you can tell the version of the java stored functions by running tDiag.
Page 7
TAFJ U p g r a d e
T24 UPGRADE
[Link] SE
Following is the procedure for upgrading the T24 libraries and data to higher release making
use of [Link] provided by Integration team. ( TAFJ.R12_201214 or higher)
Before going for upgrade, we will make sure that the existing precompiled jar files are
present in a single folder and this folder is referenced in precompiled path on [Link]
file under TAFJ_HOME/conf folder.
i.e.
in [Link]
[Link] = C:\LocalArea\201806\precompiled
(Where in the precompiled folder contains all the precompiled jar files including
Enterprise jars.)
To start the upgrade process, we launch the following command from DBTools Servlet page
from Browser
Syntax :
TEMP-RELEASE [options] pathToTempRelease pathToLibDestinationFolder [-i
pathToInsertDestinationFolder] [-bp pathToSrcDestinationFolder] [-module
T24_moduleName]
Where options can be
–s (script mode)
-log (<name of log >. To be generated under TAFJ_HOME/log )
-cf <Configuration file>
Note : For module specific upgrade [-module T24_moduleName] when passed to TEMP-RELEASE,
only the relative artifacts (jars, data records are only replaced inside the precompiled folder and database).
Page 8
TAFJ U p g r a d e
Full Upgrade Module Upgrade
Release all the libs from [Link] /t24lib Release only the module specific libs from
[Link]/t24lib
Clear the table [Link] and populate Delete all existing records related to the module from
it from [Link] J4 file [Link] in database and populate
records specific to the module from [Link]
J4 file.
Clear the table [Link] and populate it from Release all the records into [Link] based
[Link] J4 file on the ID’s matching from above step.
BP/INSERT files copy if specified into folder BP/INSERT files copy if specified into folder
Now start the upgrade process by launching this command from DBTools Servlet page.
DBtools -cf [Link] -log [Link] TEMP-RELEASE
C:\Temp_release\[Link] C:\LocalArea\201806\precompiled
-bp C:\LocalArea\201806\Source
Where
[Link] is a configuration file
[Link] is the name of the log file to be generated in TAFJ_HOME/log folder,
C:\Temp_release\[Link] is the path where my [Link] folder is present
C:\LocalArea\201806\precompiled is path where my precompiled jars are present.
Page 9
TAFJ U p g r a d e
Page 10
TAFJ U p g r a d e
MODULE UPGRADE
Creating a J4 file SYSTEM and pointing to [Link]
Page 11
TAFJ U p g r a d e
T24. P R E . R ELEA SE
Add the following property in the configuration properties file in TAFJ_HOME/conf
JEDIFILENAME_SYSTEM=SYSTEM
The process of upgrade can be monitored in the log file specified, i.e. [Link] under
TAFJ_HOME/log folder.
Once finish the first phase of upgrade, we need to run [Link] routine from the
Appserver.
tRun [Link]
Page 12
TAFJ U p g r a d e
Note:
Failure shown in above screen shot is because of a STOP statement in the program, which
will throw an exception at the end of processing.
After executing the [Link], you should be able to see the file in
&SAVEDLISTS& with the files records being exported into T24 for preliminary use.
Page 13
TAFJ U p g r a d e
Once this process is finished, we need to run the service [Link] to release the Data
records and create file wherever necessary.
Set the record [Link] of [Link] to START.
Run [Link] inside appserver using TAFJEE servlet.
Page 14
TAFJ U p g r a d e
We can find the appropriate como for the service in como folder specified.
Page 15
TAFJ U p g r a d e
Once the service [Link] is finished, you should login into T24 to see the release of
[Link]>SYSTEM record for the latest upgraded [Link] column.
Check the record SYSTEM of [Link]
Page 16
TAFJ U p g r a d e
Sample view of records after upgrade:
Page 17
TAFJ U p g r a d e
Now run the T24 service [Link] to run the conversions if any existing.
Page 18
TAFJ U p g r a d e
[Link] NV E R S I O N
Before starting the Service, we put “START” to TSM and BNK/[Link] in
[Link] record.
Page 19
TAFJ U p g r a d e
Run [Link] inside appserver using TAFJEE servlet.
We can find the appropriate como for the service in como folder specified.
Page 20
TAFJ U p g r a d e
Once this process is finished, we can now login into T24 and run the enquiry EXCEPTION to
have a look at the data records which are in $INAU status.
Page 21
TAFJ U p g r a d e
ENQUIRY EXCEPTIO N
Once done, we run the enquiry EXCEPTION enquiry to list the contents
We can either authorize the records manually or can use a program [Link] to
authorize all the existing $NAU records.
Page 22
TAFJ U p g r a d e
[Link] H O RI S E
AUTHORISING RECORDS can be achieved using core T24 Multithreaded job
([Link] or BNK/[Link]) which is included in T24 R14 and above
releases.
Run [Link] inside appserver using TAFJEE servlet.
Page 23
TAFJ U p g r a d e
We can find the appropriate como for the service in como folder specified.
Page 24
TAFJ U p g r a d e
Chan g e col u m n STRRECOR D to XMLRECOR D (H 2
& Nu o D B )
DBImport to create all VIEW is mandate when the upgarde is done from TAFJ R19 lower
release to TAFJ 201905 or higher release provided the database is H2 or NuoDB.
Page 25