TAFJ-Oracle Install

R24

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 Oracle Install
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

10th September
4 H. Aubert R14GA review
2013

20th February
5 R. Vincent R14GA review
2014

6 15th April 2014 H. Aubert R14GA review

7 4th Feb 2015 G.Gowrimani Altered the Database creation steps

8 15th March 2016 R. Vincent R16 AMR review

20th September
9 JN. Charpin Grant for XA recovery
2017

12th December
10 S. Vinod Altered the user creation dbscript
2017

Change correct oracle DB creation screen prints using

11 23rd Jan 2019 Mkumar
custom database option.

12 21st March 2019 Praveen D R19 AMR Review

13 9th March 2019 R. Vincent Add JSON documentation

14 26th Mar 2020 Praveen D R20 AMR Review

Make use of PLSQL procedures instead of java stored

15 15th Sep 2020 M Kumar
functions.

16 12th Apr 2021 Vikas R21 AMR Review

17 25th March 2022 Puja R22 AMR Review

18 6th April 2023 M.Kumar R23 AMR Review

19 7th March 2024 S Aparajitha R24 AMR Review

2 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install
Copyright

Copyright © Temenos Headquarters SA 2009-2024.

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 Oracle Install

Table of Contents
Document History................................................................................................................... 2
Copyright................................................................................................................................ 3
Errata and Comments............................................................................................................. 3
Introduction............................................................................................................................. 5
Install Oracle........................................................................................................................... 5
Create a Database Instance.................................................................................................... 5
Create Tablespace and a User............................................................................................... 13
Load the necessary PLSQL functions.....................................................................................16
Storing JSON.......................................................................................................................... 17
Procedure for applying JSON fix............................................................................................... 17
Appendix: Oracle performance parameters...........................................................................18

4 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install
Introduction
This document will show all steps to configure a database, ready to be used by T24 with TAFJ.
Currently TAFJ only supports Oracles Version 11 and up.
This procedure is for Windows® platform. For all other OS please refer to the official product
documentation.

Install Oracle
Most steps aren’t shown. Please follow the official Oracle document setup.
For 12c, see http://docs.oracle.com/cd/E16655_01/nav/portal_11.htm

Create a Database Instance

 Launch the Database configuration assistant.

Or
 Execute %ORACLE_HOME%\BIN\dbca.bat

5 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install

 Select Create a Database...

 Press Next…
 Choose Advanced mode.

 Choose custom Database.

 Next

6 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install

 Set a Global Database name. You will have to report this name in the property file of
your project to the key temn.tafj.jdbc.url
 uncheck configure Enterprise Manager

7 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install

 Press Next…
 Enter the Administrative password for the DB.
(This is NOT (!) the password you will set in the properties file...)

 Press Next…
 Uncheck Flash recovery.

8 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install

 Press Next…
 Choose Oracle JVM

 Press Next…
 IMPORTANT! Specify AL32UTF8 in the Character Sets tab...

9 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install

 Press Next…

 Press Next…

10 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install

 Press Finish…

 and let it run.

11 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install

 Press Exit… (The URL will be used as to connect to the database monitor.)

Press Close…

You can check your installation:

Browse the URL: https://localhost:5500/em
(The port number will be the one mentioned in the Database configuration Assistant)

You can check your installation:

12 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install
Username: SYS
Password: The password you gave before
Connect as SYSDBA

13 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install
Create Tablespace and a User

In the TAFJ installation <TAFJ_HOME> \dbscripts\oracle, you will find 2 SQL scripts:
 createtablespace.sql
 createuser.sql

You will need to edit this script to reflect the correct data.

In the createtablespace_oracle.sql, you will need to change 2 values (in Green):

1. The tablespace name: <TableSpace_Name> should be oracle SID
2. The full path to the file holding the data: '<TableSpace_FullPathName>.dbf'

CREATE SMALLFILE TABLESPACE <TableSpace_Name> DATAFILE

'<TableSpace_FullPathName>.dbf' SIZE 7G AUTOEXTEND ON NEXT 100M MAXSIZE
UNLIMITED LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT AUTO;

