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