Kony MobileFabric Installation Guide Windows

172 Pages·2016·4.87 MB·English

Kony MobileFabric™
Installation Guide - Windows
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 174
Kony MobileFabric Installation Guide - Windows
Version1.3
Copyright © 2014 by Kony, Inc.
All rights reserved.
June, 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 174
Kony MobileFabric Installation Guide - Windows
Version1.3
Revision History
Date Document Version Description of Modifications/Release
06/08/2016 1.3 Document updated for 7.0.1.x Hotfix Release
04/26/2016 1.2 Document updated for 7.0.1
02/29/2016 1.0 Document Released for MobileFabric 7.0 GA
© 2014 by Kony, Inc. All rights reserved 3 of 174
Kony MobileFabric Installation Guide - Windows
Version1.3
Table of Contents
1. Preface 7
1.1 Purpose 8
1.2 Intended Audience 8
1.3 Formatting ConventionsUsed in ThisGuide 8
1.4 Related Documents 9
1.5 Contact Us 10
2. Prerequisites 11
2.1 Software Requirements 11
2.2 Hardware Requirements 11
2.3 Heap and PermGen Settings 11
3. MobileFabric Topology and Components 12
3.1 Developer Environment 16
3.2 Production Environment 17
4. Preinstallation Tasks 18
4.1 Prerequisites for MobileFabric with Oracle 18
4.2 Configure Deployment of mbaasportal.war File for Multi-Node 22
4.3 Add a User in Local Group Policy (Log on as a Service) 22
4.4 Install Memcached Server 26
4.5 Increase JVMmemory for WebLogic Server 28
4.6 PlaceMS SQLServer Connector JAR inWebLogic Classpath 28
© 2014 by Kony, Inc. All rights reserved 4 of 174
Kony MobileFabric Installation Guide - Windows
Version1.3
4.7 Configure JMS for Metrics in DomainMode for WebLogic or JBoss 29
4.8 Configure Load Balancers for Sending Host Information inMultinode 35
4.9 Configure Hibernate Dialect inWebLogic (only for WebLogic) 36
4.10 Update Listen Interfaces in host.xml for JBossCluster 36
4.11 Comment the javax-persistence-module for Kony Engagement Services on JBoss
Cluster 37
4.12 Increase innodb_log_file_size in my.ini file 38
4.13 Create Locator Component for Oracle Database 38
4.14 Configure Load Balancer as Proxy in JBossMultinode Setup (Optional if SSLOffloading
at Load Balancer) 40
5. Installation Modes - Kony MobileFabric 42
5.1 Installing KonyMobileFabric 43
5.1.1 StandaloneMode (Single Node) Installation 43
5.1.1.1 Log Location for Single Node Installation 94
5.1.2 JBossDomainMode (Multinode) Installation 98
5.1.2.1 Log Location for Multinode Installation 128
5.2 Installing KonyMobileFabric - Silent-mode 132
6. Upgrading Kony MobileFabric Components 134
6.1 Prerequisites 134
7. Installing Hotfix Archives for MobileFabric - Windows 144
7.1 Patch Installer GA Versions 144
7.2 Prerequisites 144
© 2014 by Kony, Inc. All rights reserved 5 of 174
Kony MobileFabric Installation Guide - Windows
Version1.3
8. Uninstalling Kony MobileFabric 153
9. Post-Installation Tasks 159
9.1 Configuring Secure Sockets Layer (SSL) Certificate 159
9.1.1 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 159
9.1.2 How to Add an Existing SSLCertificate to Cacerts 160
9.2 JDK Version Compatibility 161
9.3 How to ConfigureMemcached for Integration Services 161
9.4 How to Update Security Configuration in Config.xml (Required in case ofWebLogic
installation) 162
10. FAQs and Troubleshooting 164
10.1 How to Configure JBossCluster 170
10.2 How to Configure a Custom JAR File onWebLogic 170
10.3 How to Configure Heap and PermGen Size 171
10.3.1 Configuring Heap and PermGen Size for Tomcat 171
10.3.2 Configuring Heap and PermGen Size for JBoss 171
10.3.3 Configuring Heap and PermGen Size for WebLogic 171
10.4 How to ConfigureMobileFabric Behind a Reverse Proxy 172
10.5 How to Configure Frontend HTTPS to Tomcat HTTP Redirection 173
10.6 WebSphere FAQs 174
10.7 How to Change Log Levels 174
© 2014 by Kony, Inc. All rights reserved 6 of 174
1. Preface Kony MobileFabric Installation Guide - Windows
Version1.3
1. Preface
KonyMobileFabric is aMobile Back-end 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, and Engagement Services. 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 KonyMobileFabric Engagement Services
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 used for granting access to
your application. MobileFabric supports the following authentication services: Microsoft Active
Directory, Salesforce, Security AssertionMarkup Language (SAML), Kony SAP Gateway,
Kony 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: Allows you to create two types of orchestration services. They are:
n Composite: Allows you to run two or more services concurrently or sequentially.
n Looping: Allows you to run a single service in a loop until the loop ends or an exit criteria is
met.
© 2014 by Kony, Inc. All rights reserved 7 of 174
1. Preface Kony MobileFabric Installation Guide - Windows
Version1.3
l Synchronization: This feature allows you to define the synchronization services for your
application. Sync supports onlyWeb Services, except SAP Sky.
l Engagement Services: This feature allows you to define and configure pushmessaging
services for your application.
This document explains how to install the KonyMobileFabric console.
1.1 Purpose
The document helps you familiarize with procedural information to install KonyMobileFabric console in
your system.
1.2 Intended Audience
This document is intended for engineers or developers who are responsible for installing and
configuring KonyMobileFabric. We assume that the reader of this document is familiar with installing
applications in aWindows environment.
1.3 Formatting Conventions Used in This Guide
The following formatting conventions are used throughout the document:
Convention Explanation
Monospace l User input text, system prompts, and responses
l File path
l Commands
l Program code
l File names
© 2014 by Kony, Inc. All rights reserved 8 of 174
1. Preface Kony MobileFabric Installation Guide - Windows
Version1.3
Convention Explanation
Italic l Emphasis
l Names of books and documents
l New terminology
Bold l Windows
l Menus
l Buttons
l Icons
l Fields
l Tabs
URL Active link to a URL
Provides helpful hints or additional information.
Note:
Highlights actions or information that might cause problems to
Important:
systems or data
1.4 Related Documents
Document Purpose
Kony MobileFabric This guide helps you understand how to create a Kony MobileFabric
User Guide account, add services, and publish apps.
© 2014 by Kony, Inc. All rights reserved 9 of 174
1. Preface Kony MobileFabric Installation Guide - Windows
Version1.3
1.5 Contact Us
Wewelcome your feedback on our documentation. Email us at