kony mobilefabric installer guide

185
Kony 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

Upload: others

Post on 11-Sep-2021

27 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Kony MobileFabric Installer Guide

Kony MobileFabrictrade

Manual Installation Guide

On-Premises

Release 65Document 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

copy 2014 by Kony Inc All rights reserved 1 of 185

Manual Installation GuideVersion13

Copyright copy 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 KonyModelerand 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

copy 2014 by Kony Inc All rights reserved 2 of 185

Manual Installation GuideVersion13

Revision History

Date Document Version Description of ModificationsRelease

05052016 13 Document updated for Hotfix Release

09162015 12 Added support forWebSphere

07142015 10 Document Release for MobileFabric Release 65

copy 2014 by Kony Inc All rights reserved 3 of 185

Manual Installation GuideVersion13

Table of Contents

1 Preface 10

11 Purpose 11

12 Intended Audience 11

13 Formatting Conventions 11

14 Related Documents 12

15 Contact Us 12

2 Prerequisites 13

21 Prerequisites for MobileFabric with Oracle 13

22 Software Requirements 16

23 Hardware Requirements 17

24 Required Setup Files 18

3 MobileFabric Topology and Components 21

4 Configuring Database for MobileFabric 25

401 Prerequisites Create Databases 25

41 Configuring Kony Identity ServicesDatabase 25

411 MySQL 25

412 Oracle 26

42 Configuring KonyWorkspace ServicesDatabase 27

421 MySQL 27

422 Oracle 27

copy 2014 by Kony Inc All rights reserved 4 of 185

Manual Installation GuideVersion13

43 Configuring Kony Accounts ServicesDatabase 28

431 MySQL 28

432 Oracle 29

5 Creating Shared Library Folders for MobileFabric - WebSphere 30

6 Creating Data Source for MobileFabric Console - WebSphere 35

61 Creating Data Source for MobileFabric Console Schema (SQL Server) 35

611 Creating a JAAS J2C Authentication 35

612 Creating a JDBC Provider 37

613 Creating a Data Source 40

614 Setting CustomProperties of Data Source 45

62 Creating Data Source for MobileFabric Console Schema (Oracle) 50

621 Creating a JAAS J2C Authentication 51

622 Creating a JDBC Provider 53

623 Creating a Data Source 56

624 Setting CustomProperties of Data Source 61

63 Creating Data Source for MobileFabric Console Schema (MySQL) 66

631 Creating a JAAS J2C Authentication 67

632 Creating a JDBC Provider 69

633 Creating a Data Source 72

634 Setting CustomProperties of Data Source 76

64 Configuring Data Source for Integration Service 81

copy 2014 by Kony Inc All rights reserved 5 of 185

Manual Installation GuideVersion13

7 Creating Data Source for MobileFabric Console Schema - WebLogic 82

8 Configuring Installation Mode 83

81 How to Configure InstallationModes - Tomcat 83

811 How to Configure Tomcat Multinode Installation 83

82 How to Configure InstallationModes - JBoss 85

821 How to Configure JBoss for Singlenode Installation 85

822 How to Configure JBoss for Multinode Installation 85

83 How to Configure InstallationModes - WebSphere 85

9 Configuring JNDI for a Database 87

91 How to Configure JNDI - Tomcat 87

911 For MySQL 87

92 How to Configure JNDI - JBoss 89

921 For MySQL 89

10 Configuring Connectors and WAR Deployment 94

101 How to Configure Connectors - Tomcat 94

1011 How to Configure Batch Files 95

102 How to Configure Connectors - JBoss 96

1021 How to Configure Deployment of mbaasportalwar file 96

1022 How to Configure Connector 96

11 Configuring Properties Files in WAR Files 98

111 How ToConfigure Properties Files inWAR Files - Tomcat and JBoss 98

copy 2014 by Kony Inc All rights reserved 6 of 185

Manual Installation GuideVersion13

1111 accountsAPIwar 98

1112 authServicewar 100

1113 mbaasportalwar 101

1114 workspaceServicewar 102

112 How ToConfigure Properties Files inWAR Files - WebSphere 103

1121 accountsAPIwar 103

1122 authServicewar 104

1123 mbaasportalwar 107

1124 workspaceServicewar 108

1125 KonyMobileFabric Integration Service (middleware) 110

113 How ToConfigure Properties Files inWAR Files - WebLogic 111

1131 accountsAPIwar 111

1132 authServicewar 111

1133 mbaasportalwar 115

1134 workspaceServicewar 115

1135 KonyMobileFabric Integration Service (middleware) 117

12 Deploying WAR Files 118

121 DeployingWAR Files to Tomcat and JBoss 118

122 DeployingWAR Files toWebSphere 119

1221 DeployingMetricsear toWebSphere 133

123 DeployingWAR Files toWebLogic 146

copy 2014 by Kony Inc All rights reserved 7 of 185

Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service 149

14 Starting Kony MobileFabric Console 150

141 Tomcat 150

142 JBoss 150

1421 For Single Node 150

1422 For Multinode 151

15 Upgrading Kony MobileFabric Components 152

151 Upgrading KonyMobileFabric Console from 652 GA to 652x 152

152 UpgradingWorkspace (WaaS) from 652 GA to 652x 153

153 Upgrading Accounts from 652 GA to 652x 155

154 Upgrading Identity from 652 GA to 652x 156

155 Upgrading Integration (Middleware) from 652 GA to 652x 158

1551 UpgradingMiddleware from 652 GA to 652x - Tomcat and JBoss 158

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic 159

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric) 161

156 UpgradingMetrics from 652 GA to 652x 162

1561 Upgrading hotfix patches from 652 GA 162

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524 165

16 Post-Installation Tasks 168

161 Configuring Secure Sockets Layer (SSL) Certificate 168

copy 2014 by Kony Inc All rights reserved 8 of 185

Manual Installation GuideVersion13

1611 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 168

1612 How to Add an Existing SSLCertificate to Cacerts 169

162 JDK Version Compatibility 170

163 How to Switch between JDK Versions 170

164 How to ConfigureMemcached for Integration Service 171

17 FAQs and Troubleshooting 173

171 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products Running

on JDK 16 175

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node 176

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode 176

172 WebSphere FAQs 177

173 FAQs and Troubleshooting 177

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products

Running on JDK 16 180

1732 WebSphere FAQs 182

174 How to Change Log Levels 182

copy 2014 by Kony Inc All rights reserved 9 of 185

1 Preface Manual Installation GuideVersion13

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

copy 2014 by Kony Inc All rights reserved 10 of 185

1 Preface Manual Installation GuideVersion13

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

11 Purpose

This document explains how to install and configure KonyMobileFabric Console

12 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 or Linux environment

13 Formatting Conventions

The following formatting conventions are used throughout the document

Convention Explanation

Monospace n User input text system prompts and responses

n File path

n Commands

n Program code

n File names

Italic n Emphasis

n Names of books and documents

n New terminology

copy 2014 by Kony Inc All rights reserved 11 of 185

1 Preface Manual Installation GuideVersion13

Convention Explanation

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

NoteProvides helpful hints or additional information

ImportantHighlights actions or information that might cause problems to systems or

data

14 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account add services and publish apps

15 Contact Us

Wewelcome your feedback on our documentation Email us at techpubskonycom

For technical questions suggestions and comments or to report problems on Konys product line

contact productsupportkonycom

copy 2014 by Kony Inc All rights reserved 12 of 185

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 2: Kony MobileFabric Installer Guide

Manual Installation GuideVersion13

Copyright copy 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 KonyModelerand 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

copy 2014 by Kony Inc All rights reserved 2 of 185

Manual Installation GuideVersion13

Revision History

Date Document Version Description of ModificationsRelease

05052016 13 Document updated for Hotfix Release

09162015 12 Added support forWebSphere

07142015 10 Document Release for MobileFabric Release 65

copy 2014 by Kony Inc All rights reserved 3 of 185

Manual Installation GuideVersion13

Table of Contents

1 Preface 10

11 Purpose 11

12 Intended Audience 11

13 Formatting Conventions 11

14 Related Documents 12

15 Contact Us 12

2 Prerequisites 13

21 Prerequisites for MobileFabric with Oracle 13

22 Software Requirements 16

23 Hardware Requirements 17

24 Required Setup Files 18

3 MobileFabric Topology and Components 21

4 Configuring Database for MobileFabric 25

401 Prerequisites Create Databases 25

41 Configuring Kony Identity ServicesDatabase 25

411 MySQL 25

412 Oracle 26

42 Configuring KonyWorkspace ServicesDatabase 27

421 MySQL 27

422 Oracle 27

copy 2014 by Kony Inc All rights reserved 4 of 185

Manual Installation GuideVersion13

43 Configuring Kony Accounts ServicesDatabase 28

431 MySQL 28

432 Oracle 29

5 Creating Shared Library Folders for MobileFabric - WebSphere 30

6 Creating Data Source for MobileFabric Console - WebSphere 35

61 Creating Data Source for MobileFabric Console Schema (SQL Server) 35

611 Creating a JAAS J2C Authentication 35

612 Creating a JDBC Provider 37

613 Creating a Data Source 40

614 Setting CustomProperties of Data Source 45

62 Creating Data Source for MobileFabric Console Schema (Oracle) 50

621 Creating a JAAS J2C Authentication 51

622 Creating a JDBC Provider 53

623 Creating a Data Source 56

624 Setting CustomProperties of Data Source 61

63 Creating Data Source for MobileFabric Console Schema (MySQL) 66

631 Creating a JAAS J2C Authentication 67

632 Creating a JDBC Provider 69

633 Creating a Data Source 72

634 Setting CustomProperties of Data Source 76

64 Configuring Data Source for Integration Service 81

copy 2014 by Kony Inc All rights reserved 5 of 185

Manual Installation GuideVersion13

7 Creating Data Source for MobileFabric Console Schema - WebLogic 82

8 Configuring Installation Mode 83

81 How to Configure InstallationModes - Tomcat 83

811 How to Configure Tomcat Multinode Installation 83

82 How to Configure InstallationModes - JBoss 85

821 How to Configure JBoss for Singlenode Installation 85

822 How to Configure JBoss for Multinode Installation 85

83 How to Configure InstallationModes - WebSphere 85

9 Configuring JNDI for a Database 87

91 How to Configure JNDI - Tomcat 87

911 For MySQL 87

92 How to Configure JNDI - JBoss 89

921 For MySQL 89

10 Configuring Connectors and WAR Deployment 94

101 How to Configure Connectors - Tomcat 94

1011 How to Configure Batch Files 95

102 How to Configure Connectors - JBoss 96

1021 How to Configure Deployment of mbaasportalwar file 96

1022 How to Configure Connector 96

11 Configuring Properties Files in WAR Files 98

111 How ToConfigure Properties Files inWAR Files - Tomcat and JBoss 98

copy 2014 by Kony Inc All rights reserved 6 of 185

Manual Installation GuideVersion13

1111 accountsAPIwar 98

1112 authServicewar 100

1113 mbaasportalwar 101

1114 workspaceServicewar 102

112 How ToConfigure Properties Files inWAR Files - WebSphere 103

1121 accountsAPIwar 103

1122 authServicewar 104

1123 mbaasportalwar 107

1124 workspaceServicewar 108

1125 KonyMobileFabric Integration Service (middleware) 110

113 How ToConfigure Properties Files inWAR Files - WebLogic 111

1131 accountsAPIwar 111

1132 authServicewar 111

1133 mbaasportalwar 115

1134 workspaceServicewar 115

1135 KonyMobileFabric Integration Service (middleware) 117

12 Deploying WAR Files 118

121 DeployingWAR Files to Tomcat and JBoss 118

122 DeployingWAR Files toWebSphere 119

1221 DeployingMetricsear toWebSphere 133

123 DeployingWAR Files toWebLogic 146

copy 2014 by Kony Inc All rights reserved 7 of 185

Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service 149

14 Starting Kony MobileFabric Console 150

141 Tomcat 150

142 JBoss 150

1421 For Single Node 150

1422 For Multinode 151

15 Upgrading Kony MobileFabric Components 152

151 Upgrading KonyMobileFabric Console from 652 GA to 652x 152

152 UpgradingWorkspace (WaaS) from 652 GA to 652x 153

153 Upgrading Accounts from 652 GA to 652x 155

154 Upgrading Identity from 652 GA to 652x 156

155 Upgrading Integration (Middleware) from 652 GA to 652x 158

1551 UpgradingMiddleware from 652 GA to 652x - Tomcat and JBoss 158

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic 159

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric) 161

156 UpgradingMetrics from 652 GA to 652x 162

1561 Upgrading hotfix patches from 652 GA 162

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524 165

16 Post-Installation Tasks 168

161 Configuring Secure Sockets Layer (SSL) Certificate 168

copy 2014 by Kony Inc All rights reserved 8 of 185

Manual Installation GuideVersion13

1611 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 168

1612 How to Add an Existing SSLCertificate to Cacerts 169

162 JDK Version Compatibility 170

163 How to Switch between JDK Versions 170

164 How to ConfigureMemcached for Integration Service 171

17 FAQs and Troubleshooting 173

171 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products Running

on JDK 16 175

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node 176

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode 176

172 WebSphere FAQs 177

173 FAQs and Troubleshooting 177

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products

Running on JDK 16 180

1732 WebSphere FAQs 182

174 How to Change Log Levels 182

copy 2014 by Kony Inc All rights reserved 9 of 185

1 Preface Manual Installation GuideVersion13

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

copy 2014 by Kony Inc All rights reserved 10 of 185

1 Preface Manual Installation GuideVersion13

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

11 Purpose

This document explains how to install and configure KonyMobileFabric Console

12 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 or Linux environment

13 Formatting Conventions

The following formatting conventions are used throughout the document

Convention Explanation

Monospace n User input text system prompts and responses

n File path

n Commands

n Program code

n File names

Italic n Emphasis

n Names of books and documents

n New terminology

copy 2014 by Kony Inc All rights reserved 11 of 185

1 Preface Manual Installation GuideVersion13

Convention Explanation

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

NoteProvides helpful hints or additional information

ImportantHighlights actions or information that might cause problems to systems or

data

14 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account add services and publish apps

15 Contact Us

Wewelcome your feedback on our documentation Email us at techpubskonycom

For technical questions suggestions and comments or to report problems on Konys product line

contact productsupportkonycom

copy 2014 by Kony Inc All rights reserved 12 of 185

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 3: Kony MobileFabric Installer Guide

Manual Installation GuideVersion13

Revision History

Date Document Version Description of ModificationsRelease

05052016 13 Document updated for Hotfix Release

09162015 12 Added support forWebSphere

07142015 10 Document Release for MobileFabric Release 65

copy 2014 by Kony Inc All rights reserved 3 of 185

Manual Installation GuideVersion13

Table of Contents

1 Preface 10

11 Purpose 11

12 Intended Audience 11

13 Formatting Conventions 11

14 Related Documents 12

15 Contact Us 12

2 Prerequisites 13

21 Prerequisites for MobileFabric with Oracle 13

22 Software Requirements 16

23 Hardware Requirements 17

24 Required Setup Files 18

3 MobileFabric Topology and Components 21

4 Configuring Database for MobileFabric 25

401 Prerequisites Create Databases 25

41 Configuring Kony Identity ServicesDatabase 25

411 MySQL 25

412 Oracle 26

42 Configuring KonyWorkspace ServicesDatabase 27

421 MySQL 27

422 Oracle 27

copy 2014 by Kony Inc All rights reserved 4 of 185

Manual Installation GuideVersion13

43 Configuring Kony Accounts ServicesDatabase 28

431 MySQL 28

432 Oracle 29

5 Creating Shared Library Folders for MobileFabric - WebSphere 30

6 Creating Data Source for MobileFabric Console - WebSphere 35

61 Creating Data Source for MobileFabric Console Schema (SQL Server) 35

611 Creating a JAAS J2C Authentication 35

612 Creating a JDBC Provider 37

613 Creating a Data Source 40

614 Setting CustomProperties of Data Source 45

62 Creating Data Source for MobileFabric Console Schema (Oracle) 50

621 Creating a JAAS J2C Authentication 51

622 Creating a JDBC Provider 53

623 Creating a Data Source 56

624 Setting CustomProperties of Data Source 61

63 Creating Data Source for MobileFabric Console Schema (MySQL) 66

631 Creating a JAAS J2C Authentication 67

632 Creating a JDBC Provider 69

633 Creating a Data Source 72

634 Setting CustomProperties of Data Source 76

64 Configuring Data Source for Integration Service 81

copy 2014 by Kony Inc All rights reserved 5 of 185

Manual Installation GuideVersion13

7 Creating Data Source for MobileFabric Console Schema - WebLogic 82

8 Configuring Installation Mode 83

81 How to Configure InstallationModes - Tomcat 83

811 How to Configure Tomcat Multinode Installation 83

82 How to Configure InstallationModes - JBoss 85

821 How to Configure JBoss for Singlenode Installation 85

822 How to Configure JBoss for Multinode Installation 85

83 How to Configure InstallationModes - WebSphere 85

9 Configuring JNDI for a Database 87

91 How to Configure JNDI - Tomcat 87

911 For MySQL 87

92 How to Configure JNDI - JBoss 89

921 For MySQL 89

10 Configuring Connectors and WAR Deployment 94

101 How to Configure Connectors - Tomcat 94

1011 How to Configure Batch Files 95

102 How to Configure Connectors - JBoss 96

1021 How to Configure Deployment of mbaasportalwar file 96

1022 How to Configure Connector 96

11 Configuring Properties Files in WAR Files 98

111 How ToConfigure Properties Files inWAR Files - Tomcat and JBoss 98

copy 2014 by Kony Inc All rights reserved 6 of 185

Manual Installation GuideVersion13

1111 accountsAPIwar 98

1112 authServicewar 100

1113 mbaasportalwar 101

1114 workspaceServicewar 102

112 How ToConfigure Properties Files inWAR Files - WebSphere 103

1121 accountsAPIwar 103

1122 authServicewar 104

1123 mbaasportalwar 107

1124 workspaceServicewar 108

1125 KonyMobileFabric Integration Service (middleware) 110

113 How ToConfigure Properties Files inWAR Files - WebLogic 111

1131 accountsAPIwar 111

1132 authServicewar 111

