Installation Guide

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.

© 2019 Temenos Headquarters SA - all rights reserved.

Installation Guide

Table of Contents
Document History 5
About this Guide 6
Who should use this guide? 6
Online Help 6
Licensing and Technical Support 6
Temenos UXP IDE and Enterprise Server 7
Developer 7
Language Editor 7
Deployer 7
Run Time Environment (RTE) 8
Enterprise Server 8
Supported Platforms 8
Supported Browsers 9
System Requirements 9
Temenos UXP IDE and Administrator 9
Enterprise Server 9
Temenos UXP Run Time Server 9
Java Runtime Environment (JRE) 10
Planning Your Installation 11
Project Roles 11
Developer 11
Deployer 11
User Manager 11
Temenos UXP Standard IDE 11
Enterprise Server 12
Supported Platforms 12
Installation 14
Before you start 14
Mac Installation 14
Enterprise 14
Upgrading from Previous Versions 14
Overview 14

Page| 2
Installation Guide

Start Installation 14
To start the Temenos UXP Install 15
Choose Install Set 18
Install Temenos UXP 18
Standard IDE 18
To Install the Developer & Deployer 18
Enterprise Server 21
To Install the Enterprise Server 21
Hybrid Server 23
To Install the Hybrid Server for Android 23
Hybrid Server Installation connection to Hybrid Master 24
Hybrid Post Installation Steps 25
Custom Install Set 26
Administrator 26
Obtain and Install Licence 26
Developer Licence 26
To obtain and install a valid developer licence 26
Enterprise Licence 26
Requirements 26
Requesting and Installing the Enterprise Server LIcence 27
Features 27
Using the Developer IDE 27
Run-time Licence 28
Set Up a Secure Connection 28
Server Setup 29
Developer Installation 29
Certificate Types 29
To Generate a self-signed certificate 29
Modify the server.xml 30
Using a self-signed certificate 31
To Mark Certificate as Trusted 31
Uninstall 32
To Uninstall Temenos UXP 32

Page| 3
Installation Guide

Troubleshooting the Installation 33

Cannot find InstallKey.txt 33
Cannot open the IDE - nothing appears to be happening 33
Cannot open the IDE – licence error message 33
Cannot connect to Temenos UXP Server on start-up 33
Unable to open Administrator, but able to open the IDE 33

Page| 4
Installation Guide

Document History

Author Version Date

Product 5.2 17/06/2013

5.3 14/05/2014

5.4 - 1321956 Enterprise licence 06/10/2015

11402653 - RTE 06/10/2015

1935859 - update supported platforms 07/12/2016

6.2 - update Java supported version 15/10/2018

Date Comments:

13/01/2015 1033256 - Mac Installation

13/07/2015 1404617 - support email change

Page| 5
Installation Guide

About this Guide

This guide provides procedures for installing Temenos UXP Standard IDE or Enterprise Server. Also included is a
description of the tools that make up product and information on how to plan your installation.

Who should use this guide?

This guide is intended for the system administrator or IT professional wishing to install Temenos UXP for use
either by a single user or in a multi-user environment. Familiarity with the overall network environment, port
usage, database environment, and web server software is especially beneficial.

Online Help
The online help provides a full reference guide for all the features of the tool and can be used in conjunction
with this guide. It is accessed via the Help item on the standard IDE toolbar or by clicking on the standard but-
ton bar. The contents provide a list of all the major sections within the help. The index provides an alphabetical
list of all the topics in the help, which is searchable. The search facility can be used to search for all topics related
to a keyword you have entered.

Licensing and Technical Support

Prior to starting any development work described in this guide, it is assumed that the Temenos UXP devel-
opment tool has been set up correctly for your environment. Product installation, setup and registration are
described in the Installation Guide.
For technical support, please use the Temenos Customer Support Portal at:
https://www.temenos.com/en/
For licence requests, please contact:
landmcodes@temenos.com
For more information about Temenos Customer support, please see:
https://www.temenos.com/en/services-support/support/customer-support/

Page| 6
Installation Guide

Temenos UXP IDE and Enterprise Server

Temenos UXP is a powerful and flexible open presentation platform that eliminates the complex, costly and
time-consuming effort of developing business solutions. It provides a complete suite of tools to build, doc-
ument, deploy and maintain your solutions. The platform has two key elements: an Integrated Development
Environment which enables the rapid development, visualisation and maintenance of business solutions and a
Run Time Environment which renders a completed application for end users.
The following diagram represents the elements making up the Temenos UXP product:

