On-Premise Install

This section provides details on using the Infinity Auto Installer to install the latest Infinity 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 Infinity auto installer
7	Copy downloaded files into Infinity 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	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 and for MSSQL1433
• 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 Infinity Files

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

Download the required files from Infinity 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

Origination Fabric Micro Apps Artifacts

Origination Client Micro Apps Artifacts

---

Extract Infinity Auto Installer

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

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

 When you extract the Infinity Auto Installer, it creates a folder called InfinityInstaller_v202304.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 Infinity Auto Installer Downloads folder.

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

INFINITY_INSTALLER_HOME refers to the folder where the Infinity 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 V9 SP7 FP1 HF2
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 Infinity 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.

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
   • 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:

--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 Infinity 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.

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 Infinity 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.