i.e:
CREATE SMALLFILE TABLESPACE T24DB DATAFILE 'C:\product\database\
oracle\oradata\T24DB.dbf' SIZE 7G AUTOEXTEND ON NEXT 100M MAXSIZE
UNLIMITED LOGGING EXTENT MANAGEMENT LOCAL SEGMENT SPACE MANAGEMENT
AUTO;

In the createuser_oracle.sql, you will need to change the username and the password and the
tablespace name (in Green):
The tablespace Name: <TableSpace_Name>
The DB Username: <DBUser>
The DB Password: <DBPassword>

CREATE USER <DBUser> PROFILE "DEFAULT" IDENTIFIED BY <DBPassword> DEFAULT

TABLESPACE “<TableSpace_Name>” TEMPORARY TABLESPACE "TEMP" ACCOUNT UNLOCK;
GRANT "CONNECT" TO <DBUser>;
GRANT "RESOURCE" TO <DBUser>;
grant query rewrite to <DBUser>;
grant create synonym to <DBUser>;
grant drop any procedure to <DBUser>;
grant create any table to <DBUser>;
grant select any table to <DBUser>;
grant update any table to <DBUser>;
grant insert any table to <DBUser>;
grant delete any table to <DBUser>;
grant drop any table to <DBUser>;

14 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install
grant create any index to <DBUser>;
grant alter any index to <DBUser>;
grant drop any index to <DBUser>;
grant create any view to <DBUser>;
grant drop any view to <DBUser>;
grant create any directory to <DBUser>;
grant select_catalog_role to <DBUser>;
grant xdbadmin to <DBUser>;
grant execute on dbms_lock to <DBUser>;
grant unlimited tablespace to <DBUser>;
grant select on sys.dba_pending_transactions TO <DBUser>;
grant select on sys.pending_trans$ TO <DBUser>;
grant select on sys.dba_2pc_pending TO <DBUser>;
grant execute on sys.dbms_xa TO <DBUser>;

i.e:
CREATE USER tafj PROFILE "DEFAULT" IDENTIFIED BY secret DEFAULT TABLESPACE
"T24BD" TEMPORARY TABLESPACE "TEMP" ACCOUNT UNLOCK;
GRANT "CONNECT" TO tafj;
GRANT "RESOURCE" TO tafj;
grant query rewrite to tafj;
grant create synonym to tafj;
grant drop any procedure to tafj;
grant create any table to tafj;
grant select any table to tafj;
grant update any table to tafj;
grant insert any table to tafj;
grant delete any table to tafj;
grant drop any table to tafj;
grant create any index to tafj;
grant alter any index to tafj;
grant drop any index to tafj;
grant create any view to tafj;
grant drop any view to tafj;
grant create any directory to tafj;
grant select_catalog_role to tafj;
grant xdbadmin to tafj;
grant execute on dbms_lock to tafj;
grant unlimited tablespace to tafj;
grant select on sys.dba_pending_transactions to tafj;

15 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install
grant select on sys.pending_trans$ to tafj;
grant select on sys.dba_2pc_pending to tafj;
grant execute on sys.dbms_xa to tafj;

Once these values have been changed, launch a console and from <TAFJ_HOME> \dbscripts\
oracle, type:

>sqlplus "/ as SYSDBA"

Then, type:

@createtablespace_oracle.sql

And

@createuser_oracle.sql

You will have to give the full path to these scripts if there are not in the current directory. These
scripts can take several minutes to be executed. Then, exit from sqlplus

exit

16 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install
Load the necessary PLSQL functions.

Run the script provided under TAFJ_HOME/dbscripts/oracle folder (oracle_plsql_functions.sql )

from inside the sql prompt.

>sqlplus <DBUser>

And type

@oracle_plsql_functions.sql

This should create your PLSql functions necessary for the transact to work properly.
Then, exit from sqlplus

exit

Once this is finished you should be able to run a DBImport for oracle. Don’t forget to copy the
ORACLE drivers from <TAFJ_HOME>/dbdrivers to <TAFJ_HOME>/ext. The properties that go
in the TAFJ properties file look like this:
temn.tafj.jdbc.url = jdbc:oracle:thin:@localhost:1521:T24DB
temn.tafj.jdbc.driver = oracle.jdbc.driver.OracleDriver
temn.tafj.jdbc.username = tafj
temn.tafj.jdbc.password = secret