1133 mbaasportalwar 115

1134 workspaceServicewar 115

1135 KonyMobileFabric Integration Service (middleware) 117

12 Deploying WAR Files 118

121 DeployingWAR Files to Tomcat and JBoss 118

122 DeployingWAR Files toWebSphere 119

1221 DeployingMetricsear toWebSphere 133

123 DeployingWAR Files toWebLogic 146

copy 2014 by Kony Inc All rights reserved 7 of 185

Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service 149

14 Starting Kony MobileFabric Console 150

141 Tomcat 150

142 JBoss 150

1421 For Single Node 150

1422 For Multinode 151

15 Upgrading Kony MobileFabric Components 152

151 Upgrading KonyMobileFabric Console from 652 GA to 652x 152

152 UpgradingWorkspace (WaaS) from 652 GA to 652x 153

153 Upgrading Accounts from 652 GA to 652x 155

154 Upgrading Identity from 652 GA to 652x 156

155 Upgrading Integration (Middleware) from 652 GA to 652x 158

1551 UpgradingMiddleware from 652 GA to 652x - Tomcat and JBoss 158

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic 159

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric) 161

156 UpgradingMetrics from 652 GA to 652x 162

1561 Upgrading hotfix patches from 652 GA 162

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524 165

16 Post-Installation Tasks 168

161 Configuring Secure Sockets Layer (SSL) Certificate 168

copy 2014 by Kony Inc All rights reserved 8 of 185

Manual Installation GuideVersion13

1611 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 168

1612 How to Add an Existing SSLCertificate to Cacerts 169

162 JDK Version Compatibility 170

163 How to Switch between JDK Versions 170

164 How to ConfigureMemcached for Integration Service 171

17 FAQs and Troubleshooting 173

171 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products Running

on JDK 16 175

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node 176

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode 176

172 WebSphere FAQs 177

173 FAQs and Troubleshooting 177

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products

Running on JDK 16 180

1732 WebSphere FAQs 182

174 How to Change Log Levels 182

copy 2014 by Kony Inc All rights reserved 9 of 185

1 Preface Manual Installation GuideVersion13

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

copy 2014 by Kony Inc All rights reserved 10 of 185

1 Preface Manual Installation GuideVersion13

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

11 Purpose

This document explains how to install and configure KonyMobileFabric Console

12 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 or Linux environment

13 Formatting Conventions

The following formatting conventions are used throughout the document

Convention Explanation

Monospace n User input text system prompts and responses

n File path

n Commands

n Program code

n File names

Italic n Emphasis

n Names of books and documents

n New terminology

copy 2014 by Kony Inc All rights reserved 11 of 185

1 Preface Manual Installation GuideVersion13

Convention Explanation

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

NoteProvides helpful hints or additional information

ImportantHighlights actions or information that might cause problems to systems or

data

14 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account add services and publish apps

15 Contact Us

Wewelcome your feedback on our documentation Email us at techpubskonycom

For technical questions suggestions and comments or to report problems on Konys product line

contact productsupportkonycom

copy 2014 by Kony Inc All rights reserved 12 of 185

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 4: Kony MobileFabric Installer Guide

Manual Installation GuideVersion13

Table of Contents

1 Preface 10

11 Purpose 11

12 Intended Audience 11

13 Formatting Conventions 11

14 Related Documents 12

15 Contact Us 12

2 Prerequisites 13

21 Prerequisites for MobileFabric with Oracle 13

22 Software Requirements 16

23 Hardware Requirements 17

24 Required Setup Files 18

3 MobileFabric Topology and Components 21

4 Configuring Database for MobileFabric 25

401 Prerequisites Create Databases 25

41 Configuring Kony Identity ServicesDatabase 25

411 MySQL 25

412 Oracle 26

42 Configuring KonyWorkspace ServicesDatabase 27

421 MySQL 27

422 Oracle 27

copy 2014 by Kony Inc All rights reserved 4 of 185

Manual Installation GuideVersion13

43 Configuring Kony Accounts ServicesDatabase 28

431 MySQL 28

432 Oracle 29

5 Creating Shared Library Folders for MobileFabric - WebSphere 30

6 Creating Data Source for MobileFabric Console - WebSphere 35

61 Creating Data Source for MobileFabric Console Schema (SQL Server) 35

611 Creating a JAAS J2C Authentication 35

612 Creating a JDBC Provider 37

613 Creating a Data Source 40

614 Setting CustomProperties of Data Source 45

62 Creating Data Source for MobileFabric Console Schema (Oracle) 50

621 Creating a JAAS J2C Authentication 51

622 Creating a JDBC Provider 53

623 Creating a Data Source 56

624 Setting CustomProperties of Data Source 61

63 Creating Data Source for MobileFabric Console Schema (MySQL) 66

631 Creating a JAAS J2C Authentication 67

632 Creating a JDBC Provider 69

633 Creating a Data Source 72

634 Setting CustomProperties of Data Source 76

64 Configuring Data Source for Integration Service 81

copy 2014 by Kony Inc All rights reserved 5 of 185

Manual Installation GuideVersion13

7 Creating Data Source for MobileFabric Console Schema - WebLogic 82

8 Configuring Installation Mode 83

81 How to Configure InstallationModes - Tomcat 83

811 How to Configure Tomcat Multinode Installation 83

82 How to Configure InstallationModes - JBoss 85

821 How to Configure JBoss for Singlenode Installation 85

822 How to Configure JBoss for Multinode Installation 85

83 How to Configure InstallationModes - WebSphere 85

9 Configuring JNDI for a Database 87

91 How to Configure JNDI - Tomcat 87

911 For MySQL 87

92 How to Configure JNDI - JBoss 89

921 For MySQL 89

10 Configuring Connectors and WAR Deployment 94

101 How to Configure Connectors - Tomcat 94

1011 How to Configure Batch Files 95

102 How to Configure Connectors - JBoss 96

1021 How to Configure Deployment of mbaasportalwar file 96

1022 How to Configure Connector 96

11 Configuring Properties Files in WAR Files 98

111 How ToConfigure Properties Files inWAR Files - Tomcat and JBoss 98

copy 2014 by Kony Inc All rights reserved 6 of 185

Manual Installation GuideVersion13

1111 accountsAPIwar 98

1112 authServicewar 100

1113 mbaasportalwar 101

1114 workspaceServicewar 102

112 How ToConfigure Properties Files inWAR Files - WebSphere 103

1121 accountsAPIwar 103

1122 authServicewar 104

1123 mbaasportalwar 107

1124 workspaceServicewar 108

1125 KonyMobileFabric Integration Service (middleware) 110

113 How ToConfigure Properties Files inWAR Files - WebLogic 111

1131 accountsAPIwar 111

1132 authServicewar 111

1133 mbaasportalwar 115

1134 workspaceServicewar 115

1135 KonyMobileFabric Integration Service (middleware) 117

12 Deploying WAR Files 118

121 DeployingWAR Files to Tomcat and JBoss 118

122 DeployingWAR Files toWebSphere 119

1221 DeployingMetricsear toWebSphere 133

123 DeployingWAR Files toWebLogic 146

copy 2014 by Kony Inc All rights reserved 7 of 185

Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service 149

14 Starting Kony MobileFabric Console 150

141 Tomcat 150

142 JBoss 150

1421 For Single Node 150

1422 For Multinode 151

15 Upgrading Kony MobileFabric Components 152

151 Upgrading KonyMobileFabric Console from 652 GA to 652x 152

152 UpgradingWorkspace (WaaS) from 652 GA to 652x 153

153 Upgrading Accounts from 652 GA to 652x 155

154 Upgrading Identity from 652 GA to 652x 156

155 Upgrading Integration (Middleware) from 652 GA to 652x 158

1551 UpgradingMiddleware from 652 GA to 652x - Tomcat and JBoss 158

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic 159

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric) 161

156 UpgradingMetrics from 652 GA to 652x 162

1561 Upgrading hotfix patches from 652 GA 162

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524 165

16 Post-Installation Tasks 168

161 Configuring Secure Sockets Layer (SSL) Certificate 168

copy 2014 by Kony Inc All rights reserved 8 of 185

Manual Installation GuideVersion13

1611 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 168

1612 How to Add an Existing SSLCertificate to Cacerts 169

162 JDK Version Compatibility 170

163 How to Switch between JDK Versions 170

164 How to ConfigureMemcached for Integration Service 171

17 FAQs and Troubleshooting 173

171 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products Running

on JDK 16 175

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node 176

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode 176

172 WebSphere FAQs 177

173 FAQs and Troubleshooting 177

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products

Running on JDK 16 180

1732 WebSphere FAQs 182

174 How to Change Log Levels 182

copy 2014 by Kony Inc All rights reserved 9 of 185

1 Preface Manual Installation GuideVersion13

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

copy 2014 by Kony Inc All rights reserved 10 of 185

1 Preface Manual Installation GuideVersion13

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

11 Purpose

This document explains how to install and configure KonyMobileFabric Console

12 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 or Linux environment

13 Formatting Conventions

The following formatting conventions are used throughout the document

Convention Explanation

Monospace n User input text system prompts and responses

n File path

n Commands

n Program code

n File names

Italic n Emphasis

n Names of books and documents

n New terminology

copy 2014 by Kony Inc All rights reserved 11 of 185

1 Preface Manual Installation GuideVersion13

Convention Explanation

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

NoteProvides helpful hints or additional information

ImportantHighlights actions or information that might cause problems to systems or

data

14 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account add services and publish apps

15 Contact Us

Wewelcome your feedback on our documentation Email us at techpubskonycom

For technical questions suggestions and comments or to report problems on Konys product line

contact productsupportkonycom

copy 2014 by Kony Inc All rights reserved 12 of 185

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 5: Kony MobileFabric Installer Guide

Manual Installation GuideVersion13

43 Configuring Kony Accounts ServicesDatabase 28

431 MySQL 28

432 Oracle 29

5 Creating Shared Library Folders for MobileFabric - WebSphere 30

6 Creating Data Source for MobileFabric Console - WebSphere 35

61 Creating Data Source for MobileFabric Console Schema (SQL Server) 35

611 Creating a JAAS J2C Authentication 35

612 Creating a JDBC Provider 37

613 Creating a Data Source 40

614 Setting CustomProperties of Data Source 45

62 Creating Data Source for MobileFabric Console Schema (Oracle) 50

621 Creating a JAAS J2C Authentication 51

622 Creating a JDBC Provider 53

623 Creating a Data Source 56

624 Setting CustomProperties of Data Source 61

63 Creating Data Source for MobileFabric Console Schema (MySQL) 66

631 Creating a JAAS J2C Authentication 67

632 Creating a JDBC Provider 69

633 Creating a Data Source 72

634 Setting CustomProperties of Data Source 76

64 Configuring Data Source for Integration Service 81

copy 2014 by Kony Inc All rights reserved 5 of 185

Manual Installation GuideVersion13

7 Creating Data Source for MobileFabric Console Schema - WebLogic 82

8 Configuring Installation Mode 83

81 How to Configure InstallationModes - Tomcat 83

811 How to Configure Tomcat Multinode Installation 83

82 How to Configure InstallationModes - JBoss 85

821 How to Configure JBoss for Singlenode Installation 85

822 How to Configure JBoss for Multinode Installation 85

83 How to Configure InstallationModes - WebSphere 85

9 Configuring JNDI for a Database 87

91 How to Configure JNDI - Tomcat 87

911 For MySQL 87

92 How to Configure JNDI - JBoss 89

921 For MySQL 89

10 Configuring Connectors and WAR Deployment 94

101 How to Configure Connectors - Tomcat 94

1011 How to Configure Batch Files 95

102 How to Configure Connectors - JBoss 96

1021 How to Configure Deployment of mbaasportalwar file 96

1022 How to Configure Connector 96

11 Configuring Properties Files in WAR Files 98

111 How ToConfigure Properties Files inWAR Files - Tomcat and JBoss 98

copy 2014 by Kony Inc All rights reserved 6 of 185

Manual Installation GuideVersion13

1111 accountsAPIwar 98

1112 authServicewar 100

1113 mbaasportalwar 101

1114 workspaceServicewar 102

112 How ToConfigure Properties Files inWAR Files - WebSphere 103

1121 accountsAPIwar 103

1122 authServicewar 104

1123 mbaasportalwar 107

1124 workspaceServicewar 108

1125 KonyMobileFabric Integration Service (middleware) 110

113 How ToConfigure Properties Files inWAR Files - WebLogic 111

1131 accountsAPIwar 111

1132 authServicewar 111

1133 mbaasportalwar 115

1134 workspaceServicewar 115

1135 KonyMobileFabric Integration Service (middleware) 117

12 Deploying WAR Files 118

121 DeployingWAR Files to Tomcat and JBoss 118

122 DeployingWAR Files toWebSphere 119

1221 DeployingMetricsear toWebSphere 133

123 DeployingWAR Files toWebLogic 146

copy 2014 by Kony Inc All rights reserved 7 of 185

Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service 149

14 Starting Kony MobileFabric Console 150

141 Tomcat 150

142 JBoss 150

1421 For Single Node 150

1422 For Multinode 151

15 Upgrading Kony MobileFabric Components 152

151 Upgrading KonyMobileFabric Console from 652 GA to 652x 152

152 UpgradingWorkspace (WaaS) from 652 GA to 652x 153

153 Upgrading Accounts from 652 GA to 652x 155

154 Upgrading Identity from 652 GA to 652x 156

155 Upgrading Integration (Middleware) from 652 GA to 652x 158

1551 UpgradingMiddleware from 652 GA to 652x - Tomcat and JBoss 158

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic 159

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric) 161

156 UpgradingMetrics from 652 GA to 652x 162

1561 Upgrading hotfix patches from 652 GA 162

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524 165

16 Post-Installation Tasks 168

161 Configuring Secure Sockets Layer (SSL) Certificate 168

copy 2014 by Kony Inc All rights reserved 8 of 185

Manual Installation GuideVersion13

1611 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 168

1612 How to Add an Existing SSLCertificate to Cacerts 169

162 JDK Version Compatibility 170

163 How to Switch between JDK Versions 170

164 How to ConfigureMemcached for Integration Service 171

17 FAQs and Troubleshooting 173

171 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products Running

on JDK 16 175

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node 176

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode 176

172 WebSphere FAQs 177

173 FAQs and Troubleshooting 177

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products

Running on JDK 16 180

1732 WebSphere FAQs 182

174 How to Change Log Levels 182

copy 2014 by Kony Inc All rights reserved 9 of 185

1 Preface Manual Installation GuideVersion13

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

copy 2014 by Kony Inc All rights reserved 10 of 185

1 Preface Manual Installation GuideVersion13

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

11 Purpose

This document explains how to install and configure KonyMobileFabric Console

12 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 or Linux environment

13 Formatting Conventions

The following formatting conventions are used throughout the document

Convention Explanation

Monospace n User input text system prompts and responses

n File path

n Commands

n Program code

n File names

Italic n Emphasis

n Names of books and documents

n New terminology

copy 2014 by Kony Inc All rights reserved 11 of 185

1 Preface Manual Installation GuideVersion13

Convention Explanation

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

NoteProvides helpful hints or additional information

ImportantHighlights actions or information that might cause problems to systems or

data

14 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account add services and publish apps

15 Contact Us

Wewelcome your feedback on our documentation Email us at techpubskonycom

For technical questions suggestions and comments or to report problems on Konys product line

contact productsupportkonycom

copy 2014 by Kony Inc All rights reserved 12 of 185

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 6: Kony MobileFabric Installer Guide

Manual Installation GuideVersion13

7 Creating Data Source for MobileFabric Console Schema - WebLogic 82

8 Configuring Installation Mode 83

81 How to Configure InstallationModes - Tomcat 83

811 How to Configure Tomcat Multinode Installation 83

82 How to Configure InstallationModes - JBoss 85

821 How to Configure JBoss for Singlenode Installation 85

822 How to Configure JBoss for Multinode Installation 85

83 How to Configure InstallationModes - WebSphere 85

9 Configuring JNDI for a Database 87

91 How to Configure JNDI - Tomcat 87

911 For MySQL 87

92 How to Configure JNDI - JBoss 89

921 For MySQL 89

10 Configuring Connectors and WAR Deployment 94

101 How to Configure Connectors - Tomcat 94

1011 How to Configure Batch Files 95

102 How to Configure Connectors - JBoss 96

1021 How to Configure Deployment of mbaasportalwar file 96

1022 How to Configure Connector 96

11 Configuring Properties Files in WAR Files 98

111 How ToConfigure Properties Files inWAR Files - Tomcat and JBoss 98

copy 2014 by Kony Inc All rights reserved 6 of 185

Manual Installation GuideVersion13

1111 accountsAPIwar 98

1112 authServicewar 100

1113 mbaasportalwar 101

1114 workspaceServicewar 102

112 How ToConfigure Properties Files inWAR Files - WebSphere 103

1121 accountsAPIwar 103

1122 authServicewar 104

1123 mbaasportalwar 107

1124 workspaceServicewar 108

1125 KonyMobileFabric Integration Service (middleware) 110

113 How ToConfigure Properties Files inWAR Files - WebLogic 111

1131 accountsAPIwar 111

1132 authServicewar 111

1133 mbaasportalwar 115

1134 workspaceServicewar 115

1135 KonyMobileFabric Integration Service (middleware) 117

12 Deploying WAR Files 118

121 DeployingWAR Files to Tomcat and JBoss 118

122 DeployingWAR Files toWebSphere 119

1221 DeployingMetricsear toWebSphere 133

123 DeployingWAR Files toWebLogic 146

copy 2014 by Kony Inc All rights reserved 7 of 185

Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service 149

14 Starting Kony MobileFabric Console 150

141 Tomcat 150

142 JBoss 150

1421 For Single Node 150

1422 For Multinode 151

15 Upgrading Kony MobileFabric Components 152

151 Upgrading KonyMobileFabric Console from 652 GA to 652x 152

152 UpgradingWorkspace (WaaS) from 652 GA to 652x 153

153 Upgrading Accounts from 652 GA to 652x 155

154 Upgrading Identity from 652 GA to 652x 156

155 Upgrading Integration (Middleware) from 652 GA to 652x 158

