On-Premise Install

This section provides details on using the Temenos Digital Auto Installer to install the latest Temenos Digital release on premise.

Prerequisites

All the prerequisites listed in the following table must be completed before attempting to run the installer. Otherwise, the installation can fail.

Step	Detail
1	Make sure your computer meets the hardware and operating system requirements
2	Make sure you meet the networking requirements
3	Text editor to edit the installer script file
4	Make sure you enabled the Windows long path (if deploying client apps)
5	Download required files
6	Extract the Temenos Digital auto installer
7	Copy downloaded files into Temenos Digital auto installer downloads folder
8	Make sure you have the required Quantum Fabric environment details
9	Make sure you have the required Keycloak details
10	Edit installer auto property file
11	SCA HID/UNIKEN Fabric and Client Deployment Configurations
12	Run requirements text file

---

Computer Requirements

Your computer must meet these minimum requirements.

Memory	Hard Disk	Operating System
At least 12 GB RAM	At least 10 GB free disk space	Windows10 Pro 64-bit Mac OS Sierra

---

Network Requirements

To run, Infinity Auto Installer requires unimpeded network access to the internet to:

• Download required tools/plugins/libraries required for python.
• Access Quantum Fabric and MySQL/SQL Server databases if running in an on-premise or a cloud environment.

Network Ports

Make sure that the network ports are free. You cannot have any service/daemon bound to the following ports:

• For MySQL 3306, for MSSQL1433 and for ORACLE 1521
• For Quantum Fabric 8080 default

---

Text Editor

To edit the installer script file, use a text editor. A couple of editors that do this are:

• Visual Studio Code
• Notepad ++

---

Enabling Windows Long Path

Enable the Windows long path if you are deploying client apps.

To enable the Windows long path, follow these steps:

1. Open the Local Group Policy Editor (enter gpedit.msc in the search bar).
   
2. Navigate to Local Computer Policy > Computer Configuration > Administrative Templates > System > Filesystem.
   
3. Double-click Enable Win32 long paths.
   
4. On the Enable Win32 long paths screen, click to select the Enabled option, and click OK.
5. Restart the system.

---

Download Temenos Digital Files

In this section, you will download the necessary Temenos Digital files to your computer. 

Download the required files from Temenos Digital software download repository. Write to distribution@temenos.com for details on where and how to download.

Digital Banking Servicing Fabric Micro Apps Artifacts

Digital Banking Servicing Client Micro Apps Artifacts

InternetBanking Client Micro Apps Artifacts for NS&I Deployment

Component	File Name	Location
AboutUsMA	AboutUsMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
AccountSweepsMA	AccountSweepsMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
ACHMA	ACHMA_UI-vx.x.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
AlertSettingsMA	AlertSettingsMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
ApprovalMatrixMA	ApprovalMatrixMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
ApprovalRequestMA	ApprovalRequestMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
Arrangements	Arrangements_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
Authentication	Authentication_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
BillPayMA	BillPayMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
BulkPaymentsMA	BulkPaymentsMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
Campaign	Campaign_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
CardsMA	CardsMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
CommonsMA	CommonsMA_DigitalBanking_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
ConsentMgmtMA	ConsentMgmtMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
FinanceManagementMA	FinanceManagementMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
ForeignExchangeMA	ForeignExchangeMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
Homepage	Homepage_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
ManageArrangementsMA	ManageArrangementsMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
ManageProfileMA	ManageProfileMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
OnlineBankingMA	OnlineBanking_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
PortfolioManagementMA	PortfolioManagementMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
ResourcesMA	ResourcesMA_DigitalBanking_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
SavingsPotMA	SavingsPotMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
SecureMessageMA	SecureMessageMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
SelfServiceEnrolmentMA	SelfServiceEnrolmentMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
SBAdvisoryMA	SBAdvisoryMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
TradeFinanceMA	TradeFinanceMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
TransfersMA	TransfersMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
UserManagementMA	UserManagementMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
WealthOrderMA	WealthOrderMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
WireTransferMA	WireTransferMA_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
TradeSupplyFinMA	TradeSupplyFinMA _UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web
ResourcesHIDMA	ResourcesHIDMA_DigitalBanking_UI-vx.x.x.zip	DigitalBanking GA Software → <release> → Desktop Web

Origination Fabric Micro Apps Artifacts

Origination Client Micro Apps Artifacts

---

Extract Temenos Digital Auto Installer

In this section, you will extract the InfinityInstaller_vR24.x.x.zip file. 

