Stack 7 Azure – JBoss

Customer Runbook 1.0 August 2018

All post R18 AMR releases up to and including R19 AMR

 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

Contents
1 About this runbook 4
1.1 Scope 4
1.1.1 Stacks table 5
1.2 Audience 5
1.3 Skills and knowledge 6
1.4 Legal 6
1.5 History 7
2 Introduction 8
2.1 Architecture diagram 8
3 Prerequisites and assumptions 9
3.1 Assumptions 9
3.2 Prerequisites 9
3.2.1 Third party software 9
3.2.2 Temenos artefacts 9
4 Before you start 11
4.1 Check disk drive space 11
4.2 Check OS details 12
4.3 Folder structure 12
4.4 Environment variables 13
4.5 Installing the Java Development Kit (JDK) 13
5 Installing T24 and TAFJ 15
5.1 Preparing the installation files 15
5.2 Installing T24 15
5.3 Installing TAFJ 15
5.4 Deploying the database driver 17
5.5 Verifying the installation of TAFJ 17
6 Configuring the T24 database 20
6.1 Prerequisites 20
6.2 Loading the TAFJ functions 20
6.3 Importing T24 DB into the Azure SQL DB 24
7 Configuring TAFJ 26
8 Sanity check 28
8.1 Accessing classic 28

2
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

8.2 DBTools 29
9 Installing and configuring JBoss EAP 7.1 31
9.1 Increasing the JVM memory 31
9.1 Deploying MSSQL database driver module 32
9.2 Configuring TAFJ modules 33
9.3 Configuring T24 modules 34
9.3.1 Generating a T24 module 35
9.4 Configuring T24/TAFJ in the application server 36
10 Configuring UXPBrowser 39
10.1 Modifying the browser-iris 39
11 Deployment 41
11.1 Deploying TAFJEE and TAFJ spooler plugins 41
11.2 Deploying BrowserWeb 41
11.3 Deploying Browser and browser-iris 41
11.4 Deploying Authenticator 42
12 Sanity check - post deployment 43
12.1 Starting the application server 43
12.2 Accessing TAFJEE 44
12.3 Accessing BrowserWeb 45
12.4 Accessing UXPBrowser 46

3
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

1 About this runbook

The R19 Stack 7 Cloud Runbook runbook describes how to configure TAFJ-T24 on a JBoss application
server. It also shows you how to deploy BrowserWeb, UXP Browser and access T24 using those browsers.

This runbook does not tell you how to install third-party software. For more information, see the
relevant vendor's documentation.

1 .1 Scope
This runbook covers:

l Installing TAFJ.

l Installing T24.

l Loading the TAFJ SQL server assembly and the CSharpload functions into the Azure SQL database.

l Installing and Configuring JBoss 7.1 EAP.

l Deploying the T24 artefacts and a detailed focus on configuring and deploying the UXP browser.

4
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

1.1.1 Stacks table

1 .2 Audience
This document is aimed at those who are interested and involved in deploying TAFJ-T24 on a JBoss
application server.

5
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

1 .3 Skills and knowledge

To use this runbook, you need some understanding of T24, TAFJ, JBoss and MS SQL server.

1 .4 Legal
© Copyright 2018 Temenos Headquarters SA. All rights reserved.

TM
The information in this guide relates to TEMENOS information, products and services. It also includes
information, data and keys developed by other parties.

While all reasonable attempts have been made to ensure accuracy, currency and reliability of the content in
this guide, all information is provided "as is".

There is no guarantee as to the completeness, accuracy, timeliness or the results obtained from the use of this
information. No warranty of any kind is given, expressed or implied, including, but not limited to warranties
of performance, merchantability and fitness for a particular purpose.

In no event will TEMENOS be liable to you or anyone else for any decision made or action taken in reliance
on the information in this document or for any consequential, special or similar damages, even if advised of
the possibility of such damages.

TEMENOS does not accept any responsibility for any errors or omissions, or for the results obtained from the
use of this information. Information obtained from this guide should not be used as a substitute for
consultation with TEMENOS.

References and links to external sites and documentation are provided as a service. TEMENOS is not
endorsing any provider of products or services by facilitating access to these sites or documentation from this
guide.

The content of this guide is protected by copyright and trademark law. Apart from fair dealing for the
purposes of private study, research, criticism or review, as permitted under copyright law, no part may be
reproduced or reused for any commercial purposes whatsoever without the prior written permission of the
copyright owner. All trademarks, logos and other marks shown in this guide are the property of their
respective owners.