1551 UpgradingMiddleware from 652 GA to 652x - Tomcat and JBoss 158

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic 159

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric) 161

156 UpgradingMetrics from 652 GA to 652x 162

1561 Upgrading hotfix patches from 652 GA 162

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524 165

16 Post-Installation Tasks 168

161 Configuring Secure Sockets Layer (SSL) Certificate 168

copy 2014 by Kony Inc All rights reserved 8 of 185

Manual Installation GuideVersion13

1611 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 168

1612 How to Add an Existing SSLCertificate to Cacerts 169

162 JDK Version Compatibility 170

163 How to Switch between JDK Versions 170

164 How to ConfigureMemcached for Integration Service 171

17 FAQs and Troubleshooting 173

171 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products Running

on JDK 16 175

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node 176

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode 176

172 WebSphere FAQs 177

173 FAQs and Troubleshooting 177

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products

Running on JDK 16 180

1732 WebSphere FAQs 182

174 How to Change Log Levels 182

copy 2014 by Kony Inc All rights reserved 9 of 185

1 Preface Manual Installation GuideVersion13

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

copy 2014 by Kony Inc All rights reserved 10 of 185

1 Preface Manual Installation GuideVersion13

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

11 Purpose

This document explains how to install and configure KonyMobileFabric Console

12 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 or Linux environment

13 Formatting Conventions

The following formatting conventions are used throughout the document

Convention Explanation

Monospace n User input text system prompts and responses

n File path

n Commands

n Program code

n File names

Italic n Emphasis

n Names of books and documents

n New terminology

copy 2014 by Kony Inc All rights reserved 11 of 185

1 Preface Manual Installation GuideVersion13

Convention Explanation

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

NoteProvides helpful hints or additional information

ImportantHighlights actions or information that might cause problems to systems or

data

14 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account add services and publish apps

15 Contact Us

Wewelcome your feedback on our documentation Email us at techpubskonycom

For technical questions suggestions and comments or to report problems on Konys product line

contact productsupportkonycom

copy 2014 by Kony Inc All rights reserved 12 of 185

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 7: Kony MobileFabric Installer Guide

Manual Installation GuideVersion13

1111 accountsAPIwar 98

1112 authServicewar 100

1113 mbaasportalwar 101

1114 workspaceServicewar 102

112 How ToConfigure Properties Files inWAR Files - WebSphere 103

1121 accountsAPIwar 103

1122 authServicewar 104

1123 mbaasportalwar 107

1124 workspaceServicewar 108

1125 KonyMobileFabric Integration Service (middleware) 110

113 How ToConfigure Properties Files inWAR Files - WebLogic 111

1131 accountsAPIwar 111

1132 authServicewar 111

1133 mbaasportalwar 115

1134 workspaceServicewar 115

1135 KonyMobileFabric Integration Service (middleware) 117

12 Deploying WAR Files 118

121 DeployingWAR Files to Tomcat and JBoss 118

122 DeployingWAR Files toWebSphere 119

1221 DeployingMetricsear toWebSphere 133

123 DeployingWAR Files toWebLogic 146

copy 2014 by Kony Inc All rights reserved 7 of 185

Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service 149

14 Starting Kony MobileFabric Console 150

141 Tomcat 150

142 JBoss 150

1421 For Single Node 150

1422 For Multinode 151

15 Upgrading Kony MobileFabric Components 152

151 Upgrading KonyMobileFabric Console from 652 GA to 652x 152

152 UpgradingWorkspace (WaaS) from 652 GA to 652x 153

153 Upgrading Accounts from 652 GA to 652x 155

154 Upgrading Identity from 652 GA to 652x 156

155 Upgrading Integration (Middleware) from 652 GA to 652x 158

1551 UpgradingMiddleware from 652 GA to 652x - Tomcat and JBoss 158

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic 159

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric) 161

156 UpgradingMetrics from 652 GA to 652x 162

1561 Upgrading hotfix patches from 652 GA 162

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524 165

16 Post-Installation Tasks 168

161 Configuring Secure Sockets Layer (SSL) Certificate 168

copy 2014 by Kony Inc All rights reserved 8 of 185

Manual Installation GuideVersion13

1611 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 168

1612 How to Add an Existing SSLCertificate to Cacerts 169

162 JDK Version Compatibility 170

163 How to Switch between JDK Versions 170

164 How to ConfigureMemcached for Integration Service 171

17 FAQs and Troubleshooting 173

171 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products Running

on JDK 16 175

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node 176

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode 176

172 WebSphere FAQs 177

173 FAQs and Troubleshooting 177

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products

Running on JDK 16 180

1732 WebSphere FAQs 182

174 How to Change Log Levels 182

copy 2014 by Kony Inc All rights reserved 9 of 185

1 Preface Manual Installation GuideVersion13

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

copy 2014 by Kony Inc All rights reserved 10 of 185

1 Preface Manual Installation GuideVersion13

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

11 Purpose

This document explains how to install and configure KonyMobileFabric Console

12 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 or Linux environment

13 Formatting Conventions

The following formatting conventions are used throughout the document

Convention Explanation

Monospace n User input text system prompts and responses

n File path

n Commands

n Program code

n File names

Italic n Emphasis

n Names of books and documents

n New terminology

copy 2014 by Kony Inc All rights reserved 11 of 185

1 Preface Manual Installation GuideVersion13

Convention Explanation

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

NoteProvides helpful hints or additional information

ImportantHighlights actions or information that might cause problems to systems or

data

14 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account add services and publish apps

15 Contact Us

Wewelcome your feedback on our documentation Email us at techpubskonycom

For technical questions suggestions and comments or to report problems on Konys product line

contact productsupportkonycom

copy 2014 by Kony Inc All rights reserved 12 of 185

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 8: Kony MobileFabric Installer Guide

Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service 149

14 Starting Kony MobileFabric Console 150

141 Tomcat 150

142 JBoss 150

1421 For Single Node 150

1422 For Multinode 151

15 Upgrading Kony MobileFabric Components 152

151 Upgrading KonyMobileFabric Console from 652 GA to 652x 152

152 UpgradingWorkspace (WaaS) from 652 GA to 652x 153

153 Upgrading Accounts from 652 GA to 652x 155

154 Upgrading Identity from 652 GA to 652x 156

155 Upgrading Integration (Middleware) from 652 GA to 652x 158

1551 UpgradingMiddleware from 652 GA to 652x - Tomcat and JBoss 158

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic 159

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric) 161

156 UpgradingMetrics from 652 GA to 652x 162

1561 Upgrading hotfix patches from 652 GA 162

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524 165

16 Post-Installation Tasks 168

161 Configuring Secure Sockets Layer (SSL) Certificate 168

copy 2014 by Kony Inc All rights reserved 8 of 185

Manual Installation GuideVersion13

1611 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 168

1612 How to Add an Existing SSLCertificate to Cacerts 169

162 JDK Version Compatibility 170

163 How to Switch between JDK Versions 170

164 How to ConfigureMemcached for Integration Service 171

17 FAQs and Troubleshooting 173

171 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products Running

on JDK 16 175

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node 176

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode 176

172 WebSphere FAQs 177

173 FAQs and Troubleshooting 177

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products

Running on JDK 16 180

1732 WebSphere FAQs 182

174 How to Change Log Levels 182

copy 2014 by Kony Inc All rights reserved 9 of 185

1 Preface Manual Installation GuideVersion13

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

copy 2014 by Kony Inc All rights reserved 10 of 185

1 Preface Manual Installation GuideVersion13

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

11 Purpose

This document explains how to install and configure KonyMobileFabric Console

12 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 or Linux environment

13 Formatting Conventions

The following formatting conventions are used throughout the document

Convention Explanation

Monospace n User input text system prompts and responses

n File path

n Commands

n Program code

n File names

Italic n Emphasis

n Names of books and documents

n New terminology

copy 2014 by Kony Inc All rights reserved 11 of 185

1 Preface Manual Installation GuideVersion13

Convention Explanation

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

NoteProvides helpful hints or additional information

ImportantHighlights actions or information that might cause problems to systems or

data

14 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account add services and publish apps

15 Contact Us

Wewelcome your feedback on our documentation Email us at techpubskonycom

For technical questions suggestions and comments or to report problems on Konys product line

contact productsupportkonycom

copy 2014 by Kony Inc All rights reserved 12 of 185

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 9: Kony MobileFabric Installer Guide

Manual Installation GuideVersion13

1611 How to Add an Installer Generated Self-Signed SSLCertificate to Cacerts 168

1612 How to Add an Existing SSLCertificate to Cacerts 169

162 JDK Version Compatibility 170

163 How to Switch between JDK Versions 170

164 How to ConfigureMemcached for Integration Service 171

17 FAQs and Troubleshooting 173

171 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products Running

on JDK 16 175

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node 176

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode 176

172 WebSphere FAQs 177

173 FAQs and Troubleshooting 177

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on KonyMobileFabric Products

Running on JDK 16 180

1732 WebSphere FAQs 182

174 How to Change Log Levels 182

copy 2014 by Kony Inc All rights reserved 9 of 185

1 Preface Manual Installation GuideVersion13

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

copy 2014 by Kony Inc All rights reserved 10 of 185

1 Preface Manual Installation GuideVersion13

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

11 Purpose

This document explains how to install and configure KonyMobileFabric Console

12 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 or Linux environment

13 Formatting Conventions

The following formatting conventions are used throughout the document

Convention Explanation

Monospace n User input text system prompts and responses

n File path

n Commands

n Program code

n File names

Italic n Emphasis

n Names of books and documents

n New terminology

copy 2014 by Kony Inc All rights reserved 11 of 185

1 Preface Manual Installation GuideVersion13

Convention Explanation

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

NoteProvides helpful hints or additional information

ImportantHighlights actions or information that might cause problems to systems or

data

14 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account add services and publish apps

15 Contact Us

Wewelcome your feedback on our documentation Email us at techpubskonycom

For technical questions suggestions and comments or to report problems on Konys product line

contact productsupportkonycom

copy 2014 by Kony Inc All rights reserved 12 of 185

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 10: Kony MobileFabric Installer Guide

1 Preface Manual Installation GuideVersion13

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

copy 2014 by Kony Inc All rights reserved 10 of 185

1 Preface Manual Installation GuideVersion13

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

11 Purpose

This document explains how to install and configure KonyMobileFabric Console

12 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 or Linux environment

13 Formatting Conventions

The following formatting conventions are used throughout the document

Convention Explanation

Monospace n User input text system prompts and responses

n File path

n Commands

n Program code

n File names

Italic n Emphasis

n Names of books and documents

n New terminology

copy 2014 by Kony Inc All rights reserved 11 of 185

1 Preface Manual Installation GuideVersion13

Convention Explanation

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

NoteProvides helpful hints or additional information

ImportantHighlights actions or information that might cause problems to systems or

data

14 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account add services and publish apps

15 Contact Us

Wewelcome your feedback on our documentation Email us at techpubskonycom

For technical questions suggestions and comments or to report problems on Konys product line

contact productsupportkonycom

copy 2014 by Kony Inc All rights reserved 12 of 185

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 11: Kony MobileFabric Installer Guide

1 Preface Manual Installation GuideVersion13

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

11 Purpose

This document explains how to install and configure KonyMobileFabric Console

12 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 or Linux environment

13 Formatting Conventions

The following formatting conventions are used throughout the document

Convention Explanation

Monospace n User input text system prompts and responses

n File path

n Commands

n Program code

n File names

Italic n Emphasis

n Names of books and documents

n New terminology

copy 2014 by Kony Inc All rights reserved 11 of 185

1 Preface Manual Installation GuideVersion13

Convention Explanation

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

NoteProvides helpful hints or additional information

ImportantHighlights actions or information that might cause problems to systems or

data

14 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account add services and publish apps

15 Contact Us

Wewelcome your feedback on our documentation Email us at techpubskonycom

For technical questions suggestions and comments or to report problems on Konys product line

contact productsupportkonycom

copy 2014 by Kony Inc All rights reserved 12 of 185

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 12: Kony MobileFabric Installer Guide

1 Preface Manual Installation GuideVersion13

Convention Explanation

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

NoteProvides helpful hints or additional information

ImportantHighlights actions or information that might cause problems to systems or

data

14 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account add services and publish apps

15 Contact Us

Wewelcome your feedback on our documentation Email us at techpubskonycom

For technical questions suggestions and comments or to report problems on Konys product line

contact productsupportkonycom

copy 2014 by Kony Inc All rights reserved 12 of 185

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 13: Kony MobileFabric Installer Guide

2 Prerequisites Manual Installation GuideVersion13

2 Prerequisites

Ensure that the following prerequisites aremet

l MySQL 56 Oracle 12c (1210) or MS SQLServer 2012 R2 database should be accessible

l A database user should be granted all permissions

l WindowsServer 2012 R2 is recommend if you are installing onWindows environment

l To use your existing SSL certificate map the SSL certificate to the domain name you want to

use

l To install in domainmode the JBoss cluster should be preconfigured

21 Prerequisites for MobileFabric with Oracle

For installingMobileFabric Database for Oracle complete the following steps

Note Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database

setup in order to successfully complete theMobileFabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with MobileFabric

database schema setup

l Unicode support needs to be enabled in Database This is possible only while creating a database

needed for MobileFabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

Important Ensure that a dedicated database user must not be an application user (for example

konydevicedb) for installation of database A dedicated user gets logged into audit logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the new

privileges loaded to the user

copy 2014 by Kony Inc All rights reserved 13 of 185

2 Prerequisites Manual Installation GuideVersion13

l Create a dedicated database user

o To create a user based on your Oracle 11g or 12c without PDB which will be used in the JDBC

Using an SQLPlus or another Database client connect to youOracle database as Sysdba

CREATE USER ltinstall-usergt

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT

GRANT ltGrants listgt TO ltinstall-usergt with admin option

-------ltGrants list for Oracle 11g or 12c without PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE SESSION ALTER SESSION

ALTER TABLESPACE ALTER USER

Important Ensure that a dedicated database user must not be an application user (for

example konydevicedb) for installation of database A dedicated user gets logged into audit

logs

A dedicated user must be granted with privileges shown in the following section

After granting privileges disconnect existing session and use new session in order to get the

new privileges loaded to the user

o To create a dedicated database user based on your Oracle 12c with PDB then create a

dedicated database local user inside PDB which will be used in the Java

Database Connectivity (JDBC) authentication

Alter session set container = PDBltMF_DBgt

CREATE USER ltdedicated-database-local-usergt

copy 2014 by Kony Inc All rights reserved 14 of 185

2 Prerequisites Manual Installation GuideVersion13

IDENTIFIED BY ltpasswordgt

DEFAULT TABLESPACE USERS

TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT ltGrants listgt TO ltinstall-local-usergt with admin option

CONTAINER=CURRENT

-------ltGrants list for Oracle 12c with PDBgt-------

CREATE JOB CREATE PROCEDURE CREATE SEQUENCE CREATE SESSION

CREATE TABLE CREATE TABLESPACE CREATE TRIGGER CREATE TYPE

CREATE USER CREATE VIEW CREATE PLUGGABLE DATABASE

CREATE SESSION ALTER SESSION ALTER TABLESPACE ALTER USER

l If you are usingMobileFabric installer to setupMobileFabric database then please choose the below

options based on your Oracle database version

o If Oracle database is created with PDB option of Oracle 12c use service name pointing to PDB in

the JDBC URL such as pdborcl orpdbmfdb

jdbcoraclethinltDatabase_Host_IPgt1521pdbmfdb

For example jdbcoraclethin192168121521pdbmfdb

o But if your database is 11g or 12c without PDB then you can useORACLE_SID in the JDBC

URL such as orcl or mfdb

jdbcoraclethinltDatabase_Host_IPgt1521mfdb

For example jdbcoraclethin192168121521mfdb

copy 2014 by Kony Inc All rights reserved 15 of 185

2 Prerequisites Manual Installation GuideVersion13

22 Software Requirements

Purpose Software Requirement

Application

Server Stack

l Apache Tomcat 7052

l JBoss Enterprise Application Platform 62

Important If you are running JBoss in Domain node (multi node) for a

production setup get the appropriate licenses from RedHat

Important Kony supports Oracle JDK 16 and JDK 17 for Tomcat and

JBoss and for all on-premises products

Kony supports Oracle JDK 1771 or higher forWebLogic

l WebLogic 1213 (1213)

l WebSphere 8555

l WindowsServer 2012 R2 if you are installing onWindows environment

l RedHat Enterprise Linux 60 if you are installing on Linux environment

l Oracle Java 16 or 17

l MySQL 56 Oracle 12cMS SQLServer 2012 R2 database

l

Note Increase your database connection limit to use the same database for all components

- such as KonyMobileFabric Console Kony Identity Service and Kony Integration Service

For example

To increaseMySQL database connection limit execute the following command

SET globalmax_connections = 350

copy 2014 by Kony Inc All rights reserved 16 of 185

2 Prerequisites Manual Installation GuideVersion13

Note Ensure that a database user should be granted all privileges like create update and

delete database schema views jobs andmanage schedulers

23 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card

Operating System RedHat Enterprise Linux 60

copy 2014 by Kony Inc All rights reserved 17 of 185

2 Prerequisites Manual Installation GuideVersion13

24 Required Setup Files

copy 2014 by Kony Inc All rights reserved 18 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

WAR Files

authServicewar

mbaasportalwar

accountsAPIwar

workspaceServicewar

middlewarewar

serviceswar

adminwar

To download theseWAR files and DB scripts

follow these steps

1 Log in to

httpcommunitykonycomdownloadsma

nual

2 Navigate to the Kony MobileFabric section

and click the Kony v65 GA version tab

3 Select the specific release from the Version

drop-down list and then click on the specific

release related files you want to download

For example if you want to download Kony

MobileFabric 652 GA

installer click the Kony v65 Kony

v65 GA tab select the652 GA

version from the drop-down list and then

click the Download button

copy 2014 by Kony Inc All rights reserved 19 of 185

2 Prerequisites Manual Installation GuideVersion13

File Location

DB Scripts andMigrations Scripts

For Kony Identity Service

l dbsql

l migrationszip

For Kony Workspace Service

l waasdbsql

l migrationszip

For Kony Accounts Service

l accountsdbsql

l accountsdbmigrationz

ip

Formiddleware service