Figure: Temenos UXP Platform.

Developer
The Temenos UXP Developer provides all the features needed to build and maintain your business solutions.
Business process, presentation and integration to 3rd party systems required for the complete solution are sep-
arated out and developed using specialist editors within the Developer. This means that:

l Business users can visualise application screens, process logic and validation.

l IT/technical users can integrate the developed solution to legacy and third-party systems.

l Marketing users or designers can add the look-and-feel of the business process.

Language Editor
The Language Editor is installed as part of the Standard IDE, but is a separate tool which is used to add or
amend the required values in Temenos UXP Language Maps. These allow you to dynamically change the text
used for any elements used within a solution e.g. questions, buttons, etc. Their main use is for presenting the
same solution in different languages, although they can also be used for alternative wording for different types
of users.

Deployer
The Temenos UXP Deployer is required to create deployments for an application server or for smart mobiles. It
allows you to:

Page| 7
Installation Guide

l Manage configuration settings for projects.

l Package libraries associated with a project into a release.

l Configure projects for portlets, as web services and for mobile devices.

l Build deployment packages that can be installed on a web application server or used offline.

Run Time Environment (RTE)

The RTE is the server platform that renders a completed application for end users. It is platform, database and
language independent. It requires an application container which can be any of the following:

l J2EE Application Server e.g. WebSphere, WebLogic or JBoss.

l Servlet platform e.g. Apache Tomcat.

This is not available as a separate installable component of the Temenos UXP Suite, but is embedded as part of
the deployment to the application server.

Enterprise Server
For a multi-developer environment, the Temenos UXP Server and Administrator provide release management
and version control facilities, including:

l Roles and permissions for developers to control access to projects.

l Release management.

l Version control to manage and track changes.

l Complete audit trail of changes.

Supported Platforms
Temenos UXP Standard IDE will run on the following platforms:

l Windows

l macOS

l Linux

Temenos UXP Enterprise Server will run on on the following platforms:

l Windows

l macOS

l Linux

l AIX

Page| 8
Installation Guide

Please see the Temenos UXP Support Matrix document, available on the Temenos Customer Support Portal, to
see what specific versions of the above operating systems are supported. Alternatively, contact Temenos Cus-
tomer Support.

Supported Browsers
Temenos UXP solutions are supported with the following browsers:

l Microsoft Internet Explorer

l Mozilla Firefox

l Safari (on Windows & MAC)

l Opera

l Chrome

Please see the release notes for the specific versions supported.

System Requirements
This section details the system requirements for running the Temenos UXP. These are minimum requirements
and will need to be increased depending on the size and complexity of the project being developed or the solu-
tion being executed.
Temenos UXP IDE and Administrator
l PC with Pentium 4 or above; or equivalent UNIX processor.

l 2GB of available RAM.

l 400MB of available hard disk space.

l 1024x768 or higher resolution monitor.

l A compatible browser with JavaScript enabled to execute Preview, Run and LiveDesigner functionalities.

Note: Note that at least 1GB of RAM should be allocated to Temenos UXP.

Enterprise Server
l Server with Xeon processor or above, or equivalent UNIX processor.

l 2GB of available RAM.

l 512MB of available hard disk space.

Temenos UXP Run Time Server
l Server with Xeon processor or above, or equivalent UNIX procssor.

l 2GB of available RAM.

Page| 9
Installation Guide

l 400MB of available hard disk space.

l Any compatible Java Application Server, or Servlet container (e.g. Tomcat) or IIS.
Java Runtime Environment (JRE)
The JRE is required for:

l The development tools.

l Enterprise Server.

l Runtime (within an application server).

Please see the Temenos UXP Support Matrix document, provided with the release or available on the Temenos
Customer Support Portal , to see the specific version of the JRE required. Alternatively, contact Temenos Cus-
tomer Support.

Page| 10
Installation Guide

Planning Your Installation

Before starting your installation, it is important that you decide the type of configuration you require and also
determine how to implement this configuration across your department structure and hardware.

Project Roles
An Temenos UXP development environment typically consists of a number of roles which together build and
manage each project. These roles can be assigned across one or more team members depending on the size
and structure of the team, and each role uses a different element of the Temenos UXP product to perform their
tasks, as described below:

Developer
Each project will require one or more Developers whose task is to build the solution specified by the end users.
Developers use the Temenos UXP IDE to define the data that must be captured, the business rules to apply to
the captured data and how to pass that data to/from 3rd party systems. The Temenos UXP IDE is separated
into specialist editors which allows you to allocate development tasks across different types of Developer; for
example, the Process Editor can be used by business analysts and end users to quickly define the overall busi-
ness process and the questions to be asked; IT Developers can use the Integration Editor to integrate the pro-
cess with 3rd party systems; and a designer or similar expert can use the Presentation Editor to style the look
and feel required.

Deployer
Once a solution is complete it must be deployed to an application server to make it available to end users. In a
large development environment, project deployment is typically allocated to a specific individual, separate to
the Developers building the solution. In smaller teams, a Developer might also deploy the completed applic-
ation.
The Deployer in your organisation would use the Temenos UXP Deployer component to package the elements
of an Temenos UXP solution together for deployment to an application server. As part of this exercise, the
Temenos UXP Deployer allows you to configure various project parameters so they are suitable to the des-
tination deployment, such as database logons, email addresses etc. The Temenos UXP Deployer also supports
Offline deployments, Portal deployments and Web Service deployments.

User Manager
In a multi-developer environment, where team members are working across a range of projects, it is important
to control who can access which projects and what actions they can perform. Access rights are typically alloc-
ated by a senior member in the team, such as a User Manager, and ensure team members don’t mistakenly
alter projects not in their domain.
A User Manager can use the Temenos UXP Administrator component to define groups of Temenos UXP users
and assign staff to each group. Groups can be generic, such as “Developer”, or specific to a project, such as
“Developer for Project ABC” and each group defines the access rights available to its members.

Temenos UXP Standard IDE

Standard IDE provides a single user development environment suitable for the development and maintenance
of applications by individual users. Each project is worked on independently by a single developer who fulfills all

Page| 11
Installation Guide

the roles within project development. All project files are held locally on the developer’s machine and, when a
project is complete, the developer would also be responsible for deploying the project from their own machine.
Note that the Run Time Environment is automatically included with the Deployer and packaged together with a
project when it is deployed.

Enterprise Server
The Enterprise Server provides an environment where multiple users are able to develop a single solution sim-
ultaneously, without conflict. The Temenos UXP IDE is used to develop the project; however the project file is
controlled centrally via the Enterprise Server. This allows management and tracking of changes to the project
file.
Only one Enterprise Server needs to be installed per organisation or development group. The person managing
the server will need to install the Administrator tool.
The following is an example Enterprise installation showing the various roles involved and the Temenos UXP
components designed to support each role:
When planning an Enterprise installation, you firstly need to decide who in your organization will perform the
above roles as this will determine what Temenos UXP components need to be installed on each machine.
Although described separately, you can of course allocate all administrative tasks to an individual if you wish.
Once you have defined the roles required, the Enterprise Server components should be installed on the appro-
priate machine, in the following order:

l Temenos UXP Server

l Administrator

l Deployer

l Developer

Supported Platforms
Temenos UXP Standard IDE will run on the following platforms:

l Windows

l macOS

l Linux

Temenos UXP Enterprise Server will run on on the following platforms:

l Windows

l macOS

l Linux

l AIX

Page| 12
Installation Guide

Please see the Temenos UXP Support Matrix document, available on the Temenos Customer Support Portal, to
see what specific versions of the above operating systems are supported. Alternatively, contact Temenos Cus-
tomer Support.

Page| 13
Installation Guide

Installation
Before you start
Before you start your installation of Temenos UXP, you need the following:

l Temenos UXP executable file either 32 or 64-bit

Mac Installation
If you are installing on a Mac you need to unzip the Temenos UXPMacOSXInstall.zip (e.g. /tmp) and double click
on Install.app. The installation process is then the same as for Windows.

Enterprise
If you are installing the Enterprise Server you will need:

l A networked environment with tested communications between a server and the required number of cli-
ent machines.

l An available Server port number (default port 9000)

l Administrator privileges for Windows.

l ROOT privileges for non-Windows OS.

Upgrading from Previous Versions

Uninstall all previous versions of Temenos UXP before installing the new version. Instructions for uninstalling
Temenos UXP are given in the Uninstall section later in this guide.

Overview

The above diagram shows the basic steps involved in installing all components of Temenos UXP. This guide will
explain each of the steps and any options available within them. Some configurations of the tool require addi-
tional information to be provided within the install process and this will be explained within the guide.