6
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

1 .5 History
Version Date Description

1.0 August 2018 First release

7
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

2 Introduction
This runbook helps you set up a Dev/Test Environment for T24/TAFJ on Azure stack. It helps you install and
configure TAFJ, T24 and JBoss to access a T24 browser. In this exercise, a 2-tier architecture was followed – an
application server and a database server.

The Application tier contains the application server with TAFJ/T24. In this exercise, we used JBoss EAP
(version 7.1.0). The Database tier contains the database that stores T24 data. In this exercise, we used an SQL
database.

2 .1 Architecture diagram

8
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

3 Prerequisites and assumptions

The following chapter describes the technical prerequisites and assumptions for installing and configuring
Stack 7.

3 .1 Assumptions
When we wrote this guide, R19 was not yet available from distribution. We upgraded an R18 environment to
R19 (201805 first release of R19) using TEMP.RELEASE from distribution.

3 .2 Prerequisites
Before you start to install and configure the stack, you need to have installed all third party software and
copied all Temenos artefacts from Distribution.

3.2.1 Third party software

Software Version

JDK 1.8

JBoss EAP 7.1.x

Azure SQL DB Latest

SQL Server Management Studio -

3.2.2 Tem enos artefacts

Artefact File Comments

MSSQL.bak MBR19.bak Contains DB

Contains the bnk directory that holds

T24 MB.R19.TAFJR19.bnk.tar
the T24 libraries.

Contains the TAFJ runtime .jar file,

TAFJ TAFJ.DEV.201805.x.tar TAFJ patch script and TAFJ setup
script.

9
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

Artefact File Comments

T24 Browser BrowserWeb.war Old browser components.

UXP Browser Browser.war New browser components.

browser-iris.war

Authenticator.war

UXP-Browser.R19.zip

10
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

4 Before you start

Before you start installing and configuring the stack, you need to check that your technical infrastructure has
been set up properly.

This runbook does not tell you how to install third-party software. For more information, see the
relevant vendor's documentation.

4 .1 Check disk drive space

To check if the required storage is available:

1. Right click the required drive.

2. Click properties.

11
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

4 .2 Check OS details
To check the required OS specification:

1. Go to Control panel.

2. Click System to view the details of your system.

4 .3 Folder structure
Create a folder structure, as shown below, with Temenos as the parent directory.

The following table describes the folder structure.

12
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

Folder Description

The 3rdParty folder contains all installed

3rdParty 3rdParty software, such as JDK 1.8, JBoss and
so on.

The Install folder contains all installers to

Install
setup TAFJ-T24.

The T24 folder contains all T24 related

T24
libraries.

The TAFJ folder contains TAFJ runtime

TAFJ
libraries.

The UXPBrowser folder contains UXP browser

UXPBrowser artefacts. (New Browser).It contains subfolders
manual and generated.

4 .4 Environment variables
After creating the folders, you need to set the following environment variables:

l TEMENOS_HOME= C:\Temenos

l T24_HOME= %TEMENOS_HOME%\T24

l TAFJ_HOME= %TEMENOS_HOME%\TAFJ

l UXPBROWSER= %TEMENOS_HOME%\UXPBrowser

4 .5 Installing the Java Development Kit (JDK)

To install the Java Development Kit (JDK):

1. Download the Java JDK installer:

http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

2. Copy the installer to %TEMENOS_HOME%\Install folder.

13
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

3. Run the installer (.exe file) and provide the path to your Java installation as %TEMENOS_
HOME%\3rdParty\Java. The folder jdk1.8.0_171 is created.

4. Set the environment variable JAVA_HOME with the path JAVA_HOME=%TEMENOS_HOME%\3rdParty\Java\

jdk1.8.0_171.

5. Append %JAVA_HOME%\bin to the environment variable PATH.

6. Check that the required JDK is installed by typing java -version in the command prompt.

14
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

5 Installing T24 and TAFJ

This chapter describes how to install T24 and TAFJ.

5 .1 Preparing the installation files

To prepare the installation files:

1. Copy the T24 artefacts (MB.R19.TAFJR19.bnk.tar) from distribution to %TEMENOS_

HOME%\Install\t24inst folder.

2. Copy the TAFJ artefacts (TAFJ.DEV.201805.x.tar) from distribution to %TEMENOS_

HOME%\Install\tafjinst folder.

5 .2 Installing T24
To install T24:

1. Go to the %TEMENOS_HOME%\Install \t24inst folder.

2. Extract the tar file to %T24_HOME%. The file is extracted as a bnk folder.

5 .3 Installing TAFJ

Check that JDK 1.8 has been installed and that JAVA_HOME has been set to the correct path. These
are the only prerequisites for TAFJ installation.

To install TAFJ:

1. Go to the %TEMENOS_HOME%\Install\tafjinst folder.

2. Check that both Setup_TAFJ.DEV.201805.x.bat and TAFJ.DEV.201805.x.jar have execute

permissions.

3. Open command prompt from tafjinst folder.

15
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

4. Execute Setup_TAFJ.DEV.201805.x.bat. During the installation, change the default installation

directory to the path of %TAFJ_HOME%, when prompted for the install directory.

5. If conf directory does not exist, enter y to create it.

After the conf directory has been created, TAFJ is installed.

16
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

5 .4 Deploying the database driver

After installing TAFJ, you need to establish a connection between TAFJ and the database by deploying the
relevant database driver.

To deploy the database driver:

1. Since we're using the SQL database, copy the sql driver in %TAFJ_HOME%\dbdrivers\sqljdbc_
6.0\enu\jre8.

2. Paste the jar file in %TAFJ_HOME%\ext folder.

5 .5 Verifying the installation of TAFJ

To verify that TAFJ has installed successfully:

1. Open the command prompt from %TAFJ_HOME%\bin.

2. Run the command tDiag. The command will show you:

17
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

l Where TAFJ_HOME is set.

l The version of the JDK.

l The version of TAFJ.

l The default project and details of all the projects set in %TAFJ_HOME%\conf.

3. Run the command tVersion which shows the installed TAFJ version.

18
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

19
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

6 Configuring the T24 database

This chapter shows you how to set up the T24 database on Azure SQL database. You'll need to use SQL
Server Management Studio (SSMS) to complete the tasks in this chapter.

6 .1 Prerequisites
Before you set up the T24 database, you need to have created your SQL database on Azure. You should also
have the following items to hand:

l The connection URL.

l The username and password.

l The whitelisted TAFJ SQL CLR script.

Note that:

l Some SQL commands can't be run on the SQL cloud database. Loading the TAFJ SQL Server assembly
on Azure DB is therefore very different from loading it on a standalone SQL Server Host.

l You need to arrange the whitelisting of your TAFJSQLServer assembly with Microsoft. Microsoft will
provide you with a script for installing/creating the TAFJSQL CLR on the SQL database.

6 .2 Loading the TAFJ functions

To load the TAFJ functions:

1. When you have the connection details, log into the Azure database server from SQL Server
Management Studio (SSMS).

2. In this example, the created SQL database on Azure is R18 with collation set to Latin1_General_BIN2.
Run the below queries.

20
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

21
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

3. Move to %TAFJ_HOME%\dbscripts\ms-sql folder.

4. Open csharpload file.

5. Update the first line with your database name (R18).

6. In the CREATE ASSEMBLY statement set the path of whitelisted CLR script.

7. Copy the CREATE ASSEMBLY and all the CREATE FUNCTION statements and execute it in the SSMS.

22
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

8. View the created functions by using the following select statement.

SELECT ROUTINE_NAME FROM INFORMATION_SCHEMA.ROUTINES

WHERE ROUTINE_TYPE = 'FUNCTION' ORDER BY ROUTINE_NAME

23
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

6 .3 Importing T24 DB into the Azure SQL DB

This section assumes that you have already have created a local environment, using the database restored
from the bak file received from distribution.

This local environment is used as a datasource to populate your T24 Azure SQL database. You can use
DBImport to copy the database over as usual.

To import the T24 database into the Azure SQL database:

1. Move to the %TAFJ_HOME%\conf folder.

2. Open TAFJDBImport.default.

3. Set the import type to DATABASE.

4. Set the URL, driver, username and password of the Azure SQL database where the data will be
imported to (target database).

24
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

5. Set the URL, driver, username and password from the local environment where the bak file has been
restored which forms the source database.

6. Open command prompt from %TAFJ_HOME%\bin.

7. Run DBImport –GUI.

8. Click Next through the rest of the wizard and then click Start. It takes a few hours for the DBImport to
complete.

25
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

7 Configuring TAFJ
This chapter describes how to configure tafj.properties.

TAFJ does not use environment variables. Instead it uses a properties file (.properties) for its internal
configuration. Property files are stored in %TAFJ_HOME%\conf directory.