l admindb_db2zip

l admindb_mysqlzip

l admindb_oraclezip

l admindb_sqlserverzip

l devicedb_db2zip

l devicedb_mysqlzip

l devicedb_oraclezip

l devicedb_sqlserverzip

l reportsdb_db2zip

l reportsdb_mssqlzip

l reportsdb_mysqlzip

l reportsdb_oraclezip

copy 2014 by Kony Inc All rights reserved 20 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

3 MobileFabric Topology and Components

MobileFabric topology explains the logical arrangement of various components such as console

identity services developer environment and production environment

In design time you configure appswith services and publish them to a developer environment After

you confirm the changes in the apps these appswill need to be published to a production

environment Authorized users can access apps onmobile devices from a production environment

An overview of theMobileFabric architecture and components follows

copy 2014 by Kony Inc All rights reserved 21 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

An overview of theMobileFabric deployment architecture follows

The following table describes the components of MobileFabric

copy 2014 by Kony Inc All rights reserved 22 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Identity This component validates user accounts and applications for authentication

and authorization

l Authentication identifies log-on credentials of a user

l Authorization allows or denies access to resources based on a users

role

Identity is used to authenticate and authorize runtime and design-time users

Accounts The accounts component contains information about what a user can do

such as create other users delete users create environments delete

environments and publish apps to an environment

This component uses auth service for authorizing requests based on user

roles

Workspace

(WaaS)

Workspace configures MBaaS services (applications identity integration

orchestration synchronization andmessaging) After these services are

configured these services must be published to respective

cloudsenvironments so that the services are available for run-time use

ConsolePortal The consoleportal is the user interface for configuring services for an

application

Environments

(KMS Sync

Integration

Service)

This component adds runtime capabilities to apps such as messaging

services synchronization services and integration services

copy 2014 by Kony Inc All rights reserved 23 of 185

3 MobileFabric Topology and Components Manual Installation GuideVersion13

Convention Description

Admin Admin provides the capability to list down the set of services published and

test the services shown in Admin Console Also you can view list of

published apps and provides the delete apps functionality In Kony Cloud

changing the log levels and checking the logs features are available as the

cloud is managed by Kony You can also view reports if you are usingmetrics

module This is an optional component

For more details refer to httpdocskonycomkonylibraryintegrationkony_

mobilefabric_integration_service_admin_console_user_guideDefaulthtm

Middleware This component exists between amobile device and an endpoint server It

receives a request from amobile device sends it to an endpoint server

fetches the response from the backend and provides the required information

to the device in the JSON format

Services Services component is used only whenMobileFabric is integrated It has

same runtime capabilities as themiddleware

Note To use Kony Sever with MobileFabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar

For more details refer to httpdocskonycomkonylibraryintegrationhtml

Note TheMobileFabric components can be configured on one node or separate nodes - for

example you can use one of the following choices

- Install All Components on one node

- Install KonyMobileFabric Console Kony Identity Service and Kony Integration Service on

separate nodes

copy 2014 by Kony Inc All rights reserved 24 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Configuring Database for MobileFabric

The following section explains how to configure Kony Identity ServicesDatabase

401 Prerequisites Create Databases

l Configuring Kony Identity ServicesDatabase

l Configuring KonyWorkspace ServicesDatabase

l Configuring Kony Accounts ServicesDatabase

41 Configuring Kony Identity Services Database

411 MySQL

To configure Kony Identity Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingdbsql and insidemigrationszip

follow these steps

l search for ltauthglobaldbgt and replace with desired ltKony Identity

Service Global DB namegt

l search for ltauthconfigdbgt and replace with desired ltKony Identity

Service configuration DB namegt

3 Execute thedbsql of Kony Identity Service fromworkbench

copy 2014 by Kony Inc All rights reserved 25 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute themigrationszip of Kony Identity Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

412 Oracle

To configure Identity Services Database follow these steps

1 To change DB names in all SQL files includingidentity-oraclesql and inside

migrations-auth-oraclezip follow these steps

l search for ltauthglobaldbgt and replace with desiredltKony Identity

Service Global DB namegt

l search for ltauthconfiggt and replace with desiredltKony Identity

Service configuration DB namegt

2 Execute theidentity-oraclesql of Kony Identity Service fromOracle client

3 Execute the migrations-auth-oraclezip of Kony Identity Service using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Identity Service database is created

copy 2014 by Kony Inc All rights reserved 26 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

42 Configuring Kony Workspace Services Database

421 MySQL

To configure Kony Workspace Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingwaasdbsql and inside

migrationszip follow these steps

l search for ltworkspaceglobaldbgt and ltwaasglobaldbgt replace with desired

ltKony Workspace Service Global DB namegt

3 Execute thewaasdbsql of KonyWorkspace Service from the workbench

4 Execute themigrationszip of KonyWorkspace Service using the following options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

KonyWorkspace Service database is created

422 Oracle

To configure Workspace Service Database follow these steps

1 To change DB names in all SQL files including workspacedb-oraclesql and inside

migrations-waas-oraclezip follow these steps

copy 2014 by Kony Inc All rights reserved 27 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

l search for ltworkspacesglobaldbgt andltwaasglobaldbgt replace with

desiredltKony Workspace Service Global DB namegt

2 Execute theworkspacedb-oraclesql of KonyWorkspace Service fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-waas-oraclezip

4 Execute the migrations-waas-oraclezip of Kony Accounts using the following

options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

KonyWorkspace Service database is created

43 Configuring Kony Accounts Services Database

431 MySQL

To configure Kony Accounts Services Database follow these steps

1 Navigate to Start gt All Programs gt MySQL 56 workbench

2 To change DB names in all SQL files includingaccountsdbsql and inside

accountsdbmigrationzip follow these steps

l search ltaccountsonpremgt and replace with desired ltKony Accounts

Service DB namegt

3 Execute theaccountsdbsql of Kony Accounts Service from the workbench

copy 2014 by Kony Inc All rights reserved 28 of 185

4 Configuring Database for MobileFabric Manual Installation GuideVersion13

4 Execute theaccountsdbmigrationzip of Kony Accounts Service using the following

options

l Flyway tool (httpflywaydborg)

l workbench

Important Execute all scripts in serial order depending upon version of the files

Kony Accounts Service database is created

432 Oracle

To configure Kony Accounts Database follow these steps

1 To change DB names in all SQL files includingaccountsdb-oraclesql and inside

migrations-accounts-oraclezip follow these steps

l search for ltaccountsdbgt and replace with desiredltKony Accounts DB

namegt

2 Execute theaccountsdb-oraclesql of Kony Accounts fromOracle client

3 Prepend ALTER SESSION SET CURRENT_SCHEMA=dbname in all the sql files in the

migrations-accounts-oraclezip

4 Execute themigrations-accounts-oraclezip of Kony Accounts using the

following options

l Flyway tool (httpflywaydborg)

Important Make sure that all scripts should be (arrange these files) executed in serial

order depending on upon version)

Kony Accounts database is created

copy 2014 by Kony Inc All rights reserved 29 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

5 Creating Shared Library Folders for MobileFabric - WebSphere

The following details list of libraries with jar files These files are available in theMobileFabric 652 GA

artifacts

l accounts

o commons-codec-16jar

o httpclient-435jar

o httpcore-432jar

o httpmime-431jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1181jar

l mfconsole

o commons-codec-16jar

o httpclient-436jar

o httpcore-433jar

o httpmime-436jar

o jackson-annotations-250jar

o jackson-core-251jar

o jackson-core-asl-1913jar

copy 2014 by Kony Inc All rights reserved 30 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o jackson-coreutils-18jar

o jackson-databind-251jar

o jackson-mapper-asl-1913jar

o jackson-module-jsonSchema-244jar

o jackson-xc-1913jar

l identity

o commons-codec-14jar

o hibernate-validator-432Finaljar

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jboss-logging-310CR2jar

o jersey-core-1181jar

l integration

o commons-codec-16jar

o httpclient-426jar

o httpcore-425jar

copy 2014 by Kony Inc All rights reserved 31 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

o httpmime-426jar

o mysql-connector-java-5126-binjar

l workspace

o httpclient-426jar

o httpcore-425jar

o jackson-core-asl-192jar

o jackson-jaxrs-192jar

o jackson-mapper-asl-192jar

o jackson-xc-192jar

o jersey-core-1171jar

To create a shared library folder for MobileFabric follow these steps

Note To create other shared library folders follow these steps

1 Open theWebSphere Administration Console

2 Go to Environment gt Shared libraries

3 Select your server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

Important For cluster setup select Scope asCell=XXXXCell01

copy 2014 by Kony Inc All rights reserved 32 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

4 Click New

5 Provide name of the shared library in Name For example accounts mfconsole integration

and workspace

6 Provide description of the shared library in Description For example MobileFabricShared

libraries (Optional)

7 Provide the classpath in Classpath This should be the folder path to the directory where the jar

file is extracted

The screenshot above shows shared lib configuraiton for accounts Similarly create shared libs

for identity

copy 2014 by Kony Inc All rights reserved 33 of 185

5 Creating Shared Library Folders for MobileFabric - WebSphere Manual Installation GuideVersion13

8 Under Class Loading select the Use an isolated class loader for this shared library check

box

9 ClickOK A screen appears to save themaster configuration

10 Click Save to save inmaster configuration

copy 2014 by Kony Inc All rights reserved 34 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Creating Data Source for MobileFabric Console - WebSphere

Create data source for the below databases created using scripts such asDEVICEDB

ADMINDB ACCOUNTSDB CONSOLEDB and REPORTS

l Creating Data Source for MobileFabric Console Schema (SQL Server)

l Creating Data Source for MobileFabric Console Schema (Oracle)

l Creating Data Source for MobileFabric Console Schema (MySQL)

61 Creating Data Source for MobileFabric Console Schema (SQL

Server)

To create a data source inWebSphere youmust create a Java Application and Authorization Service

(JAAS) JAAS-J2C Authentication Data and JDBC Provider

Important Use this section if you want to configure a data source for SyncConsole schema on

SQL Server

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

611 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

copy 2014 by Kony Inc All rights reserved 35 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go toWebSphere Administration Console gt Security gt clickGlobal Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data

A screen appears to create a new JAAS - J2C authentication data

3 Click New

copy 2014 by Kony Inc All rights reserved 36 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

4 Provide your database user details shown below

Youmust enter your database alias name user name and password in Alias User ID and

Password (not the system user details)

5 ClickOK

A screen appears to save themaster configuration

6 Click Save

612 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC providers

2 Select your server scope the scope namemay appear asNode=XXXXNode01

Server=server1

copy 2014 by Kony Inc All rights reserved 37 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New

4 Select the database from the Database Type drop-down to create a SQL Server JDBC

Provider

5 Select Microsoft SQL Server JDBC Provider (anymeaningful name that you shall use in

Creating Datasource) from the Provider Type drop-down

6 Click Next

copy 2014 by Kony Inc All rights reserved 38 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Set Database class path to the location of JDBC connector sqljdbc4jar file

Note Native library path is optional

copy 2014 by Kony Inc All rights reserved 39 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next and review your inputs

9 Click Finish and Save to save changes tomaster configuration

613 Creating a Data Source

To create a data source follow these steps

copy 2014 by Kony Inc All rights reserved 40 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select you server Scope The scope name looks like Node=XXXXNode01 Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 41 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 42 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Provide (the database that is created using console schema script initially) Database name

9 Click Next

The Setup security aliases screen appears

copy 2014 by Kony Inc All rights reserved 43 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01sa

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01sa

copy 2014 by Kony Inc All rights reserved 44 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Click Next review changes and then click Finish

Note Save changes tomaster configuration

614 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 45 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 46 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format The instance is optional

jdbcsqlserverDBHOSTIP

[DBINSTANCENAME]PORTdatabasename=DBNAME

For example

jdbcsqlserver10102311MSSQLEXPRESS1433databasename

=konyidconfigdb3

Or

copy 2014 by Kony Inc All rights reserved 47 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

jdbcsqlserver101023111433databasename=konyidconfig

db3

copy 2014 by Kony Inc All rights reserved 48 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 49 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

62 Creating Data Source for MobileFabric Console Schema (Oracle)

To create a data source inWebSphere you need to create a JAAS-J2C Authentication Data and

JDBC Provider

copy 2014 by Kony Inc All rights reserved 50 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Important Use this section if you need to configure a data source for SyncConsole schema on

Oracle

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data source

621 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 51 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details as shown below

User ID database_name

Password System_Password

copy 2014 by Kony Inc All rights reserved 52 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

(not the system user details)

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

622 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click JDBC Provider

2 Select your server scope scope namemay appear asNode=XXXXNode01 Server=server1

3 Click New

4 Select the database from the Database Type drop-down to create Oracle JDBC Provider

5 Select JDBC Driver (anymeaningful name that you use in Creating a Data Source) from the

Provider Type drop-down

6 Select Connection pool data source as Implementation type

copy 2014 by Kony Inc All rights reserved 53 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Provide JDBC Provider (anymeaningful name that you use in Creating a Data Source) as

Name

8 Click Next

copy 2014 by Kony Inc All rights reserved 54 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Set Database class path to the location of JDBC connector ojdbc6_gjar file

copy 2014 by Kony Inc All rights reserved 55 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next and review your inputs

11 Click Finish and Save to save changes tomaster configuration

623 Creating a Data Source

To create a Data source follow these steps

copy 2014 by Kony Inc All rights reserved 56 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Go to Resources gt JDBC click Data sources

2 Select your server Scope the scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 57 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example JDBC Provider (created in Creating a JDBC

Provider) Click Next

copy 2014 by Kony Inc All rights reserved 58 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Provide JDBC URL for Oracle database in URL as below

jdbcoraclethinlocalhost1521XE where

localhost ndash Oracle database host (can be IP address or host name)

1521 - Oracle port number

XE - Oracle SID

copy 2014 by Kony Inc All rights reserved 59 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

10 Click Next

The Setup security aliases screen appears

11 Set up the security aliases shown below choose already created JAAS ndash J2C Authentication

Data here

Component-managed authentication alias XXXNode01database_source

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01database _alias

copy 2014 by Kony Inc All rights reserved 60 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

624 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 61 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 62 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcoraclethinDBHOSTPORTSERVICENAME

For example jdbcoraclethin101023111521orcl

copy 2014 by Kony Inc All rights reserved 63 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 64 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 65 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

63 Creating Data Source for MobileFabric Console Schema (MySQL)

MySQL is not a certified JDBC driver onWebSphere Therefore youmust configure a user-defined

JDBC provider when you configure your data source to point to aMySQL database

copy 2014 by Kony Inc All rights reserved 66 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

To create a data source inWebSphere youmust create a JAAS - J2C Authentication Data and JDBC

Provider

Important Use this section if you need to configure a data source for SyncConsole schema on

MySQL

Creating a data source involves the following processes

1 Creating a JAAS J2C Authentication

2 Creating a JDBC Provider

3 Creating a Data Source

4 Setting CustomProperties of Data Source

631 Creating a JAAS J2C Authentication

To create a JAAS J2C authentication follow these steps

1 Go toWebSphere Administration Console gt Security gt Global Security

2 Expand Java Authentication and Authorization Service gt click J2C authentication data gt

click New

copy 2014 by Kony Inc All rights reserved 67 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Provide your database user details shown below

copy 2014 by Kony Inc All rights reserved 68 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

Youmust enter your database alias user name and password in Alias User ID and Password

4 ClickOK

A screen appears to save themaster configuration

5 Click Save

632 Creating a JDBC Provider

To create a JDBC provider follow these steps

1 Go to Resources gt JDBC and click the JDBC Provider

2 Select your server scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Create a JDBC provider with name JDBC Provider

5 Set User defined asDatabase type

copy 2014 by Kony Inc All rights reserved 69 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Set commysqljdbcjdbc2optionalMysqlConnectionPoolDataSource as Implementation

class name

7 Click Next

8 Set Database class path to the location of JDBC connector mysql-connector-java-

5126-binjar file

copy 2014 by Kony Inc All rights reserved 70 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Next and review your inputs

10 Click Finish

copy 2014 by Kony Inc All rights reserved 71 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

633 Creating a Data Source

To create a Data source follow these steps

1 Go to Resources gt JDBC and click Data sources

2 Select you server Scope The scope namemay appear asNode=XXXXNode01

Server=server1

3 Click New

4 Provide Datasource name

5 Provide jdbckonyaccounts as JNDI Name (youmust configure the same JNDI name in the

properties file)

copy 2014 by Kony Inc All rights reserved 72 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Next

7 Select an existing JDBC provider for example MySQL JDBC Provider (created in Creating a

JDBC Provider)

copy 2014 by Kony Inc All rights reserved 73 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

8 Click Next

9 Choose the data store helper class name Retain the default values

10 Click Next

copy 2014 by Kony Inc All rights reserved 74 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

11 Setup security aliases shown below choose already created JAAS ndash J2C Authentication Data

here

Component-managed authentication alias XXXNode01mysqlroot

Mapping configuration alias DefaultPrincipalMapping

Container-managed authentication alias XXXNode01mysqlroot

copy 2014 by Kony Inc All rights reserved 75 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

12 Click Next review changes and then click Finish

Note Save changes tomaster configuration

634 Setting Custom Properties of Data Source

For user defined data sources youmust provide database details (Server Name Port Database

Name User and Password) under custom properties of a data source

To set the custom properties of a data source follow these steps

copy 2014 by Kony Inc All rights reserved 76 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

1 Click Data source to open it

2 Click Custom Properties under Additional Properties section

copy 2014 by Kony Inc All rights reserved 77 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

3 Click New Other wise search for existing properties and edit them and provide values

4 Click URL

5 In the Value field enter the URL in below format

jdbcmysql1010241563306Ram65_mfaccountsdb_

2autoReconnect=true

copy 2014 by Kony Inc All rights reserved 78 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

6 Click Apply and save changes tomaster configuration

copy 2014 by Kony Inc All rights reserved 79 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

7 Go back to datasource page ClickWebSphere Application Server data source properties

8 Configure the Connection validation properties shown below

a Select the Validate new connections check box and Validate existing pooled

connections check box

b Under Validate options enter the query as SELECT 1

copy 2014 by Kony Inc All rights reserved 80 of 185