Start Installation
All configurations of Temenos UXP are supplied as a single install.exe file. The file is supplied as a 32-bit or 64-bit
version. Please make sure you have the correct version for your machine.

Page| 14
 Installation Guide

To start the Temenos UXP Install

1. Navigate to the appropriate install.exe file and double click it

The Install Anywhere install preparation screen will appear.

Figure: Install Anywhere Screen.

The first page of the install process is displayed.

Figure 6.2 UXP Installer » Introduction screen.

Page| 15
 Installation Guide

2. Click Next to continue.

3. The License Agreement screen asks you to read and accept the License agreement.

Figure: UXP Installer » License Agreement screen.

4. Click Next to continue.

The Choose Install Set screen allows you to select the Temenos UXP tools that you want to install. The Install
Set default selection is Standard IDE, so Developer, Deployer and Language Editor are automatically selected.

Page| 16
Installation Guide

Figure: UXP Installer » Choose Install Set screen.

There are a number of predefined install sets to choose from.

Figure: Choose what to Install screen.

Alternatively, you can select the elements you wish to install individually.

Page| 17
 Installation Guide

Choose Install Set

A summary of the Install Sets available is given below. For details of how to organize an Enterprise installation,
see Planning Your Installation. You may select the software you require individually by selecting the checkbox
beside it. This creates a Custom Install Set.

Install Set Description Software included

Standard IDE A development environment Developer

for both single or Enterprise
Deployer
users
Enterprise Server Store users and projects for an Server
Enterprise
Hybrid Server Required to develop hybrid Hybrid master and Android Slave
applications
Custom Allows release and user man- Developer
agement in an Enterprise envir-
Deployer
onment.
Administrator
Any other software component
can be added to this install set. + any other selected item

Install Temenos UXP

The steps required for the Standard IDE install set are given below.
The Enterprise Server Install Set differs slightly since a port number and start up options need to be specified.
This and the Hybrid Server installation are described after the Standard IDE installation.

Standard IDE
The Temenos UXP Standard IDE provides a user environment for development and deployment of Temenos
UXP solutions whether or not an Enterprise Server is used.
To Install the Developer & Deployer

1. Select Standard IDE from the drop down list of install sets.

The Install Set default selection is Standard IDE, so Developer, Deployer and Language Editor are automatically
selected.

Page| 18
 Installation Guide

Figure: UXP Installer » Choose what to install screen.

2. Click Next to continue.

Page| 19
 Installation Guide

Figure: UXP Installer » Choose Install Folder screen.

3. Choose the location in which to install the Temenos UXP software. A default location is provided which can be
overridden if required. Click Restore Default Folder if you wish to return to the default location.

If you wish to maintain multiple versions of the software, then you need to provide a separate location for each
version.

Best Practice:
Over time you are likely to install and work with several versions of Temenos UXP and there-
fore it is best practice to use a naming convention that contains the version information.
For example: C:\UXP\UXP7_0_0_1

4. Click Next to continue.

5. Choose the location in which you wish the product icons to appear for a shortcut to launching the Temenos
UXP tools.

Figure: UXP Installer » Choose Shortcut Location Screen.

Linux users will need to change the default location for product icons to /root/Desktop otherwise they will not
appear.
If certain options are chosen, the Create Icons for All Users checkbox become enabled. Checking this will allow
the shortcut icons to be available to all users logging into the machine.

6. Click Next to continue.

A summary of the installation is displayed.

Page| 20
 Installation Guide

Figure: UXP Installer » Pre-installation Summary screen.

7. Click Install to complete the installation.

The installation can be stopped by clicking the Cancel button at any stage. Note that the installer downloaded
initially will not be deleted and will remain in the IA_Installers directory unless deleted by the user.

Enterprise Server
The Server provides release and version control for Temenos UXP solutions in an Enterprise environment. Only
one server needs to be installed per development. This must be installed on a suitable Server with the correct
machine specification (see System Requirements). Only the person managing the server will need to install the
Administrator.
To Install the Enterprise Server

1. Select Enterprise Server from the drop down list of install sets.

2. Click Next to continue.

3. Choose the location in which to install the Temenos UXP software. A default location is provided. The default
location can be overridden if required.

4. Click Next to continue.

5. Choose the location in which you wish the product icons to appear for a shortcut to launching the Temenos
UXP tools.

Page| 21
 Installation Guide