17 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install
Storing JSON
Oracle supports storing and querying JSON, and TAFJ now supports storing it in Blob columns.
To import your data in JSON format:
1) Put T24’s AllRecords.jar into <TAFJ_HOME>/ext (this jar stores the metadata for JSON
representation of different tables and is needed by TAFJ)

2) Run a DBImport and select JSON as the data type.

JSON tables are created with a constraint to ensure it is valid JSON. An example CREATE TABLE
statement follows.
CREATE TABLE <TableName> (RECID VARCHAR2(255) NOT NULL PRIMARY KEY, XMLRECORD
BLOB CONSTRAINT <TableName>_json CHECK (XMLRECORD IS JSON)) LOB (XMLRECORD)
STORE AS (CACHE)”.
During the DBImport, JSON views will be created with a json_table for single attribute columns.
Multi-value columns will be formed using json_exists function dynamically. Putting multi-value
columns inside a json_table creates an unwanted Cartesian product.
JSON columns can be promoted and indexed. Please see the Oracle documentation.
Note that Oracle has a bug with prepared statements with version 12.2.0.1 that
requires a patch. To get around this bug, one can set the property
temn.tafj.jdbc.use.ps.json.oracle.fix=true in tafj.properties (default is false as
applying the patch is better)

Procedure for applying JSON fix.

Apply Oracle patch 28662603 and 25028996.
1. Download the patches from support.oracle.com and extract the contents of the patch on
Oracle Server. Ensure that the ORACLE_HOME is set to the correct path and there are no
processes running in the ORACLE_HOME (database or oracle listener)
Note: Before applying the opatch, download the latest version for opatch from the following
Oracle Metalink Note: 6880880 (p6880880_122010_Linux-x86-64.zip) or else you will get errors
apply $ORACLE_HOME/OPatch/opatch lsinventory or $ORACLE_HOME/OPatch/opatch apply
Reference: https://support.oracle.com/knowledge/Oracle%20Database%20Products/
274526_1.html
2. After downloading the OPatch and copy the p6880880_122010_Linux-x86-64.zip file in
$ORACLE_HOME. Rename the current OPatch to OPatch_old and extract the contents of
p6880880_122010_Linux-x86-64.zip

To check current inventory for ORACLE_HOME

$ORACLE_HOME/OPatch/opatch lsinventory
1 ) Navigate to 28662603
a. cd 28662603
b. $ORACLE_HOME/OPatch/opatch apply
2) Navigate to 25028996
a. cd 25028996
b. $ORACLE_HOME/OPatch/opatch apply
Check the applied patches running.
$ORACLE_HOME/OPatch/opatch lsinventory

18 Temenos Application Framework Java – (TAFJ)

TAFJ Oracle Install

Appendix: Oracle performance parameters

When using INSERT/UPDATE instead of MERGE for TAFJ-TRANSACT, the following is the
recommendation from Oracle to improve the performance with respect to primary key violation
errors.
# Use the MERGE statement instead of UPDATE/INSERT for XML Schema
#
temn.tafj.jdbc.write.use.merge= false

# Use the MERGE statement instead of UPDATE/INSERT for NO XML Schema and NO XML Schema work
#
temn.tafj.jdbc.write.use.merge.no.xml=false

When an INSERT is executed, it will return an ORA-00001 error saying that the primary key already exists,
and that error message include the table owner and name; to get that information, we internally execute a
data dictionary query, namely 2jfqzrxhrm93b. Unfortunately, we don't cache the result (which is the table
owner and name), so we re-execute and also re-parse this query for every ORA-00001. There is a
workaround for the mentioned problem which can be put in place if the application does not need to
actually get the table owner/name, but just needs to get the fact that there is a duplication, i.e. ORA-00001.

ORA-00001 : unique constraint (BENGSIG.SYS_C006057) violated

ORA-00001: unique constraint (UNKNOWN.obj#=63917) violated

The way to change this is to set the parameter "_suppress_identifiers_on_dupkey" to true; this
can be done online without database/instance bounce.

19 Temenos Application Framework Java – (TAFJ)