6 Creating Data Source for MobileFabric Console - WebSphere Manual Installation GuideVersion13

9 Click Apply and save changes tomaster configuration

Important Repeat all the above steps for configuring theworkspacedb

64 Configuring Data Source for Integration Service

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereConfigure_Websphere

copy 2014 by Kony Inc All rights reserved 81 of 185

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

Manual Installation

GuideVersion13

7 Creating Data Source for MobileFabric Console Schema -

WebLogic

The following table details data source information

DatabaseDataSourceName

JDBC URL Driver JNDI Name

Oracle mfconsole jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcworkspacesglobaldb

accounts jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyaccounts

reports jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyreports

Admin jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbckonyadmindb

devicedb jdbcoraclethin$DB_

IP$$DB_

PORT$$ORACLE_

SERVICEID$

oraclejdbcdriverOracleDriver jdbcKDCDB

Create data sourceswith the details provided in the above table inWebLogic Admin Console by using

the steps provided at httpwwworaclecomwebfoldertechnetworktutorialsobefmwwls12c04-

ConfigDataSourceconfigdshtm

copy 2014 by Kony Inc All rights reserved 82 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

8 Configuring Installation Mode

l Tomcat

l JBoss

l WebSphere

81 How to Configure Installation Modes - Tomcat

To download and install Tomcat follow these steps

1 Download Apache Tomcat v7052 from the following link

httpsarchiveapacheorgdisttomcattomcat-7v7052bin

2 Extract theapache-tomcat-7052-windows-x64 file and place it in your local

folder Your Tomcat server setup is ready now

Important Examples in this document refer the ltUser_Install_Directorygt as your install

folder Ensure that you place JRE and Tomcat in the ltUser_Install_Directorygt folder

811 How to Configure Tomcat Multinode Installation

To install Kony MobileFabric Console on Tomcat multinode follow these steps

Important Install KonyMobileFabric Console in different boxes pointing to same database before

configuring the setup page For more details refer to Hot to Get started with KonyMobileFabric

Console

copy 2014 by Kony Inc All rights reserved 83 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

1 Install standaloneMobileFabric onmultiple nodeswith Tomcat pointing to same database

2 In theaccountsproperties file theWAAS_BASE_URL should be configured with

load balancer URL for all the nodes

3 In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY value should

be configured with the same value as in all nodes

l Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

4 In theconfigproperties file theWAAS_BASE_URL and KONY_ACCOUNT_API_

BASE_URL should be configured with load balancer URL for all the nodes

l Path for theconfigproperties file

ltInstaller FoldergttomcatwebappsmfconsoleWEB-

INFclasses

5 TheAuthservicekey should be configured with the same value in all nodes

l Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

6 Theworkspaceservicekey value should be configured with the same value in all

nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

copy 2014 by Kony Inc All rights reserved 84 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

82 How to Configure Installation Modes - JBoss

821 How to Configure JBoss for Singlenode Installation

To configure JBoss in standalone mode follow these steps

1 Download JBoss 62 EAP from the following link

httpwwwredhatcomjelqNowelqRedirhtmref=httpswwwjbossorgdownload-

managercontentoriginfilessha25662627773f1798623eb599bbf7d39567f60941a706dc971

c17f5232ffad028bc6f4jboss-eap-620zip

2 Extract thejboss-eap-620zip file to your local folder Your JBoss server setup is

ready now

822 How to Configure JBoss for Multinode Installation

Prerequisites

l Configure JBoss cluster before configuringmultinode

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

l Ensure that themaster node hostnameIP address is not 127001 0000 or localhost It

should be a public IP address or a fully qualified domain name (FQDN)

83 How to Configure Installation Modes - WebSphere

Prerequisites

l Install your WebSphere 855 5

l ConfigureWebSphere cluster before configuringmultinode

copy 2014 by Kony Inc All rights reserved 85 of 185

8 Configuring Installation Mode Manual Installation GuideVersion13

l Ensure that the Fully Qualified Public URL of MobileFabric Console or Fully Qualified Public

URL of Identity Service should be that of the load balancer URL that is used for public

communication

copy 2014 by Kony Inc All rights reserved 86 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9 Configuring JNDI for a Database

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java

software clients to discover and look up data and objects via a name Like all Java APIs that interface

with host systems JNDI is independent of the underlying implementation

The following section explains how to configure JNDI for a database

l Tomcat

l JBoss

91 How to Configure JNDI - Tomcat

911 For MySQL

9111 How to Configure JNDI

1 Copy themysql-connector-java-5126-binjar from the downloaded folder

ltKony Linkgt

2 Paste themysql-connector-java-5126-binjar file under user install

directory inside the Tomcat gt Lib folder - for example ltUser install

directorygtapache-tomcat-7052lib

9112 How to Configure Data Source

1 Open thecontextxml file located under ltUser install

directorygtapache-tomcat-7052conf depending on the database type

copy 2014 by Kony Inc All rights reserved 87 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

2 In thecontextxml file add the following data source configurations

In the following data source configurations youmust replace the following fields with

appropriate values to access the database

The following table details field names to be configured for data source

Field Name Value

ltDB_Drivergt Database specific driver For example

commysqljdbcDriver

ltJNDI_NAMEgt JNDI string For example

jdbcworkspacesglobaldb

ltPWDgt Database password

ltDB_connection_Stringgt Database connection string For example

jdbcmysqlltHost NamePortgtltDB_

NamegtautoReconnect=true

ltUSER_NAMEgt Database username For example root

The following JNDI configuration template is for Kony Identity Service component

ltResource auth=Container driverClassName=ltDB_Drivergt

factory=orgapachetomcatjdbcpoolDataSourceFactory

initialSize=5 jmxEnabled=true logAbandoned=true

maxActive=10 maxIdle=10 maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=5 name=ltJNDI_NAMEgt

password=ltPWDgt removeAbandoned=true

removeAbandonedTimeout=600 testOnBorrow=true

testOnReturn=false testWhileIdle=true

timeBetweenEvictionRunsMillis=30000 type=javaxsqlDataSource

copy 2014 by Kony Inc All rights reserved 88 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

url=ltDB_connection_Stringgt username=ltUSER_NAMEgt

validationInterval=30000 validationQuery=SELECT 1gt

ltTransaction auth=Container

factory=orgobjectwebjotmUserTransactionFactory

jotmtimeout=60 name=UserTransaction

type=javaxtransactionUserTransactiongt

The following JNDI configuration template is for KonyMobileFabric Console component

ltResource auth=Container testOnBorrow=true

testWhileIdle=true validationQuery=SELECT 1

driverClassName=ltDB_Drivergt logAbandoned=true maxActive=10

maxIdle=5 maxWait=120000 name=ltJNDI_NAMEgt scope=Shareable

type=javaxsqlDataSource url=ltDB_connection_Stringgt

username=ltUSER_NAMEgt password=ltPWDgtgt

3 Save thecontextxml file

92 How to Configure JNDI - JBoss

921 For MySQL

9211 Module for Single node

1 Create a folder hierarchy for files shown below

l com

l mysql

l main

2 Copy and paste the mysql-connector-java-5126-binjar file to the

main folder that you created in the previous step

3 Create themodule configuration file in the to the main folder- for example modulexml

copy 2014 by Kony Inc All rights reserved 89 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

9212 How to Configure JNDI for Single Node

To configure JNDI for MySQL follow these steps

1 Create a directory $JBOSS_HOMEmodulescommysqlmain

2 Copy and paste themysql-connector-java-5127-binjar file under

$JBOSS_HOMEmodulescommysqlmain

3 Create themodulexml file under $JBOSS_HOMEmodulescommysqlmain

with the following code

ltmodule xmlns=urnjbossmodule11 name=commysqlgt

ltpropertiesgt

ltproperty name=jbossapi value=unsupportedgt ltpropertiesgt

ltresourcesgt

ltresource-root path=mysql-connector-java-5127-binjargt

ltresourcesgt

ltdependenciesgt

ltmodule name=javaxapigt

ltmodule name=javaxtransactionapigt

ltmodule name=javaxservletapi optional=truegt

ltdependenciesgt

ltmodulegt

9213 Data Source for Single Node and Multinode

l Single node Configure thestandalonexml located under $JBOSS_

HOMEstandaloneconfiguration depending on the database type

l Multinode Configure thedomainxml located under $JBOSS_

HOMEdomainconfiguration depending on the database type

copy 2014 by Kony Inc All rights reserved 90 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Important In the following sections to configure data sources configure the driver tag

ltdrivergt ltdrivergt according to themode of installation - for example single node or

multinode

Ensure that you configure only single node or multinode

Kony Identity Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaauthglobaldb pool-name=authds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKonyIdentity

Service Global DB namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltpoolgt

ltmax-pool-sizegt5ltmax-pool-sizegt

ltprefillgttrueltprefillgt

ltpoolgt

ltsecuritygt

ltuser-namegtltDB_USERgtltuser-namegt

ltpasswordgtltDB_PASSWORDgtltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

copy 2014 by Kony Inc All rights reserved 91 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

Kony Workspace Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javaworkspacesglobaldb pool-name=waasds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKWS DB

namegtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Kony Accounts Service Data Source

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdatasource jndi-name=javakonyaccounts pool-name=accountsds

enabled=true use-java-context=truegt

ltconnection-urlgtjdbcmysqlltDB_SERVER_IPgtltDB_PORTgtltKAS DB

NAMEgtautoReconnect=trueltconnection-urlgt

lt-- Specify the driver as MySql for single-node --gt

ltdrivergtMySqlltdrivergt

lt-- Specify the driver as mysql-connector-java-5127-binjar for

copy 2014 by Kony Inc All rights reserved 92 of 185

9 Configuring JNDI for a Database Manual Installation GuideVersion13

multi-node --gt

ltdrivergtmysql-connector-java-5127-binjarltdrivergt

ltsecuritygt

ltuser-namegtDB_USERltuser-namegt

ltpasswordgtDB_PASSWORDltpasswordgt

ltsecuritygt

ltnew-connection-sqlgtSELECT 1ltnew-connection-sqlgt

ltvalidationgt

ltvalidate-on-matchgttrueltvalidate-on-matchgt

ltcheck-valid-connection-sqlgtSELECT 1ltcheck-valid-connection-sqlgt

ltvalidationgt

ltdatasourcegt

Configure Driver Details

Configure the following only for singlenode

Configure the ltdrivergt ltdrivergt tag in thestandalonexml file of MySQLServer

ltdriversgt

ltdriver name=MySql module=commysqlgt

ltdriversgt

copy 2014 by Kony Inc All rights reserved 93 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

10 Configuring Connectors and WAR Deployment

A connector receives requests passes them on to an engine and returns the results to its specified

port

With customized configurations in app server connectors you can link app servers with Kony

MobileFabric Console and other supporting web technologies such as an Apache web server

l Tomcat

l JBoss

101 How to Configure Connectors - Tomcat

1 From theltUser_Install_Directorygtapache-tomcat-7052conf

open theserverxml

2 In theserverxml under theltService name=Catalinagt tag add the

connector tag

l For HTTP

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000 gt

l For HTTPS

ltConnector server=Kony port=ltHTTP_PORTgt

protocol=HTTP11 connectionTimeout=20000

redirectPort=ltHTTPS_PORTgt gt ltConnector server=Kony

port=ltHTTPS_PORTgt protocol=HTTP11 SSLEnabled=true

maxThreads=150 scheme=https secure=true

copy 2014 by Kony Inc All rights reserved 94 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

clientAuth=false sslProtocol=TLS

keystoreFile=ltAPPSERVER_KEYSTORE_FILEgt

keystorePass=ltAPPSERVER_KEYSTORE_PASSgt

keystoreType=ltAPPSERVER_KEYSTORE_TYPEgtgt

1011 How to Configure Batch Files

10111 catalinabat

Catalinbat files are required to be configured in Tomcat server to work properly

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

thecatalinabat

2 Before theecho off command add the following JVMmemory configuration

set JAVA_OPTS= -server -Xmsltbytesgt -Xmxltbytesgt -XXNewSize=512m -

XXMaxNewSize=256m -XXPermSize=512m -XXMaxPermSize=512m

Important For All Components (KonyMobileFabric Console or Kony Identity Service or

Kony Integration Service) change the value of ltbytesgt to1024m

3 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

4 Save thecatalinabat file

10112 servicebat

1 From theltUser_Install_Directorygtapache-tomcat-7052bin open

theservicebat

copy 2014 by Kony Inc All rights reserved 95 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

2 Set JRE home if it is not set For example use the following command

set JRE_HOME=ltUser_Install_Directorygtjre

3 Set catalina home if it is not set For example use the following command

set CATALINA_HOME=ltUser_Install_Directorygttomcat

4 To configure the service name for the service you install use the following commands

set SERVICE_NAME=ltService_Namegt_SVC

set PR_DISPLAYNAME=ltService_Namegt

5 Save theservicebat file

102 How to Configure Connectors - JBoss

1021 How to Configure Deployment of mbaasportalwar file

OnceMobileFabric installation succeeds MobileFabric Console will not be displayed as the enable-

welcome-root value is set true in thedomainxml file Configure the mbaasportalwar file to

accessMobileFabric Console

To configure mbaasportalwar in the standalonexml file follow these steps

1 In master node open thestandalonexml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

2 Replace enable-welcome-root=true with enable-welcome-root=false

You can accessMobileFabric Console now

1022 How to Configure Connector

10221 For HTTP

Configure the following connector tag in standalonexml file

copy 2014 by Kony Inc All rights reserved 96 of 185

10 Configuring Connectors and WAR Deployment Manual Installation GuideVersion13

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=httpgt

10222 For HTTPS

Configure the following connector tag in the standalonexml file

ltconnector name=http protocol=HTTP11 scheme=http socket-

binding=http redirect-port=ltHTTPS_PORTgtgt ltconnector name=HTTPS

protocol=HTTP11 scheme=https socket-binding=https

secure=truegt

ltssl name=https password=ltKEYSTORE_PASSgt certificate-key-

file=ltKEYSTORE_FILEgt protocol=TLSv1TLSv11TLSv12gt

ltconnectorgt

The following attributes in the connector tag need to be configured with values - for example

l port=1021

l password=password

l certificate-key-file=path for the jks file

copy 2014 by Kony Inc All rights reserved 97 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

11 Configuring Properties Files in WAR Files

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

l How ToConfigure Properties Files inWAR Files - Tomcat and JBoss

l How to Configure Properties Files - WebSphere

l How to Configure Properties Files - WebLogic

111 How To Configure Properties Files in WAR Files - Tomcat and

JBoss

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar and

workspaceServicewar For more details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1111 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 98 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

3 In theaccountsproperties file configure the following properties with proper values

shown below

l For JBoss change the value of ltACCOUNTS_JNDI_NAMEgt = javakonyaccounts

l For Tomcat change the value of ltACCOUNTS_JNDI_NAMEgt = jdbckonyaccounts

Important Enter the appropriate path for LOG_LOCATION=ltINSTLL_DIRgt

For example

copy 2014 by Kony Inc All rights reserved 99 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

1112 authServicewar

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

ADMIN_USERSTORE_PROVIDER=AUTH

copy 2014 by Kony Inc All rights reserved 100 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

2 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

3 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1113 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsAPIapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

copy 2014 by Kony Inc All rights reserved 101 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

1114 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

3 In theworkspaceServiceproperties file configure the following properties with

proper values shown below

copy 2014 by Kony Inc All rights reserved 102 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MySQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltCKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

112 How To Configure Properties Files in WAR Files - WebSphere

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1121 accountsAPIwar

To configure properties files in the accountsAPIwar file follow these steps

copy 2014 by Kony Inc All rights reserved 103 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename theaccountsAPIwar to accountswar

2 In the accountswarWEB-INFclasses folder open the

accountsproperties file

This properties file is NOT meant for individual developer

changes

if you need to overwrite any of the following please use -

DPARAMS locally on your PC

ACCOUNTS_DB_JNDI_NAME=ltACCOUNTS_JNDI_NAMEgt

ACCOUNTS_DB_CONNECTION_POOL=hikari

ACCOUNTS_DB_SQL_DIALECT=orghibernatedialectMySQLDialect

ACCOUNTS_DB_SQL_SHOW=false

ACCOUNTS_DB_SQL_USE_SCROLLABLE_RESULTSET=true

ACCOUNTS_ENCRYPTION_KEY=ltANY_RANDOM_GUID like 8bf8cae5-d25e-497c-

93b8-72300eab45d1gt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltINSTLL_DIRgtlogs

WAAS_BASE_URL=ltPUBLIC_URLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URLgtaccountsapiv1_0

1122 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

copy 2014 by Kony Inc All rights reserved 104 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

copy 2014 by Kony Inc All rights reserved 105 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 106 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

1123 mbaasportalwar

To configure properties files in the mbaasportalwar file follow these steps

copy 2014 by Kony Inc All rights reserved 107 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1 Rename thembaasportalwar to mfconsolewar

2 In the mfconsolewarWEB-INFclasses open theconfigproperties file

WAAS_BASE_URL=ltPUBLIC_RLgtworkspace

KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_RLgtaccountsapiv1_0

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtlogs

WAAS_ENCRYPTION_KEY=ltAny random GUID like 3bcf2351-a3e5-44b3-ac06-

ff1bd5f738cdgt

UI_ACCOUNTS_URLS=false

mobileFabricVersion=ltVersion of MobileFabricgt

3 Edit the webxml file in war file In the mfconsolewarWEB-INF open thewebxml

file

4 Remove the below tags in thewebxml file

ltcookie-configgt

lthttp-onlygttruelthttp-onlygt

ltcookie-configgt

lttracking-modegtCOOKIElttracking-modegt

1124 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

copy 2014 by Kony Inc All rights reserved 108 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

copy 2014 by Kony Inc All rights reserved 109 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1125 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereInstall and Configure KonyMobileFabric Integration Service

copy 2014 by Kony Inc All rights reserved 110 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

113 How To Configure Properties Files in WAR Files - WebLogic

KonyMobileFabric Console setup consists of configuring properties files in the war files such as

accountsAPIwar authServicewar mbaasportalwar

workspaceServicewar metricswar adminwar andmiddleware For more

details refer to MobileFabric Topology and Components

Important The field names in the properties files of the followingWAR files are the same for all