If certain options are chosen, the Create Icons for All Users checkbox becomes enabled. Checking this will allow
the shortcut icons to be available to all users logging in to the machine.

6. Click Next to Continue.

The server configuration screen is displayed.

Figure: Server Configuration dialog » Install as Application screen.

7. Enter the port number you wish the server to listen on. The default is 9000.

If you are using windows, you can check if a port is in use by typing netstat -a on the command line.

8. Select Startup Type.

You can choose to start the service automatically or manually.

Page| 22
 Installation Guide

9. Check Start Service to start the Server automatically after installation.

10. Click OK.

A summary of the installation is displayed.

11. Click Install to complete the installation

The installation can be stopped by clicking the Cancel button at any stage.

Hybrid Server
Installation of the Hybrid Server and Hybrid Slaves can made separately or at the same time as installing the
other applications.
The Hybrid Server option is required if you wish to build and deploy Hybrid Applications. A hybrid application
allows you to create native solutions for smart phones that have internet access.
Only one hybrid server needs to be installed per development and, although the installation will work perfectly
well, you will need a Hybrid IDE licence in order to run the server. Please see below for details of how to obtain
the appropriate licence.
The Hybrid Server installation option consists of two elements. The Hybrid Master is the server that the
Deployer requires to produce the Android, iOS or Windows app. The server must be installed on a Windows
machine. This then requires one or more Hybrid Slaves to be installed. The slave required depends on which
platform you are using:

l Hybrid Android Slave - required for Android apps and must be installed on a Windows host, which can be
the same machine as the Master.

l Hybrid iOS Slave - required for iOS apps and must be installed on a Mac. This option will only be visible if
you are installing on a Mac.
To Install the Hybrid Server for Android

1. Select Hybrid Server from the drop down list of install sets.

2. Click Next to continue.

3. Choose the location in which to install the Temenos UXP software. A default location is provided. The default
location can be overridden if required.

4. Click Next to continue.

5. Choose the location in which you wish the product icons to appear for a shortcut to launching the Temenos
UXP tools.

6. Click Next to Continue.

The JDK location screen is displayed.

Page| 23
 Installation Guide

7. Enter the location of the JDK you wish to use, as shown below for example.

The jdk must be v1.8.

Hybrid Server Installation connection to Hybrid Master
The Choose connection to Hybrid Master dialog is displayed if you are going to install a Hybrid Slave.

Figure: Choose connection to Hybrid Master dialog.

Page| 24
 Installation Guide

You can set the following options:

l Hybrid Master address: Enter the Host Name or IP Address of the computer that Hybrid Master is installed
on.

l Hybrid Master Port: Enter the Hybrid Master Communication Port Number (default 9022).

8. Click OK.

The Pre-Installation Summary screen shows what options you have selected to be installed.

Figure: UXP Installer » Pre-installation Summary screen.

9. Click Install to complete the installation.

The installation can be stopped by clicking the Cancel button at any stage.
Hybrid Post Installation Steps
Once the Hybrid Server and Slave have been installed, there are extra steps that are required. These are doc-
umented in README.txt which is located in the install directory.
To complete the setup you need to:

1. Edit <installfolder>/jenkins/HybridAndroidSlave.lax and change %server% on the line beginning lax.-

command.line.args to the name of the host the hybrid master is installed on.

2. User a browser http://developer.android.com/sdk/index.html and download the sdk.

3. Follow the instructions in the installAndroidSDK.pdf

Page| 25
 Installation Guide

Custom Install Set

A custom install set can be used to select any combination of the software options available. Those not included
in a standard install set are:

l Administrator

Administrator
The Administrator allows you to manage your Temenos UXP projects and users. This needs to be installed by
the person who is managing the Enterprise Server.

Obtain and Install Licence

Before running any of the Temenos UXP software, it is necessary to obtain a valid licence. Different licences are
required for the runtime and development tools.

Developer Licence
To obtain and install a valid developer licence

1. Open the Temenos UXP IDE directory where the product was installed.

2. Locate the file InstallKey.txt

3. Email InstallKey.txt to the UXP Helpdesk at landmcodes@temenos.com

Please also include the name of your contact at Temenos in the email. You will be sent a licence file,
Connect.lic, by return.

4. Copy Connect.lic to <Temenos UXP Install Dir>\IDE You are now able to run Temenos UXP.

You are now able to run Temenos UXP.

