TAFJ - Updater

R23

Information in this document is subject

to change without notice.
No part of this document may be
reproduced or transmitted in any form or
by any means, for any purpose, without
the express written permission of
TEMENOS HEADQUARTERS SA.
© 2022 Temenos Headquarters SA -
all rights reserved.
TAFJ - Updater
Document History

Revisio
Date Amended Name Description
n
1 1st April 2011 TAFJ team Initial version
2 7st February 2012 H. Aubert R12GA review

3 16th January 2013 R. Vincent R13GA review

13th February
4 R. Vincent R14GA review
2014

5 10th March 2015 H. AUBERT R15 AMR review

6 15th March 2016 M. Kumar R16 AMR review

18th November Update installation steps modified with runtime

7 S. Sakthi
2016 directory.

8 21st March 2019 M. Kumar R19 AMR review

9 26th March 2020 MY Halith R20 AMR review

10 12th April 2021 M. Siranjeevi R21 AMR review

Vigneshwara
11 02nd June 2022 Updated property for cloud environment
n

12 6th April 2023 M.Kumar R23 AMR Review

2 Temenos Application Framework Java – (TAFJ)

 TAFJ - Updater

Copyright

Copyright © Temenos Headquarters SA 2009-2023.

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.

Errata and Comments

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. [email protected]

3 Temenos Application Framework Java – (TAFJ)

 TAFJ - Updater

Table of Contents
Document History................................................................................................................... 2
Copyright................................................................................................................................ 3
Errata and Comments............................................................................................................. 3
Install the Parent Installer....................................................................................................... 5
Add the T24 TAFJ Child Installer Service to the ParentInstaller................................................5
What the Child Installer Does........................................................................................................... 6
Showing Version of TAFJ Components.....................................................................................7
Logging for the TAFJ Child Installer.......................................................................................... 7
A T24 TAFJ Update Example.................................................................................................... 8

4 Temenos Application Framework Java – (TAFJ)

 TAFJ - Updater
Install the Parent Installer

This section assumes you have already installed the ModelBank pack / working TAFJ
Environment.
Create a directory (ex: UD/T24UD) and make use the same runtime directory by setting the
directory path as T24_HOME.
Specify the created directory path in property temn.tafj.runtime.directory.current in the
TAFJProperties and install the Parent Installer under it.
Set JEDIFILENAME_SYSTEM=SYSTEM in TAFJProperties in order to release the records.
You obtain the ParentInstaller kit from Distribution. The ParentInstaller program delegates work
(the actual updating process) to a child installer for TAFJ, TAFC, T24, etc. Each child installer is
defined as a service to the ParentInstaller.
The key in the TAFj properties file is temn.tafj.runtime.directory.current
Note: Assume runtime path as temn.tafj.runtime.directory.current=
/glodev1/tafj/tafjx01/TAFJ/T24UD

Add the T24 TAFJ Child Installer Service to the

ParentInstaller

Add the service for T24 TAFJ as shown below in the T24_HOME/updater/config/updater.xml file.
Comment out other services defined that are not used.
<service name="T24" pathType="EXEC" updateType="AUTO">
<path>[TAFJ_HOME]\bin\tRun.bat t24Version</path>
<installpath>[T24_HOME]\updater\updates\tmp</installpath>
<installprogram>[TAFJ_HOME]\bin\t24Updater.bat</installprogram>
</service>

Note: If the updater is executed on a cloud environment, then set the environmental variable
temn_cloud_updater to true.

Test the ParentInstaller by showing the T24 component versions as shown below.
 $export T24_HOME = /glodev1/tafj/tafjx01/TAFJ/T24UD

 $export TAFJ_HOME: /glodev1/tafj/tafjx01/TAFJ

 $export PATH=%PATH%;%T24_HOME%/updater/bin

 temn.tafj.runtime.directory.current = /glodev1/tafj/tafjx01/TAFJ/T24UD

Execute /glodev1/tafj/tafjx01/TAFJ/T24UD>updater -help

java com.temenos.upgrader.Upgrader -report –version
-report Report only. Reports the components/dependencies only and doesn't run the updater.

5 Temenos Application Framework Java – (TAFJ)

 TAFJ - Updater
-version Show the version of the updater.

Execute /glodev1/tafj/tafjx01/TAFJ/T24UD>updater -report