• Locate the Temenos Digital Auto Installer zip file you downloaded previously.
• Extract the zip file to a location on your computer.

 When you extract the Temenos Digital Auto Installer, it creates a folder called InfinityInstaller_vR24.x.x. From this point on in the documentation, this folder is referred to as INFINITY_INSTALLER_HOME.

---

Copy Downloads

In this section, you will copy the downloaded files to the Temenos Digital Auto Installer Downloads folder.

1. Locate the Temenos Digital files that you downloaded earlier.
2. Copy the files to INFINITY_INSTALLER_HOME > downloads.

INFINITY_INSTALLER_HOME refers to the folder where the Temenos Digital Auto Installer zip was extracted.

---

Quantum Fabric Environment Details

You must make sure that you have all the details listed in the following table.

Quantum Fabric Environment	Quantum Fabric 202404.0.0
Quantum Fabric Admin Credentials	You need the credentials for a user with admin access.
MySQL Database	v8.0
MySQL Admin Credentials	You need the credentials for a database user who has permissions to perform the following: Create a database Create tables Create indices Create views Create procedures

---

Keycloak Details

Make sure that you have the following:

• Keycloak host URL: You need host URL for Keycloak.
• Keycloak user and password: You need the credentials for a user with admin access.
• Keycloak environment: Keycloak version 16.1.0

---

Edit Installer Property File

In this section, you will edit the Temenos Digital Auto Installer property file to set the appropriate values for your environment.

   Remember to use a text editor.

1. Start your text editor.
2. Open the file INFINITY_INSTALLER_HOME > config.properties.
   
3. Change the values for the variable shown in the table and save the property file.

To download a sample config.properties file, click here.

SCA HID/UNIKEN Fabric and Client Deployment Configurations

In SCA we will perform both the fabric and the client build. Before that, we need to fulfil some prerequisites.

For Fabric Build:

For the Temenos Digital deployment, use the comment 'python installer.py --infinity' to ensure a comprehensive execution that covers all aspects of the job configuration.

Before we start this process, we need to put all artifacts into the download folder. Here, [python installer.py –infinity] is used to generate dbxdb database, fabric apps, and common configurations.

Before we run the comment [python installer.py –infinity], we must first fulfil some prerequisites. These prerequisites are listed below.

Prerequisites:

Before you start, make sure that the version you require is entered in the properties file [config.properties], which is located in the [common] section.

For the "digitalbanking.client.binary.name" field, you must select one of the following values: Before you start, make sure that the version you require is entered in the properties file [config.properties], which is located in the [common] section.

For the "digitalbanking.client.binary.name" field, you must select one of the following values:

For the complete solution, the SCA artifacts are listed below:

• "DigitalBanking_UI_SCA_HID_Binary-v<VERSION>.zip"
• "DigitalBanking_UI_SCA_UNIKEN_Binary-v<VERSION>.zip"

For RES Enterprise Solution, the SCA artifacts are listed below:

• "DigitalBanking_RES_UI_SCA_HID_Binary-v<VERSION>.zip"
• "DigitalBanking_RES_UI_SCA_UNIKEN_Binary-v<VERSION>.zip"

You must enter one of the above options in the "digitalbanking.client.binary.name" field.

You should enter the same version that is specified in the [config.properties] for this field. Replace "VERSION" in the zip file with the actual version number to ensure accuracy.

Then enter all SCA configurations in the properties file [Config.properties] under the section [common_params_for_all_fabric_apps], as shown in the following table:

SCA Configurations for SCA_Type – HID & Variable Type - Vendor:

SCA Configurations for SCA_Type – HID and Variable Type - SRE:

SCA Configurations for SCA_Type – UNIKEN and Variable Type - Vendor:

SCA Configurations for SCA_Type – UNIKEN and Variable Type - SRE:

For Client Build:

To deploy the SCA build client applications, use the 'python installer.py --upload_and_publish_client_binaries' comment to ensure a comprehensive execution that covers all aspects of the job configuration.

Before we start this process, we need to put all artifacts into the download folder. [python installer.py --upload_and_publish_client_binaries] is used to upload and publish the mentioned client binaries.

Before you execute the command [python installer.py --upload_and_publish_client_binaries], you must fulfil some of the prerequisites listed below.

Prerequisites:

First make sure that the version you require is entered in the properties file [config.properties], which is located in the [common] section. For the field " digitalbanking.client.binary.name" you must select one of the following values:

For the complete solution, the SCA artifacts are listed below:

• "DigitalBanking_UI_SCA_HID_Binary-v<VERSION>.zip"
• "DigitalBanking_UI_SCA_UNIKEN_Binary-v<VERSION>.zip"

For RES Enterprise solution, the SCA artifacts are listed below:

• "DigitalBanking_RES_UI_SCA_HID_Binary-v<VERSION>.zip"
• "DigitalBanking_RES_UI_SCA_UNIKEN_Binary-v<VERSION>.zip"

You must enter one of the above options in the "digitalbanking.client.binary.name" field.

You should enter the same version that is specified in the [config.properties] for this field. Replace "VERSION" in the zip file with the actual version number to ensure accuracy

Run Requirements Text File

In this section, you will run the Infinity Auto Installer requirements text file to install all the necessary libraries for the installer.

Remember to use a command line. Start the command line.

To run the requirements text file,

1. Open the command line in the INFINITY_INSTALLER_HOME location and run the following command:
   pip install -r requirements.txt
   The response will be like the following image.
   
2. If you face any issues with installing libraries, check the network/firewall settings to make sure that the connection is properly established.

---

Installation Process

The following table lists the installation steps that must be completed.

Step	Detail
1	Run the installer check
2	Run the installer for Fabric apps Installation
3	Run the installer for client apps installation

---

Run Installer Script Check

The installer script provides an option to validate the values that have been configured. When you run the script, the check validates the following:

• All key variables have a value set.
• The installer files (all Infinity artefacts) are accessible.
• The database can be logged in to.
• Quantum Fabric can be accessed.

To run the check,

1. Run the following command.
   python installer.py --script_check
   The response will be like the following image.
   
2. If you face any issues with the script check, verify the property file with the credentials/hostname for Quantum Fabric and database. Make sure you can access/connect to the given database and Fabric.

---

Run Installer for Fabric Apps Installation

After the configuration in the installer script has been validated, you are ready to start the installation.

1. Run the following command.
   python installer.py --infinity
2. This will install the required Infinity applications.
   • DigitalBanking-Composite
   • KonyBankingAdminConsole
   • InfinityAssist
   • FCM
   • Corporate Lending Origination System(CLOS) Setup
   • TransactionLimitsEngine
   • Origination
   • dbpEventManager
   • InfinityThirdParty
   • ServiceRequestAPI
3. The response will be like the following image.
   
4. After the installer script is completed, the completed message will be like as shown in the following image.
   

---

Run Installer for Client Apps Installation

This section explains the procedure to install the client apps for the following options:

• --spotlight_web
• --infinityassist_web
• --retailbanking_web
• --retailbanking_native
• --infinityorigination_web
• --account_summary_web
• --feature_actions_web

To deploy the client apps, follow these steps:

Make sure the following pre-requisites are satisfied before start deploying the client apps.

1. Install Apache Ant
2. Install Node.js
3. Enabling windows long path

--spotlight_web

1. Place the Spotlight_Web-vx.x.x.zip client app artifact in download folder and provide the corresponding version in the property file.
2. If you want to disable Keycloak for Spotlight, provide the value as true in the disable.keycloak.for.spotlight variable in config.properties file.
3. Run the following command for installing spotlight client app: python installer.py --spotlight_web.
4. After the installation is started, the initial response will be like as shown in the following image.
   
5. After the deployment is completed, the system displays the corresponding Web app URL as shown in the following image.
   

--infinityassist_web

1. Place the InfinityAssist_Web-vx.x.x.zip client app artifact in download folder and provide the corresponding version in the property file.
2. Run the following command for installing Temenos Digital Assist client app: python installer.py --infinityassist_web.
3. After the installation is started, the initial response will be like as shown in the following image.
   
4. After the deployment is completed, the system displays the corresponding Web app URL as shown in the following image.
   

--retailbanking_web

1. Provide the list of Client Micro Apps in retail.banking.client.microapps.list variable that you want to install.
2. Place all artifacts mentioned in retail.banking.client.microapps.list in the download folder.
   

   Download and keep only the respective Retail Banking Client Micro Apps artifacts in the downloads folder while doing the Retail Banking web build. The build will fail if you made the override of commonsMA and resourcesMA artifacts in the downloads folder from Origination.

3. Run the following command for installing Retail Banking client app: python installer.py --retailbanking_web.
4. After the installation is started, the initial response will be as shown in the following image.
   
5. After the deployment is completed, the system displays the corresponding Web app URL as shown in the following image.
   

--retailbanking_native