Enterprise Licence
If you have a requirement for a large number of developer licences and don't want to get an individual licence
for each Developer IDE instance, you can obtain an Enterprise Licence. This gets installed on the Enterprise
server and is distributed to any Developer IDE that is connected to the server, up to a predefined limit. This
enables just one Enterprise license to be delivered even if many licences are required for all the Temenos UXP
Developers installed on different hosts.
Requirements
In order to use this new Licensing option, the following requirements must be met:

l An Temenos UXP Enterprise Server must be used.

l The computer names must exist in the same last two parts of Fully Qualified domain e.g. "temen-
osgroup.com"

l The maximum number of Developer IDE licences must be specified.

Page| 26
Installation Guide

Requesting and Installing the Enterprise Server LIcence

l Request an enterprise Server licence e.g. 10 users, where the domain for all the computers are "acme.com"
and the Enterprise server host name is "Server23".

l License Code Maintenance generates and delivers an Enterprise Server license: Enterprise.lic

l Install Temenos UXP Enterprise Server e.g. on host Server23. Obtain the Enterprise.lic from the license
team and then copy it to either the Temenos UXP installation folder or Server/Data folder. Restart the enter-
prise server.

l The Enterprise Server host name and port number are distributed to the Temenos UXP Developers.

l When the Developer IDE is run for the first time the user enters the enterprise server name and port num-
ber. The licence will then be distributed via the Enterprise Server.

The developer is now able to use the Temenos UXP IDE.

Features
When the Enterprise Server Licence is installed it has the following features:

l If the host name in the Enterprise server license does not match the host name of the machine it is installed
on, it will not start. Therefore an Enterprise License cannot be copied between different Enterprise Servers.

l The number of connections to the Enterprise server is limited to the maximum number of users specified
within the licence.

l The administrator can make a connection even if that connection would exceed the maximum number of
users specified in the licence.
Using the Developer IDE
When the Developer IDE is opened for the first time, a licence is required and the user is prompted as shown
below.

Figure: No License file.

The user must enter the Enterprise server name and port number.

Page| 27
 Installation Guide

Figure: License Server Connection.

With this information the Developer IDE obtains a license from the Enterprise Server and the Licence Type can
be seen within the developer in the About dialog (Menu > Help > About).

Figure: About screen.

The Developer IDE functions in the same way regardless of the type of licence that is being use i.e. Enterprise
Licence or individual licence.

Run-time Licence
To obtain and install a valid runtime licence:

1. Email the IP address of the machine or machines on which the solution will be deployed to land-
mcodes@temenos.com

You will be sent a valid licence file forms.lic by Temenos UXP Support. A single licence will be returned which will
be valid for all the IP addresses supplied.

2. Copy forms.lic to the RTE directory of <Temenos UXP Install Dir>\RTE created when the Developer tool was
installed. This will be from where you will deploy the solution using the Deployer tool.

Set Up a Secure Connection

This section describes how to setup and use a secure (SSL) connection between the Enterprise Server and any
connecting IDE tools e.g. Developer. This provides extra security as the user password and project contents are

Page| 28
Installation Guide

encrypted. An example of where this would be useful is if you wanted to install the Enterprise Server in the
cloud.
The steps needed to use a secure connection are shown below for the Server and each connecting IDE.

Server Setup
l Generate a certificate.

l Modify server.xml

n Specify that a secure port should be used.

n Specify the location of the keystore and the keystore password.

n Specify the secure port.

l Restart the enterprise server.

Developer Installation
l Change the connection details to the Secure Enterprise Server name and port number.

l If the self-signed certificate is being used, the Developer needs to know that the certificate should be trus-
ted.

Certificate Types
There are two possible options when generating a certificate.

l Use a Certificate Authority.

n Once this is completed and installed on the enterprise server there are no additional steps.

n Looks better for Developer IDE users.

n There is a cost and time associated with obtaining the certificate.

l Use a self-signed certificate.

n no cost involved with generation, quick to implement.

n Extra work involved with each installation of Developer that wants to connect to the server.
To Generate a self-signed certificate
You need to use an executable called keytool which is contained within any installed jre installed on the host.
You can use the one installed with Temenos UXP which can be found at <install Folder>/jre/bin/keytool.exe.

Page| 29
 Installation Guide

1. Open a command window and change directory to the Temenos UXP install folder

2. type .\jre\bin\keytool -genkey -keyalg RSA -alias <name> -keystore keystore.ks -storepass <pass-word> -valid-
ity 360 -keysize 2048
<password> will be used to protect the keystore
<name> will be the visible name of the certificate