T24 Updater
Loading Upgrader configuration from:
/glodev1/tafj/tafjx01/TAFJ/T24UD/updater/config/updater.xml
Update Dir: /glodev1/tafj/tafjx01/TAFJ/T24UD/updater/updates
Config Path: /glodev1/tafj/tafjx01/TAFJ/T24UD/updater/config
$JBCRELEASEDIR: null
$TAFJ_HOME: /glodev1/tafj/tafjx01/TAFJ
$T24_HOME: /glodev1/tafj/tafjx01/TAFJ/T24UD
<ivy-module version="1.0">
<info organisation="Temenos" branch="200907_AIX" module="T24"/>
<dependencies>
<dependency org="Temenos" branch="201112_AIX" name="EB_Conversion" rev="0"/>
<dependency org="Temenos" branch="201112_AIX" name="SCC_ClassicCA" rev="0"/>
<dependency org="Temenos" branch="201112_AIX" name="AA_ActivityAPI" rev="0"/>
<dependency org="Temenos" branch="201112_AIX" name="PD_Schedules" rev="0"/>
.
.
</dependencies>

Place an update in the T24_HOME/updater/updates directory and launch the updater from
T24_HOME.
Update successful for R12_DE_Inward_1_java1.6.tar : Message: Upgrade successful!
Update successful for R12_DM_Foundation_1_java1.6.tar : Message: Upgrade successful!
Update failed for R12_DW_BiExport_12_java1.6.tar : Message: Cannot open file.
Skipping F.DW.EXPORT$NAU
Output Summary:
20 files processed.
Updates not successful.
Exiting Updater...

What the Child Installer Does

1) Calls the TAFJRuntime API and invokes the program T24.UPDATE.INSTALLER with
arguments –installpath (directory where update lives) and –updatefile (the actual update)

2) Copies jars from the T24 component update to the directory defined in property
temn.tafj.directory.updates in tafj.properties
3) Deletes temporary directory where update was unzipped.

If one wants to bypass the Parent Installer (not suggested), one can do so by running:
t24Updater –installpath <path> -updatefile <absolute path to update>

6 Temenos Application Framework Java – (TAFJ)

 TAFJ - Updater
In this case the zip file of updates must be unzipped to <path> beforehand. When running this,
the T24 TAFJ child installer does the 3 steps shown above, but in bypassing the ParentInstaller,
no version or dependency checking will be done.

Showing Version of TAFJ Components

It is possible to show the version of all TAFJ components by running the tVersion utility (under
TAFJ_HOME/bin) as shown below.
tVersion
<ivy-module version="1.0">
<info organisation="Temenos" module="TAFJ" branch="R12_ALL"/>
<dependencies>
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJCommon" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJCompiler" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJConfHelper" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJCore" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJDBImport" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJLocking" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJPackager" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJTelnetD" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJIODeamon" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJCommon" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJCore" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJIODeamon" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJTelnetD" rev="0" />
<dependency org="Temenos" branch="R12_ALL" name="FJ_TAFJBASIC" rev="0" />
</dependencies>
</ivy-module>

Logging for the TAFJ Child Installer

Once the Parent Installer begins to install updates, you can see the child installer logs in
TAFJ_HOME/log/updater.log as shown below

7 Temenos Application Framework Java – (TAFJ)

 TAFJ - Updater

Afterwards, we can see how many updates processed by the TAFJ Child Installer by doing the
following in DBTools in SQL mode

[email protected]:T24>SELECT RECID FROM F_T24_RELEASE

|R12_TT_Contract_3
|R12_TT_ErrorCodes_2
|R12_TT_Foundation_1
Etc.
287 rows selected.

A T24 TAFJ Update Example

Copied the updates to the updates directory [UPDATER_HOME]/updates

Install the update

The T24.UPDATE.RELEASE before running the T24.UPDATES service:

8 Temenos Application Framework Java – (TAFJ)

TAFJ - Updater

&SAVEDLISTS& and &COMO& o/p:

Set temn.tafj.directory.updates with runtime path associated “updates” directory

(/glodev1/tafj/tafjx01/TAFJ/T24UD/updates)

9 Temenos Application Framework Java – (TAFJ)

 TAFJ - Updater
The component jars get copied to a directory updates in defined by property
temn.tafj.directory.updates.
There will be a new folder created with the update name directory with jars inside the updates
directory.
Copy the component jars AC_ModelBank.jar from the update name directory to the precompiled
directory (defined in tafj.properties).
In most customer cases, this would be a directory know by the application server.

tShow of one of the CLASS files available in the component jar.

The Service BNK/T24.UPDATES has to be run to release the data records of the T24 Updates.
The co-responding Batch record BNK/T24.UPDATES should have “T24.UPDATES” entered in the
DATA field.

10 Temenos Application Framework Java – (TAFJ)

TAFJ - Updater

Run the service T24.UPDATES to complete the data record updates, authorization, and other
processing that needs to take place.

11 Temenos Application Framework Java – (TAFJ)