To configure TAFJ properties:

1. Go to %TAFJ_HOME%\conf folder.

2. Open the tafj.properties file.

3. Check that tafj.home points to the correct location.

4. Ensure that temn.tafj.directory.precompile points to T24 libraries.

5. In the Database setup section, configure the database connection.

a. Copy the relevant code for url and driver.

b. Provide the relevant driver information in temn.tafj.jdbc.driver.

26
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

c. Set the user name and password.

6. Set the value of temn.tafj.jdbc.write.use.merge and temn.tafj.jdbc.write.use.merge.no.xml

to false.

27
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

8 Sanity check
This chapter describes how to verify T24 after TAFJ and the database connection has been configured for
standalone mode.

8 .1 Accessing classic
To access T24 through classic mode:

1. Open command prompt from %TAFJ_HOME%\bin.

2. Execute tRun EX.

3. Login using a valid T24 username and password.

28
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

4. After logging into classic, try accessing T24 applications.

8 .2 DBTools
TAFJ-DBTools can be accessed only with authenticated users. A username and password has to be passed as
parameters to DBTools. To access DBTools, you need to create a user using a file tUserMgnt.bat. DBTools
provides access to SQL / JQL / OFS statements.

To access DBTools:

1. Open command prompt from %TAFJ_HOME%\bin.

2. Create a user.

3. The user is created. Login to DBTools using these credentials.

After logging in to DBtools, the database name, database username and IP address are displayed in the

29
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

bottom left of the screen.

30
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

9 Installing and configuring JBoss EAP 7.1

This chapter describes how to install and configure JBoss modules for TAFJ, T24 and database.

To install JBoss EAP 7.1

1. Download jboss-eap-7.1 from the below link. The filename is jboss-eap-7.1.x.zip.

https://developers.redhat.com/products/eap/download/

2. Copy the .zip file to %TEMENOS_HOME%\Install folder.

3. Extract the jboss-eap-7.1.x.zip file to %TEMENOS_HOME%\3rdParty\AS.

4. Set an environment variable.

JBOSS_HOME= %TEMENOS_HOME%\3rdParty\AS\ jboss-eap-7.1

5. Append %JBOSS_HOME%\bin to the environment variable PATH.

9 .1 Increasing the JVM memory

To increase the JVM memory:

1. Move to %JBOSS_HOME%\bin.

2. Open standalone.conf.bat file.

3. Add the below line, to set tafj home and file encoding.

4. Increase the JVM memory as shown below.

31
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

9 .1 Deploying MSSQL database driver module

To enable the SQL databsae to connect to JBoss, the database jar and module has to be present in the JBoss
modules.

To deploy the MSSQL database driver module:

1. Move to the modules folder in JBoss (%JBOSS_HOME%\modules).

2. Create the following directory structure under modules folder.

mkdir com\microsoft\sqlserver\jdbc\main

3. Copy module.xml to main folder.

copy %TAFJ_HOME%\appserver\jboss\jboss7eap\modules\com\microsoft\sqlserver\main\module.xml
%JBOSS_HOME%\modules\com\microsoft\sqlserver\jdbc\main

4. Copy the corresponding database driver to main folder.

copy %TAFJ_HOME%\dbdrivers\sqljdbc_6.0\enu\jre8\sqljdbc42 .jar

%JBOSS_HOME%\modules\com\microsoft\sqlserver\jdbc\main

The following screenshot shows the copied file module.xml and the database driver sqljdbc42.jar.

5. Open module.xml to check the jar name of driver and add .jdbc in module name. The module name
should be same as folder path for that module. As we have jdbc folder under the folder path, add

32
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

.jdbc in the module name.

9 .2 Configuring TAFJ modules
To configure the TAFJ modules:

1. Move to the com folder in JBoss (%JBOSS_HOME%\modules\com).

2. Create the following directory structure under com folder.

mkdir temenos\tafj\main

3. Copy the TAFJ module from TAFJ to the JBoss modules folder.

copy %TAFJ_HOME%\appserver\jboss\jboss7eap\modules\com\temenos\tafj\main \module.xml

%JBOSS_HOME%\modules\com\temenos\tafj\main

4. Open command prompt from %JBOSS_HOME%\modules\com\temenos\tafj\main.

5. Create a symbolic link to %TAFJ_HOME%\lib and %TAFJ_HOME%\ext.

mklink /D lib %TAFJ_HOME%\lib