3. Fill in the prompts to populate the certificate Example below:

What is your first and last name?
[Unknown]: ABCZ002.europe.softinc.com
What is the name of your organizational unit?
[Unknown]: Software
What is the name of your organization?
[Unknown]: SoftInc
What is the name of your City or Locality?
[Unknown]: London
What is the name of your State or Province?
[Unknown]: London
What is the two-letter country code for this unit?
[Unknown]: UK
Is CN=ABCZ002.europe.softinc.com, OU=Software, O=SoftInc, L=London, ST=London, C=UK cor-
rect?
[no]: yes

Enter key password for <self-signed>

(RETURN if same as keystore password):

Now the public certificate needs to be extracted from the keystore.

4. type .\jre\bin\keytool -export -alias <name> -keystore keystore.ks -file <certificatefilename>

<name> is the same as used above
<certificatefilename> is the name of the certificate file name such as “selfsigned.cer”
Modify the server.xml
Add the following init-param to Server.xml

Page| 30
 Installation Guide

<init-param>
<param-name>SecureConnection</param-name>
<param-value>Y</param-value>
</init-param>
<init-param>
<param-name>KeyStoreFile</param-name>
<param-value>C:/Users/auser/workspace/Secure/keystore.ks</param-value>
</init-param>
<init-param>
<param-name>KeyStorePassword</param-name>
<param-value>abcd2014</param-value>
</init-param>
<init-param>
<param-name>CertificateFile</param-name>
<param-value>C:/Users/auser/workspace/Secure/selfsigned.cer</param-value>
</init-param>

Using a self-signed certificate

If you are using a self-signed certificate you will need to indicate that the certificate is trusted. In order to do this
you will need to modify the Temenos UXP installation jre to trust the Enterprise Server certificate.
To Mark Certificate as Trusted

1. Open a command line window as administrator and change the directory to the install folder.

2. type .\jre\bin\keytool -import -v -trustcacerts -alias <name> -file <certificatefilename> -keystore ./jre/ lib/se-
curity/cacerts

l when prompted, the password is changeit

Page| 31
 Installation Guide

Uninstall
If the Temenos UXP Server is running, this must be stopped before running the uninstall process. It is recom-
mended that you set the service to manual, stop the service and reboot to make sure the service has stopped
correctly.
If you are using Windows, Temenos UXP components should be removed using the Add/Remove programs
option. If not follow the instructions below to remove Temenos UXP components.

To Uninstall Temenos UXP

1. Open Windows Explorer and navigate to the Temenos UXP folder.

The default location is c:\Program Files\Temenos\Temenos UXP

2. Open the UninstallerData folder.

3. Double click Uninstall Temenos UXP 7.0.exe

Figure: Uninstalling UXP.

On Windows platforms use Add or Remove Programs to uninstall Temenos UXP.

4. Click Uninstall to continue. The program will now remove the Temenos UXP application from the selected dir-
ectory.

Page| 32
Installation Guide

Troubleshooting the Installation

This section contains possible solutions to problems which may be encountered when installing Temenos UXP
Standard IDE or Enterprise Server.

Cannot find InstallKey.txt

If you do not have the correct privileges, this file is sometimes not created.
If you are unable to locate the file in the < Temenos UXP Install Dir >\Temenos UXP\IDE directory, contact the
Helpdesk.

Cannot open the IDE - nothing appears to be happening

l Check the log files for possible reasons why Temenos UXP IDE does not appear

Error messages will be in the user folder c:\Users\<username>DeveloperSysErr.txt for the Temenos UXP IDE and
c:\Users\<username>\DeployerSysErr.txt for the Temenos UXP Deployer.

Cannot open the IDE – licence error message

l Check that you have a valid Temenos UXP licence.

l Check that the licence is installed in the correct location. See section “Obtain and Install Licence”.

Note that any changes to the directory structure, naming or positioning will invalidate your supplied licence.
You will need to re-contact the Temenos UXP Helpdesk in order to obtain a replacement licence.

Cannot connect to Temenos UXP Server on start-up

l Check the name or IP address of the server is correct.

l Check the port number of the server is correct.

Unable to open Administrator, but able to open the IDE

Check that you have the correct type of licence i.e. Enterprise Server licence.
For technical support, please contact Temenos Product Support Portal at:
https://tcsp.temenos.com/SitePages/Home.aspx

Page| 33