Kony Fabric Installation Guide – Windows

423 Pages·2017·6.09 MB·English

Kony Fabric
Installation Guide - Windows
On-Premises
Release V8 SP4
Document Relevance and Accuracy
This document is considered relevant to the Release stated on this title page and the document version stated on the
Revision History page. Remember to always view and download the latest document version relevant to the software
release you are using.
© 2020 by Kony, Inc. All rights reserved 1 of 393
Kony Fabric Installation Guide - Windows
Version1.12
Copyright © 2014 by Kony, Inc.
All rights reserved.
February, 2020
This document contains information proprietary to Kony, Inc., is bound by the Kony license
agreements, andmay not be used except in the context of understanding the use andmethods of
Kony, Inc., software without prior, express, written permission. Kony, Empowering Everywhere, Kony
Fabric, KonyNitro, and Kony Visualizer are trademarks of Kony, Inc. MobileFabric is a registered
trademark of Kony, Inc. Microsoft, theMicrosoft logo, Internet Explorer, Windows, andWindowsVista
are registered trademarks of Microsoft Corporation. Apple, the Apple logo, iTunes, iPhone, iPad, OS
X, Objective-C, Safari, Apple Pay, AppleWatch, and Xcode are trademarks or registered trademarks
of Apple, Inc. Google, the Google logo, Android, and the Android logo are registered trademarks of
Google, Inc. Chrome is a trademark of Google, Inc. BlackBerry, PlayBook, Research inMotion, and
RIM are registered trademarks of BlackBerry. SAP® and SAP® Business Suite® are registered
trademarks of SAP SE in Germany and in several other countries. All other terms, trademarks, or
servicemarksmentioned in this document have been capitalized and are to be considered the
property of their respective owners.
© 2020 by Kony, Inc. All rights reserved 2 of 393
Kony Fabric Installation Guide - Windows
Version1.12
Revision History
Date Document Version Description of Modifications/Release
01/26/2020 1.12 Document published for adding Upgrading Custom
Metrics Component.
10/18/2019 1.11 Document published for adding Upgrade from Kony
Fabric 8.2.
09/26/2019 1.10 Document published for adding Prerequisites for
Upgrade fromMobileFabric 7.x to Kony Fabric 8.x.
08/05/2019 1.9 Document published after modifying the -DKMS_
CORE_VERSION for JBoss, WebLogic, and
WebSphere.
08/05/2019 1.8 Document published after modifying Application
Servers Pre-installation Tasks for JBoss, WebLogic,
andWebSphere.
06/20/2019 1.7 Document published after modifying Corporate Firewall
Settings - Engagement Services
04/18/2019 1.6 Document Published for V8 SP4 FP1HF1
02/27/2019 1.5 Document Published for V8 SP4 FP1
09/24/2018 1.4 Document Published for V8 SP3
04/19/2018 1.3 Document Published for V8 SP2
12/18/2017 1.2 Document Published for V8 SP1
09/19/2017 1.0 Document Published for V8GA
© 2020 by Kony, Inc. All rights reserved 3 of 393
Kony Fabric Installation Guide - Windows
Version1.12
© 2020 by Kony, Inc. All rights reserved 4 of 393
Kony Fabric Installation Guide - Windows
Version1.12
Table of Contents
1. Preface 13
1.1 Purpose 14
1.2 Intended Audience 14
1.3 Formatting ConventionsUsed in ThisGuide 15
1.4 Related Documents 16
1.5 Contact Us 16
2. Prerequisites 17
2.1 Software Requirements 17
2.2 Hardware Requirements 17
2.3 Network Settings 18
2.3.1 Corporate Firewall Settings - Engagement Services 18
2.3.2 Proxy Settings for Integration Service 21
2.3.3 Network Settings - Licensing 22
2.4 Database Prerequisites 23
2.4.1 Prerequisites for Kony Fabric with Oracle 23
2.4.2 Prerequisites for Kony Fabric with DB2 25
2.4.3 Prerequisites for Kony Fabric with SQL Server 27
2.4.4 Prerequisites for Kony Fabric with MSSQL - Applicable for Engagement Services 28
2.4.5 Prerequisites for Kony Fabric with MySQL 29
2.4.5.1 Applicable for Engagement Services 29
© 2020 by Kony, Inc. All rights reserved 5 of 393
Kony Fabric Installation Guide - Windows
Version1.12
2.4.5.2 Applicable for Identity Services 30
2.5 Application Servers Prerequisites 31
2.5.1 Tomcat Prerequisites 31
2.5.1.1 How to DisableWeakCiphers 31
2.5.1.2 Heap and PermGen Settings 32
2.5.2 JBoss Prerequisites 32
2.5.2.1 Heap and PermGen Settings 32
2.5.2.2 Configuration of Database Driver Module 32
2.5.2.3 Configure the Standalone Existing JBoss 33
2.5.2.4 Configure the Log Locations - JBoss 35
2.5.2.5 Configure the Standalone Existing JBosswith Self-Signed Certificate (JBoss 7.1) 35
2.5.2.6 Configure Port Settings for Multinode Loadbalancer Setups 36
2.5.3 WebLogic Prerequisites 37
2.5.3.1 Heap and PermGen Settings 37
2.5.3.2 Security Configurations 37
2.5.3.3 Configure the Log Locations - WebLogic 37
2.5.4 WebSphere Prerequisites 38
2.5.4.1 Heap and PermGen Settings 38
2.5.4.2 How to Enable TLSv1.2 Protocol 38
2.5.4.3 How to Retrieve Server Groups inWebSphere when using Admin Security with
TLS v1.2 40
© 2020 by Kony, Inc. All rights reserved 6 of 393
Kony Fabric Installation Guide - Windows
Version1.12
2.5.4.4 SOAP Connector Port details for WebSphere 42
2.5.4.5 Updating the SSL Socket Factory Providers 45
2.5.4.6 NGINX Load Balancer Configuration 45
3. Kony Fabric Topology and Components 47
3.1 Developer Environment 52
3.2 Production Environment 53
4. Kony Fabric Installation on Single Node and Multinode 54
5. Pre-Installation Tasks 55
5.1 Download Kony Fabric Installer 55
5.2 Steps before installing (or) upgrading Kony Fabric with the existing database 55
5.3 Add a User in Local Group Policy (Log on as a Service) 56
5.4 Install Memcached Server 59
5.5 Configure Load Balancers for Sending Host Information inMultinode 61
5.5.0.1 Configure Hibernate Dialect inWebLogic (only for WebLogic) 62
5.6 Download and Install the Unrestricted JCE Policy Files 62
5.7 Database Pre-Installation Tasks 64
5.7.1 MySQL 64
5.7.1.1 Increase innodb_log_file_size in my.ini file - MySQL 64
5.7.2 SQL Server 64
5.7.3 WindowsAuthentication Support 64
5.7.4 Oracle 65
© 2020 by Kony, Inc. All rights reserved 7 of 393
Kony Fabric Installation Guide - Windows
Version1.12
5.7.4.1 Create Locator Component for Oracle Database 65
5.7.5 MariaDB 67
5.7.5.1 Increase the table_definition_cache and table_open_cache values 67
5.8 Application Servers Pre-Installation Tasks 68
5.8.1 JBoss 68
5.8.1.1 Configure Load Balancer as Proxy in JBossMultinode Setup (Optional if SSL
Offloading at Load Balancer) 68
5.8.1.2 Update Listen Interfaces in host.xml for JBossCluster 68
5.8.1.3 Comment the javax-persistence-module for Kony Engagement Services on
JBossCluster 69
5.8.1.4 How to Configure Connector - JBoss 70
5.8.1.5 How to Increase Timeout andMaximumHeap Size Settings - JBoss 70
5.8.1.6 How to Configure Engagement Services - JBoss 71
5.8.2 WebLogic 72
5.8.2.1 Increase JVMmemory for WebLogic Server 72
5.8.2.2 PlaceMS SQLServer Connector JAR inWebLogic Classpath 72
5.8.2.3 How to Configure Engagement Services - WebLogic 72
5.8.3 WebSphere 73
5.8.3.1 Install Kony Fabric on a RemoteWebSphere Server with Global Security Enabled73
5.8.3.2 Configure Property Settings for Logs - (only for WebSphere) 73
5.8.3.3 Support Deployment of apiportal.war onWebSphere Server 75
5.8.3.4 Updating authService.war and accounts.war for WebSphere 9 75
© 2020 by Kony, Inc. All rights reserved 8 of 393
Kony Fabric Installation Guide - Windows
Version1.12
5.8.3.5 How to Configure Engagement Services - WebSphere 76
6. Installation Modes - Kony Fabric 77
6.1 Installing Kony Fabric - GUI (for Windows installations) 78
6.1.1 Installing Kony Fabric on Tomcat 78
6.1.2 Installing Kony Fabric on JBossGUI (for Windows installations) 116
6.1.2.1 Installing Kony Fabric on a StandaloneMode in Bundled JBoss 117
6.1.2.2 Installing Kony Fabric on a StandaloneMode in a Pre-configured JBoss 158
6.1.2.3 Installing Kony Fabric on a DomainMode (Multi node installation in pre-
configured JBoss cluster) 184
6.1.3 Installing Kony Fabric onWebLogic 218
6.1.4 Installing Kony Fabric onWebSphere 252
6.2 Installing Kony Fabric - Silent-mode 287
7. How to Stop and Start Kony Fabric 289
7.1 Tomcat Server 289
7.2 JBoss Server 289
7.2.1 For Multinode - JBoss 289
7.3 WebLogic Server 289
7.4 WebSphere Server 290
7.4.1 Windows - To stop and start WebSphere Server 290
8. Upgrading Kony Fabric 291
8.1 Prerequisites for Upgrade fromMobileFabric 7.x to Kony Fabric 8.x 291
© 2020 by Kony, Inc. All rights reserved 9 of 393
Kony Fabric Installation Guide - Windows
Version1.12
8.2 Upgrading Kony Fabric using installer 293
8.3 Prerequisites 294
8.4 Upgrading Kony Fabric to V8 SP4 304
8.4.1 Prerequisites 306
8.5 Upgrade fromKony Fabric V8 SP2 to V8 SP4 313
8.6 Upgrading CustomMetrics Component 314
9. Installing Hot Fix Archives for Kony Fabric - Windows 316
9.1 Patch Installer GA Versions 316
9.2 Prerequisites 317
10. Uninstalling Kony Fabric 324
11. Post-Installation Tasks 330
11.1 Configuring Secure Sockets Layer (SSL) Certificate 330
11.1.1 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 330
11.1.2 How to Add an Existing SSLCertificate to Cacerts 331
11.2 JDK Version Compatibility 332
11.3 How to Update Security Configuration in Config.xml (Required in case ofWebLogic
installation) 333
11.4 How to ConfigureMemcache for Integration Services 334
11.5 Configure Deployment of mbaasportal.war File for Multi-Node 336
11.6 Remote Installation Pre-requisites 336
11.6.1 Installing Kony Fabric Remotely 336
© 2020 by Kony, Inc. All rights reserved 10 of 393