1. Provide the list of Client Micro Apps in retail.banking.client.microapps.list variable that you want to install.
2. Place all artifacts mentioned in retail.banking.client.microapps.list in the download folder.
   

   Download and keep only the respective Retail Banking Client Micro Apps artifacts in the downloads folder while doing the Retail Banking web build. The build will fail if you made the override of commonsMA and resourcesMA artifacts in the downloads folder from Origination.

3. Make sure that the path length of repository is maximum 15 characters.
4. Run the following command for installing Retail Banking native app: python installer.py --retailbanking_native.
5. After the installation is started, the initial response will be like as shown in the following image.
   
6. After the deployment is completed, the system displays the corresponding Native app URL for downloading APK and KAR files as shown in the following image.
   

--infinityorigination_web

1. Provide the list of Client Micro Apps in origination.client.microapps.list variable that you want to install.
2. Place all artifacts mentioned in origination.client.microapps.list in the download folder.
   

   Download and keep only the respective Origination Client Micro Apps artifacts in the downloads folder while doing the Origination web build. The build will fail if you made the override of commonsMA and resourcesMA artifacts in the downloads folder from Retail Banking.

3. Run the following command for installing Origination client app: python installer.py --infinityorigination_web.
4. After the installation is started, the initial response will be like as shown in the following image.
   
5. After the deployment is completed, the system displays the corresponding Web app URL as shown in the following image.
   

--account_summary_web (Only for IDFS)

1. Place the AccountSummary_Web-vx.x.x.zip client app artifact in download folder and provide the corresponding version in the property file.
2. Run the following command for installing account summary client app: python installer.py --account_summary_web.
3. After the deployment is completed, the system displays the web app in browser like below.
   

--feature_actions_web (Only for IDFS)

1. Place the FeaturesActions_Web-vx.x.x.zip client app artifact in download folder and provide the corresponding version in the property file.
2. Run the following command for installing Feature actions client app: python installer.py –feature_actions_web.
3. After the deployment is completed, the system displays the web app in browser like below.
   

Process to clean the fabric (API Management)

To delete all applications from Fabric and clean up API management and custom code, the following steps must be followed:

1. Specify the list of applications in the apps.to.uninstall variable in the config.properties file.
2. In the case of retail banking or origination microapps, specify the composite app name in the apps.to.uninstall variable, this will determine the dependent child apps and delete them internally. For monolithic apps, simply specify the name of the fabric app.
3. Run the following command to uninstall: python installer.py -uninstall

This removes the installed applications from the APPS section in Fabric, but leaves the API management and custom code uncleaned. The following process allows you to clean them up:

1. In INFINITY_INSTALLER_HOME > tools, clean the fabric env folder, a script for cleaning the fabric (clean_the_fabric.py).
2. In the above mentioned location, in addition to the script, you have configuration.properties file where you can make the necessary changes (for the fabric) and save the properties file.
3. Refer to Edit Installer Property File table to edit the properties file.
4. From INFINITY _INSTALLER_ HOME > tools > clean_the_fabric_env , open cmd and run the following command: python clean_the_fabric.py.

If a service (identity or integration or orchestration or object) or jars remains uncleared even after running the above command, delete it manually.

Infinity Health Check Tool

Added infinity health check tool support in installer as a separate option to do the following checks.

• Database health: DB health , dbxdb & dbxlogs availability , Migration status , Multientity status , Basic configuration (Keycloak enabled or not and single entity or not).
• Fabric health
• Keycloak health
• Microservices health
• Deployed fabric and client apps

--do_infinity_health_checks (DB,Fabric,Keycloak,MS,BasicConfigs)

FAQs

Following are the answers to several frequently asked questions regarding the use of the installer. 

Known Issues

The table shows the known issues with this version of the Temenos Digital Auto Installer.

---

Troubleshooting

• If you are using Linux OS, Python is preinstalled and can be confirmed by checking the version by using following command: python --version. if Python version is 2.X, install Python 3 version above 3.7.2. To check the Python3 version, use the following command: python3 --version. if you are using Windows, Python must be installed manually.
• To run all the installer commands in Linux OS, if Python 3 is installed, you must use python3 installer.py <option> and to install external libraries, use the following command: pip3 install -r requirements.txt.
• If you are using Windows or Linux, check the Java home path by using following command: echo $JAVA_HOME for Linux and in Windows, echo %JAVA_HOME%. If the Java home is not available, set the Java home path by using following command: export JAVA_HOME=<path_to_jdk> for Linux and in Windows, use Environment variable.
• In Linux, use the command python3 -m pip install -U pip to install or redirect the pip to the corresponding Python version.