Table Of ContentKony MobileFabric™
Manual Installation Guide
On-Premises
Release 7.0
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.
© 2014 by Kony, Inc. All rights reserved 1 of 316
Manual Installation Guide
Version1.0
Copyright © 2014 by Kony, Inc.
All rights reserved.
April, 2016
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
Modeler, 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.
© 2014 by Kony, Inc. All rights reserved 2 of 316
Manual Installation Guide
Version1.0
Revision History
Date Document Version Description of Modifications/Release
04/26/2016 1.2 Document Updated for Release 7.0.1
02/29/2016 1.0 Document Updated for Release 7.0
© 2014 by Kony, Inc. All rights reserved 3 of 316
Manual Installation Guide
Version1.0
Table of Contents
1. Preface 12
1.1 Purpose 13
1.2 Intended Audience 13
1.3 Formatting Conventions 13
1.4 Related Documents 15
1.5 Contact Us 15
2. Prerequisites 16
2.1 Software Requirements 16
2.2 Hardware Requirements 16
2.3 DB2 JNDI Datasource Setup 16
2.4 Heap and PermGen Settings 17
3. MobileFabric Topology and Components 18
4. Preinstallation Tasks 22
4.1 Prerequisites for MobileFabric with Oracle 22
4.2 Configure Deployment of mbaasportal.war File for Multi-Node 26
4.3 Add a User in Local Group Policy (Log on as a Service) 27
4.4 Install Memcached Server 30
4.5 Increase JVMmemory for WebLogic Server 32
4.6 PlaceMS SQLServer Connector JAR inWebLogic Classpath 32
4.7 Configure JMS for Metrics in DomainMode for WebLogic or JBoss 33
© 2014 by Kony, Inc. All rights reserved 4 of 316
Manual Installation Guide
Version1.0
4.8 Configure Load Balancers for Sending Host Information inMultinode 39
4.9 Configure Hibernate Dialect inWebLogic (only for WebLogic) 40
4.10 Update Listen Interfaces in host.xml for JBossCluster 40
4.11 Comment the javax-persistence-module for Kony Engagement Services on JBoss
Cluster 41
4.12 Increase innodb_log_file_size in my.ini file 42
4.13 Create Locator Component for Oracle Database 42
4.14 Configure Load Balancer as Proxy in JBossMultinode Setup (Optional if SSLOffloading
at Load Balancer) 44
4.15 ConfigureManager User for Tomcat 45
4.16 Configuring FlywayCommand-line Tool 45
5. Installing MobileFabric on WebSphere with DB2 57
6. Configuring Database for MobileFabric 61
6.1 Configuring Kony Identity (Auth) ServicesDatabase 62
6.1.1 MySQL 62
6.1.2 Oracle 62
6.1.3 SQL Server 63
6.1.4 DB2 64
6.2 Configuring KonyWorkspace ServicesDatabase 67
6.2.1 MySQL 67
6.2.2 Oracle 67
6.2.3 SQL Server 68
© 2014 by Kony, Inc. All rights reserved 5 of 316
Manual Installation Guide
Version1.0
6.2.4 DB2 69
6.3 Configuring Kony Accounts ServicesDatabase 72
6.3.1 MySQL 72
6.3.2 Oracle 72
6.3.3 SQL Server 73
6.3.4 DB2 74
6.4 Configuring Kony Admin Database 78
6.5 Configuring KonyReports Database 88
6.6 Configuring KonyDevice Database 91
7. Configuring Flyway Command-line Tool 94
8. Creating Shared Library Folders for MobileFabric - WebSphere 105
8.1 Creating Shared Library Folders - WebSphere 105
8.2 Mapping Shared Library Folders References toWAR Files - WebSphere 110
9. Creating Data Source for MobileFabric Console - WebSphere 117
9.1 Creating Data Source for MobileFabric Console Schema (MySQL) 117
9.1.1 Creating a JAAS J2C Authentication 118
9.1.2 Creating a JDBC Provider 121
9.1.3 Creating a Data Source 129
9.1.4 Setting CustomProperties of Data Source 144
9.2 Creating Data Source for MobileFabric Console Schema (Oracle) 149
9.2.1 Creating a JAAS J2C Authentication 150
© 2014 by Kony, Inc. All rights reserved 6 of 316
Manual Installation Guide
Version1.0
9.2.2 Creating a JDBC Provider 152
9.2.3 Creating a Data Source 155
9.2.4 Setting CustomProperties of Data Source 160
9.3 Creating Data Source for MobileFabric Console Schema (SQL Server) 165
9.3.1 Creating a JAAS J2C Authentication 166
9.3.2 Creating a JDBC Provider 168
9.3.3 Creating a Data Source 171
9.3.4 Setting CustomProperties of Data Source 176
9.4 Creating Data Source for MobileFabric Console Schema (DB2) 181
9.4.1 Creating a JAAS J2C Authentication 182
9.4.2 Creating a JDBC Provider 184
9.4.3 Creating a Data Source 188
9.5 Configuring Data Source for Integration Service 193
10. Creating Data Source for MobileFabric Components Schema - WebLogic 194
11. Configuring Installation Mode 195
11.1 How to Configure InstallationModes - Tomcat 195
11.1.1 How to Configure Tomcat Multinode Installation 195
11.2 How to Configure InstallationModes - JBoss 197
11.2.1 How to Configure JBoss for Singlenode Installation 197
11.2.2 How to Configure JBoss for Multinode Installation 197
11.3 How to Configure InstallationModes - WebSphere andWebLogic 197
© 2014 by Kony, Inc. All rights reserved 7 of 316
Manual Installation Guide
Version1.0
12. Configuring JNDI for a Database 199
12.1 How to Configure JNDI - Tomcat 199
12.1.1 For MySQL 199
12.1.2 Configure JNDI for Middleware.war and Services.war 202
12.2 How to Configure JNDI - JBoss 203
12.2.1 For MySQL 203
13. Configuring Connectors and WAR Deployment 211
13.1 How to Configure Connectors - Tomcat 211
13.1.1 How to Configure Batch Files 212
13.2 How to Configure Connectors - JBoss 213
13.2.1 How to Configure enable-welcome-root Value 213
13.2.2 How to Configure Connector 214
14. Configuring Properties Files in WAR Files 215
14.1 How ToConfigure Properties Files inWAR Files - Tomcat and JBoss 215
14.1.1 accountsAPI.war 215
14.1.2 authService.war 217
14.1.3 mbaasportal.war 218
14.1.4 workspaceService.war 219
14.1.5 How To Set Middlware Home - Tomcat 220
14.1.6 How To Set Middlware Home - JBoss 221
14.2 How ToConfigure Properties Files inWAR Files - WebSphere 222
© 2014 by Kony, Inc. All rights reserved 8 of 316
Manual Installation Guide
Version1.0
14.2.1 accountsAPI.war 223
14.2.2 authService.war 223
14.2.3 mbaasportal.war 225
14.2.4 workspaceService.war 226
14.2.5 How to Configure KonyMobileFabric Integration Services 227
14.3 How ToConfigure Properties Files inWAR Files - WebLogic 236
14.3.1 accountsAPI.war 236
14.3.2 authService.war 236
14.3.3 mbaasportal.war 240
14.3.4 workspaceService.war 240
14.3.5 KonyMobileFabric Integration Services (middleware) 242
15. Configuring JMS Server and JMS Module for Integration Server (Metrics) -
WebSphere 243
15.1 Configure JMS 243
16. Configuring JMS Server and JMS Module for Integration Server (Metrics) - WebLogic 258
16.1 Configure JMS Server for Managed Server (Optional) 258
16.1.1 Create JMS Server 258
16.1.2 Create JMSModule 259
16.1.3 Create Connection Factory under JMS Module 259
16.1.4 Create Topic under JMSModule 260
17. Configuring Metrics.ear 262
© 2014 by Kony, Inc. All rights reserved 9 of 316
Manual Installation Guide
Version1.0
18. Deploying WAR Files 263
18.1 DeployingWAR Files to Tomcat and JBoss 263
18.2 DeployingWAR Files toWebSphere 264
18.2.1 DeployingMetrics.ear toWebSphere 280
18.3 DeployingWAR Files toWebLogic 292
19. Configuring Kony MobileFabric as a Service 295
20. Starting Kony MobileFabric Console 296
20.1 Tomcat 296
20.2 JBoss 296
20.2.1 For Single Node 296
20.2.2 For Multinode 297
21. Post-Installation Tasks 298
21.1 Configuring Secure Sockets Layer (SSL) Certificate 298
21.1.1 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 298
21.1.2 How to Add an Existing SSLCertificate to Cacerts 299
21.2 JDK Version Compatibility 300
21.3 How to Switch between JDK Versions 300
21.4 How to ConfigureMemcached for Integration Service 301
21.5 How to Change Default Artifact Size inWorkspace - DB2 302
22. FAQs and Troubleshooting 304
22.1 How to Configure JBossCluster 309
© 2014 by Kony, Inc. All rights reserved 10 of 316