mklink /D ext %TAFJ_HOME%\ext

The following screenshot shows the symbolic links that were created and the copied file module.xml.

33
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

6. Open the TAFJ module.xml, uncomment the sql module name and add .jdbc to the module name.
Check whether the dependency module for t24 is present.

9 .3 Configuring T24 modules

To configure T24 modules:

1. Move to the temenos folder in JBoss (%JBOSS_HOME%\modules\com\temenos).

2. Create the following directory structure under the temenos folder.

mkdir t24\main

3. Open command prompt from %JBOSS_HOME%\modules\com\temenos\t24\main.

4. Create a symbolic link to %T24_HOME%\bnk\t24lib.

mklink /D lib %T24_HOME%\bnk\t24lib

34
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

9.3.1 G enerating a T24 m odule

T24 contains many libraries, which makes adding jars into module.xml a lengthy process. To make it easier,
TAFJ provides a utility JBossTools in %TAFJ_HOME%\bin to generate module.xml.

Syntax:

JBossTools module_name path_to_jars dest [root_prefix] [-tafjdep]

Option Description

module_name Name of the JBoss module.

path_to_jars The list of folders that you want to parse.

The path to the folder where the

dest
module.xml will be generated.

Name of the link if module.xml is at the

root_prefix
same level as the link.

Option to add TAFJ module dependencies

-tafjdep
in the dependencies section.

To generate a T24 module:

1. Move to %TAFJ_HOME%\bin.

2. Create t24 module.xml file.

JBossTools com.temenos.t24 %T24_HOME%\bnk\t24lib

%JBOSS_HOME%\modules\com\temenos\t24\main lib –tafjdep

The following screenshot shows the created symbolic link and the module.xml.

35
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

3. Open the created module.xml from %JBOSS_HOME%\modules\com\temenos\t24\main and check if

dependency module for tafj is present. If it isn't present, add the module name.

9 .4 Configuring T24/TAFJ in the application server

To configure T24/TAFJ in the application server:

1. Move to %JBOSS_HOME%\standalone\configuration.

2. Copy the standalone-full.xml and paste it in the same folder.

3. Rename the copied file as T24.xml.

4. Go to %TAFJ_HOME%\appserver\jboss\jboss7eap\jboss-cli.

5. Open tafj.properties.

6. Provide TAFJ_HOME, DB_URL, DB_DRIVER, DB_USER, DB_PWD parameters.

36
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

7. Open T24Setup.cli.

8. Under drivers section, uncomment the SQL driver parameters.

9. Move to %JBOSS_HOME%\bin.

10. Open jboss-cli.xml file.

11. Set the resolve-parameter-values and validate-operation-requests to true.

12. Start JBoss using this command.

37
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

%JBOSS_HOME%\bin\standalone.bat --server-config=T24.xml –b 0.0.0.0

13. Run jboss-cli command.

%JBOSS_HOME%\bin\jboss-cli.bat --connect
--file=C:\Temenos\TAFJ\appserver\jboss\jboss7eap\jboss-cli\T24Setup.cli
--properties=C:\Temenos\TAFJ\appserver\jboss\jboss7eap\jboss-cli\tafj.properties

The following screenshot shows the successful execution of jboss-cli command.

14. The scripts add the following to the standalone configuration file (T24.xml):

l System properties

l Drivers

l Datasources

l Global modules (TAFJ and T24)

l JMS Pools

l JMS Queues

38
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

10 Configuring UXPBrowser
To configure UXPBrowser:

1. Move the UXPBrowser.zip file from distribution to %TEMENOS_HOME%\Install folder.

2. Unzip the UXPBrowser.zip to %TEMENOS_HOME%\UXPBrowser folder.

3. The extracted UXPBrowser file has generated.zip, which needs to be extracted to get two more sub-
folders: manual and generated.

4. Set up environment variable for GENERATED and MANUAL.

l GENERATED= %UXPBROWSER%\generated

l MANUAL= %UXPBROWSER%\manual

5. Rename Browser-18.x.x.war,browser-iris-18.x.x.war and Authenticator.18.x.x.war to

Browser.war, browser-iris.war and Authenticator.war.

The following screenshot shows the files under UXPBrowser directory.

1 0 .1 Modifying the browser-iris

To modify browser-iris:

1. Move to %UXPBROWSER%.

2. Open brower-iris.war\WEB-INF\SSOAPI.properties.

3. Set BASIC.AUTH.MODE to false.

39
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