app servers Youmust configure the values in the fields based on your app servers

1131 accountsAPIwar

For more details refer to accountsAPIwar

1132 authServicewar

In the authServicewar file configure the following property files

l authServiceproperties

l authservicekey

l authServicedefaultproperties

l databaseinternalproperties

To configure properties files in the authServicewar file follow these steps

1 In theauthServicewarWEB-INFclasses open the

authServiceproperties file

copy 2014 by Kony Inc All rights reserved 111 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Database parameters

RDS_DB_TYPE=ltDatabase Typegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

AUTH_GLOBAL_DBNAME=ltKony identity service global database namegt

AUTH_CONFIG_DBNAME=ltKony identity service configuration database

namegt

MAX_ACTIVE_DBC=20

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=5

DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

hibernatedialect=orghibernatedialectOracle9Dialect

ORACLE_SID=ltsidgt

TXN_ISOLATION_LEVEL=2

RDS_GLOBAL_USERNAME= authglobaldb

RDS_GLOBAL_PASSWORD=ltpwdgt

General auth parameters

APPSERVER_TYPE=ltApplication server typegt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=ltUSER_INSTALL_DIRgtkonymflogs

ADMIN_USERSTORE_PROVIDER=AUTH

Caching parameters

CACHE_CONFIG=

2 In theauthServicewarWEB-INFclasses open the

authServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 112 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

AUTH_GLOBAL_DBNAME=ltauthglobaldbgt

AUTH_CONFIG_DBNAME=ltauthconfiggt

MAX_ACTIVE_DBC=22

AUTH_GLOBAL_DB_MAX_ACTIVE_DBC=3

AUTH_GLOBAL_DB_FRACTIONAL_DBC=035

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

APPSERVER_TYPE=ltWEBSPHEREgt

this can be ORACLE MSSQL POSTGRES etc Default is MYSQL

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

RDS_HOSTNAME=lt101024156gt

3 In theauthServicewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=trueamprewriteBatchedStatements=true

MYSQL_DATASOURCE_

CLASS=commysqljdbcjdbc2optionalMysqlDataSource

MYSQL_HIBERNATE_DIALECT=orghibernatedialectMySQLDialect

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

ORACLE_DATASOURCE_CLASS=oraclejdbcpoolOracleDataSource

ORACLE_HIBERNATE_DIALECT=orghibernatedialectOracle9Dialect

copy 2014 by Kony Inc All rights reserved 113 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

MSSQL_DATASOURCE_

CLASS=commicrosoftsqlserverjdbcSQLServerDataSource

MSSQL_HIBERNATE_DIALECT=orghibernatedialectSQLServerDialect

4 In theauthServiceproperties file configure the following properties with proper

values shown below

l RDS_DB_TYPE=ltDatabase Typegt For example RDS_DB_TYPE=MYSQL

l APPSERVER_TYPE=ltApplication server typegt

l for JBoss JBOSS

l for Tomcat TOMCAT

l for WebSphere WEBSPHERE

l for WebLogic WEBLOGIC

Important Enter the appropriate path for LOG_LOCATION=ltUSER_INSTALL_DIRgt

For example

- For Windows ltLocalDriveKonyMobileFabricgt

- For Linux lthomeuserKonyMobileFabricgt

5 In theWEB-INFclasses edit theauthservicekey file shown below

master_key=ltAny Random GUIDgt

master_key_id=ltAny Random GUIDgt

copy 2014 by Kony Inc All rights reserved 114 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

1133 mbaasportalwar

For more details refer to mbaasportalwar

1134 workspaceServicewar

To configure properties files in the workspaceServicewar file follow these steps

1 Rename theworkspaceServicewar to workspacewar

2 In the workspacewarWEB-INFclasses open the

workspaceServiceproperties file

RDS_DB_TYPE=ltDatabase Typegt

WORKSPACESDB_NAME=ltWorkspace Service Database Namegt

WAASGLOBALDB_NAME=ltWorkspace Service Database Namegt

RDS_HOSTNAME=ltDataserver IPHostnamegt

RDS_USERNAME=ltDatabase usernamegt

RDS_PASSWORD=ltDatabase Passwordgt

RDS_PORT=ltDatabase portgt

LOG_LEVEL=INFO

LOG_OPTION=logfile

LOG_LOCATION=$Log_Rootkonymflogs

MAX_ACTIVE_DBC=25

APPSERVER_TYPE=ltApplication Server Typegt

WAAS_ENCRYPTION_KEY=ltRandom GUIDgt

hibernatedialect=orghibernatedialectltDatabase Dialectgt

ORACLE_SID=

TXN_ISOLATION_LEVEL=2

3 In the workspacewarWEB-INFclasses open the

workspaceServicedefaultproperties file

copy 2014 by Kony Inc All rights reserved 115 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

Default values for cloud

WORKSPACESDB_NAME=ltDB Namegt

WAASGLOBALDB_NAME=ltDB Namegt

MAX_ACTIVE_DBC=10

APPSERVER_TYPE=WEBSPHERE

RDS_DB_TYPE=MYSQL

RDS_PORT=3306

LOG_LEVEL=INFO

LOG_OPTION=SYSLOG

LOG_LOCATION=varlogsyslog

change this for Oracle

hibernatedialect=orghibernatedialectltDatabase Dialectgt

4 In the workspacewarWEB-INFclasses open the

databaseinternalproperties file

mysql

MYSQL_DRIVER=commysqljdbcDriver

MYSQL_CONNSTR=jdbcmysql$RDS_HOSTNAME$RDS_PORT$DB_

NAMEautoReconnect=true

oracle

ORACLE_DRIVER=oraclejdbcdriverOracleDriver

ORACLE_CONNSTR=jdbcoraclethin$RDS_HOSTNAME$RDS_

PORT$ORACLE_SID

mssql

MSSQL_DRIVER=commicrosoftsqlserverjdbcSQLServerDriver

MSSQL_CONNSTR=jdbcsqlserver$RDS_HOSTNAME$RDS_

PORTdatabaseName=$DB_NAME

copy 2014 by Kony Inc All rights reserved 116 of 185

11 Configuring Properties Files in WAR Files Manual Installation GuideVersion13

5 In the workspacewarWEB-INFclasses open theworkspaceServicekey

file

master_key=ltRandom GUI IDgt

master_key_id=ltRandom GUI IDgt

1135 Kony MobileFabric Integration Service (middleware)

For more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_integration_

service_installation_weblogic_htmlDefaulthtm

copy 2014 by Kony Inc All rights reserved 117 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Deploying WAR Files

l Tomcat and JBoss

l WebSphere

l WebLogic

121 Deploying WAR Files to Tomcat and JBoss

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Important The following configuration is same for all app servers except the deployment paths

for app servers

To deploy configured WAR files to Kony MobileFabric Console follow these steps

1 Copy the updatedwar files such asaccountswar authServicewar

mbaasportalwar andworkspacewar

2 Paste the files in the following location

l For Tomcat ltUser install directorygtapache-tomcat-

7052webapps

l For JBoss single node ltJBoss-DIRgtstandalonedeployments

l For JBossmultinode ltJBoss-DIRgtltnew_Folder- for example

deployedWar foldergt

copy 2014 by Kony Inc All rights reserved 118 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Important For JBossmultinode place themysql-connector-java-

5127-binjar file in the same location This also applies to

accountswar authServicewar ROOTwar and

workspacewar

3 Configure your app server (Tomcat or JBoss) as a service

122 Deploying WAR Files to WebSphere

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

The updated war files need to be deployed inWebShpere Server such as accountswar

adminwar authServicewar metricsear mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Go to Applications and click New Application

The New Application page appears

copy 2014 by Kony Inc All rights reserved 119 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click New Enterprise Application

3 Select Local file system and browse to the war file

4 Click Next

The Preparing for the application installation page appears

copy 2014 by Kony Inc All rights reserved 120 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

5 Select the Detailed - Show all installation options and parameters option and click Next

6 If the Application Security Warnings page appears click Continue

copy 2014 by Kony Inc All rights reserved 121 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 The Select installation options page appears

copy 2014 by Kony Inc All rights reserved 122 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Retain the default values and click Next

TheMap modules to servers page appears

9 The accountsmodule ismapped to the selected server by default Map the accountsmodule to

your selected server if not mapped by default and click Next

The Provide JSP reloading options for Web modules page appears

copy 2014 by Kony Inc All rights reserved 123 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

10 Retain the default values and click Next

TheMap shared libraries page appears

copy 2014 by Kony Inc All rights reserved 124 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Select the shared lib folder related to the WAR file For more details refer to integration

services gt Install and ConfigureMiddleware

11 Map previously created shared librarySharedLib folder to accountsmodule

a Select the check box against accounts_war application and click Reference shared

libraries

TheMap libraries page appears

copy 2014 by Kony Inc All rights reserved 125 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

b Select your shared library under Available andmove it to Selected using the right arrow

key

c ClickOK

Repeat the same steps for mfconsole to map to the shared library

TheMap shared library relationships page appears

copy 2014 by Kony Inc All rights reserved 126 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Retain the default values and click Next

TheMap virtual hosts for Web modules page appears

copy 2014 by Kony Inc All rights reserved 127 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Map your virtual host (default_host) to module if not mapped by default and click Next

TheMap context roots for Web modules page appears

copy 2014 by Kony Inc All rights reserved 128 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Type the context root value as accounts in Context Root and click Next

TheMap JASPI provider page appears

copy 2014 by Kony Inc All rights reserved 129 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

15 Retain the default values and click Next

The Display module build Ids page appears

copy 2014 by Kony Inc All rights reserved 130 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

16 Retain the default values and click Next

The Summary page appears

copy 2014 by Kony Inc All rights reserved 131 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

17 Review summary and click Finish Wait till you get amessage conveying that the application is

installed successfully

18 Click Save to save themaster configuration

19 Youmay have to restart theWebSphere Application Server

copy 2014 by Kony Inc All rights reserved 132 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

20 Go to Applications gt Application Types clickWebSphere enterprise applications

21 Select the application and click Start

22 Restart theWebSphere application server for the changes to take effect

You can now log in toMobileFabric Console

1221 Deploying Metricsear to WebSphere

After you configure all properties files in WAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

To deploy metricsear file to WebSphere follow these steps

Enterprise application page displays the list of installed applications inWebSphere If metrics server is

not up or not installed correctly the application status across themetrics displays a X symbol To use

themetrics application you need to reinstall the application and use it To reinstall themetrics initially

uninstall the existingmetrics application

1 Select Metrics from the list of applications and click Uninstall

copy 2014 by Kony Inc All rights reserved 133 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Themetrics application will be uninstalled and the Enterprise application windows displays a

message at the top and the remaining applications in the window

copy 2014 by Kony Inc All rights reserved 134 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

2 Click Install to reinstall theMetrics application

3 Select themetrics file to be installed from the following path Install_

folderdeploymentsmetricsear and click Next

copy 2014 by Kony Inc All rights reserved 135 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

4 Select Detailed option to display all the installation options and parameters and click Next

Step 1 Select Installation Options window is displayed The default installation options are

automatically selected

5 Click Next to map themodules to the server

copy 2014 by Kony Inc All rights reserved 136 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

copy 2014 by Kony Inc All rights reserved 137 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

In Step 2 Map modules to servers window themodules are automaticallymapped to the

server

copy 2014 by Kony Inc All rights reserved 138 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

6 Click Next to move to step 3

In Step 3 Map shared libraries window the existing shared libraries are automatically

mapped

copy 2014 by Kony Inc All rights reserved 139 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Click Next to move to step 4

Step 4 Map shared library relationships window displays the relationships for themapped

shared libraries

copy 2014 by Kony Inc All rights reserved 140 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

8 Click Next to enter the JNDI name

9 In Step 5 Bind listeners for message-driven beans window select Activation Specification

under Listener Bindings column and enter the JNDI Name as jmsKMT and click Next

In Step 6 Metadata for modules window themeta data is automatically added to themodules

10 Click Next to move to step 7

copy 2014 by Kony Inc All rights reserved 141 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Step7 Display module build Ids window displays the build Ids for themetricsmodule

copy 2014 by Kony Inc All rights reserved 142 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

11 Click Next to move to step 8

t

Step 8 Summary window displays the overall summary of the installation process

copy 2014 by Kony Inc All rights reserved 143 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

12 Click Finish to install themetrics application

Once themetrics application is successfully installed amessage will be displayed on the

installation window

copy 2014 by Kony Inc All rights reserved 144 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

13 Click Save to save the changes tomaster configuration

The Enterprise Application window is displayed with themetrics application in the list of

applications

copy 2014 by Kony Inc All rights reserved 145 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

14 Select themetrics application and click Start to start the application

123 Deploying WAR Files to WebLogic

After you configure all properties files inWAR files in the Configuring Properties Files inWAR File

section deploy them to KonyMobileFabric Console

Deploymiddlewareear

The updated war files need to be deployed inWebLogic Server such as accountswar

adminwar authServicewar metricswar mfconsolewar

middlewarewar serviceswarandworkspacewar

To deploy the war file follow these steps

copy 2014 by Kony Inc All rights reserved 146 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

Note As an example the stepswith screen shots in the following procedure are provided for

accountswar file You can follow the same steps to deploy other wars

1 Extract konylibzip fromMobileFabric artifacts

2 Deployojdbc6_gjar library from ltlocaldrivegtmobilefabric-

652konylibkonylibdatabaseConnectors

3 Log intoWebLogic Admin Console

4 Go to Domain Structure gt Base Domain gt Deployments click Install in the Install

Application Assistant

5 Click Current Location and browse for theojdbc6_gjar

6 Click Next and Finish

copy 2014 by Kony Inc All rights reserved 147 of 185

12 Deploying WAR Files Manual Installation GuideVersion13

7 Deploywar files

You can now log in toMobileFabric Console

copy 2014 by Kony Inc All rights reserved 148 of 185

13 Configuring Kony MobileFabric as a Service Manual Installation GuideVersion13

13 Configuring Kony MobileFabric as a Service

After you complete deployment of WAR files ensure that you start KonyMobileFabric Console as a

service

To configuring Kony MobileFabric Console as a service follow these steps

1 Download theservice_jbossbat file from the location

2 Place theservice_jbossbat file at the locationltJBoss_DIRgtbin

3 Rename theservice_jbossbat file toservicebat

4 In theservicebat file do the following

l search for ltJBOSS_DIRgt and replace with - JBoss location

l search for ltSERVICE_NAMEgt and replace withService Name you want to

use

5 Open command prompt navigate to ltJBoss_DIRgtbin and execute the following command

servicebat install

6 Configure service start-up type and log on user using theservicesmsc window

copy 2014 by Kony Inc All rights reserved 149 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

14 Starting Kony MobileFabric Console

141 Tomcat

1 If you configured KonyMobileFabric Console asWindows service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupbat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltUser

install directorygtapache-tomcat-7052bin and execute the following

file

startupsh

142 JBoss

1421 For Single Node

1 If you configured KonyMobileFabric Console asWindows service go to this pathltJBoss

DIRgtbin and execute the following file

standalonebat

Or openservicesmsc and start service

2 If you configured KonyMobileFabric Console as Linux service go to this pathltJBoss

DIRgtbin and execute the following file

standalonesh

copy 2014 by Kony Inc All rights reserved 150 of 185

14 Starting Kony MobileFabric Console Manual Installation GuideVersion13

1422 For Multinode

Start the services for the appropriate service groups that you have configured through the JBoss

Management Console from themaster node

copy 2014 by Kony Inc All rights reserved 151 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

15 Upgrading Kony MobileFabric Components

The following sections explain upgrading KonyMobileFabric Components from 652 GA to 652x

versionsmanually

l Console

o mfconsolewar

o workspacewar

o accountswar

l Identity Service

l Integration Service (Middleware)

l Metrics

151 Upgrading Kony MobileFabric Console from 652 GA to 652x

To upgrade MobileFabric Console instance follow these steps

1 Download the mbassportalwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The mbassportalwar contains the following files and folders

l Angular ltDIRgt

l appdashboardhtml

l css ltDIRgt

l downloads ltDIRgt

l font-awesome ltDIRgt

copy 2014 by Kony Inc All rights reserved 152 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l fontface ltDIRgt

l images ltDIRgt

l js ltDIRgt

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the configproperties file from existing mfconsolewar and update it into the

new mbassportalwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsmfconsoleWEB-INFclasses folder

and copy the configproperties file

b Paste the configproperties into the WEB-INFclasses folder of the new

mbassportalwar that you downloaded

3 Rename the updated mbassportalwar to mfconsolewar

4 Stop the Server

5 Delete the existing mfconsolewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete mfconsole

l For JBoss delete mfconsolewardeployed

6 Deploy the mfconsolewar on to the Server

7 Start the Server

152 Upgrading Workspace (WaaS) from 652 GA to 652x

To upgrade MobileFabric WaaS follow these steps

copy 2014 by Kony Inc All rights reserved 153 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Download the workspacewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

2 Copy the workspaceServicekey file from existing workspacewar and update it into

the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServicekey file

b Paste the workspaceServicekey into the workspaceWEB-INFclasses

folder of the new workspacewar that you downloaded

3 Copy the workspaceServiceproperties file from the existing workspacewar and

update it into the new workspacewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsworkspaceWEB-INFclasses folder

and copy the workspaceServiceproperties file

b Paste the workspaceServiceproperties into the workspaceWEB-

INFclasses folder of the new workspacewar that you downloaded

4 Stop the Server

5 Delete the existing workspacewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete workspace

l For JBoss delete workspacewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Workspace_Services_

copy 2014 by Kony Inc All rights reserved 154 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____2

7 Deploy the workspacewar on to the Server

8 Start the Server

153 Upgrading Accounts from 652 GA to 652x

To upgrade MobileFabric Accounts follow these steps

1 Download the accountsAPIwar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The accountsAPIwar contains the following files and folders

l WEB-INF

l META-INF

l indexjsp

2 Copy the accountsproperties file from existing accountswar and update it into the

new accountsAPIwar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsaccountsWEB-INFclasses folder

and copy the accountsproperties file

b Paste the accountsproperties into the workspaceWEB-INFclasses folder

of the new accountsAPIwar that you downloaded

3 Rename the accountsAPIwar to accountswar

4 Stop the Server

