Table Of ContentKony MobileFabric™
Manual Installation Guide
On-Premises
Release 6.5
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 185
Manual Installation Guide
Version1.3
Copyright © 2014 by Kony, Inc.
All rights reserved.
September, 2015
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
MobileFabric, KonyModeler,and Kony Visualizer are trademarks 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. 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 185
Manual Installation Guide
Version1.3
Revision History
Date Document Version Description of Modifications/Release
05/05/2016 1.3 Document updated for Hotfix Release
09/16/2015 1.2 Added support forWebSphere
07/14/2015 1.0 Document Release for MobileFabric Release 6.5
© 2014 by Kony, Inc. All rights reserved 3 of 185
Manual Installation Guide
Version1.3
Table of Contents
1. Preface 10
1.1 Purpose 11
1.2 Intended Audience 11
1.3 Formatting Conventions 11
1.4 Related Documents 12
1.5 Contact Us 12
2. Prerequisites 13
2.1 Prerequisites for MobileFabric with Oracle 13
2.2 Software Requirements 16
2.3 Hardware Requirements 17
2.4 Required Setup Files 18
3. MobileFabric Topology and Components 21
4. Configuring Database for MobileFabric 25
4.0.1 Prerequisites Create Databases 25
4.1 Configuring Kony Identity ServicesDatabase 25
4.1.1 MySQL 25
4.1.2 Oracle 26
4.2 Configuring KonyWorkspace ServicesDatabase 27
4.2.1 MySQL 27
4.2.2 Oracle 27
© 2014 by Kony, Inc. All rights reserved 4 of 185
Manual Installation Guide
Version1.3
4.3 Configuring Kony Accounts ServicesDatabase 28
4.3.1 MySQL 28
4.3.2 Oracle 29
5. Creating Shared Library Folders for MobileFabric - WebSphere 30
6. Creating Data Source for MobileFabric Console - WebSphere 35
6.1 Creating Data Source for MobileFabric Console Schema (SQL Server) 35
6.1.1 Creating a JAAS J2C Authentication 35
6.1.2 Creating a JDBC Provider 37
6.1.3 Creating a Data Source 40
6.1.4 Setting CustomProperties of Data Source 45
6.2 Creating Data Source for MobileFabric Console Schema (Oracle) 50
6.2.1 Creating a JAAS J2C Authentication 51
6.2.2 Creating a JDBC Provider 53
6.2.3 Creating a Data Source 56
6.2.4 Setting CustomProperties of Data Source 61
6.3 Creating Data Source for MobileFabric Console Schema (MySQL) 66
6.3.1 Creating a JAAS J2C Authentication 67
6.3.2 Creating a JDBC Provider 69
6.3.3 Creating a Data Source 72
6.3.4 Setting CustomProperties of Data Source 76
6.4 Configuring Data Source for Integration Service 81
© 2014 by Kony, Inc. All rights reserved 5 of 185
Manual Installation Guide
Version1.3
7. Creating Data Source for MobileFabric Console Schema - WebLogic 82
8. Configuring Installation Mode 83
8.1 How to Configure InstallationModes - Tomcat 83
8.1.1 How to Configure Tomcat Multinode Installation 83
8.2 How to Configure InstallationModes - JBoss 85
8.2.1 How to Configure JBoss for Singlenode Installation 85
8.2.2 How to Configure JBoss for Multinode Installation 85
8.3 How to Configure InstallationModes - WebSphere 85
9. Configuring JNDI for a Database 87
9.1 How to Configure JNDI - Tomcat 87
9.1.1 For MySQL 87
9.2 How to Configure JNDI - JBoss 89
9.2.1 For MySQL 89
10. Configuring Connectors and WAR Deployment 94
10.1 How to Configure Connectors - Tomcat 94
10.1.1 How to Configure Batch Files 95
10.2 How to Configure Connectors - JBoss 96
10.2.1 How to Configure Deployment of mbaasportal.war file 96
10.2.2 How to Configure Connector 96
11. Configuring Properties Files in WAR Files 98
11.1 How ToConfigure Properties Files inWAR Files - Tomcat and JBoss 98
© 2014 by Kony, Inc. All rights reserved 6 of 185
Manual Installation Guide
Version1.3
11.1.1 accountsAPI.war 98
11.1.2 authService.war 100
11.1.3 mbaasportal.war 101
11.1.4 workspaceService.war 102
11.2 How ToConfigure Properties Files inWAR Files - WebSphere 103
11.2.1 accountsAPI.war 103
11.2.2 authService.war 104
11.2.3 mbaasportal.war 107
11.2.4 workspaceService.war 108
11.2.5 KonyMobileFabric Integration Service (middleware) 110
11.3 How ToConfigure Properties Files inWAR Files - WebLogic 111
11.3.1 accountsAPI.war 111
11.3.2 authService.war 111
11.3.3 mbaasportal.war 115
11.3.4 workspaceService.war 115
11.3.5 KonyMobileFabric Integration Service (middleware) 117
12. Deploying WAR Files 118
12.1 DeployingWAR Files to Tomcat and JBoss 118
12.2 DeployingWAR Files toWebSphere 119
12.2.1 DeployingMetrics.ear toWebSphere 133
12.3 DeployingWAR Files toWebLogic 146
© 2014 by Kony, Inc. All rights reserved 7 of 185
Manual Installation Guide
Version1.3
13. Configuring Kony MobileFabric as a Service 149
14. Starting Kony MobileFabric Console 150
14.1 Tomcat 150
14.2 JBoss 150
14.2.1 For Single Node 150
14.2.2 For Multinode 151
15. Upgrading Kony MobileFabric Components 152
15.1 Upgrading KonyMobileFabric Console from 6.5.2 GA to 6.5.2.x 152
15.2 UpgradingWorkspace (WaaS) from 6.5.2 GA to 6.5.2.x 153
15.3 Upgrading Accounts from 6.5.2 GA to 6.5.2.x 155
15.4 Upgrading Identity from 6.5.2 GA to 6.5.2.x 156
15.5 Upgrading Integration (Middleware) from 6.5.2 GA to 6.5.2.x 158
15.5.1 UpgradingMiddleware from 6.5.2 GA to 6.5.2.x - Tomcat and JBoss 158
15.5.2 Upgrading hotfix patches from 6.5.2 GA to 6.5.2.x - WebLogic 159
15.5.3 Upgrading hotfix patches from 6.5.2 GA to 6.5.2.x - WebSphere (Standalone,
without MobileFabric) 161
15.6 UpgradingMetrics from 6.5.2 GA to 6.5.2.x 162
15.6.1 Upgrading hotfix patches from 6.5.2 GA 162
15.6.2 Upgrading Jasper Single-Tenant License from 6.5.2.2 to 6.5.2.4 165
16. Post-Installation Tasks 168
16.1 Configuring Secure Sockets Layer (SSL) Certificate 168
© 2014 by Kony, Inc. All rights reserved 8 of 185
Manual Installation Guide
Version1.3
16.1.1 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 168
16.1.2 How to Add an Existing SSLCertificate to Cacerts 169
16.2 JDK Version Compatibility 170
16.3 How to Switch between JDK Versions 170
16.4 How to ConfigureMemcached for Integration Service 171
17. FAQs and Troubleshooting 173
17.1 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products Running
on JDK 1.6 175
17.1.1 How to Enable SSLv2Hello Protocol in the standalone.xml File for Single Node 176
17.1.2 How to Enable SSLv2Hello Protocol in the domain.xml File for Multinode 176
17.2 WebSphere FAQs 177
17.3 FAQs and Troubleshooting 177
17.3.1 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products
Running on JDK 1.6 180
17.3.2 WebSphere FAQs 182
17.4 How to Change Log Levels 182
© 2014 by Kony, Inc. All rights reserved 9 of 185
1. Preface Manual Installation Guide
Version1.3
1. Preface
KonyMobileFabric is aMobile Backend as a Service (MBaaS) provider that helps developers build
native and web apps for mobile. MobileFabric allows you to define the back-end to build nativemobile
apps for iOS, Android, and HTML5-based apps for modern browsers. MobileFabric ensures that
developers build mobile applications quickly by focusing on core areas and obtaining secured back
end services instantly. MobileFabric hasmultiple features that can be used - Identity, Integration,
Orchestration, Sync, andMessaging. These features can be accessed through a common, centralized
console.
For successful authentication with users, and to access the centralized features of MobileFabric, Kony
recommends that you install the followingMobileFabric features on premises:
l KonyMobileFabric Identity and Console
l KonyMobileFabric Integration
l KonyMobileFabricMessaging
l KonyMobileFabric Sync
KonyMobileFabric supports the following back-end services for your applications:
l Identity: This feature allows you to define the type of authentication that grants access to your
application. MobileFabric supports the following authentication services: Microsoft Active
Directory, Salesforce, Security AssertionMarkup Language (SAML), Kony SAP Gateway,
Facebook, and KonyUser Repository.
l Integration: This feature allows you to define various back-end services for your application.
You can define the service in XML, SOAP, JSON, Java, Salesforce, and Kony SAP Gateway.
l Orchestration: This feature allows you to create two types of orchestration services. They are:
o Composite: You can run two or more services concurrently or sequentially.
o Looping: You can run a single service in a loop until the loop ends or an exit criteria ismet.
© 2014 by Kony, Inc. All rights reserved 10 of 185
