Kony MobileFabric Installation Guide - Linux

121 Pages·2016·1.43 MB·English

Kony MobileFabric™
Installation Guide - Linux
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 123
Kony MobileFabric Installation Guide - Linux
Version5.0
Copyright © 2014 by Kony, Inc.
All rights reserved.
August, 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 123
Kony MobileFabric On-Premises Installation Guide – Linux Ver - 1.0
Revision History
Date Document Version Description of Modifications/Release
08/31/2015 5.0 Updated for 6.5.2 hot fix.
Added support forWebSphere
07/14/2015 4.0 Document Release for 6.5 GA:
l Added support for Oracle DB
l Added support forWebLogic
l Added support for Kony Integration
Service
03/30/2015 3.0 Document is updated for Release 6.0.3
02/19/2015 2.0 Document updated for 6.0.2 Release (Added
support for Apache Tomcat 7.0.52 and JDK 1.6)
01/22/2015 1.0 Document Release for Fall Wave Release 6.0
Copyright © 2014 Kony, Inc., All rights reserved. Page 3 of 123
Kony MobileFabric On-Premises Installation Guide – Linux Ver - 1.0
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 9
2. Prerequisites 10
2.1 Software Requirements 10
2.2 Hardware Requirements 11
2.3 Creating the Installation User for Linux 12
3. MobileFabric Topology and Components 13
3.1 Developer Environment 17
3.2 Production Environment 18
4. Preinstallation Tasks 19
4.1 Prerequisites for MobileFabric with Oracle 19
4.2 DownloadMobileFabric Installer 21
4.3 How to Configure Deployment of mbaasportal.war File for Multi-Node 23
4.4 How to Install Memcached Server 23
4.4.1 libevent (memcached dependency) 23
4.4.2 Memcached Server 24
Copyright © 2014 Kony, Inc., All rights reserved. Page 4 of 123
Kony MobileFabric On-Premises Installation Guide – Linux Ver - 1.0
4.5 How to Increase JVMmemory for WebLogic Server 25
4.6 How to PlaceMS SQLServer Connector JAR inWebLogic Classpath 26
4.7 How to DeployMetrics in DomainMode for WebLogic or JBoss 27
4.8 How to Configure Load Balancers for Sending Host Information inMultinode 30
4.9 How to Create Locator Component for Oracle Database 31
4.10 How to Configure Load balancer as Proxy in JBossMultinode Setup (Optional if SSL
Offloading at Load Balancer) 33
5. Installation Modes - Kony MobileFabric 34
5.1 Installing KonyMobileFabric 35
5.1.1 StandaloneMode (Single Node) Installation 35
5.1.1.1 Logs for Single Node Installation 73
5.1.2 JBossDomainMode (Multinode) Installation 76
5.1.2.1 Logs for Multinode Installation 101
5.2 Installing KonyMobileFabric - Silent-mode 104
6. Uninstalling Kony MobileFabric 106
7. Post-Installation Tasks 109
7.1 Configuring Secure Sockets Layer (SSL) Certificate 109
7.1.1 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 109
7.1.2 How to Add an Existing SSLCertificate to Cacerts 110
7.2 JDK Version Compatibility 111
7.3 How to Switch between JDK Versions 111
7.4 How to ConfigureMemcached for Integration Service 112
Copyright © 2014 Kony, Inc., All rights reserved. Page 5 of 123
Kony MobileFabric On-Premises Installation Guide – Linux Ver - 1.0
8. FAQs and Troubleshooting 114
8.1 How to Configure Custom JAR File onWeblogic 117
8.2 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products Running
on JDK 1.6 118
8.2.1 How to Enable SSLv2Hello Protocol in the standalone.xml File for Single Node 118
8.2.2 How to Enable SSLv2Hello Protocol in the domain.xml File for Multinode 119
8.3 WebSphere FAQs 120
8.4 How to Change Log Levels 120
Copyright © 2014 Kony, Inc., All rights reserved. Page 6 of 123
1. Preface Kony MobileFabric Installation Guide - Linux
Version5.0
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, andMessaging. These features can be accessed through a common, centralized
console.
For successful authentication with users, and to access 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 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: This feature 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 123
1. Preface Kony MobileFabric Installation Guide - Linux
Version5.0
l Synchronization: This feature allows you to define the synchronization services for your
application. Sync supports onlyWeb Services, except SAP Sky.
l Messaging: This feature allows you to define and configure pushmessaging services for your
application.
1.1 Purpose
This document explains how to install the KonyMobileFabric Console.
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 a Linux 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
Italic l Emphasis
l Names of books and documents
l New terminology
© 2014 by Kony, Inc. All rights reserved 8 of 123
1. Preface Kony MobileFabric Installation Guide - Linux
Version5.0
Convention Explanation
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 systems or
Important:
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.
1.5 Contact Us
Wewelcome your feedback on our documentation. Email us at
2. Prerequisites Kony MobileFabric Installation Guide - Linux
Version5.0
2. Prerequisites
The following sections provide information about the software and hardware required to install Kony
MobileFabric Console.
2.1 Software Requirements
Purpose Software Requirement
Kony KonyMobileFabricInstaller-6.5.0.GA.bin
MobileFabric
installer
Database MySQL 5.6
Server
Oracle 12.1.0 (12.1.0)
* Database is
shared across
MS SQL Server 2012 R2
instances.
Note: A database user should be granted all permissions.
Note: Increase your database connection limit to use the same database for
all components - such as Kony MobileFabric Console, Kony Identity
Service, and Kony Integration Service.
For example:
To increaseMySQL database connection limit, execute the following
command:
SET global max_connections = 350;
Note: Ensure that a database user should be granted all privileges like
create update, and delete database schema, views, jobs, andmanage
schedulers.
© 2014 by Kony, Inc. All rights reserved 10 of 123