copy 2014 by Kony Inc All rights reserved 155 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

5 Delete the existing accountswar from your MobileFabricInstall_652_

Folder

l For Tomcat delete accounts

l For JBoss delete accountswardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

Kony_Accounts_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____3

7 Deploy the accountswar on to the Server

8 Start the Server

154 Upgrading Identity from 652 GA to 652x

To upgrade MobileFabric Identity follow these steps

1 Download the authServicewar from

httpdownloadkonycomonpremisemobilefabric6525mobilefabric-6525zip

The authServicewar contains the following files and folders

l resources ltDIRgt

l logoutjsp

l indexjsp

l security ltDIRgt

copy 2014 by Kony Inc All rights reserved 156 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

l META-INFltDIRgt

l WEB-INF ltDIRgt

2 Copy the authservicekey file from existing authServicewar and update it into the

new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authservicekey file

b Paste the authservicekey into the authServiceWEB-INFclasses folder of

the new authServicewar that you downloaded

3 Copy the authServiceproperties file from the existing authServicewar and

update it into the new authServicewar as follows

a Navigate to your MobileFabricInstall_652_

FolderAppServerwebappsauthServiceWEB-

INFclasses folder and copy the authServiceproperties file

b Paste the authServiceproperties into the authServiceWEB-INFclasses

folder of the new authServicewar that you downloaded

4 Stop the Server

5 Delete the existing authServicewar from your MobileFabricInstall_652_

Folder

l For Tomcat delete authServicewar

l For JBoss delete authServicewardeployed

6 In case tomigrate your database run themigration steps provided at httpdocskonycom6_

5konylibrarymobilefabrickony_mobilefabric_manual_install_guideDefaulthtmConfiguring_

copy 2014 by Kony Inc All rights reserved 157 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

Kony_Identity_Services_

Databasehtm3FTocPath3DConfiguring2520Database2520for2520MobileFabric

7C_____1

7 Deploy the authServicewar on to the Server

8 Start the Server

155 Upgrading Integration (Middleware) from 652 GA to 652x

1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss

15511 Prerequisites

1 Stop all the servers (JMS and Application server)

2 Download the admin andmiddleware war from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

3 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

4 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15512 Backup

Take the backup of the following files

copy 2014 by Kony Inc All rights reserved 158 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1 Admin middleware and serviceswars

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Middleware Libraries

l Location ltmiddleware_homegtlibmiddleware

3 After taking the Backup delete all jar files from themiddleware libraries

15513 Upgrade

1 Copy the three latest downloaded artifacts to the location

l Location for Tomcat ltInstall_Locationgttomcatwebapps

l Location for JBoss ltInstall_

Locationgtjbossstandalonedeployments

2 Untar the Libraries tar to the locationltmiddleware_homegtlibmiddleware

3 Copy the jboss-clientjar from the backup of Middleware Libraries and paste it to the

same abovementioned folder

4 Start the servers

1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic

15521 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverweblogic

copy 2014 by Kony Inc All rights reserved 159 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the Libraries (libraries-MIDDLEWARE-GA-652xtar ) also from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-652xMiddlewareKony20Server

15522 Backup

1 Download existing admin middleware and serviceswars fromWebLogic console and take

backup of them

2 After taking the backup delete all the jar files in themiddleware folder mentioned in the above

step

15523 Upgrade

1 Undeploy older admin middleware and serviceswars fromWebLogic Console

2 Deploy the newly downloaded admin middleware and serviceswars toWebLogic Console For

more details refer to httpdocskonycomkonylibraryintegrationkony_mobilefabric_

integration_service_installation_weblogic_htmlDefaulthtmUpgrading_WebLogic_Manually_

56x_to_

65xhtm3FTocPath3DUpgrade2520Kony2520MobileFabric2520Integration2520

Service7C_____3

3 Restart the server

copy 2014 by Kony Inc All rights reserved 160 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone

without MobileFabric)

15531 Prerequisites

1 Download the admin andmiddleware from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

2 Download the serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Servermbaas

3 Download the shared-libraries-wastar and shared-libraries-was8xtar

from the location httpdeveloperkonycomtwikipubPortalReleasesGA-

652xMiddlewareKony20Serverwebsphere

15532 Backup

1 Take the backup of the shared-Libraries and shared-Libraries-was from the respective folders

and delete all the jars from the folders

2 If required download and take backup of admin middleware and services ears from the

WebSphere Console

15533 Upgrade

1 Untar and copy the latest jars ( shared-Libraries and shared-Libraries-was) to the respective

folders

2 Deploy the latest admin middleware and serviceswars toWebSphere administrative console

For more details refer to httpdocskonycomkonylibraryintegrationkmf_installation_

websphereDefaulthtmUpgrading_Kony_Server_Manually_WebSphere_56_

copy 2014 by Kony Inc All rights reserved 161 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

60htmUpgradin3FTocPath3DUpgradingWebSphere2520Manually2520from252

050x252F55x252F56x2520to25206x7CUpgrading2520middlewareear7

C_____0

3 Restart the server after you deploy war files

156 Upgrading Metrics from 652 GA to 652x

1561 Upgrading hotfix patches from 652 GA

The following steps help you upgradeMetrics from 652 GA to 652x

1 Upgrade artifacts in theMobileFabric installation folder

2 Upgrade steps in the Flyway folder

15611 Upgrade artifacts in the MobileFabric installation folder

1 StopMobileFabric services (MobileFabric and JavaMessage Service)

2 Download serviceswar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Servermbaas

3 Download adminwar and middlewarewar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-

6521MiddlewareKony20Serverjboss62

4 Replace adminwar middlewarewar and serviceswar inMF_INSTALL_

DIRECTORYjbossstandalonedeployments folder

5 Download metricsear from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

copy 2014 by Kony Inc All rights reserved 162 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

6 Replace the metricsear (downloaded it in the previous step 5) in MobileFabric_

INSTALL_DIRECTORY jboss_jmsstandalonedeployments folder

7 Download metricsAPI-10058jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6521Metrics

8 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL _DIRECTORY as a backup

9 Now extract accountswar to ltextraction foldergt

10 Navigate toltextraction foldergtWEB-INFlib and remove metricAPI

(xxxx)jar (namelymetricsAPI-10053jar) from the same

11 Paste metricsAPI-10058jar (The jar that you have downloaded in step 7 above)

12 Delete the original accountswar

13 From the accountswar ltextraction foldergt location zip the three folders

such as META-INF WEB-INF and indexjsp as accountswar

15612 Upgrade steps in the Flyway folder

Flywaymigration steps (for modifying the backend database)

Instructions are written specifically for SQL Server

Prerequisites

1 Download the flyway (321) software from the link

httpflywaydborggetstarteddownloadhtml For example for Windows flyway-commandline-

321-windows-x64zip

2 Extract the flyway-commandline-321-windows-x64zip file in your local system

copy 2014 by Kony Inc All rights reserved 163 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

3 Place the hotfix version 4 SQL (V4__mssql_reports_dbsql) in the SQL folder inside ldquoflyway-

321rdquo folder of folder created in Step 2

4 Configure database connectivity using flyway file in the conf folder following the instructions

below

a Update the ldquoFlywayURL ldquondash JDBC URL for respective databases (modify URL as per the

database server port db)

For example

flywayurl=jdbcsqlserver101111641434DatabaseName=s

qlreports

b Update the ldquoflywaydriverrdquo property shown below

flywaydriver=commicrosoftsqlserverjdbcSQLServerDriver

(for example for MSSQL)

c Update ldquoflywayuserrdquo property to the database user credentials

Example flywayuser=ltusernamegt

d Update ldquoflyway passwordrdquo property to the database password

Example flywaypassword=ltdatabase_passwordgt

e Uncomment ldquoflywaybaselineVersionrdquo and set it as followsSet flywaybaselineVersion=3

f Set ldquoflywaybaselineonmigraterdquo to true (only for mssql - uncomment)

g Copy the jdbc driver of respective database in flyway drivers folder

h Open up a command prompt and navigate to the flyway-321 folder

copy 2014 by Kony Inc All rights reserved 164 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

1562 Upgrading Jasper Single-Tenant License from 6522 to 6524

There are two different types of steps involved in the hotfix

1 Import the Jasper repository and configure with MobileFabric Server

2 ConfigureMetrics API JAR in theMobileFabric Server

15621 Import the Jasper repository and configure with MobileFabric Server

Download Reports

Download the reports package from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsReports56jasper-reports-

mssqlzip

Import Repository

The following steps to import the reports package

For Linux

1 Open the Linux terminal

2 Go to the ltpath of the extracted packagegt

3 Run the konyreports_importsh script followed by the JasperServer location as the input

4 konyreports_importsh ltjasperinstall-dirgt usrjaspersoft

Configure Jasper to MobileFabric

1 Follow the below Analytics document to configure Jasper with MobileFabric

Link to Document httpdocskonycomkonylibrarymobilefabrickony_analytics_

reportingDefaulthtmHow_to_Configure_MobileFabrichtm3FTocPath3D_____7

copy 2014 by Kony Inc All rights reserved 165 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

2 Follow the below additional step to specify single tenant license value after above you have

configured Jasper with MobileFabric inapplicationContext-security-web-

OAuthxml

For example ltjasperinstall-dirgtapache-

tomcatwebappsjasperserver-proweb-inf

applicationContext-security-web-OAuthxml

ltproperty name=singleTenant value=SET_LICENSE_TYPE gt

l Replace above value with ldquotruerdquo for Professional EditionSingleTenant License

l Replace above value with ldquofalserdquo for Enterprise EditionMultiTenant License

For example ltproperty name=singleTenant value=true gt

15622 Configure Metrics API JAR in the MobileFabric Server

1 StopMobileFabric services (MobileFabric and JMS)

2 Download metricsAPI-10068jar from the link

httpdeveloperkonycomtwikipubPortalReleasesGA-6524MetricsmetricsAPI-

10068jar

3 Navigate toMobileFabric_INSTALL_

DIRECTORYjbossstandalonedeployments and copy accountswar to an

location outside of MobileFabric_INSTALL_DIRECTORY as a backup

4 Extract accountswar to ltextraction foldergt

5 Navigate to theltextraction foldergtWEB-INFlib and removemetricAPI

(xxxx)jar (namelymetricsAPI-10058jar) from the same

6 Paste metricsAPI-10068jar (The jar that you have downloaded in step 2 above)

7 Delete the original accountswar

copy 2014 by Kony Inc All rights reserved 166 of 185

15 Upgrading Kony MobileFabric Components Manual Installation GuideVersion13

8 From the accountswar to ltextraction foldergt location zip the three folders META-INF

WEB-INF and indexjsp as accountswar

9 Restart both services in order (JMS andMobileFabric)

copy 2014 by Kony Inc All rights reserved 167 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

16 Post-Installation Tasks

161 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

After installing KonyMobileFabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your MobileFabric Installers JRE trusted certificate authority

(CA) certificates file - for example ltINSTALL_DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - peer not authenticated

To enable communication between MobileFabric Console and other products such as Kony

MobileFabric Sync Kony MobileFabric Integration and Kony MobileFabric Messaging follow

these steps

l import each products certificate (KonyMobileFabric Sync KonyMobileFabric Integration and

KonyMobileFabricMessaging) into theMobileFabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

l import console cert into the product boxes cacerts such as KonyMobileFabric Integration Kony

MobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts

To add an installer generated self-signed SSL certificate to cacerts follow these steps

1 From your MobileFabric installed system open the Linux terminal and run the following

command to generate anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

copy 2014 by Kony Inc All rights reserved 168 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

Based on the hostname and keystore password provided at the SSL Certificate window the

preceding command exports the required certificate from the source keystore with the given

name - for example intermediatecrt

2 Run the following command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1612 How to Add an Existing SSL Certificate to Cacerts

If Java does not identify a certificate issuer by default you need to import an SSL into your cacerts

To add an existing SSL certificate to cacerts follow these steps

Use the following steps to import your existing certificate to cacerts with the proper value of alias

keystore location and keystore password

1 From your MobileFabric installed system open the Linux terminal and run the following

command to add anintermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltyourcertificate_

domaingt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltkeystore_locationgt-storepass ltPasssword_of_keystoregt

2 Run the below command to import theintermediatecrt certificate file into your

MobileFabric Installers JRE trusted certificate authority (CA) certificates file

copy 2014 by Kony Inc All rights reserved 169 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts -

alias ltyourcertificate_domaingt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

162 JDK Version Compatibility

In case if you upgrade your JDK version in your middleware server to enable JDK version

compatibility make the appropriate changes in an app servers middlewareproperties file

located in your middleware server installation folder

For example When you upgrade JDK V 16 to JDK V 17 (vice-versa) you can still run your

middleware server MobileFabrics run-time apps cannot be accessed If you try to access any apps at

runtime the system throws an error message due to JDK version incompatibility

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts

163 How to Switch between JDK Versions

Ensure that youmake necessary changes in themiddlewareproperties file before you

switch between Java version such (for example JDK V 16 to JDK V 17 or JDK V 17 to JDK V 16)

copy 2014 by Kony Inc All rights reserved 170 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

To configure JDK version in middleware follow these steps

1 In your middleware server installation folder open the middlewareproperties file

located at the below path

l for JBoss ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfigl for Tomcat ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

2 In themiddlewareproperties file do the following changes

l Java 6

sslSocketFactoryprovider=sunsecuritysslSSLSocketFactoryI

mpl

sslServerSocketFactoryprovider=sunsecuritysslSSLServerSo

cketFactoryImpl

l Java 7

sslSocketFactoryprovider=comsunnetsslinternalsslSSLSo

cketFactoryImpl

sslServerSocketFactoryprovider=comsunnetsslinternalssl

SSLServerSocketFactoryImpl

164 How to Configure Memcached for Integration Service

If you install MobileFabric on Tomcat or JBoss configure thememcachecluster value in the

middlewareproperties file to make service calls

1 Stop KonyMobileFabric services

2 In your middleware server installation folder open the middlewareproperties file

located at the below path

copy 2014 by Kony Inc All rights reserved 171 of 185

16 Post-Installation Tasks Manual Installation GuideVersion13

l for JBoss

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

l for Tomcat

ltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfig

3 In themiddlewareproperties file do the following changes

Memcache configuration

memcachecluster=

memcachecluster=

memcacheexpiry=1200

memcachestoreattempts=12

memcacheretriveattempts=3

memcachenoofclients=

memcachestoretime=300

Important Ensure that you uncomment thememcachecluster Key For example

memcachecluster=

4 Restart the KonyMobileFabric services

copy 2014 by Kony Inc All rights reserved 172 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

17 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

copy 2014 by Kony Inc All rights reserved 173 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

copy 2014 by Kony Inc All rights reserved 174 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF-

abric Products Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

copy 2014 by Kony Inc All rights reserved 175 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

copy 2014 by Kony Inc All rights reserved 176 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

172 WebSphere FAQs

For more information seeWebSphere FAQs

173 FAQs and Troubleshooting

This section lists the troubleshooting tips to resolve problems that youmay encounter during

installation

l Issue

If your service providers certificate is not configured the system displays an error - peer not

authenticated

Workaround

copy 2014 by Kony Inc All rights reserved 177 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

For trusted certification issues refer to SSLCertificate Issues

l Issue - MySQL DB error

If you use a common database for multiple tasks such as installingMobileFabric or accessing a

service from a device the system throws theMySQLDB error -- prepared statement needs to

be re-prepared-- in logs

Workaround

To avoid this error increaseTABLE_DEFINITION_CACHE and TABLE_OPEN_

CACHEand MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for MobileFabric

l Issue - App publishing error

If your app publish fails the system displays an error message

When IDE app publish fails with Error MessageInternal

server error occurred while publishing application More Details

null

ResponseHTTP11 500 Internal Server Error 500 Internal server

error more details null

Workaround

Restart middleware server and re-publish the app

copy 2014 by Kony Inc All rights reserved 178 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

l Issue

When a user deploys sync by providing -Dsynchome parameter on sameWebLogic where

KonyMobileFabric (with integrated server) installed app publish fails

Workaround

Configure -D parameter for syncmiddleware home pointing to existingMobileFabric

middleware home which is created while installingMobileFabric

For example add the -Dsynchome=ltpath of the Kony MobilelFabric

middleware home directorygt parameter for syncmiddleware home

l Issue - Latest MobileFabric does not support old DB configured with lower versions of

MobileFabric

In Multinode environment user should be adding new node with same version of MobileFabric

and do the additional settings related to key

Workaround

1 Configure additional nodes into the existing environment by using the existing database

that is setup with MobileFabric

2 Replace the following key values in the new node with the key values in the existing

configuration

o In theaccountsproperties file theACCOUNTS_ENCRYPTION_KEY

value should be configured with the same value as in all nodes

Path for theaccountsproperties file

ltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses

o TheAuthservicekey should be configured with the same value in all nodes

Path for the authservicekey file

copy 2014 by Kony Inc All rights reserved 179 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o Theworkspaceservicekey value should be configured with the same

value in all nodes

Path for theworkspaceservicekey file

ltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products

Running on JDK 16

If you useMobileFabric with HTTPs running on JDK 16 youmust enable the SSLv3

(SSLv2Hello) Protocol on KonyMobileFabric products such as KonyMobileFabric Integration

KonyMobileFabric Sync KonyMobileFabricMessaging and KonyMobileFabricManagement

By default JDK 16 supports SSLv3 Protocol along with other protocols When a client tries (for

example KonyMobileFabric Server) to send data to a server (for example MobileFabric Console)

the SSLv3 protocol from both client and server handshakeswith each other before exchanging data

If SSLv2Hello protocol is not configured the system does not allow requests between clientserver

such as exchanging data or publishing apps The system throws a handshake error

17311 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node

To enable SSLv3 (SSLv2Hello) Protocol for single-node follow these steps

1 Open thestandalonexml file located in your MobileFabric install location

For example ltinstallation

foldergtjbossstandaloneconfigurationstandalonexml

2 In thestandalonexml file find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

The SSLv2Hello is added in the protocol list shown below

copy 2014 by Kony Inc All rights reserved 180 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thestandalonexml file

17312 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode

To enable SSLv3 (SSLv2Hello) Protocol for multi-node follow these steps