4. Open browser-iris.war\WEB-INF\web.xml.

5. Comment out the <filter-mapping> section.

40
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

11 Deployment
This chapter describes how to deploy TAFJEE, BrowserWeb, browser-iris and Browser.war files to access
the BrowserWeb and UXP Browser.

1 1 .1 Deploying TAFJEE and TAFJ spooler plugins

To deploy TAFJEE and TAFJ spooler plugins:

1. Move to %TAFJ_HOME%\appserver\jboss\jboss7eap.

2. Copy the TAFJJEE_EAR.ear to %JBOSS_HOME%\standalone\deployments folder.

3. Move to %TAFJ_HOME%\appserver.

4. Copy the TAFJSpoolerPlugins.rar to %JBOSS_HOME%\standalone\deployments folder.

TAFJJEE_EAR.ear fails to deploy with an error of PrintHold is missing if the

TAFJSpoolerPlugins.rar is not present.

1 1 .2 Deploying BrowserWeb
To deploy BrowserWeb:

1. Get the BrowserWeb version specific to TAFJ-T24 from distribution.

2. Copy the BrowserWeb.tar file to %TEMENOS_HOME%\Install folder.

3. Extract the file in the Install folder.

4. Copy BrowserWeb.war to %JBOSS_HOME%\standalone\deployments folder.

1 1 .3 Deploying Browser and browser-iris

To deploy Browser and browser-iris:

41
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

1. Copy the browser-iris.war from UXPBrowser folder to %JBOSS_HOME%\standalone\deployments

folder.

2. Copy the Browser.war from UXPBrowser folder to %JBOSS_HOME%\standalone\deployments folder.

1 1 .4 Deploying Authenticator
Authenticator.war file is required for authentication in UXPBrowser. Without this file, you won't be able to
login to UXPBrowser.

To deploy Authenticator.war, copy the Authenticator.war from UXPBrowser folder to %JBOSS_

HOME%\standalone\deployments folder.

The following screenshot shows the copied files under deployments folder.

42
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

12 Sanity check - post deployment

1 2 .1 Starting the application server
The standalone.bat script in %JBOSS_HOME%\bin is used to start JBoss. It may require several parameters,
depending on what's being deployed.

If UXP browser is not being deployed the following start command parameters are sufficient (for
BrowserWeb).

standalone.bat --server-config=T24.xml –b 0.0.0.0

To access UXPBrowser use the following command:

%JBOSS_HOME%\bin\standalone.bat --server-config=T24.xml
-Djboss.http.port=9089 -Djboss.node.name=node1 -b 0.0.0.0
-Djboss.as.management.blocking.timeout=1200
-Dcom.edgeipk.librarypath=%MANUAL%/edge,%GENERATED%/edge
-DedgeSystemPropertyUpdaters=com.temenos.connect.system.BRPRuntimeProperties
-Doverride.IRIS_MAP=%MANUAL%/edge/data/HrefComponentManualMap.properties,
%GENERATED%/edge/data/HrefComponentMap.properties
-Dcom.temenos.interaction.config.dir=%GENERATED%/iris
-Doverride.SLANG_FOLDERS=%MANUAL%/edge/data/slang/manual,
%GENERATED%/edge/data/slang/generated,$$PROJECTHOME$/WEB-INF/data/slang/default
-Dcom.edgeipk.checkForUpdates=Y
-Doverride.ENABLE_COMMAND_LINE=Y
-Diris.cache.index.file=%TEMENOS_HOME%\workspace\BRP-models-gen\lastChange
-Diris.skip.validation=true
-Dorg.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH=true
-Dorg.apache.catalina.connector.CoyoteAdapter.ALLOW_BACKSLASH=true
-DRTP_REAPER_MEM_USED_PERCENT_ABORT=99
-Djava.awt.headless=true

After the server has started, go to JBoss deployments folder to see all the deployed artefacts.

43
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

1 2 .2 Accessing TAFJEE
Access TAFJJEE servlet using the URL: http://localhost:9089/TAFJEE

44
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

1 2 .3 Accessing BrowserWeb
To access BrowserWeb:

1. Go to the URL: http://localhost:9089/BrowserWeb

2. Login into T24 with a valid username and password.

45
 R 1 9 St a ck 7 C lo u d R u n b o o k 1 . 0

1 2 .4 Accessing UXPBrowser
To access UXPBrowser:

1. Go to the URL: http://localhost:9089/Browser

2. Login into T24 with a valid username and password.

46