1 Open thedomainxmlfile located in your MobileFabric install location

For example ltinstallation foldergtjboss-eap-62-

masterdomainconfigurationdomainxml

2 In thedomainxmlfile find for TLSv1TLSv11TLSv12 and replace with

SSLv2HelloTLSv1TLSv11TLSv12

Important In thedomainxml file youmust replace the

SSLv2HelloTLSv1TLSv11TLSv12 at four places If you fail to do this your

MobileFabric console will not receive data properly from other KonyMobileFabric Servers

The SSLv2Hello is added in the protocol list shown below

ltconnector name=HTTPS protocol=HTTP11

scheme=https socket-binding=https secure=truegt

ltssl name=https password=ltpasswordgt

certificate-key-file=ltcertificate-key-filegt

copy 2014 by Kony Inc All rights reserved 181 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

protocol=SSLv2HelloTLSv1TLSv11TLSv12gt

ltconnectorgt

3 Save thedomainxmlfile

1732 WebSphere FAQs

For more information seeWebSphere FAQs

174 How to Change Log Levels

l For console and auth log files by default log level value is set toINFO

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o andworkspaceServicelog (for workspace)

o authServicelog

o For KMS the default log level is INFO

l For adminlog and sync log files by default log level value is set to ERROR

To change log levels for mbaasportallog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsmfconsolewarWEB-INFclasses and open

thelog4jproperties file

2 Change the log level to the required value

3 Redeploy themfconsolewar file

copy 2014 by Kony Inc All rights reserved 182 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

To change log levels for accountsServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theaccountsServicewar file

To change log levels for workspaceServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsaccountsServicewarWEB-INFclasses

and open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theworkspaceServicewar file

To change log levels for authServicelog follow these steps

1 Go toltMobileFabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and

open thelog4jproperties file

2 Change the log level to the required value

3 Redeploy theauthServicewar file

To change log levels for adminlog follow these steps

copy 2014 by Kony Inc All rights reserved 183 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconfadmin and open theadmin-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for middlewarelog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themiddleware-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for metricslog follow these steps

1 Go toltinstaller foldergtmiddleware_

homemiddlewaremiddleware-bootconf and open themetrics-

log4jproperties file

2 Change the log level to the required value

3 Restart the server

To change log levels for KMS logs follow these steps

1 Go toltKMS install directorygtkpns-resources and open thekms-

log4jproperties file

copy 2014 by Kony Inc All rights reserved 184 of 185

17 FAQs and Troubleshooting Manual Installation GuideVersion13

2 Change the log level to the required value

3 Restart the server

To change log levels for Sync logs follow these steps

1 Go toltSync install directorygtconf and open the following properties files

l console-log4jproperties

l services-log4jproperties

2 Change the log level to the required value

3 Restart the server

copy 2014 by Kony Inc All rights reserved 185 of 185

  • 1 Preface
    • 11 Purpose
    • 12 Intended Audience
    • 13 Formatting Conventions
    • 14 Related Documents
    • 15 Contact Us
      • 2 Prerequisites
        • 21 Prerequisites for MobileFabric with Oracle
        • 22 Software Requirements
        • 23 Hardware Requirements
        • 24 Required Setup Files
          • 3 MobileFabric Topology and Components
          • 4 Configuring Database for MobileFabric
            • 401 Prerequisites Create Databases
            • 41 Configuring Kony Identity Services Database
              • 411 MySQL
              • 412 Oracle
                • 42 Configuring Kony Workspace Services Database
                  • 421 MySQL
                  • 422 Oracle
                    • 43 Configuring Kony Accounts Services Database
                      • 431 MySQL
                      • 432 Oracle
                          • 5 Creating Shared Library Folders for MobileFabric - WebSphere
                          • 6 Creating Data Source for MobileFabric Console - WebSphere
                            • 61 Creating Data Source for MobileFabric Console Schema (SQL Server)
                              • 611 Creating a JAAS J2C Authentication
                              • 612 Creating a JDBC Provider
                              • 613 Creating a Data Source
                              • 614 Setting Custom Properties of Data Source
                                • 62 Creating Data Source for MobileFabric Console Schema (Oracle)
                                  • 621 Creating a JAAS J2C Authentication
                                  • 622 Creating a JDBC Provider
                                  • 623 Creating a Data Source
                                  • 624 Setting Custom Properties of Data Source
                                    • 63 Creating Data Source for MobileFabric Console Schema (MySQL)
                                      • 631 Creating a JAAS J2C Authentication
                                      • 632 Creating a JDBC Provider
                                      • 633 Creating a Data Source
                                      • 634 Setting Custom Properties of Data Source
                                        • 64 Configuring Data Source for Integration Service
                                          • 7 Creating Data Source for MobileFabric Console Schema - WebLogic
                                          • 8 Configuring Installation Mode
                                            • 81 How to Configure Installation Modes - Tomcat
                                              • 811 How to Configure Tomcat Multinode Installation
                                                • 82 How to Configure Installation Modes - JBoss
                                                  • 821 How to Configure JBoss for Singlenode Installation
                                                  • 822 How to Configure JBoss for Multinode Installation
                                                    • 83 How to Configure Installation Modes - WebSphere
                                                      • 9 Configuring JNDI for a Database
                                                        • 91 How to Configure JNDI - Tomcat
                                                          • 911 For MySQL
                                                            • 92 How to Configure JNDI - JBoss
                                                              • 921 For MySQL
                                                                  • 10 Configuring Connectors and WAR Deployment
                                                                    • 101 How to Configure Connectors - Tomcat
                                                                      • 1011 How to Configure Batch Files
                                                                        • 102 How to Configure Connectors - JBoss
                                                                          • 1021 How to Configure Deployment of mbaasportalwar file
                                                                          • 1022 How to Configure Connector
                                                                              • 11 Configuring Properties Files in WAR Files
                                                                                • 111 How To Configure Properties Files in WAR Files - Tomcat and JBoss
                                                                                  • 1111 accountsAPIwar
                                                                                  • 1112 authServicewar
                                                                                  • 1113 mbaasportalwar
                                                                                  • 1114 workspaceServicewar
                                                                                    • 112 How To Configure Properties Files in WAR Files - WebSphere
                                                                                      • 1121 accountsAPIwar
                                                                                      • 1122 authServicewar
                                                                                      • 1123 mbaasportalwar
                                                                                      • 1124 workspaceServicewar
                                                                                      • 1125 Kony MobileFabric Integration Service (middleware)
                                                                                        • 113 How To Configure Properties Files in WAR Files - WebLogic
                                                                                          • 1131 accountsAPIwar
                                                                                          • 1132 authServicewar
                                                                                          • 1133 mbaasportalwar
                                                                                          • 1134 workspaceServicewar
                                                                                          • 1135 Kony MobileFabric Integration Service (middleware)
                                                                                              • 12 Deploying WAR Files
                                                                                                • 121 Deploying WAR Files to Tomcat and JBoss
                                                                                                • 122 Deploying WAR Files to WebSphere
                                                                                                  • 1221 Deploying Metricsear to WebSphere
                                                                                                    • 123 Deploying WAR Files to WebLogic
                                                                                                      • 13 Configuring Kony MobileFabric as a Service
                                                                                                      • 14 Starting Kony MobileFabric Console
                                                                                                        • 141 Tomcat
                                                                                                        • 142 JBoss
                                                                                                          • 1421 For Single Node
                                                                                                          • 1422 For Multinode
                                                                                                              • 15 Upgrading Kony MobileFabric Components
                                                                                                                • 151 Upgrading Kony MobileFabric Console from 652 GA to 652x
                                                                                                                • 152 Upgrading Workspace (WaaS) from 652 GA to 652x
                                                                                                                • 153 Upgrading Accounts from 652 GA to 652x
                                                                                                                • 154 Upgrading Identity from 652 GA to 652x
                                                                                                                • 155 Upgrading Integration (Middleware) from 652 GA to 652x
                                                                                                                  • 1551 Upgrading Middleware from 652 GA to 652x - Tomcat and JBoss
                                                                                                                  • 1552 Upgrading hotfix patches from 652 GA to 652x - WebLogic
                                                                                                                  • 1553 Upgrading hotfix patches from 652 GA to 652x - WebSphere (Standalone without MobileFabric)
                                                                                                                    • 156 Upgrading Metrics from 652 GA to 652x
                                                                                                                      • 1561 Upgrading hotfix patches from 652 GA
                                                                                                                      • 1562 Upgrading Jasper Single-Tenant License from 6522 to 6524
                                                                                                                          • 16 Post-Installation Tasks
                                                                                                                            • 161 Configuring Secure Sockets Layer (SSL) Certificate
                                                                                                                              • 1611 How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts
                                                                                                                              • 1612 How to Add an Existing SSL Certificate to Cacerts
                                                                                                                                • 162 JDK Version Compatibility
                                                                                                                                • 163 How to Switch between JDK Versions
                                                                                                                                • 164 How to Configure Memcached for Integration Service
                                                                                                                                  • 17 FAQs and Troubleshooting
                                                                                                                                    • 171 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                      • 1711 How to Enable SSLv2Hello Protocol in the standalonexml File for Single Node
                                                                                                                                      • 1712 How to Enable SSLv2Hello Protocol in the domainxml File for Multinode
                                                                                                                                        • 172 WebSphere FAQs
                                                                                                                                        • 173 FAQs and Troubleshooting
                                                                                                                                          • 1731 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK 16
                                                                                                                                          • 1732 WebSphere FAQs
                                                                                                                                            • 174 How to Change Log Levels
Page 14: Kony MobileFabric Installer Guide
Page 15: Kony MobileFabric Installer Guide
Page 16: Kony MobileFabric Installer Guide
Page 17: Kony MobileFabric Installer Guide
Page 18: Kony MobileFabric Installer Guide
Page 19: Kony MobileFabric Installer Guide
Page 20: Kony MobileFabric Installer Guide
Page 21: Kony MobileFabric Installer Guide
Page 22: Kony MobileFabric Installer Guide
Page 23: Kony MobileFabric Installer Guide
Page 24: Kony MobileFabric Installer Guide
Page 25: Kony MobileFabric Installer Guide
Page 26: Kony MobileFabric Installer Guide
Page 27: Kony MobileFabric Installer Guide
Page 28: Kony MobileFabric Installer Guide
Page 29: Kony MobileFabric Installer Guide
Page 30: Kony MobileFabric Installer Guide
Page 31: Kony MobileFabric Installer Guide
Page 32: Kony MobileFabric Installer Guide
Page 33: Kony MobileFabric Installer Guide
Page 34: Kony MobileFabric Installer Guide
Page 35: Kony MobileFabric Installer Guide
Page 36: Kony MobileFabric Installer Guide
Page 37: Kony MobileFabric Installer Guide
Page 38: Kony MobileFabric Installer Guide
Page 39: Kony MobileFabric Installer Guide
Page 40: Kony MobileFabric Installer Guide
Page 41: Kony MobileFabric Installer Guide
Page 42: Kony MobileFabric Installer Guide
Page 43: Kony MobileFabric Installer Guide
Page 44: Kony MobileFabric Installer Guide
Page 45: Kony MobileFabric Installer Guide
Page 46: Kony MobileFabric Installer Guide
Page 47: Kony MobileFabric Installer Guide
Page 48: Kony MobileFabric Installer Guide
Page 49: Kony MobileFabric Installer Guide
Page 50: Kony MobileFabric Installer Guide
Page 51: Kony MobileFabric Installer Guide
Page 52: Kony MobileFabric Installer Guide
Page 53: Kony MobileFabric Installer Guide
Page 54: Kony MobileFabric Installer Guide
Page 55: Kony MobileFabric Installer Guide
Page 56: Kony MobileFabric Installer Guide
Page 57: Kony MobileFabric Installer Guide
Page 58: Kony MobileFabric Installer Guide
Page 59: Kony MobileFabric Installer Guide
Page 60: Kony MobileFabric Installer Guide
Page 61: Kony MobileFabric Installer Guide
Page 62: Kony MobileFabric Installer Guide
Page 63: Kony MobileFabric Installer Guide
Page 64: Kony MobileFabric Installer Guide
Page 65: Kony MobileFabric Installer Guide
Page 66: Kony MobileFabric Installer Guide
Page 67: Kony MobileFabric Installer Guide
Page 68: Kony MobileFabric Installer Guide
Page 69: Kony MobileFabric Installer Guide
Page 70: Kony MobileFabric Installer Guide
Page 71: Kony MobileFabric Installer Guide
Page 72: Kony MobileFabric Installer Guide
Page 73: Kony MobileFabric Installer Guide
Page 74: Kony MobileFabric Installer Guide
Page 75: Kony MobileFabric Installer Guide
Page 76: Kony MobileFabric Installer Guide
Page 77: Kony MobileFabric Installer Guide
Page 78: Kony MobileFabric Installer Guide
Page 79: Kony MobileFabric Installer Guide
Page 80: Kony MobileFabric Installer Guide
Page 81: Kony MobileFabric Installer Guide
Page 82: Kony MobileFabric Installer Guide
Page 83: Kony MobileFabric Installer Guide
Page 84: Kony MobileFabric Installer Guide
Page 85: Kony MobileFabric Installer Guide
Page 86: Kony MobileFabric Installer Guide
Page 87: Kony MobileFabric Installer Guide
Page 88: Kony MobileFabric Installer Guide
Page 89: Kony MobileFabric Installer Guide
Page 90: Kony MobileFabric Installer Guide
Page 91: Kony MobileFabric Installer Guide
Page 92: Kony MobileFabric Installer Guide
Page 93: Kony MobileFabric Installer Guide
Page 94: Kony MobileFabric Installer Guide
Page 95: Kony MobileFabric Installer Guide
Page 96: Kony MobileFabric Installer Guide
Page 97: Kony MobileFabric Installer Guide
Page 98: Kony MobileFabric Installer Guide
Page 99: Kony MobileFabric Installer Guide
Page 100: Kony MobileFabric Installer Guide
Page 101: Kony MobileFabric Installer Guide
Page 102: Kony MobileFabric Installer Guide
Page 103: Kony MobileFabric Installer Guide
Page 104: Kony MobileFabric Installer Guide
Page 105: Kony MobileFabric Installer Guide
Page 106: Kony MobileFabric Installer Guide
Page 107: Kony MobileFabric Installer Guide
Page 108: Kony MobileFabric Installer Guide
Page 109: Kony MobileFabric Installer Guide
Page 110: Kony MobileFabric Installer Guide
Page 111: Kony MobileFabric Installer Guide
Page 112: Kony MobileFabric Installer Guide
Page 113: Kony MobileFabric Installer Guide
Page 114: Kony MobileFabric Installer Guide
Page 115: Kony MobileFabric Installer Guide
Page 116: Kony MobileFabric Installer Guide
Page 117: Kony MobileFabric Installer Guide
Page 118: Kony MobileFabric Installer Guide
Page 119: Kony MobileFabric Installer Guide
Page 120: Kony MobileFabric Installer Guide
Page 121: Kony MobileFabric Installer Guide
Page 122: Kony MobileFabric Installer Guide
Page 123: Kony MobileFabric Installer Guide
Page 124: Kony MobileFabric Installer Guide
Page 125: Kony MobileFabric Installer Guide
Page 126: Kony MobileFabric Installer Guide
Page 127: Kony MobileFabric Installer Guide
Page 128: Kony MobileFabric Installer Guide
Page 129: Kony MobileFabric Installer Guide
Page 130: Kony MobileFabric Installer Guide
Page 131: Kony MobileFabric Installer Guide
Page 132: Kony MobileFabric Installer Guide
Page 133: Kony MobileFabric Installer Guide
Page 134: Kony MobileFabric Installer Guide
Page 135: Kony MobileFabric Installer Guide
Page 136: Kony MobileFabric Installer Guide
Page 137: Kony MobileFabric Installer Guide
Page 138: Kony MobileFabric Installer Guide
Page 139: Kony MobileFabric Installer Guide
Page 140: Kony MobileFabric Installer Guide
Page 141: Kony MobileFabric Installer Guide
Page 142: Kony MobileFabric Installer Guide
Page 143: Kony MobileFabric Installer Guide
Page 144: Kony MobileFabric Installer Guide
Page 145: Kony MobileFabric Installer Guide
Page 146: Kony MobileFabric Installer Guide
Page 147: Kony MobileFabric Installer Guide
Page 148: Kony MobileFabric Installer Guide
Page 149: Kony MobileFabric Installer Guide
Page 150: Kony MobileFabric Installer Guide
Page 151: Kony MobileFabric Installer Guide
Page 152: Kony MobileFabric Installer Guide
Page 153: Kony MobileFabric Installer Guide
Page 154: Kony MobileFabric Installer Guide
Page 155: Kony MobileFabric Installer Guide
Page 156: Kony MobileFabric Installer Guide
Page 157: Kony MobileFabric Installer Guide
Page 158: Kony MobileFabric Installer Guide
Page 159: Kony MobileFabric Installer Guide
Page 160: Kony MobileFabric Installer Guide
Page 161: Kony MobileFabric Installer Guide
Page 162: Kony MobileFabric Installer Guide
Page 163: Kony MobileFabric Installer Guide
Page 164: Kony MobileFabric Installer Guide
Page 165: Kony MobileFabric Installer Guide
Page 166: Kony MobileFabric Installer Guide
Page 167: Kony MobileFabric Installer Guide
Page 168: Kony MobileFabric Installer Guide
Page 169: Kony MobileFabric Installer Guide
Page 170: Kony MobileFabric Installer Guide
Page 171: Kony MobileFabric Installer Guide
Page 172: Kony MobileFabric Installer Guide
Page 173: Kony MobileFabric Installer Guide
Page 174: Kony MobileFabric Installer Guide
Page 175: Kony MobileFabric Installer Guide
Page 176: Kony MobileFabric Installer Guide
Page 177: Kony MobileFabric Installer Guide
Page 178: Kony MobileFabric Installer Guide
Page 179: Kony MobileFabric Installer Guide
Page 180: Kony MobileFabric Installer Guide
Page 181: Kony MobileFabric Installer Guide
Page 182: Kony MobileFabric Installer Guide
Page 183: Kony MobileFabric Installer Guide
Page 184: Kony MobileFabric Installer Guide
Page 185: Kony MobileFabric Installer Guide