kony fabric installation guide â€“ linux

Kony Fabric

Installation Guide - Linux

On-Premises

Release V8 SP4 FP1Document 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 2020 by Kony Inc All rights reserved 1 of 469

Kony Fabric Installation Guide - LinuxVersion111

Copyright copy 2014 by Kony Inc

All rights reserved

February 2020

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

Fabric KonyNitro and Kony Visualizer are trademarks of Kony Inc MobileFabric is a registered

trademark of Kony Inc Microsoft theMicrosoft logo Internet Explorer Windows andWindowsVista

are registered trademarks of Microsoft Corporation Apple the Apple logo iTunes iPhone iPad OS

X Objective-C Safari Apple Pay AppleWatch and Xcode are trademarks or registered trademarks

of Apple Inc Google the Google logo Android and the Android logo are registered trademarks of

Google Inc Chrome is a trademark of Google Inc BlackBerry PlayBook Research inMotion and

RIM are registered trademarks of BlackBerry SAPreg and SAPreg Business Suitereg are registered

trademarks of SAP SE in Germany and in several other countries All other terms trademarks or

servicemarksmentioned in this document have been capitalized and are to be considered the

property of their respective owners



Revision History

Date Document Version Description of ModificationsRelease

01262020 112 Document published for adding Upgrading

CustomMetrics Component

10182019 111 Document published for adding Upgrade from

Kony Fabric 82

09262019 110 Document published for adding Prerequisites for

Upgrade fromMobileFabric 7x to Kony Fabric

8x

08052019 19 Document published after modifying the -DKMS_

CORE_VERSION for JBoss WebLogic and

WebSphere

06242019 18 Document published after modifying Application

Servers Pre-installation Tasks for JBoss

WebLogic andWebSphere

06202019 17 Document published after modifying Corporate

Firewall Settings - Engagement Services

04182019 16 Document published for V8 SP4 FP1HF1

02272019 15 Document published for V8 SP4 FP1

09242018 14 Document published for V8 SP3



09192017 10 Document published for V8GA





Table of Contents

1 Preface 9

11 Purpose 10

12 Intended Audience 10

13 Formatting ConventionsUsed in ThisGuide 11

14 Related Documents 12

15 Contact Us 12

2 Prerequisites 13

21 Software Requirements 13

22 Hardware Requirements 13

23 Network Settings 14

24 Creating the Installation User for Linux 20

25 Database Prerequisites 21

26 Application Servers Prerequisites 30

3 Kony Fabric Topology and Components 43

31 Developer Environment 48

32 Production Environment 49

4 Kony Fabric Installation on Single Node and Multinode 50

5 Pre-Installation Tasks 51

51 Download Kony Fabric Installer 51

52 Steps before installing (or) upgrading Kony Fabric with the existing database 51



53 Create tmp Folder 52

54 Install Memcached Server 52

55 libevent (memcached dependency) 52

56 Memcached Server 53

57 Configure Load Balancers for Sending Host Information inMultinode 54

58 Download and Install the Unrestricted JCE Policy Files 56

59 Database Pre-installation Tasks 58

510 Application Servers Pre-Installation Tasks 61

6 Installation Modes - Kony Fabric 70

61 Installing Kony Fabric - Console-mode (for command-line-driven installations) 71

62 Installing Kony Fabric - Silent-mode 360

7 Installing Kony Fabric on IBM AIX 362

71 Prerequisites 362

72 Download Kony Fabric installers for AIX platform 362

73 Installing Kony Fabric on IBMAIX 363

74 Post Installation 363

75 Upgrading Kony Fabric 364

8 How to Stop and Start Kony Fabric 366

81 Tomcat Server 366

82 JBoss Server 366

83 WebLogic Server 366



84 WebSphere Server 367


91 Prerequisites for Upgrade fromMobileFabric 7x to Kony Fabric 8x 368

92 Upgrading Kony Fabric using V8 370

93 Upgrading Kony Fabric to V8 SP4 380

94 Upgrade fromKony Fabric V8 SP2 to V8 SP4 391

95 Upgrading CustomMetrics Component 391

10 Installing Hotfix Archives for Kony Fabric - Linux 393

101 Patch Installer GA Versions 393


11 Uninstalling Kony Fabric 401

12 Post-Installation Tasks 405

121 Configuring Secure Sockets Layer (SSL) Certificate 405

122 JDK Version Compatibility 407

123 How to ConfigureMemcached for Integration Services 408

124 Configure Deployment of mbaasportalwar File for Multi-Node 410

125 Remote Installation Pre-requisites 410

126 How to Turn off the Send usage data anonymously feature 411

127 Configuring Datasource for performance improvements for JBoss pre-existing and

DomainMode 412

128 Health CheckURL 413



129 Steps to enable SAPJCo 413

13 FAQs and Troubleshooting 418

131 HostnamePort changes for Tomcat Application Server 439

132 HostnamePort changes for JBoss Application Server 439

133 How to Configure JBossCluster 440

134 How to Configure a Custom JAR File onWebLogic 440

135 How to Configure Heap and PermGen Size 441

136 How to Configure Kony Fabric Behind a Reverse Proxy 442

137 Preserving Proxy if Load Balancer or Proxy Server is Configured 444

138 How to Configure Frontend HTTPS to Tomcat HTTP Redirection 445

139 WebSphere FAQs 445

1310 How to Change Log Levels 445

1311 Context Root-path 447


1 Preface Kony Fabric Installation Guide - LinuxVersion111

1 Preface

Kony Fabric is aMobile Back-end as a Service (MBaaS) provider that helps developers build native

and web apps for mobile Kony Fabric allows you to define the back-end to build nativemobile apps for

iOS Android and HTML5-based apps for modern browsers Kony Fabric ensures that developers

build mobile applications quickly by focusing on core areas and obtaining secured back-end services

instantly Kony Fabric hasmultiple features that can be used - Identity Integration Objects

Orchestration and Engagement Services These features can be accessed through a common

centralized console

For successful authentication with users and to access centralized features of Kony Fabric Kony

recommends that you install the following Kony Fabric features on premises

l Kony Fabric Identity and Console

l API Developer Portal

l Kony Fabric Integration

l Kony Fabric Engagement Services

Kony Fabric supports the following back-end services for your applications

l Identity This feature allows you to define the type of authentication used for granting access to

your application Kony Fabric supports the following authentication services

o Enterprise Identity Microsoft Active Directory Open LDAP Salesforce Security

AssertionMarkup Language (SAML) Kony SAP Gateway OAuth 20 Okta Custom

andOAuth Provider

o Social Identity Google Instagram Microsoft BOX Facebook LinkedIn Amazon and

Yahoo

l API Developer Portal This feature allows you create a Portal for exposing APIs created using

Kony Fabric Developers from internal and external partner teams can access the portal created

to explore and test the APIs



l Integration This feature allows you to define various back-end services for your application

You can define the following integration services

o Technology Adapters XML SOAP JSON Java JavaScript and APIProxy

o Business Adapters Kony SAP Gateway MuleSoft AWSAPIGateway Relational

Database MongoDB RAML OpenAPI (Swagger) Salesforce and IBMMQ

l Orchestration Service orchestration is the coordination or integration of several services and

exposing them as a single service This feature allows you to create two types of orchestration

services They are

o Composite Allows you to run two or more services concurrently or sequentially

o Looping Allows you to run a single service in a loop until the loop ends or an exit criteria is

met

l Objects Allows you to create appmodels for LOB objects storage objects and Service-Driven

Objects

l Offline sync This feature allows you to define the synchronization services for your application

Sync supports onlyWeb Services except SAP Sky

l Logic The logic services feature in Kony Fabric helps you import and integrate Nodejs services

(APIs) directly into Kony Fabric for developing server-side and networking applications

l Engagement This feature allows you to send push notifications email SMS and passes to

subscribed applications

11 Purpose

This document helps you install and configure Kony Fabric using the installer on Linux

12 Intended Audience

This document is intended for engineers or developers who are responsible for installing and

configuring Kony Fabric We assume that the reader of this document is familiar with installing

applications in a Linux environment



13 Formatting Conventions Used in This Guide

The following formatting conventions are used throughout the document

Convention Explanation

Monospace l User input text system prompts and responses

l File path

l Commands

l Program code

l File names

Italic l Emphasis

l Names of books and documents

l New terminology

Bold l Windows

l Menus

l Buttons

l Icons

l Fields

l 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 Fabric User

Guide

This guide helps you understand how to create a Kony Fabric 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 supportkonycom


2 Prerequisites Kony Fabric Installation Guide - LinuxVersion111

2 Prerequisites

The following sections provide information about the software and hardware required to install Kony

Fabric Console

21 Software Requirements

For software system requirements click here

22 Hardware Requirements

Component Requirement

Processor Quad-core processor

Memory 16GB

Internal Storage 150GB

Network 100Mbps Ethernet interface card



23 Network Settings

231 Corporate Firewall Settings - Engagement Services

Source Destination Ports

Protocol

Direction

Action

Description

Engageme

nt Server

httpsapipushapplecom4433devi

ce

443 TCP Both Allow Allow the

Engageme

nt Server

to access

Apple

APNS

HTTP2

production

URL

Engageme

nt Server

httpsapijpushcnv3push 443 TCP Outboun

d

Allow Allow the

Engageme

nt Server

to access

the JPush

notification

server

URL

Engageme

nt Server

httpsapidevelopmentpushappleco

m4433device


Engageme

nt Server

to access

Apple

APNS

HTTP2

developme

nt URL




Protocol

Direction

Action

Description

Engage

ment

Server

httpsfcmgoogleapiscom 44

3

TCP Outb

ound

All

o

w

Allow

the

Engage

ment

Server

to

access

Firebas

e Cloud

Messa

ging

(FCM)

service

Engage

ment

Server

feedbackpushapplecom

feedbacksandboxpushappleco

m 170008 (17001 to

17255255254)

21

96

TCP Outb

ound

All

o

w

Allow

the

Engage

ment

Server

to

access

APNS

feedba

ck

service




Protocol

Direction

Action

Description

Engage

ment

Server

gatewaypushapplecom

gatewaysandboxpushapplecom

170008 (17001 to

17255255254)

21

95

TCP Outb

ound

All

o

w

Allow

the

Engage

ment

Server

to

access

Apples

APNS

Engage

ment

Server

All subdomains of

pushapievalblackberrycom

Sample Push URL

httpscpxxxxxxxxxxxxxxxxxxxxx

x pushapievalblackberryco

mmssPD_pushRequest

44

3

TCP Outb

ound

All

o

w

Allow

connec

t to

Blackb

erry

Cloud

through

this

port

Engage

ment

Server

httpsn1notifylivenet 44

3

TCP Outb

ound

All

o

w

Allow

connec

t to

Windo

ws

Cloud

(MPN

S)

through

this

port




Protocol

Direction

Action

Description

Engage

ment

Server

httpsloginlivecom 44

3

TCP Outb

ound

All

o

w

Allow

connec

t to

Windo

ws

Cloud

(WNS)

through

this

port

Internal

Corpor

ate

WiFi

router

for

Android

Mobile

Device

s

Allow your firewall to accept

outgoing connections to all IP

addresses contained in the IP

blocks listed in Googles ASN of

15169 Reference link for the IP

Addresses

httpbgphenetAS15169

52

2

8

52

2

9

52

30

TC

P

HTT

P

HTT

PS

UD

P

Both All

o

w

Android

device

s will

connec

t to

GCM

through

this

port

Internal

Corpor

ate

WiFi

router

for iOS

Device

s

gatewaypushapplecom




m 170008 (17001 to

17255255254)

52

23

TCP Both All

o

w

Apple

device

s

connec

t to

APNS

servers

through

this

port




Protocol

Direction

Action

Description

Internal

Corpor

ate

WiFi

router

for iOS

Device

s

axinititunesapplecom

ocspapplecom

8

0

44

3

TCP Both All

o

w

Apple

device

s will

connec

t to

public

Apple

OCSP

and

iTunes

service

through

this

port

Internal

Corpor

ate

WiFi

router

for

Windo

w

Device

s

Add the list IPs specified in the

followingWNS URL

httpwwwmicrosoftcomen-

usdownloaddetailsaspxid=4423

8

TC

P

HTT

P

HTT

PS

UD

P

Both All

o

w

Windo

ws

device

s will

connec

t to

WNS

through

this

port




Protocol

Direction

Action

Description

Internal

Corpor

ate

WiFi

router

for

Windo

w

Device

s


followingMPNS URL

httpswwwmicrosoftcomen-


5

TC

P

HTT

P

HTT

PS

UD

P

Both All

o

w

Windo

ws

device

s will

connec

t to

MPNS

through

this

port

232 Proxy Settings for Integration Service

To add an Integration Service Environment when the proxy is set at an App Server level enable the

following proxy settings at the JVM level

l DkonyhttpproxyHost= 100429

l DkonyhttpproxyPort= 2080

l DkonyhttpproxyUser= websphere

l DkonyhttpproxyPassword= 3MqGU9e5nv3B

233 Network Settings - Licensing

The on-premises server should allow outbound requests to httpsmanagekonycom and allow

inbound requests from our License servers (IPs mentioned at the end can be whitelisted in a

customerrsquos firewall)



An on-premises Fabric development or non-production license can be activated without making the

on-premises Identity URL available to our License servers However a production license requires

the Identity URL to be available to our License servers at the time of activation and thereafter as the

license is validated on a weekly frequency Each time that a production license is validated the license

validity is good for 30 days from the last successful validation The Identity URL is expected to remain

available to our License server for the entirety of their licensing term

The Fabric Identity account tenant must be accessible on the internet The Cloud license activation

screen displays the Identity tenant configured in on-premise console (For example

httpskonyfabricmycompanycomauthService)

Cloud license activation flow appends ldquoaccountsrdquo to the Identity URL (For example

httpskonymobilefabricmycompanycomauthServiceaccounts) The URLmust be accessible on the

public internet for license activation to work The response of the URL should be ldquoWelcome to Test

Auth Servicerdquo

Communication fromKonys License servers will originate from the following IP addresses which can

be whitelisted in an organizations firewall configuration

l 5420819284

l 54208192248

24 Creating the Installation User for Linux

To create a user follow these steps

1 From your Kony Fabric install system open Linux terminal

Note For security and administrative reasons install and run Kony Fabric Installer as a

non-root user



2 Run the following commands

adduser core

passwd core

25 Database Prerequisites

Before you install Kony Fabric Console Installer youmust perform the following pre-installation tasks

l Ensure access to a database server

l A database user should be granted all required permissions as per this document

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

use

l To install in domain (multi-node) mode the JBoss cluster should be preconfigured

251 Prerequisites for Kony Fabric with Oracle

For installing Kony Fabric 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 the Kony Fabric database deployment Oracle software

must be installed and basic databasemust be created before to continue with Kony Fabric

database schema setup

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

of database A dedicated user gets logged into audit logs

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

privileges loaded to the user

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



needed for Kony Fabric with a Unicode character set with the properties for Database character set as

AL32UTF8 and National character set as AL16UTF16

l Create the following three tablespaces These tablespaces will be used to create Kony Fabric database

objects

o Tables and data tablespace MF_DATA

o Index tablespace MF_INDEX

o Lob tablespace MF_LOB_DATA

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

Replace the ltDATA_FILE_PATHgt with actual data file path on the Oracle database server

CREATE TABLESPACE MF_DATA DATAFILE ltDATA_FILE_PATHgtMF_DATA_01DBF

SIZE 2048M AUTOEXTEND ON NEXT 100M MAXSIZE 5120M

CREATE TABLESPACE MF_INDEX DATAFILE ltDATA_FILE_PATHgtMF_INDEX_01DBF


CREATE TABLESPACE MF_LOB_DATA DATAFILE ltDATA_FILE_PATHgtMF_LOB_DATA_

01DBF SIZE 2048M AUTOEXTEND ON NEXT 100M MAXSIZE 5120M

l Create a dedicated database user with default tablespaces (MF_DATA) and grant quota to two other

tablespaces (MF_INDEX andMF_LOB_DATA tablespaces)

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

CREATE USER ltinstall-usergt IDENTIFIED BY ltpasswordgt DEFAULT

TABLESPACE MF_DATA TEMPORARY TABLESPACE TEM PROFILE DEFAULT

GRANT DBA TO ltinstall-usergt

ALTER USER ltinstall-usergt QUOTA UNLIMITED ON MF_DATA

ALTER USER ltinstall-usergt QUOTA UNLIMITED ON MF_INDEX

ALTER USER ltinstall-usergt QUOTA UNLIMITED ON MF_LOB_DATA

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 IDENTIFIED BY

ltpasswordgt DEFAULT TABLESPACE MF_DATA TEMPORARY TABLESPACE TEMP

PROFILE DEFAULT CONTAINER=CURRENT

GRANT DBA TO ltinstall-local-usergt CONTAINER=CURRENT

ALTER USER ltinstall-local-usergt QUOTA UNLIMITED ON MF_DATA

CONTAINER=CURRENT

ALTER USER ltinstall-local-usergt QUOTA UNLIMITED ON MF_INDEX

CONTAINER=CURRENT

ALTER USER ltinstall-local-usergt QUOTA UNLIMITED ON MF_LOB_DATA

CONTAINER=CURRENT

l If you are using Kony Fabric installer to setup Kony Fabric 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

252 Prerequisites for Kony Fabric with DB2

Note FromV8 SP4 FP1HF1 onwards DB2 is not supported for bundled Tomcat and JBoss

servers



Important Download the following DB2 JARs from IBM download site

- IBMDB2 Type 4 Driver (db2jcc4jar)

- DB2 JDBC Driver licence (db2jcc_license_cujar)

The version of the downloaded JARs should be compatible with your installed DB2Database

version

For IBMDB2 while creating database choose 32k page size as default tablespace Because after a

database with page size as default tablespace is created you will not be able tomodify the page size

of the default tablespace Additionally you need to create three tablespaces one for tables and data

one for index and the other tablespace for Large objects (LOBs) For creating tablespace the details

are provided int he below sections

Create the Big tablespace with big bufferpool of 32K page size Only DB2 database administrator (DBA) or

equivalent DB user will have access to create database with default tablespace with particular

pagesizebufferpool In DB2 whenever Binary LargeObject (BLOB) and Character LargeObject (CLOB) are

used you need to have the database created with default tablespace as well as default temp tablespace with

big pagesize of 32k

-- Replace ltDatabase_namegt with your actual database name

CONNECT TO ltDatabase_namegt

CREATE BUFFERPOOL BIGBUFFERPOOL IMMEDIATE ALL DBPARTITIONNUMS

SIZE AUTOMATIC NUMBLOCKPAGES 100 BLOCKSIZE 100 PAGESIZE 32K

COMMIT

-- To create a tablespace for tables and Data

CREATE LARGE TABLESPACE ltData_Tablespace_Namegt IN DATABASE PARTITION GROUP

IBMDEFAULTGROUP

PAGESIZE 32K MANAGED BY AUTOMATIC STORAGE EXTENTSIZE 32 PREFETCHSIZE

AUTOMATIC

BUFFERPOOL BIGBUFFERPOOL OVERHEAD 75 TRANSFERRATE 006 AUTORESIZE YES

INITIALSIZE 32M NO FILE SYSTEM CACHING

COMMIT



-- To create an index tablespace

CREATE LARGE TABLESPACE ltIndex_Tablespace_Namegt IN DATABASE PARTITION GROUP

IBMDEFAULTGROUP


AUTOMATIC



COMMIT

-- To create a LOB tablespace

CREATE LARGE TABLESPACE ltLOB_Tablespace_Namegt IN DATABASE PARTITION GROUP

IBMDEFAULTGROUP


AUTOMATIC



COMMIT

CREATE SYSTEM TEMPORARY TABLESPACE BIGTEMP IN DATABASE PARTITION GROUP

IBMTEMPGROUP

PAGESIZE 32K MANAGED BY AUTOMATIC STORAGE USING STOGROUP IBMSTOGROUP

EXTENTSIZE 1M

PREFETCHSIZE AUTOMATIC BUFFERPOOL BIGBUFFERPOOL

COMMIT

CONNECT RESET

Note If Kony Fabric installation with DB2 fails youmust verify the following settings

db2set DB2_COMPATIBILITY_VECTOR=ORA

db2set DB2_DEFERRED_PREPARE_SEMANTICS=YES



253 Prerequisites for Kony Fabric with SQL Server

l Database User security role Create a database login dbclient using SQL server

authenticationwith server roles as sysadmin and public

l Database and schema access Installer will make use of the above login to create necessary

databases and schemas required for the selected Kony Fabric components

l Database Growth sizing Refer to Kony Fabric Deployment Guide gt DatabaseGrowth Sizing

l Database Transaction log size Allocate sufficient space for the Transaction log file based on

all the transactions activity of all the Kony Fabric components installed and as per your database

backup policy Because transaction log sizing is linked to database backup If additional

application loggingevents are enabled inmultiple components of Kony Fabric then youmay

need to consider additional size for the transaction log

l Temp Database and temp log This is based on usage of all the databases on the server

instance by all applications connecting to these databases In case of Kony Fabric for sizing of

the temp database consider auto growth with increment size should be of 100MB andwith

maximum size to 10GB But if application loggingevents are enabled inmultiple components of

Kony Fabric then themaximum size should be increased upto 20GB This size will get

reclaimed as and when the DB is restarted

l Database versions You can use SQL Server Standard Edition or SQL Server Enterprise

Edition database for installing Kony Fabric Kony Fabric is compatible with these editions

There are no prerequisites specific to these editions as Kony Fabric uses features common to

both editions

l Backup plan Youmust use your organizations defined backup and retention policies for

Backup strategies for your database



254 Prerequisites for Kony Fabric with MSSQL - Applicable for Engagement Services

Database collation needs to be set for a database This is possible while creating a database with your

required language as database collation For example use Database collation as Arabic_100_CI_AS

for Arabic language support Similarly for other languages use appropriate collation for support Use

SQL Server Management Studio to create a database with the name as kpnsdb and with appropriate

collation support

255 Prerequisites for Kony Fabric with MySQL

256 Applicable for Engagement Services

1 Create the database needed for Engagement Serviceswith unicode character set as UTF8

Also ensure that youmodify the mycnf or myini with the following parameters

[client]

default-character-set = utf8

[mysql]


[mysqld]|

character-set-client-handshake = FALSE

collation_server=utf8_unicode_ci

character_set_server=utf8

2 Next restart theMySQL service and run the following query to verify the details

mysqlgt show variables like coll

+----------------------+-----------------+

| Variable_name | Value |

+----------------------+-----------------+

| collation_connection | utf8_unicode_ci |

| collation_database | utf8_unicode_ci |

| collation_server | utf8_unicode_ci |

+----------------------+-----------------+

3 rows in set (000 sec)



mysqlgt show variables like char

+--------------------------+----------------------------+


+--------------------------+----------------------------+

| character_set_client | utf8 |

| character_set_connection | utf8 |

| character_set_database | utf8 |

| character_set_filesystem | binary |

| character_set_results | utf8 |

| character_set_server | utf8 |

| character_set_system | utf8 |

| character_sets_dir | usrsharemysqlcharsets |

+--------------------------+----------------------------+

2561 Applicable for Identity Services

If you are using any lower versions of MySQL 57 such as v5712 or lower during installation youmay

encounter an error due to which the installation rolls back This error occurs due to a bug in theMySQL

database

For more information refer MySQLBugs

Following are the error details

l Error Migration V810_27_01__

DeleteDuplicateAcsUserIdProviderGuidRowsAddUniqueConstraintsql failed

l SQL State HY000

l Error Code 1093

l Error Message You cant specify target table users for update in FROMclause

l Location ltLocation where the installation is donegt

To resolve this error run the following commands in theMySQLServer



1 Execute the following command before running the installer

SET GLOBAL optimizer_switch = derived_merge=off

2 Once the installation is done set derived_mergeON using the following command

SET GLOBAL optimizer_switch = derived_merge=on

257 Steps before installing (or) upgrading Kony Fabric with the existing database

Perform the following activities before installing (or) upgrading Kony Fabric with the existing database

l Take database backup

l Make sure you have previously installed directory

l Take a backup of applications deployed at the server level (Post installation take backup of the

changes done to the binaries)

l Post installation (or) upgrade process replace old authServicekey workspaceServicekey and

ACCOUNTS_ENCRYPTION_KEY (applicable only for identity and workspace components)

258 Create tmp Folder

Kony Fabric Installer required a tmp folder in Linux environment to unpack installer When the tmp

folder is not found the Installer shows IO exception at the time of unpack exception shown below

This must specify in the pre-req of installation Installation must

required temp folder to unpack MF installer (either default custom

temp folder)



26 Application Servers Prerequisites

261 Tomcat Prerequisites

2611 How to Disable Weak Ciphers

To disable weak ciphers modify the SSLConnector container attribute inside the serverxml with

the required https connector tag details The serverxml is located in the ltInstall_

Drivegttomcatconf folder

Add the following is a sample details to SSL connector tag

SSLEnabled=true sslEnabledProtocols=TLSv12 ciphers=TLS_ECDHE_

RSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHATLS_

ECDHE_RSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_256_CBC_

SHATLS_ECDHE_RSA_WITH_RC4_128_SHA TLS_RSA_WITH_AES_128_CBC_

SHA256TLS_RSA_WITH_AES_128_CBC_SHATLS_RSA_WITH_AES_256_CBC_SHA256

TLS_RSA_WITH_AES_256_CBC_SHASSL_RSA_WITH_RC4_128_SHA

For example the following is a samplemodified https connector tag

ltconnector port=443 maxhttpheadersize=8192 address=127001

enablelookups=false disableuploadtimeout=true acceptCount=100

scheme=https secure=true clientAuth=false SSLEnabled=true

sslEnabledProtocols=TLSv12 ciphers=TLS_ECDHE_RSA_WITH_AES_128_

CBC_SHA256 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHATLS_ECDHE_RSA_WITH_

AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_256_CBC_SHATLS_ECDHE_

RSA_WITH_RC4_128_SHA TLS_RSA_WITH_AES_128_CBC_SHA256TLS_RSA_WITH_

AES_128_CBC_SHATLS_RSA_WITH_AES_256_CBC_SHA256 TLS_RSA_WITH_AES_

256_CBC_SHASSL_RSA_WITH_RC4_128_SHA keystoreFile=mydomainkey

keystorePass=password truststoreFile=mytruststoretruststore

truststorePass=passwordgt

Note Upgrade the SSLCipher list to the latest available versions



2612 Heap and PermGen Settings

For Oracle Java 7 and Java 8 configure the heap settings for your application servers In case of

Oracle Java 7 you also need to configure PermGen settings Tomcat heap and PermGen settings

Note FromV8 SP4 FP1HF1 onwards Java 11 is supported for bundled Tomcat and JBoss

servers

262 JBoss Prerequisites



Oracle Java 7 you also need to configure PermGen settings JBoss heap and PermGen settings


servers

2622 Configuration of Database Driver Module

1 Extract the comzip file

The unzipped folder structure will be commysqlmain

2 Stop the JBoss Application Server

3 For JBoss configured in the standalonemode copy the extracted comzip folder and place it

in the JBOSS_HOMEmodules path For the domainmode place the unzipped comzip

folder (commysqlmain) in the JBOSS_HOMEmodules path for each of the

masterslavemachines

4 Open and edit the appropriate configuration file based on the configured JBossmode



For example domainxml in the domainmode and standalone-fullxml in the

standalonemode These files are available at JBOSS_HOMEdomainconfiguration

and JBOSS_HOMEstandaloneconfiguration folders respectively

5 Search for the ltsubsystem xmlns=urnjbossdomainee40gt tag and add the

appropriate globalmodule based on the database selected

For example add the following code for the domainmode

ltglobal-modulesgt

ltmodule name=commysql slot=maingt

ltglobal-modulesgt

6 Save the changes

7 Start the JBoss Server

2623 Configure the Standalone Existing JBoss

To install Kony Fabric on an existing standalone JBoss follow the steps to configure the standalone

JBoss

1 Open the standalonexml from the ltJBoss_Homegtstandaloneconfiguration

2 Configure HostnameIP in the standalonexml file for JBoss as below

ltinterfacesgt

ltinterface name=managementgt

ltinet-address value=127001gt

ltinterfacegt

ltinterface name=publicgt

ltinet-address value=ltmyHostNamegtgt

ltinterfacegt

ltinterfacesgt



3 Configure JBoss to listen for remotemanagement requests as below

l Add ltsocket-binding name=management-native

interface=management

port=$jbossmanagementnativeport9999gt under the ltsocket-binding-groupgt

l Add following section under the ltmanagement-interfacesgt

ltnative-interface security-realm=ManagementRealmgt

ltsocket-binding native=management-nativegt

ltnative-interfacegt

4 For Engagement Services to work remove the following subsystem

ltsubsystem xmlns=urnjbossdomainjpa11gt

ltjpa default-datasource= default-extended-persistence-

inheritance=DEEPgt|

ltsubsystemgt

5 In case of installing all the Kony Fabric components follow these steps to increase heap size by

setting the JAVA_OPTS in the ltJBOSS_DIRgtstandalonebinstandaloneshbat

l standalonebat

set JAVA_OPTS= -server -Xms2048m -Xmx2048m

l standalonesh

JAVA_OPTS=-server -Xms1024M -Xmx1024M

2624 Configure the Standalone Existing JBoss with Self-Signed Certificate (JBoss 71)

If you need to use existing JBosswith self-signed certificate follow these steps



1 Add an Existing SSLCertificate to Cacerts For more details click How to Add an Existing

Secure Sockets Layer (SSL) Certificate

2 Copy the keystore file to ltJBoss_Homegtstandaloneconfiguration folder

3 Modify the standalonexml by adding the following security-realm in the security-

realms section

ltsecurity-realm name=WebSocketRealmgt

ltserver-identitiesgt

ltsslgt

ltkeystore path=ltKeystore_file_

namegt relative-to=jbossserverconfigdir keystore

password=ltKeystore_passwordgtgt

ltsslgt


ltsecurity-realmgt

Here ltKeystore_file_namegt = Name of the keystore file (for example keystorejks)

ltKeystore_passwordgt = Password of keystore file

4 In the standalonexml add the following https-listener tag for default-server in the

Subsystem urnjbossdomainundertow31

lthttps-listener name=https max-post-size=262144000 security-

realm=WebSocketRealm socket-binding=httpsgt

2625 Configure Port Settings for Multinode Loadbalancer Setups

Before installing Kony Fabric on an application server for the application server to communicate with a

Web Server properly youmust open the port 80



How to Disable Weak Ciphers in JBoss

To disable weak ciphers replace the https-listener under JBoss subsystemundertow for

example ltsubsystem xmlns=urnjbossdomainundertow31gt

For example the following is a sample for https connector tag

lthttps-listener name=https socket-binding=connect security-realm-

m=ApplicationRealm verify-client=REQUIREDgt


lthttps-listener name=https enabled-pro-

tocols=TLSv1TLSv11TLSv12 enabled-cipher-suites=SSL_RSA_WITH_

3DES_EDE_CBC_SHASSL_DHE_RSA_WITH_3DES_EDE_CBC_SHA TLS_RSA_WITH_

AES_128_CBC_SHATLS_DHE_DSS_WITH_AES_128_CBC_SHA TLS_DHE_RSA_WITH_

AES_128_CBC_SHATLS_RSA_WITH_AES_256_CBC_SHA TLS_DHE_DSS_WITH_AES_

256_CBC_SHATLS_DHE_RSA_WITH_AES_256_CBC_SHA TLS_ECDH_ECDSA_WITH_

3DES_EDE_CBC_SHATLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA TLS_ECDH_

ECDSA_WITH_AES_256_CBC_SHATLS_ECDHE_ECDSA_WITH_3DES_EDE_CBC_SHA

TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHATLS_ECDHE_ECDSA_WITH_AES_256_

CBC_SHA TLS_ECDH_RSA_WITH_3DES_EDE_CBC_SHATLS_ECDH_RSA_WITH_AES_

128_CBC_SHA TLS_ECDH_RSA_WITH_AES_256_CBC_SHATLS_ECDHE_RSA_WITH_

3DES_EDE_CBC_SHA TLS_ECDHE_RSA_WITH_AES_128_CBC_SHATLS_ECDHE_RSA_

WITH_AES_256_CBC_SHA TLS_ECDH_anon_WITH_3DES_EDE_CBC_SHATLS_ECDH_

anon_WITH_AES_128_CBC_SHA TLS_ECDH_anon_WITH_AES_256_CBC_SHA

verify-client=REQUIRED security-realm=ApplicationRealm socket-

binding=connectgt



263 WebLogic Prerequisites



Oracle Java 7 you also need to configure PermGen settings WebLogic heap and PermGen settings

2632 Security Configurations

To add environments to Kony Fabric Console add the following configuration inside the security-

configuration tag of the configxml file of WebLogic Server

ltenforce-valid-basic-auth-credentialsgtfalseltenforce-valid-basic-auth-

credentialsgt

After configuring the security-configuration tag restart the server fromWebLogic console In

case ofWebLogic cluster restart all servers fromWebLogic console

264 WebSphere Prerequisites



Oracle Java 7 you also need to configure PermGen settings WebSphere heap settings

2642 How to Enable TLS v12 Protocol

If your Kony Fabric instance onWebSphere that is updated with IBM Java 7 SDK fix pack 70960 the

identity fails to log-in to Salesforce Because the TLSv10 protocol is disabled on Kony Fabric and on

the other external sites that Kony Fabric wants to connect - for example Salesforce To avoid log-in

issueswith external back-ends add the -D parameters into JVMArguments

To add -D parameters in the JVM arguments follow these steps

1 Log intoWebSphere Admin Console

2 Go to Application servers gt server1 gt Process definition gt Java Virtual Machine



3 Under the Configuration gt General Properties gt Generic JVM arguments add the following -

D parameter

-Dhttpsprotocols=TLSv11TLSv12 -Dcomibmjsse2overrideDefaultTLS=true

4 Go to Security gt SSL certificate and key management gt SSL configurations gt

NodeDefaultSSLSettings gt Quality of protection (QoP) settings

5 Under General Properties gt Protocol select the TLSv11 protocol

6 If your Kony Fabric is installed onWebSphere with IBM Java 8 add the following parameter to

JVM arguments

-Dcomibmjsse2overrideDefaultTLS=true

For more details refer to Salesforce disabling TLS 10



2643 How to Retrieve Server Groups in WebSphere when using Admin Security with TLSv12

1 InWebSphere Admin Console download the default SSL certificate

2 Import certificate into IBM Java path IBM_PATHJAVAjrelibsecuritycacerts

For example optIBMWebSphereAppServerjava_18_64jrelibsecuritykeytool -importcert -keystore cacerts -

storetype jks -file optIBMWebSphereAppServerjava_18_

64jrelibsecurity17229154223crt -alias 17229154223

3 If you are prompted for a password enter the password

l Default password changeit



4 Select the Enable administrative security check box

5 Set the following JVM arguments

l Set JVM heap size

l Set JVM generic arguments



6 Restart the application server after setting JVMarguments

7 Execute the installer with LAX_VM

For example KonyMobileFabricInstallerbin LAX_VM

optIBMWebSphereAppServerjava_18_64binjava

8 Provide the default path of certs in the installation wizard For example

optIBMWebSphereAppServerprofilesAppSrv01etc



2644 Updating the SSL Socket Factory Providers

l See that the SOAP_CONNECTOR_PORT is open

l If theWAS server is secured set the following in javajrelibsecurityjavasecurity

l sslSocketFactoryprovider=comibmjsse2SSLSocketFactoryImpl

(for Java7)

l sslServerSocketFactoryprovider=comibmjsse2SSLServerSocke

tFactoryImpl (for Java8)

Refer Configure SSL for WebSphere

2645 NGINX Load Balancer Configuration

l Following are the URLmappings for the Load Balancer configuration

l httpsltdomaingtmfconsole -gt httpsltServer iphostportgtmfconsole

l httpsltdomaingtaccounts -gt httpsltServer iphostportgtaccounts

l httpsltdomaingtworkspace -gt httpsltServer iphostportgtworkspace

l httpsltdomaingtauthService -gt httpsltServer iphostportgtauthService

l httpsltdomaingtadmin -gt httpsltServer iphostportgtadmin

l httpsltdomaingtservices -gt httpsltServer iphostportgtservices

l httpsltdomaingtmiddleware -gt httpsltServer iphostportgtmiddleware

l httpsltdomaingtapps -gt httpsltServer iphostportgtapps

l httpsltdomaingtmetrics -gt httpsltServer iphostportgtmetrics

l httpsltdomaingtkpns -gt httpsltServer iphostportgtkpns

l Visualizer runs on localhost 5000 by default Hence it must be allowed Also allow 8888 if you



want to test web applications locally Set the following HTTP response header X-Frame options

to allow the required localhost

l add_header X-Frame-Options ALLOW-FROM localhost5000



3 Kony Fabric Topology and Components Kony Fabric Installation Guide - LinuxVersion111

3 Kony Fabric Topology and Components

Kony Fabric 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 the Kony Fabric architecture and components follows



An overview of the Kony Fabric deployment architecture follows

The following table describes the components of Kony Fabric



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 and engagement services) 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

API Developer

Portal

Kony Fabric Developer Portal feature lets you create a Portal for exposing

APIs created using Kony Fabric Developers from internal and external

partner teams can access the portal created to explore and test the APIs

You can directly access your Kony Developer Portal in Kony Fabric Console




Environments

(Engagement

Services

Integration

Services)

This component adds runtime capabilities to apps such as engagement

services and integration services

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

test the services shown as well 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_

fabric_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 when Kony Fabric is integrated It has same

runtime capabilities as themiddleware

Note To use Kony Sever with Kony Fabric integrated you can ignore

themiddlewarewar Similarly when you use only standalone Kony

Server you can ignore the serviceswar



Note The Kony Fabric 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 Kony Fabric Console Identity Services Integration Services and Engagement Services

on separate nodes

For frequently asked questions and troubleshooting refer to FAQs and Troubleshooting

31 Developer Environment

For development environment a developer can preferably install Kony Fabric components in a

standalonemode (single node) on a local environment For more details refer to Single Node

Installation

Important Kony Fabric Installer supports Tomcat JBossWebLogic andWebSphere

Tomcat on single-node only For multi-node installation on Tomcat refer to Kony FabricManual

Install Guide

Kony Fabric Consolidated installer supports JBoss on single node (Standalone Mode) andmulti-

node (Domain Mode)

Important By default Kony Fabric Consolidated installer supportsmemcached server only in case

of multinode installation

By default Kony Fabric Consolidated installer is not enabled with memcached server for single

node installation (Tomcat and JBoss) If you want usememcached server follow manual steps

provided at How to Install Memcached Server



32 Production Environment

For production environment domainmode (multinode) installation with HTTPs protocol is preferred

Multinode installation helps to enable better performance high availability and load balancing For

more details refer to Multinode Installation


4 Kony Fabric Installation on Single Node and

Multinode

Kony Fabric Installation Guide -

LinuxVersion111

4 Kony Fabric Installation on Single Node and Multinode

You can install Kony Fabric in a domainmode (multinode) or a standalonemode (single node) on a

local environment

The following table details Kony Fabric installation supported for a single node andmultinode

installations

Kony Fabric Components can be installed Single Node Multinode

Console

l Workspace

l Accounts

Identity

Integration

l Admin

l Middleware

l Services

l Metrics

API Developer Portal

Engagement Services


5 Pre-Installation Tasks Kony Fabric Installation Guide - LinuxVersion111

5 Pre-Installation Tasks

51 Download Kony Fabric Installer

l Download KonyFabricSetuptargz file from httpcommunitykonycomdownloads and

extract the file To download Kony Fabric installer from the community portal follow these steps

1 Log in to httpcommunitykonycomdownloads You can obtain a user name and

password from your sales representative or partner

2 Click the Kony Fabric tab

3 Select the specific release version from the Kony Fabric Installer (Consolidated

Installer for all features) drop-down list and then click on the specific release related files

you want to download For example if you want to download Kony Fabric 800

GA installer select the 800 GA version from the drop-down list and then click

the Installer_Linux link

The KonyFabricSetuptargz file contains the following files

n KonyFabricInstaller-xxxx_GAbin

n installerproperties - This file is required for silent installation

n READMEtxt

52 Steps before installing (or) upgrading Kony Fabric with the existing

database















temp folder)

54 Install Memcached Server

Memcached is a high-performance distributedmemory object caching system generic in nature but

intended for use in speeding up dynamic web applications by alleviating database load

55 libevent (memcached dependency)

The libevent API provides amechanism to execute a callback function when a specific event

occurs on a file descriptor or after a timeout has been reached Furthermore libevent also support

callbacks due to signals or regular timeouts

libevent is meant to replace the event loop found in event driven network servers An application

just needs to call event_dispatch() and then add or remove events dynamically without having to

change the event loop Refer to httplibeventorg

To install libevent (memcached dependency) follow these steps

1 First checkwhether libevent is installed on your computer To check type the below

command in your Linux terminal



whereis libevent

2 If you do not find libevent on your system download and install it Download libevent-

148-stabletargz Refer to httplibeventorg

3 Extract the libevent-148-stable

4 In your Linux terminal type the below command

cd libevent-148-stable

configure

make

make install

5 Type the below command to create a symlink to libevent

ln -s usrlocalliblibevent-14so2 usrlib

Now that you have installed the dependencies install thememcahced server

56 Memcached Server

To install Memcached Server follow these steps

1 Download thememcached server

2 Extract the zip file

3 Open the Linux terminal

4 Go to memcache directory



5 Run the following command

tar xfz memcached-126targz

cd memcached-126

configure

make

make install

memcached -d -m 1024 -u root -l 127001 -p 11211

Important RunMemcached as a daemon (d = daemon m = memory u = user l = IP to

listen to p = port)

57 Configure Load Balancers for Sending Host Information in

Multinode

When user is installing Kony Fabric onmultinode environment the user should checkwhether the

parameter proxypreserveHost is set to On in the Loadbalancer configuration file to send host in

the headers

If the proxypreserveHost is not configured the loadbalancer will not send host in the headers Users

cannot launch Kony Fabric Console

The above configuration is based on the loadbalancer

For example

l For Apache preserveHost On

l For HAProxy preserve host flag is not required



571 Tuning File Descriptor Limits on Linux

To run the enterprise applications successfully on Linux distribution youmay have to update some of

the default kernel parameter settings

In Linux there is a limit to the number of file descriptors that a process can open The default is set to

1024 per process You can increase this limit for optimum performance

To increase the file descriptor limit follow these steps

Note Based on the user you create for your app server and database increase the file descriptor

limit for the user accordingly

For example In this procedure the created user isWebLogic for running theWebLogic server

You can follow these steps to increase the file descriptor limit based on your application server and

database such as Tomcat JBossWebLogic or WebSphere

1 Log on to Linux system and change toWebLogic user

2 Enter the following command

[weblogiclocalhost ~]$ ulimit -n

If the result is displayed as 32768 skip the following steps The limit is set for optimum

performance Else perform the steps to increase the limit

3 Increase the file descriptors limits

You can limit WebLogic user to specific limits by editing etcsecuritylimitsconf file

a Enter the following command to edit the file

vi etcsecuritylimitsconf



b SetWebLogic user soft and hard limits by adding the following lines

weblogic soft nofile 32768

weblogic hard nofile 32768

c Save and close the file Log out and log back in again

d Verify the changes by entering the following command


It should display 32768

4 Restart your App server

58 Download and Install the Unrestricted JCE Policy Files

In accordance with the United States of America export restrictions Java that is bundled with the

server has limited encryption key sizes that can be used in the server operation In order to

successfully convert signed client certificates or sign server Certificate Signing Request for use in the

server youmust download the following bundled encryption policy files and replace themwith the

unrestricted files published by the Java vendor

l local_policyjar

l US_export_policyjar

To Configure Unrestricted JCE Policy Files for WebSphere follow these steps

For WebSphere follow the steps provided in the link

httpswwwibmcomsupportknowledgecenterSS8JFY_

750comibmlmt75doccomibmlicensemgmtsecuritydoclmt_scr_downloading_installing_jce_

policyfileshtml

To Configure Unrestricted JCE Policy Files for Tomcat JBoss or WebLogic follow these steps



1 Go to the Oracle Java SE download

page httpwwworaclecomtechnetworkjavajavasedownloadsindexhtml

2 Scroll down to Additional Resources section You will find Java Cryptography Extension

(JCE) Unlimited Strength Jurisdiction Policy File

3 Download the JCE version that matches your installed JVM for example

UnlimitedJCEPolicyJDKltVersiongtzip

4 Extract the downloaded zip file The UnlimitedJCEPolicyJDKltVersiongtzip file

contains the following files

l local_policyjar


l READMEtxt

5 Copy the jar files (local_policyjar and US_export_policyjar) to ltjava-

homegtlibsecurity

Note These jars will be already there so you have to overwrite them Back up the existing

jars before you overwrite themwith new jars

6 Restart your application server

After the encryption policy files are installed you should be able to successfully convert signed

client certificates for use in the server

l Database Pre-Installation Tasks

l Application Servers Pre-Installation Tasks



59 Database Pre-installation Tasks

591 MySQL

5911 Increase innodb_log_file_size in mycnf file - MySQL

Note If the size of your application ismore than the variable size of server database an error

occurs Ensure the variable max_allowed_packet_size is set to a higher value than the

application size

To avoid this error increase the global variable in the server database

- Modify the SQL Statement to Set global max_allowed_packet=1010241024

In this statement the server database size is configured to 10-Megabytes(MB)

For example if your application size is 1024-kilobytes (1 MB) and you try to publish an application

fromKony Studio of 2048-Kilobytes(2MB) an error appears while publishing Increase the size of

server database to a valuemore than 2048-Kilobytes (2 MB) for publishing the application

For innodb_log_file_size the value is set to 48M by default

In the mycnf file increase the innodb_log_file_size = ltvalue should be greater than 10 of

max_allowed_packetgt

592 Oracle

5921 Create Locator Component for Oracle Database

By default when anOracle database is created using DBCA or Oracle Installer Enterprise Edition with

create database option the SDO_Geometry object type will be default created as part of locator

component

If the database is created using scripts by followingmanual process then the Locator component will

not be created You need to create the locator component for your Oracle database separately



Verify if the locator component is already installed

Run the below queries in the Oracle database used for Installer

Select comp_name version status from dba_registry where upper

(comp_name) like MEDIA

Select username from dba_users where username = MDSYS

If the above statements return zero records andMDSYS schema is not created then follow these

steps to create theMDSYS schema and install the locator component manually

The following steps need to be executed by a SYSDBA only

To create Locator or MDSYS schema follow these steps in option 1 or option 2

l Option 1 Follow DBCA or Oracle Installer enterprise edition with create database option to

create Oracle database Use the same database during Kony Fabric Installation

l Option 2 Run the following scripts on the database to be used for Kony Fabric where Oracle

locator is not installed

i Connect as SYSDBA

sqlplus as sysdba

ii CreateMDSYS User if not exists

Create user mdsys identified by secret default tablespace

sysaux

A secret is a dummy password Provide the password that is used duringMDSYS user

creation



iii Run the below SQL to grant the privileges

SQLgtmdadminmdprivssql

iv Connect to MDSYS user

Conn mdsyssecret

A secret is dummy password Provide the password that is used duringMDSYS user

creation

v Run the below SQL to create the locator objects

SQLgtmdadmincatmdlocsql

All the above sql files executed will be available as part of database software md folder

After executing the above steps execute the following query to check if everything is fine

Select from dba_objects where owner=MDSYS and object_name

like SDO

Once theOracle locator is installed run the Installer to setup Kony Fabric The system should

not throw the error Invalid Data Type SDO_GEOMETRY

Note As per Oracle 12cRelease 1 (121) documentation Oracle Locator is available with

the following editions

l Oracle Database Standard Edition One

l Oracle Database Standard Edition



l Oracle Database Enterprise Edition

l Oracle Database Express Edition (Oracle Database XE)

For more information regarding Oracle licensing refer to Oracle Database documentation

Important SDO_GEOMETRY is part of Oracle Locator which is free and does not need

additional licensing but this is bundled with Oracle Spatial which is part of enterprise

edition licensing

For more details please go through the followingOracle reference document

Doc ID 10668371 - Oracle Spatial andOracle Locator Licensing Information

593 Maria DB

5931 Increase the table_definition_cache and table_open_cache values

To increase the values of table_definition_cache and table_open_cache inMaria DB execute the

following commands or update the ini or cnf file with

set GLOBAL table_definition_cache=4000

For table_definition_cache 4000 is the minimum value

set GLOBAL table_open_cache=2000 For table_open_cache 2000 is the

minimum value

510 Application Servers Pre-Installation Tasks

5101 JBoss

51011 Configure Load Balancer as Proxy in JBoss Multinode Setup (Optional if SSL Offloading at

Load Balancer)

1 Navigate to your Kony Fabric install directory and open the domainxml file



2 In the domainxml update all the http connector tags to include the scheme and

proxy-port details

For exampleltconnector name=http protocol=HTTP11 scheme=https socket-

binding=http proxy-name=loadbalancer hostname proxy-port=443

secure=truegt

51012 Update Listen Interfaces in hostxml for JBoss Cluster

For JBoss domainmode installation configure the following interface address

1 Go to ltJBOSS EAP dirgtdomainconfigurationhostxml

2 In place of existing interfaces xml tag replace the default content with below details

ltinterfacesgt


ltany-ipv4-addressgt

ltinterfacegt



ltinterfacegt

ltinterface name=unsecuregt

lt-- Used for IIOP sockets in the standard con-

figuration

To secure JacORB you need to setup SSL --gt


ltinterfacegt

ltinterface name=anygt


ltinterfacegt

ltinterfacesgt



51013 Comment the javax-persistence-module for Kony Engagement Services on JBoss Cluster

If you are installing Kony Engagement Services on JBoss domainmode installation comment the

below persistencemodule in the domainxml file

1 Go to ltJBOSS EAP dirgtdomainconfigurationdomainxml

2 Comment the below xml tag Comment the persistencemodule at four places in the

domainxml file

lt-- ltsubsystem xmlns=urnjbossdomainjpa11gt

ltjpa default-datasource= default-extended-per-

sistence-inheritance=DEEPgt

ltsubsystemgt --gt



51014 How to Configure Connector - JBoss

For importing an app to Kony Fabric Console properly youmust have set the enough value for the

max-post-size in the standalonexml file For more details refer to Configure Connectors -

JBoss

51015 How to Increase Timeout and Maximum Heap Size Settings - JBoss

Restarting JBoss can cause deployment failures To avoid these failures youmust increase the JBoss

timeout andmaximumheap size settings for cluster

To increase memory and timeout settings in JBoss (pre-configured JBoss) follow these steps

1 In the standalonebat or sh file add the following properties to Java_opts

-Djbossasmanagementblockingtimeout=8400

-Xms2048m

-Xmx4096m

2 In the ltJBoss_Homegtstandaloneconfigurationstandalonexml file add

config deployment-timeout=rdquo8400rdquo in the deployment-scanner subsystem

shown below

ltsubsystem xmlns=urnjbossdomaindeployment-scanner20gt

ltdeployment-scanner path=deployments relative-

to=jbossserverbasedir scan-interval=5000 deployment-

timeout=rdquo8400rdquo runtime-failure-causes-

rollback=$jbossdeploymentscannerrollbackonfailurefalse

gt

ltsubsystemgt

To increase memory and timeout settings in JBoss Multinode follow these steps



1 In the domainbat or sh file add the following properties to Java_opts


2 Set the heap size for the selected server groups as below in the ltJBoss_

Homegtdomainconfigurationdomainxml

l Search for ltserver-groupsgt tag in the domainxml and set the heap size in the JVM

settings

ltheap size=2048m max-size=4096mgt

51016 How to Configure Engagement Services - JBoss

When Engagement is selected as Fabric Component based on the selected JBossmode youmust

add the following parameter in the JVMarguments present in standalonebatdomainbat( for

Windows) or standaloneshdomainsh(for Unix)

-DKMS_CORE_VERSION=2

5102 WebLogic

51021 Increase JVMmemory for WebLogic Server

For a successful deployment of Kony FabricWar files onWebLogic server increase the PermGen

memory inWebLogicmemory arguments For more details refer to Heap and PermGen Settings

51022 Place MS SQL Server Connector JAR in WebLogic Classpath

If you want to install MS SQLServer Database withWebLogic then you need tomanually place

the mssql-jdbc-700jre8 file in theWebLogic classpath

Important To add the mssql-jdbc-700jre8 file in theWebLogic classpath perform the

following steps before starting Kony Fabric installation



To add mssql-jdbc-700jre8 file in the WebLogic classpath follow these steps

1 Place the mssql-jdbc-700jre8 in the ltWL_HOMEgtserverlib folder

2 Edit the commEnvcmdsh script in the ltWL_HOMEgtoracle_commoncommonbin

3 Prepend your JAR file to theWEBLOGIC_CLASSPATH environment variable like set WEBLOGIC_CLASSPATH=WL_HOMEserverlib mssql-jdbc-

700jre8JAVA_HOMElibtoolsjarPROFILE_CLASSPATHANT_

CONTRIBlibant-contribjarCAM_NODEMANAGER_JAR_PATH

4 Restart the server

51023 Configure Hibernate Dialect in WebLogic (only for WebLogic)

For the Engagement Services to work with Oracle DB set the following parameter in the

setDomainEnvsh and run the setDomainEnvsh before starting theWebLogic server

-Dhibernatedialect=orghibernatedialectOracle10gDialect

51024 How to Configure Engagement Services - WebLogic

When Engagement is selected as Fabric Component youmust add the following parameter in the

JVMarguments present in domain-nameStartWebLogiccmd (for Windows) or domain-

nameStartWebLogicsh (for Unix)


5103 WebSphere

51031 Configure Property Settings for Logs - (only for WebSphere)

Tomake the LOG_ROOT variable accessible to applications set the variable under custom properties

of process definition

1 Log in toWebSphere Admin Console

2 Go to Servers gt Server Types gt WebSphere application servers



3 Click Application Server (For example server1 it is the default server created with

WebSphere installation)

4 Go to Server Infrastructure section expand Java and Process Management and click

Custom Properties

5 Go to Custom Properties click Java Virtual Machine

6 Click New to add LOG_ROOT property

7 Enter LOG_ROOT as name

8 Enter $LOG_ROOT as value



9 Save the configuration

After setting the LOG_ROOT variable under custom properties logs are created under IBM_WebSphereWebSphereAppServerprofilesAppSrv02logskonymflogs

51032 Install Kony Fabric on a Remote WebSphere Server with Global Security Enabled

To get server groups of a remoteWebSphere Server using a SOAP port follow these steps before

running the Kony Fabric Installer

1 Install IBMWebSphere SDK on a systemwhere you want to run the Kony Fabric Installer

2 Add the SSL certificate to DMGR For more information refer to How to Add an Existing Secure

Sockets Layer (SSL) Certificate

3 Launch a Terminal window

4 Go to the location of the Kony Fabric Installer



5 Run the Kony Fabric Installer as follows

KonyFabricInstaller-7xbin LAX_VM ltfully qualified path to IBM

java executablegt

51033 Support Deployment of apiportalwar on WebSphere Server

To support deployment of the apiportalwar onWebSphere make the following configuration

changes

l Disable the following option

Go to Servers gt Server Types gt WebSphere application servers gt server_name gt Session

management gt Enable cookies gt Restrict cookies to HTTPS sessions

l Remove the row matching with domain= name=JSESSIONID path= in the

Security gt Global Security gt Programmatic session cookie configuration

51034 Updating authServicewar and accountswar for WebSphere 9

1 Add the following -D params in the jvm properties

ldquocomibmwebspherejaxrsserverDisableIBMJAXRSEngine=truerdquo

2 In the server configuration expand container services In the Default

JAXRS provider settings change the JAX-RS Provider to 20spec

51035 How to Configure Engagement Services - WebSphere


Generic JVM arguments section of theWebSphere Administration Console under Application

Servers gt serverName gt Process Definition gt Java Virtual Machine



6 Installation Modes - Kony Fabric Kony Fabric Installation Guide - LinuxVersion111

6 Installation Modes - Kony Fabric

You can install Kony Fabric by any of the followingmodes

Important Ensure that you have the required hardware and access to the supporting software as

mentioned in the Prerequisites section and performed the steps asmentioned in the Pre-

installation Tasks section

l Installing Kony Fabric - Console-mode (for command-line-driven installations)

l Installing Kony Fabric - Silent-mode (for working with limited or no user interaction)



61 Installing Kony Fabric - Console-mode (for command-line-driven

installations)

This section of the document provides you with the instructions for installing and configuring Kony

Fabric on Linux

Note If you install Kony Fabric Console on a partition different from the users home directory

youmust have readwrite execute permissions




Important Make sure you have proper administrative rights to install Kony Fabric on your

computer You also need a user where Kony Fabric will be installed

The ltInstall Locationgt directory contains the log files logging each invocation of the installer Tomake

problem identification easier provide these log files to Konywhen reporting an issue

You can install Kony Fabric on Tomcat JBossWebLogic or WebSphere servers

l Installing Kony Fabric on Tomcat

l Installing Kony Fabric on JBoss

o StandaloneMode (Single node installation in bundled JBoss)

o StandaloneMode (Single Node installation in a pre-configured JBoss)

o DomainMode (Multi node installation in pre-configured JBoss)

l Installing Kony Fabric onWebLogic

l Installing Kony Fabric onWebSphere



611 Installing Kony Fabric on Tomcat - Console-mode

Note If a user installs Kony Fabric Console on a partition different from the users home directory

the user must have readwrite execute permissions


Fabric Console on a single node For multi-node installations refer the Deployment Checklist and

Example Case Studies




Make sure you have proper administrative rights to install Kony Fabric on your computer

You also need a user where Kony Fabric will be installed



To install Kony Fabric Console on Tomcat using the installer follow these steps

1 Execute the following command to switch to the user that you created

su - username

2 Press Enter The system prompt you to enter the password

3 Enter the password and press Enter

4 Unzip the KonyFabricSetuptargz file and navigate to the folder KonyFabric_Installer_

Linux

5 Start the KonyFabricInstaller-xxxx_GAbin file by executing the following command



Preparing to install

Extracting the JRE from the installer archive

Unpacking the JRE

Extracting the installation resources from the installer

archive

Configuring the installer for this systems environment

Launching installer

=================================================================

==============

Kony Fabric (created with InstallAnywhere)

------------------------------------------------------------------

-------------

Preparing CONSOLE Mode Installation

=================================================================

==============

Introduction

------------

This installer will install a new or upgrade an existing instance



of Kony Fabric

Kony Fabric is a set of enterprise-grade mobile infrastructure

services

that makes it easy to build amazing apps that integrate and

support all of

your backend systems With open standards-based development

scalable and

secure services and exceptional agility enterprises can

dramatically reduce

the cost and complexity of enterprise mobility projects

To proceed with installation please confirm that the following

prerequisites

have been met -

1 Database server for installation MySQL MariaDB Oracle MS

SQL Server

and DB2 are the

supported databases MariaDB is supported for TomcatJBoss

only

2 Corresponding database user should exist and that user should

have all required

privileges as per the documentation

3 If you want to use your existing SSL certificate then please

have the SSL

certificate

mapped to the domain name you want to use

4 If you want to install with JBoss WebLogic WebSphere as an



option for application

server then have the application server preconfigured Please

note that single node

JBoss is also bundled as part of the installer in case you

want to install afresh

To change input type back to go back to the previous step

To cancel the installation type quit at any time

For troubleshooting amp help on the installation use

httpdocskonycomkonylibrarykonyfabricresourcesinstallerh

tm

For getting started on Kony Fabric refer

httpcommunitykonycomdocumentation

For upgrading Kony Fabric refer online documentation

If you have more questions or feedback you can join our

httpcommunitykonycom or raise a

httpsupportkonycom

-gt1- Continue with Installation

2- Abort Installation

ENTER THE NUMBER OF THE DESIRED CHOICE OR PRESS ltENTERgt TO ACCEPT

THE



DEFAULT


servers

1 Press Enter The Software License Agreement details appear

=================================================================

=======

License Agreement

-----------------

Installation and Use of Kony Fabric Console Requires Acceptance of

the

Following License Agreement

KONY INC

SOFTWARE LICENSE AGREEMENT

THE TERMS AND CONDITIONS CONTAINED HEREIN CONSTITUTE A LEGAL

AGREEMENT

THIS AGREEMENT (AGREEMENT) CONTAINS THE ENTIRE AGREEMENT BETWEEN

YOU

(LICENSEE) AND KONY INC (KONY) WITH RESPECT TO THE TERMS AND

CONDITIONS

DESCRIBED HEREIN READ THIS AGREEMENT CAREFULLY BEFORE YOU CLICK



THE I

ACCEPT BUTTON BELOW BY CLICKING ON THE I ACCEPT BUTTON YOU

ACKNOWLEDGE

THAT (1) YOU ARE AUTHORIZED TO ENTER THIS AGREEMENT FOR AND ON

BEHALF OF YOUR

COMPANY AND ARE DOING SO AND (2) YOU HAVE READ AND UNDERSTAND

AND AGREE THAT

YOU AND THE COMPANY SHALL BE BOUND BY THESE TERMS AND CONDITIONS

AND ALL

MODIFICATIONS AND ADDITIONS PROVIDED FOR IF YOU DO NOT AGREE WITH

THESE TERMS

AND CONDITIONS CLICK ON THE I DO NOT ACCEPT BUTTON BELOW AND

INSTALLATION

WILL TERMINATE

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT (YN) Y

2 Press Enter to continue with new installation

The following installation types are supported for new installation

l Development for singlemachine instance

l Non-Production for larger environments like QA or UAT

l Production for the production instance

=================================================================

==============

Licensing Type



--------------

Please select the type of environment you want to install

Development ndash Single server instance typically used for

development Non-Production ndash A multi-server environment for

testing or staging environments Production ndash A full production-

grade environment

1- Development

2- Non-Production

-gt3-

Production

ENTER THE NUMBER FOR YOUR CHOICE OR PRESS ltENTERgt TO ACCEPT THE

DEFAULT

3 Enter your choice and press Enter The Send Usage Data Anonymously details appear Allows

Kony to collect product usage information tomake your Kony Fabric experience better Kony

does not save any of your private or application data

=================================================================

==============

Send Usage Data Anonymously

--------------

------------

Help us make your Kony Fabric experience better by allowing us to



collect product usage information We will not save any of your

private or application data

Send usage data anonymously

-gt1- Yes

2- No


DEFAULT

4 Enter your choice and press Enter The Install Components details appear

=================================================================

======

Install Components

------------------

Please select Kony Fabric components to install

The Console is the administrative interface to manage your apps

environments and users

The Identity Services helps you to use a single gateway for all

your authentication and authorization requests

The Integration Services helps you connect with any enterprise or

third-party system to expose transform and orchestrate your data

as APIs

The API Developer Portal is a console that enables partner teams

to discover test and consume APIs

Engage your app users over sms email and push using segmentation



location campaigns and event driven messaging

A specialized component used to manage offline data

synchronization between the backend system of record and the

front-end app

Console Identity and Integration Services are mandatory

components of Kony Fabric

In a development scenario all components can be installed on the

same server However it is recommended to install these

components on separate servers for a production environment

-gt1- Console

-gt2- Identity Services

-gt3- Integration Services

-gt4- API Development Portal

-gt5- Engagement Services

ENTER A COMMA-SEPARATED LIST OF NUMBERS REPRESENTING THE DESIRED

CHOICES OR PRESS ltENTERgt TO ACCEPT THE DEFAULT

l Console - To install Kony Fabric Console type 1 and press Enter

The system creates the following databases ltprefixgtmfconsoledbltsuffixgt

ltprefixgtmfaccountsdbltsuffixgt and ltprefixgtmfreportsdbltsuffixgt

o Click here for Accounts schema diagram

o Click here for Workspace schema diagram

o Click here for ReportsDB (Metrics) schema diagram

l Identity Services - To install Kony Identity Services type 2 and press Enter

The system creates the following database ltprefixgtidconfigdbltsuffixgt

o Click here for Identity schema diagram



l Integration Services - To install Kony Fabric Integration type 3 and press Enter

The system creates the following databases konyadmindb and mfreportsdb

o Click here for Admin DB schema diagram


l API Developer Portal - To install developer portal type 4 and press Enter

Note During installation if you have selected API Developer Portal the API

Developer Portal is created You can directly access your KonyDeveloper Portal in

Kony Fabric Console

l Engagement Services - To install Kony Fabric Engagement Services type 5 and press

Enter

The system creates the following database ltprefixgtkpnsdbltsuffixgt

o Click here for Engagement Server schema diagram

Reports Database

The reports database is used for configuring reports

The Installer creates the mfreportsdb if you choose either Console or Integration Services

l Console without Integration Services (with or without Engagement Services)

l Console and Integration Services (with or without Engagement Services)

l Integration Services without Console (with or without Engagement Services)

Reports Database for Integration on a Separate Node

While installing console and integration on separate nodes the installer prompts you to point the

reports database during the integration installation

For example



You have installed only Console on one node The installer creates these three databases such

as ltgtmfreportsdbltgt along with the ltgtmfconsoledbltgt and ltgtmfaccountsdbltgt For

example your report database name is konymfreportsdb1

When you install the integration with or without one or more components (identity or

Engagement Services ) on a separate node the installer displays the Reports Database Name

field in the Database Details window If the installer prompts you to enter the existing reports

db enter the reports database name (for example konymfreportsdb1) in the Database

Details window gt Reports Database Name field

Refer to creating a reports database for example ltprefixgtmfreportsltsuffixgt

5 Press Enter to continue the installation The Install Folder details appear

=================================================================

======

Install Folder

---------------------

Please choose a destination folder for this installation

NOTE The installation path should not contain any special

characters

Default Install Folder homeuser1KonyFabric



ENTER AN ABSOLUTE PATH OR PRESS ltENTERgt TO ACCEPT THE DEFAULT

Note By default Kony Fabric is installed at the home directory of the user

6 Press Enter to continue the installation The installer prompts for the Application Server details

as follows

=================================================================

==============

Application Server

------------------

Enter requested information

-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT



7 In the Application Server type 1

Note By default Tomcat manager password in used by Kony Fabric for Web Application

publish To change the default Tomcat manager password the new password needs to be

replaced in the password value for user manager in lttomcat-usersgt tag in tomcat-

usersxml

Now to replace the value in database the password value should be encrypted To encrypt

the database password follow these stepsmentioned in the Encrypt_Passwords section

Once the password is encrypted replace the encrypted value in the prop_value column

in the row where prop_value is management_server_password of

ltDatabasePrefixgtadmindbltDatabaseSuffixgt database in the server_

configuration table

8 Press Enter The HTTP or HTTPS details appear asking you to choose the HTTP or HTTPS

=================================================================

=======

HTTP or HTTPS

-------------

Please select the communication protocol you want to use

We recommend that you use HTTPS in production environment

-gt1- HTTP

2- HTTPS




DEFAULT

a In HTTP or HTTPS if you select 1 and press Enter the following details in the Details for

Application Server details appear

=============================================================

==================

Details for Application Server

------------------------------

Please enter the HostnameIP Address and port you want to

use The default

value is the IP Address of this machine

HostnameIP Address (Default )

ltIP addressgt

HTTP Port (Default 8080)

8181

Tomcat Shutdown Port (Default 38011)

Important In case of Tomcat enter the Tomcat shutdown port



b In the HTTP or HTTPS if you type 2 and press Enter the following details in the Details

for Application Server details appear

=============================================================

==================


------------------------------


use The default


NOTE If you want to use your existing SSL certificate then

please have the

SSL certificate mapped to the domain name you want to use


ltIP addressgt


HTTPS Port (Default 8443)




Important After installing Kony Fabric import your SSL certificate (for example

domainsubdomaincrt) into your Kony Fabric installers JRE trusted certificate

authority (CA) certificates file - for example ltINSTALL_

DIRgtjrelibsecuritycacerts

If your SSL certificate is not configured the system displays an error - for example

peer not authenticated

For details refer to Troubleshoot with SSLCertificate Issues

Note Based on the inputs provided in the previous HTTP or HTTPS gt a or HTTP

or HTTPS gt b one of the following error messages appears

l If a port is already in use the installer displays the following error message

=========================================================

======================

Validation of Host Detail

-------------------------

Port 22 is already in use

Please provide a different port

-gt1- Go back to give valid input




ENTER THE NUMBER OF THE DESIRED CHOICE OR PRESS ltENTERgt

TO ACCEPT THE

DEFAULT

l If you provide an invalid port the installer displays the following error message

=========================================================

======================

Port Validation

---------------

Please enter a valid port Port should be in between 1-

65535

-gt1- Go back to give valid port



TO ACCEPT THE

DEFAULT

l If you provide an invalid HostnameIP address the installer displays the following

error message

=========================================================

======================

Invalid HostnameIP Address

---------------------------



Please enter a valid hostnameIP address

-gt1- Go back to give valid details



TO ACCEPT THE

DEFAULT

9 Provide the HostnameIP Address HTTP Port and HTTPS Port and press Enter The SSL

Configuration for HTTPS Communication details appear only if you select HTTPS Choose one

of the following two options

=================================================================

=======

SSL Configuration for HTTPS Communication

-----------------------------------------

Please select the appropriate option to proceed

-gt1- Create self-signed certificate

2- Provide SSL certificate




DEFAULT

a In the SSLConfiguration for HTTPS Communication if you select 1 the Details for self-

signed SSLCertificate details appear

Important To add an existing SSL certificate to cacerts file refer to How to Add Your

Existing SSLCertificate

=============================================================

===========

Details for self-signed SSL Certificate

-----------------------------------------

Please provide the following details to create self-signed

certificate All the

fields are mandatory

Please note that the path of self-signed certificate will be

rootKonyFabrickeystorejks

Organizational Unit (DEFAULT ) platform

Host Name (DEFAULT ) konycom



Company (DEFAULT ) Kony

City (DEFAULT ) HYD

State (DEFAULT ) AP

Country (DEFAULT ) IND

Note The path for a self-signed certificate will be in this location ltinstallfoldergtkeystorejks

b In the SSLConfiguration for HTTPS Communication if you select 2 the SSLCertificate

Details details appear

Note Provide path for jks file as input

=============================================================

===========

SSL Certificate Details

-----------------------



Please provide the following details

Absolute Path to Keystore File (Default )

downloads_konylabsnet2016jks

c Type the details The installer prompts for Password for keystore file details as follows

=============================================================

===========

Password for keystore file

-----------------------------------------

Password should contain minimum six characters and should not

contain space

Please enter the password

l If you enter an incorrect password -- for example one that is fewer than six

characters contains a space or is empty -- the following error message for an

invalid keystore password is displayed

=========================================================

===============


-----------------------------------------

=========================================================

===============

Invalid Keystore Password



-------------------------

Keystore password must be at least six characters and

should not contain

space

PRESS ltENTERgt TO ACCEPT THE FOLLOWING (OK)

10 Type the password

11 Press Enter The Database Choice details appear

=================================================================

=======

Database Choice

-----------------------------------------

Please select the database of your choice

-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT



Note FromV8 SP4 FP1HF1 onwards DB2 is not supported for bundled Tomcat and

JBoss servers

12 In the Database Choice choose the DB

l In the Database Choice if you select 1 theMySQLDatabase Details appear

=============================================================

===========

MySQL Database Details

-----------------------------------------

Please enter MySQL database server details

Database Server IP (DEFAULT localhost) ltIP addressgt

Port (DEFAULT 3306)

Username (DEFAULT ) root

a Enter the following details

l Database Server IP Enter the server HostnameIP to be used to create a

database of selected components of Kony Fabric By default the server

HostnameIP is set as localhost



l Port Enter the database port of theMySQLServer By default this field is

set to 3306 for MySQL

l Username Enter the user name used while creating the database user - for

example dbclient

b Provide a password and press Enter

l If the database connection fails the following error message displays

====================================================

===========================

Database Connection Failed

--------------------------

Database connection failed

For the following reasons

Communications link failure

The last packet sent successfully to the server was

0 milliseconds ago The

driver has not received any packets from the server




l If the database server not compatible the following error message displays

====================================================

===========================

Incompatible Database Server Version

------------------------------------

Minimum requirement for MySQL database server is

57


l In the Database Choice if you select 2 the Oracle Database Details appear

=============================================================

===========

Oracle Database Details

-----------------------------------------

Please enter Oracle database server details

Database Server HostnameIP (Default 10102451)

ltHostnameIPgt

Port (Default 1521)



Service ID Service Name(Default )

System Username (Default )





l Port Enter the database port of the Oracle Server By default this field is set

to 1521 for oracle

l Service ID Service Name Enter Oracle service ID or service name

Service ID is unique alias given to an instance name of Oracle DB

l System Username Enter the user name used while creating the database

user

b Press Enter The installer prompts for Enter Password for Database User details

as follows

=========================================================

===============

Enter Password for Database User

-----------------------------------------




c Provide a password and press Enter


====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------




d Select the tablespace for Oracle database

Important If tablespaceswere already created the DBAmust grant quota

(permissions) on these tablespaces to installer with admin option

The DBA alsomust include grant quota on the schemas from installer login

=========================================================

===============

Tablespace Choice

-----------------------------------------

Please select the Table Space type

-gt1- Default Tablespace

2- User Defined Tablespace

ENTER THE NUMBER FOR YOUR CHOICE OR PRESS ltENTERgt TO

ACCEPT THE DEFAULT



n Default Tablespace If selected the database schema and SQL scripts

migration happens automatically to the default tablespace - for exampleUSERS

n User Defined Tablespace If selected enter the tablespaces for the

following

====================================================

====================

Ask for the Tablespaces

-----------------------------------------

Please enter the names of the Tablespaces

Data Tablespace (Default ) Kony123

Index Tablespace (Default )

LOB Table Space (Default )

l Data Tablespace

Enter the name for Data tablespace

This is amandatory field If the Data tablespace field is empty the

installers displays the error message

================================================

========================

TableSpace details not provided

---------------------------------------

Please provide a valid Tablespace for at least



the Data field for the

installation wizard to proceed further


If the Data tablespace (for example Kony123) does not exist the


================================================

========================

Invalid TableSpace Details

---------------------------------------

Installation wizard is not able to access the

Kony123 TableSpace provided with

give credentials Please verify the details

again


l Index Index Tablespace Enter the name for Index tablespace

If input for Index Tablespace is not provided then the value will be set

to the provided Datatable space value

l LOB Tablespace Enter the name for LOB tablespace

If input for LOB Tablespace is not provided then the value will be set


l In the Database Choice if you select 3 the SQL Server Database Details appear

=============================================================

===========

SQLServer Database Details

-----------------------------------------



Please enter SQL database server details


ltHostnameIPgt

Port (Default 1433)

Username 9Default )

Instance Name (Optional) (Default )





l Port Enter the database port of the SQL Server By default this field is set to

1433 for SQL


example dbclient

l Instance Name (Optional) Enter the instance name for the database This

information is optional


as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


Important Follow the below steps only if you want install Kony Fabric on

Tomcat with Microsoft Azure SQL Server database

l For Microsoft Azure (MSSQL) If you want to install Kony Fabric V8

on Tomcat with Microsoft Azure SQL youmust edit the

authServicexml file from the existing Tomcat with Microsoft SQL

Server install location For more details refer the following section on

how to configure identity to work onMicrosoft Azure SQL

Configure Identity on Tomcat with Microsoft Azure SQL Server

To run identity on Tomcat with Microsoft Azure SQL youmust edit the

authServicexml file from the existing Tomcat with MSSQL install

location

1 Open theauthServicexml file from the existing Tomcat with

MSSQL install location

Sample Location for authServicexml from Tomcat with MSSQL

install folder



ltLocalDrivegtKonyFabricInstallerV8tomcatc

onfCatalinalocalhostauthServicexml

2 Modify the following theauthServicexml file

ltxml version=10 encoding=utf-8 gt

lt-- The contents of this file will be loaded

for each web application --gt

ltContextgt

ltResource auth=Container

driverClassName=commicrosoftsqlserverjdbc

SQLServerDriver

factory=orgapachetomcatjdbcpoolDataSourc

eFactory initialSize=5 jmxEnabled=true

logAbandoned=true maxActive=10 maxIdle=5

maxWait=10000

minEvictableIdleTimeMillis=30000 minIdle=2

name=jdbcauthglobaldb password=ltPasswordgt

removeAbandoned=true

removeAbandonedTimeout=600

testOnBorrow=true testOnReturn=false

testWhileIdle=true

timeBetweenEvictionRunsMillis=30000

type=javaxsqlDataSource

url=jdbcsqlserver

ltDBServerIPPORTgtdatabasename=ltauth database

namegtsendStringParametersAsUnicode=true

username=ltUser_Namegt

validationInterval=30000

validationQuery=SELECT 1gt





SQLServerDriver




maxWait=10000


name=jdbcauthconfig password=ltPasswordgt




testWhileIdle=true



url=jdbcsqlserver






ltContextgt

l In the Database Choice if you select 4 the DB2Database Details appear

Note FromV8 SP4 FP1HF1 onwards DB2 is not supported for bundled Tomcat

and JBoss servers

=============================================================

===========

DB2 Database Details

-----------------------------------------



Please enter DB2 database server details

Database Server HostnameIP (Default localhost)

ltHostnameIPgt

Port (Default 50000)

Instance Name (Default )

Username(Default )

DB2 JDBC Driver Path (Default ) rootdb2jcc4jar

DB2 JDBC Driver licence path (Default ) rootdb2jcc_

license_cujar


l Database Server HostnameIP Enter the server HostnameIP to be used

to create a database of selected components of Kony Fabric By default the

server HostnameIP is set as localhost

l Port Enter the database port of the DB2 By default this field is set to 50000

for DB2

l Instance Name Enter the instance name for the database



l Username Enter the user name used while creating the database user




The version of the downloaded JARs should be compatible with your

installed DB2Database version

l DB2 JDBC Driver Path (Default ) Enter the path for the IBMDB2 Type 4

Driver (db2jcc4jar) that you downloaded

Note Provide the complete path of the database jar file For exampleltpath of the database jar locationgtdb2jcc4jar

l DB2 JDBC Driver licence path (Default ) Enter the path for the DB2

JDBC Driver license (db2jcc_license_cujar) that you downloaded

Note Provide the complete path of the database license file For

example ltpath of the database license

locationgtdb2jcc_license_cujar


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------




d Provide tablespace for DB2 database

=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT


migration happens automatically to the default tablespace - for exampleUSERSPACE1


following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again


l Index Tablespace Enter the name for Index tablespace




If LOB Tablespace is not provided then the value will be set to the

provided Datatable space value

l In the Database Choice if you select 5 theMariaDB Database Details appear

=============================================================

===========

MariaDB Database Details

-----------------------------------------

Please enter MariaDB database server details


ltHostnameIPgt



Database Port (Default 1433)

Database Username (Default )






l Database Port Enter the database port of theMariaDB Server By default

this field is set to 3306 for MariaDB

l Database Username Enter the user name used while creating the

database user - for example dbclient


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------




13 Press Enter The installation prompts for Database name prefix and suffix details as follows

=================================================================

==============

Database name prefix and suffix

-------------------------------

Please enter database name prefix and suffix Please provide

existing Prefix and Suffix if you intend to upgrade to the new

Kony Fabric Database

Database Name Prefix (Default kony) tomcat

Database Name Suffix (Default 1) 54

l Database NamePrefix Enter valid prefix databases - for example Kony

l Database NameSuffix Enter valid suffix for all databases - for example 1

14 Press Enter The Important Information details appear

=================================================================

==============

Important Information

---------------------



Required manual step

Before proceeding further with this installation please do the

following

manual steps

1 Copy konylib folder from ltUSER_INSTALL_DIRgt to your

ltWebsphere_Install_DirgtAppServer

This is required for the configuration of shared libraries and

successful

deployment of applications


15 Enter the prefix and suffix for the database and press Enter The Administrator Account

Configuration details appear

The Administrator Account Configuration details help you to configure your super

administrator account

The Administrator Account Configuration window appears only while installing Console and

Identity Services along with one or all other Kony Fabric components such as Integration

Services and Engagement Services on Tomcat or JBoss on a single node You can select the

components at Install Components

=================================================================

==============

Administrator Account Configuration

-------------------------------



Please configure your Administrator Account We require your First

Name Last Name Email Address and Password Your Name is used for

display purposes in the console the Email address will be used as

your login ID and we do not use it to send unsolicited emails

Public URL (Default )

First Name (Default )

Last Name (Default )

Email (Default )

a In the Administrator Account Configuration enter the following details to create the


l Public URL The URL field is filled with required details for example

ltHostnameIP addressgtltportgt Change these details if required

l First Name Enter the first name of the user

l Last Name Enter the last name of the user

l Email Enter the email address of the user It can include alphanumeric and special

characters that follow standard email address form



Note During Kony Fabric installation if you have configured your super

administrator account you can directly log in to Kony Fabric Console

b Press Enter The Password for the Administrator Account details appear

=============================================================

==================

Password for the Administrator Account

-------------------------------

Please Enter the Password

Confirm Password for the Administrator Account Configuration


c Enter the admin log-in password and press Enter The Confirm Password for the

Administrator Account Configuration details appear

=============================================================

==================




-------------------------------


16 Re-enter the admin log-in password and press Enter The Kony Fabric server startup details

appear

=================================================================

==============

Kony Fabric server startup details

-----------------------------------

Do you want to start the Kony Fabric server after successful

installation of

Kony Fabric

-gt1- Yes

2- No


DEFAULT



17 To start the server automatically after the successful installation of Kony Fabric press Enter

Note To start the server manually after the successful installation of Kony Fabric refer to

Starting Kony Fabric Console

The Pre-Installation Summary details appear

==================================================

Pre-Installation Summary

------------------------

Please review the following before continuing

Installation Type

New Installation

Install Components

Console Developer Portal Identity Services Integration

Services and Engagement Services

Install Folder

homeUserKonyFabricInstaller-DEV-841438



Application Server

Tomcat 8532

Application Server Details

HostnameIP Address 101112201 Protocol HTTP HTTP Port

8080

Database Choice

MySQL 57

Database Details

HostnameIP Address mbaastest22konylabsnet User mfuser

Port 3306

Database Names

Test_mfconsoledb_438 Test_mfaccountsdb_438 Test_mfreportsdb_

438 Test_idconfigdb_438 Test_admindb_438 and Test_kpnsdb_438



Admin Account Details

First Nametest Last Nameone Emailbvtuserkonycom

PRESS ltENTERgt TO CONTINUE

===========================================================

Installing

-------------

[==================|==================|==================]

18 Type the details and press Enter The Ready To Install details appear

=================================================================

=======

Ready To Install

-----------------------------------------

Installer is now ready to install Kony Fabric Console onto your

system

at the following location



homeuser1KonyFabric

PRESS ltENTERgt TO INSTALL

19 Press Enter to continue the installation

=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]

20 Press Enter The Installation Complete details appear

=================================================================

=======

Installation Complete

-----------------------------------------

Congratulations Kony Fabric has been successfully installed to

homeuser1KonyFabric



Console URL https00000000portmfconsole

Identity Service URL https00000000portauthService

Integration Service URL https00000000portadmin

Engagement Services URL http000000000portkpns

PRESS ltENTERgt TO EXIT THE INSTALLER

[user1cnt6-01c downloads]$

21 Press Enter to complete the installation After the installation is completed the installer creates

logs in the install folder

Important When you are using a third party tool (for example PuTTY) for installing Kony

Fabric remotely if any network connection issues occur at the end of the installation the

installer stops the installation and the installation log is not created


domainsubdomaincrt) into your Kony Fabric installers JRE trusted certificate authority (CA)

certificates file - for example

ltINSTALL_DIRgtjrelibsecuritycacerts

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

authenticated




Note You can now access Kony Fabric Console by using the URLs For more details refer to

Accessing Kony Fabric Console - On-premises

During installation if you have configured your super administrator account you can directly log in

to Kony Fabric Console by using the Console URL



612 Installing Kony Fabric on JBoss Console-mode (for command-line-driven install-

ations)

You can install Kony Fabric on JBoss by any of the followingmodes




Kony Fabric Installer supports JBoss on single node (Standalone Mode) andmultinode (Domain

Mode)






6121 Installing Kony Fabric on a Standalone Mode in Bundled JBoss




Fabric Console








To install Kony Fabric Console on bundled JBoss using the installer follow these steps


su - username




Linux






Unpacking the JRE


archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric




services


support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom






THE

DEFAULT


=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE




BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type

--------------







grade environment

1- Development

2- Non-Production

-gt3-

Production


DEFAULT




=================================================================

==============


--------------

------------







-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs









front-end app






-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example







Engagement Services) on a separate node the installer displays the Reports Database Name






=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT





usersxml








configuration table

13 Press Enter to continue the installation The InstallationMode details appear

=================================================================

==============

Installation Mode

-----------------

Please select your required installation mode Standalone mode is

for single node deployment whereas domain mode is for multi node

deployment in JBoss cluster Please note that if you want to

install in domain mode then JBoss cluster should be preconfigured

Note If you are running JBoss in Domain node for a production

setup please procure appropriate licenses from Red Hat Inc

-gt1- Standalone Mode

(Single Node)

2- Standalone Mode

(Existing)

3- Domain Mode



(Multi Node)


DEFAULT

l Standalone Mode (Single Node) To install Kony Fabric on single node on JBoss that is

bundled with the Kony Fabric installer chooseStandalone Mode (Single Node)

l Standalone Mode (Existing) To install Kony Fabric on single node on JBoss that is

installed on your machine choose Standalone Mode (Existing) For more details on how

to install Kony Fabric on the existing JBoss refer to Installing Kony Fabric on a pre-

configured standalone JBoss - (Single Node)

l Domain Mode (Multinode) To install Kony Fabric on JBossmultinode choose Domain

Mode Before installing domainmode ensure that the JBoss cluster is configured on your

install system For more details on how to install Kony Fabric on Domainmode refer to

JBossMultinode Installation Procedure

Important Before installing Kony Fabric on domainmode ensure that the JBoss

cluster is configured on your install system

14 In the InstallationMode if you type 1 and press Enter the HTTP or HTTPS details appear

=================================================================

=======

HTTP or HTTPS

-------------

Please select the communication protocol you want to use We

recommend that you use HTTPS in production environment

-gt1- HTTP



2- HTTPS


DEFAULT



=============================================================

==================


------------------------------

=============================================================

==================


use The default



ltIP addressgt


8181





=============================================================

==================


------------------------------


use The default



please have the



ltIP addressgt















=========================================================

======================


-------------------------






TO ACCEPT THE

DEFAULT




=========================================================

======================

Port Validation

---------------


65535




TO ACCEPT THE

DEFAULT


error message

=========================================================

======================


---------------------------







TO ACCEPT THE

DEFAULT




=================================================================

=======


-----------------------------------------







DEFAULT





=============================================================

===========


-----------------------------------------


certificate All the









City (DEFAULT ) HYD

State (DEFAULT ) AP






=============================================================

===========


-----------------------







=============================================================

===========


-----------------------------------------


contain space





=========================================================

===============


-----------------------------------------

=========================================================

===============


-------------------------




should not contain

space




=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT


JBoss servers





=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------









====================================================

===========================




------------------------------------


57



=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)










to 1521 for oracle




user


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------








=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT






following

====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL


example dbclient




as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------



ltHostnameIPgt





Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------





l Data Tablespace






================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=================================================================

==============


-------------------------------


existing prefix and suffix if you intend to upgrade to the new









=================================================================

==============


---------------------



following

manual steps




successful













=================================================================

==============


-------------------------------








Email (Default )














=============================================================

==================


-------------------------------








=============================================================

==================


-------------------------------



appear

=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes



2- No


DEFAULT





=================================================================

==============


------------------------


Installation Type

New Installation

Install Components



Install Folder

rootKonyFabricInstaller-DEV-8426

Application Server

JBoss 71 Installation Mode Standalone Remote




HostnameIP Address Port 9999 HTTPHTTPS Port 8080

Database Choice

MySQL 57

Database Details

HostnameIP Address User mfuser Port 3306

Database Names

testmfconsoledbjboss testmfaccountsdbjboss

testmfreportsdbjboss testidconfigdbjboss testadmindbjboss and

testkpnsdbjboss

PRESS ENTER TO CONTINUE


=================================================================

=======

Ready To Install

-----------------------------------------


system


homeuser1KonyFabric





=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------


homeuser1KonyFabric



















authenticated












Log Location for Single Node Installation

For Tomcat

If you select the single node in the InstallationModewindow the logs folder will be created at the

following locations

l For Kony Fabric ltUserInstallDirectorygtlogs

o If you install Console the ltUserInstallDirectorygtlogs folder has three log files They

are mbaasportallog (for mbaas portal) accountsServicelog (for accounts)

and workspaceServicelog (for workspace)

o If you install Identity Service the ltUserInstallDirectorygtlogs folder has one log file -

authServicelog (for authentication)

l For Kony Fabric Integration ltUserInstallDirectorygtlogs

o If you install Integration Service the ltUserInstallDirectorygtlogs folder has five log

files They are adminlog (for admin) datasource-payloadlog (for

datasource) device-payloadlog (for device) downloadlog (download) and

middlewarelog (middleware)

Note Based on the combination of components selected during installation the

ltUserInstallDirectorygtlogs folder will have log files each component

l For Kony Fabric Engagement Services ltUserInstallDirectorygtlogs folder contains these log

files kmslog and kms-messageslog

l To check Tomcat Server logs refer to the following location

ltKony Fabric_Install_DIRgttomcatlogs

For JBoss


following locations


















l To check JBoss Server logs refer to the following location

ltJBoss_DIRgtstandalonelog

For WebLogic


following locations

l For Kony Fabric ltROOTgtkonymflogs

o If you install Console the ltROOTgtkonymflogs folder has three log files They are

mbaasportallog (for mbaas portal) accountsServicelog (for accounts) and

workspaceServicelog (for workspace)

o If you install Identity Service the ltROOTgtkonymflogs folder has one log file -




o If you install Integration Service the ltROOTgtkonymflogs folder has five log files They

are adminlog (for admin) datasource-payloadlog (for datasource)

device-payloadlog (for device) downloadlog (download) and


n For example on CentOS if an admin installed Kony Fabric as a User1 product

logs are located at homeUser1konymflogs


ltROOTgtkonymflogs folder will have log files for each component

l For Kony Fabric Engagement Services ltROOTgtkonymflogs folder contains these log files

kmslog and kms-messageslog

l For WebLogic Server logs by default the server log file is located below the server instances

root directory root-directoryserver-nameserver-namelog

For example if you created a domain in the cuser_projectsdomainsMyDomain directory and

you used the ltWebLogic_Directorygtuser_

projectsdomainsMyDomainstartWebLogicServercmd script to start the server

then by default the log file is located in ltWebLogic_Directorygtuser_

projectsdomainsMyDomainMyServerMyServerlog

If the Server File Name field contains only a filename the log file is located in the root-

directoryserver-name directory

For more details refer to httpdocsoraclecomcdE13222_

01wlsdocs81ConsoleHelplogginghtml1045661

For WebSphere


following locations



l For Kony Fabric ltInstallDrivegtkonymflogs

o If you install Console the ltInstallDrivegtkonymflogs folder has three log files They are



o If you install Identity Service the ltInstallDrivegtkonymflogs folder has one log file -


o If you install Integration Service the ltInstallDrivegtkonymflogs folder has five log files

They are adminlog (for admin) datasource-payloadlog (for datasource)




logs are located at konymflogs

n For example onWindows if an admin installed Kony Fabric in C drive product

logs are located at Ckonymflogs


ltInstallDrivegtkonymflogs folder will have log files each component

l For Kony Fabric Engagement Services ltInstallDrivegtkonymflogs folder contains these log


l For WebSphere Server logs refer to the following location

ltWAS_INSTALL_DIRgtAppServerprofilesltprofileNamegtlogsSystemOutlog

6122 Installing Kony Fabric on a pre-configured Standalone JBoss

Kony Fabric can be installed on a pre-configured standalone (single node) JBoss Before installing

ensure that you configure the existing standalone JBoss by using themanual steps provided in the

Prerequisites gt Configure the pre-configured Standalone JBoss






mentioned in the Prerequisites section

Youmust perform the steps noted in the Pre-installation Tasks section





To install Kony Fabric in pre-configured JBoss follow these steps


su - username




Linux

5 Start the KonyFabricInstaller-xxxxGAbin file by executing the following command

6 Preparing to install


Unpacking the JRE




archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric


services




support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom






THE

DEFAULT


JBoss servers


=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS




THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type



--------------





grade environment

1- Production

2- Non-Production

-gt3- Development


DEFAULT




=================================================================

==============


--------------

------------







-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs









front-end app






-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT

13 In the Application Server type two and press Enter




=================================================================

==============

Installation Mode

-----------------

Please select required installation mode

Standalone mode is a single node deployment typically used for

development and

testing environments

Domain mode is a high availability multiple node deployment

typically used for

production environments For domain mode install you will need a

preconfigured JBoss cluster


setup please

procure appropriate licenses from Red Hat Inc


(Single Node)

2- Standalone Mode

(Existing)

3- Domain Mode



(Multi Node)


DEFAULT2

Important To install Kony Fabric on single-node on JBoss that is bundled with the Kony

Fabric installer choose 1- Standalone Mode (Single Node) For more details refer to

StandaloneMode (Single Node) Installation

To install multinode choose 3- Domain Mode Before installing domainmode ensure that

the JBoss cluster is configured on your install system For more details refer to Multinode

Installation Procedure

15 In the InstallationMode type 2 and press Enter

16 The Application Server Details details will appear with the following details if have selected All

Components or Kony Fabric Console at Install Components

=================================================================

=======


--------------------------

Please enter the details of preconfigured standalone JBoss The

default value

is IP address of this machine

HostnameIP Address should not be 127001 0000 or localhost



It should

be a public IP address or a fully qualified domain name

(FQDN)

Fully Qualified Public URL of Kony Fabric with HTTP Management

Port

(Default )

HostnameIP Address (Default test201)

Native Management Port (Default 9999)

HTTPHTTPS Port (Default 8080)

User Name (Default master)

17 In the Application Server Details details do the following

l Fully Qualified Public URL of Kony Fabric Enter Load balancer URL to use public

communication For example lthttphttpsgtlthostnamegtlthttphttps

portgt

l HostnameIP Address Enter public HostnameIP of JBoss node The node should be

accessible from your installation system



l Management Port Enter native port of JBossmaster node

l HTTPHTTPS Port Enter port of Kony Fabric Console

l User Name Enter user that you configured in node of JBoss

18 Type the password of the JBoss user


=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT


JBoss servers





=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------









====================================================

===========================




------------------------------------


57



=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)










to 1521 for oracle




user


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------








=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT






following

====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL


example dbclient




as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------



ltHostnameIPgt





Username(Default )



license_cujar


and JBoss servers






for DB2



















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------







l Data Tablespace




================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=================================================================

==============


-------------------------------











=================================================================

==============


---------------------



following

manual steps




successful













=================================================================

==============


-------------------------------








Email (Default )














=============================================================

==================


-------------------------------








=============================================================

==================


-------------------------------



appear

=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes



2- No


DEFAULT





=================================================================

==============


------------------------


Install Components

Console Identity Service and Integration Service

Install Folder

rootKonyFabric



Application Server

ltApp Servergt


ltHostnameIP Addressgt

Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names

konyidconfigdb1 konymfconsoledb1 amp konymfaccountsdb1



=================================================================

=======

Ready To Install

-----------------------------------------




system


homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------




homeuser1KonyFabric



















authenticated








6123 JBoss Domain Mode (Multinode) Installation

This section of the document provides you with the instructions for installing and configuring the Kony

Fabric Console onmultinode

To install Kony Fabric Console using the installer follow these steps

1 Switch to the user that you created by executing the following command

su - username

2 Press Enter The system prompts you to enter the password





Linux




Unpacking the JRE


archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction



------------


of Kony Fabric


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required





have the SSL

certificate












tm






httpsupportkonycom






THE

DEFAULT


JBoss servers


=================================================================

=======

License Agreement

-----------------


the


KONY INC





AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE


8 Press Y to accept the agreement The Installation Type details appear







=================================================================

==============

Installation Type

-----------------

Please select whether to perform a new installation or upgrade an

existing

installation

-gt1- New Installation

2- Upgrade an existing installation


DEFAULT




=================================================================

==============

Licensing Type

--------------

Installation environment is set to Development by default Please

select the

appropriate type based on your license

Select Development for single machine instance Non-Production for

larger

environments like QA or UAT and Production for the production

instance

1- Development

2- Non-Production

-gt3-

Production


DEFAULT






=================================================================

==============


--------------

------------





-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------










as APIs







front-end app






-gt1- Console






DEFAULT



















Kony Fabric Console


Enter



Reports Database











For example











=================================================================

======

Install Folder

---------------------





characters



rootmfdomainmode

INSTALL FOLDER IS rootmfdomainmode

IS THIS CORRECT (YN) y


13 Press Enter to continue the installation The Application Server details appear

=================================================================

==============

Application Server

------------------




-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT

14 In the Application Server choose 2


=================================================================

==============

Installation Mode

-----------------







-gt1- Standalone Mode (Single Node)

2- Standalone Mode (Existing)

3- Domain Mode

(Multi Node)




DEFAULT



Installing Kony Fabric on JBoss - Single Node

To install Kony Fabric on single node on JBoss that is installed on your machine choose 2-

Standalone Mode (Existing) For more details refer to refer to Installing Kony Fabric on

Existing JBoss - Single Node

16 In the InstallationMode type 3 and press Enter The Application Server Details details appear

The Application Server Details details will appear with the following details if have selected All


=================================================================

=======


--------------------------

Please enter the details of preconfigured JBoss cluster The

default value is

IP address of this machine

Master node hostnameIP address should not be 127001 0000

or localhost

It should be a public IP address or a fully qualified domain name

(FQDN)



Fully Qualified Public URL of Kony Fabric(Default ) httpltIP

addressportgt

Master Node HostnameIP Address (Default ) ltIP addressgt

Master Node Management Port (Default 9999) 9999

Master Node HTTPHTTPs Port (Default8080) 8081

User (Default master)



communication

l Master Node HostnameIP Address Enter public HostnameIP of JBossmaster node

Themaster node should be accessible from your installation system

l Master Node Management Port Enter native port of JBossmaster node

l Master Node HTTPHTTPs Port Enter port of Kony Fabric Console

l User Enter user that you configured inmaster node of JBoss cluster

18 Press Enter The installer prompts for JBossMaster Node Users Password details as follows



=================================================================

=======

JBoss Master Node Users Password

---------------------------------


19 Type the password that you configured inmaster node of JBoss cluster The Server Groups

details appear

=================================================================

==============

Server Groups

-------------

A server group is set of server instances that will be managed and

configured

as one In a managed domain each application server instance is a

member of a

server group Please select the server groups from below mentioned

list of

available server groups to which you would like to deploy this

application

1 main-server-group

2 other-server-group



Enter comma separated server groups number you want to use (eg

12 or

all) (Default all)

20 Enter server groupswith a comma separated - for example 1 2 shown above

The Selected Server Group details appear

=================================================================

==============

Selected Server Group

---------------------

You have selected below mentioned server groups

1 main-server-group


-gt1- Continue with installation

2- Go back to select again


THE

DEFAULT



21 Press Enter The installer prompts the Database Choice details as follows

=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT



=============================================================

===========


-----------------------------------------





Port (DEFAULT 3306)









example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57



=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1521)








to 1521 for oracle




user




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------






=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------





l Data Tablespace






================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1433)

Username 9Default )









1433 for SQL


example dbclient




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )

DB2 JDBC Driver Path (Default ) rootPatchTestdb2jcc4jar

DB2 JDBC Driver licence path (Default )

rootPatchTestdb2jcc_license_cujar


and JBoss servers






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again





l LOB Tablespace Enter the name for LOB tablespace If input for

LOB Tablespace is not provided then the value will be set to the



=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------




23 Press Enter The Database name prefix and suffix details appear Enter the following details

=================================================================

==============


-------------------------------








24 Enter the prefix and suffix for the database and press Enter The Pre-Installation Summary

details appear

=================================================================

==============




------------------------


Install Folder

rootKonyFabric

Components

Console

and Identity Services

Installation Mode

Domain Mode

Fully Qualified Public URL

httpslthostnamegt

Master Node HostnameIP Address

lthostnamegt

Database Server



ltIP addressgt

Database Names

konyidconfigdb konymfconsoledb amp konymfaccountsdb


25 Press Enter The Ready To Install details appear

=================================================================

=======

Ready To Install

-----------------------------------------


system


homeuser1KonyFabric




26 Press Enter The Installing details appear

=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------


homeuser1KonyFabric


Identity Services URL https00000000portauthService

Integration Services URL https00000000portadmin











Important After installing Kony Fabric ensure that you import your SSL certificate in ltJAVA_

HOMEgtjrelibsecuritycacerts of all nodes of the JBoss cluster


authenticated












Log Location for Multinode Installation

For Tomcat

If you select domainmode (multi node) in the InstallationMode option the logs folder will be created at

the following locations







l For Kony Fabric Integration ltROOTgtkonymflogs

o If you install Integration Service the konymflogs folder has five log files They are

adminlog (for admin) datasource-payloadlog (for datasource) device-

payloadlog (for device) downloadlog (download) and middlewarelog

(middleware)



l For Kony Fabric Engagement Services ltROOTgtkmslogs log folder contains these log files




For JBoss















(middleware)






ltJBoss_Install_DIRgtstandalonelog

For WebLogic














(middleware)



Note Based on the combination of components selected during installation

the ltROOTgtkonymflogs folder will have log files for each component

l For Kony Fabric Engagement Services ltROOTgtkonymflogs log folder contains these log













For WebSphere











l For Kony Fabric Integration ltInstallDrivegtkonymflogs




(middleware)



n For example onWindows if an admin installed Kony Fabric in C Drive product



the ltInstallDrivegtkonymflogs folder will have log files for each component

l For Kony Fabric Engagement Services ltInstallDrivegtkonymflogs log folder contains these

log files kmslog and kms-messageslog



613 Installing Kony Fabric on WebLogic - Console-mode






Fabric Console








To install Kony Fabric Console on WebLogic using the installer follow these steps


su - username




Linux




Unpacking the JRE


archive




Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric


services


support all of


scalable and


dramatically reduce





prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom




THE

DEFAULT


=================================================================

=======

License Agreement

-----------------




the


KONY INC



AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS




INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type

--------------





grade environment



1- Production

2- Non-Production

-gt3- Development


DEFAULT




=================================================================

==============


--------------

------------





-gt1- Yes



2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs







front-end app








-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT

12 In the Application Server type 3 and press Enter installation The Application Server Details

details for WebLogic appear

=================================================================

==============


--------------------------

Please enter the details of your existing WebLogic server

Fully Qualified Public URL of Kony Fabric (Default )



HostnameIP Address of WebLogic Administration Server (Default

test201)

WebLogic Administration Port (Default 7001)

WebLogic Administration Server User (Default weblogic) back

a Enter the following details for WebLogic Server

l Fully Qualified Public URL of Kony Fabric (Default ) Enter load balancer URL

to use public communication

l IP AddressHostname of WebLogic Management Server (Default

10102451) Enter IP AddressHostname of theWebLogicManagement Server

l WebLogic Management Port (Default 7001) Enter native port of WebLogic

Management Server

l WebLogic Management Server User (Default weblogic) Enter the log-in

username for WebLogicManagement Server

b Press Enter The installer prompts for WebLogicManagement Server User Password

details as follows

=============================================================

==================

Weblogic Management Server User Password

--------------------------




c Enter the log-in password for WebLogic server and press Enter The Server Groups

details appear

=============================================================

==================

Server Groups

-------------

A server group is set of server instances that will be

managed and configured

as one In a managed domain each application server instance

is a member of a

server group Please select the server groups from below

mentioned list of

available server groups to which you would like to deploy

this application

1 AdminServer

Enter comma separated server groups number you want to use

(eg 12 or

all) (Default all)

d Enter server groupswith a comma separated - for example 1 2 shown above


=============================================================

==================




---------------------


1 AdminServer



ENTER THE NUMBER OF THE DESIRED CHOICE OR PRESS ltENTERgt TO

ACCEPT THE

DEFAULT

13 Press Enter The following details appear for WebLogic connector Jar

l If you want to install Kony Fabric onWebLogic with MS SQL youmust place the SQL

connector jar ( mssql-jdbc-700jre8) in theWebLogic Server path

For more details follow these steps

=============================================================

==================


---------------------

Please read before continuing



To use Kony Fabric with WebLogic Server in combination with

MS SQL database

place the SQL connector jar ( mssql-jdbc-700jre8) in the

WebLogic Server

Perform the following steps to complete pre-requisites before

continuing with

installation -

1 Copy the mssql-jdbc-700jre8 from your Kony Fabric

Installation folder ndash

rootKonyFabric location

2 Paste the mssql-jdbc-700jre8 into the ltWL_

HOMEgtserverlib folder

3 Go to the ltWL_HOMEgtoracle_commoncommonbin and edit the

commEnv file

- For Windows commEnvcmd

- For Linux commEnvsh

4 Prepend your JAR file to the WEBLOGIC_CLASSPATH

environment variable



For Example

set WEBLOGIC_CLASSPATH=WL_HOMEserverlibmssql-jdbc-

700jre8JAVA_HOMElibtoolsjarPROFILE_

CLASSPATHANT_CONTRIBlibant-contribjarCAM_

NODEMANAGER_JAR_PATH


Note ltWL_HOMEgt is the folder where WebLogic is installed

DESIRED CHOICE OR PRESS ltENTERgt TO ACCEPT THE

DEFAULT

l If you want to install Kony Fabric onWebLogic with DB2 youmust place the DB2

connector jar (db2jcc4jar) in theWebLogic Server path


=============================================================

==================


---------------------



DB2 database

place the DB2 connector jar (db2jcc4jar) in the WebLogic



Server


continuing with

installation -

1 Copy your db2jcc4jar and paste it into the ltWL_



commEnv file





For Example

set WEBLOGIC_CLASSPATH=WL_

HOMEserverlibdb2jcc4jarJAVA_

HOMElibtoolsjarPROFILE_CLASSPATHANT_






IMPORTANT INFORMATION COMPLETE PRESS ltENTERgt TO CONTINUE


=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2


DEFAULT



=============================================================

===========


-----------------------------------------





Port (DEFAULT 3306)









example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57





=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)








to 1521 for oracle






user


as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------






=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------







l Data Tablespace




================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1433)

Username 9Default )









1433 for SQL


example dbclient




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=================================================================

==============


-------------------------------










17 Enter the prefix and suffix for the database and press Enter The Important Information details

appear

=================================================================

==============


---------------------



following

manual steps




successful





18 Press Enter The Kony Fabric server startup details appear

=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes

2- No


DEFAULT





=================================================================

==============


------------------------




Installation Type

New Installation

Install

Components



Install Folder

rootKonyFabricInstaller-GA-8410

Application Server

WebLogic 12c (122120)


HostnameIP Address Port 7001 User weblogic



Database Choice

MySQL 57

Database Details


Database Names

premfconsoledbinstall premfaccountsdbinstall

premfreportsdbinstall preidconfigdbinstall preadmindbinstall

and prekpnsdbinstall



=================================================================

=======

Ready To Install

-----------------------------------------




system


homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------




homeuser1KonyFabric

















authenticated










614 Installing Kony Fabric on WebSphere - Console-mode




Fabric Console










To install Kony Fabric Console on WebSphere using the installer follow these steps


su - username




Linux




Unpacking the JRE


archive


Launching installer

=================================================================

==============




------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -




SQL Server

and DB2 are the


only


have all required



have the SSL

certificate












tm








httpsupportkonycom




THE

DEFAULT


=================================================================

=======

License Agreement

-----------------


the


KONY INC





AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE









=================================================================

==============

Licensing Type

--------------

To upgrade your existing instance for Kony Fabric provide the

Database

details of your existing instance The Database schema will be

updated to the

latest version no application data will be lost





grade environment

1- Production

2- Non-Production



-gt3- Development


DEFAULT




=================================================================

==============


--------------

------------





-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components



------------------








as APIs







front-end app






-gt1- Console

























Kony Fabric Console


Enter





Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters





as follows

=================================================================

==============

Application Server

------------------




-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT

12 In the Application Server choose 4 and press Enter the Application Server Details details for

WebSphere appear

Important While installing Kony Fabric onWebSphere if you face any issues refer to

httpdocskonycomkonylibrarykonyfabricresourceswebsphere_faqshtm

=================================================================

==============


--------------------------

Please enter the details of preconfigured WebSphere server

To see information such as ports in the Administrative console

select



Servers gt Server Types gt WebSphere application servers gt [Server

Name] gt

Communication gt ports


HostnameIP Address of WebSphere Administration Server (Default

101025

251)

WebSphere SOAP Connector Port (Default 8880)

WebSphere Administration Server User (Default wasadmin)

a Enter the following details for WebSphere Server



l HostnameIP Address of WebSphere Administration Server (Default

101025251) Enter IP AddressHostname of theWebSphere Administrator

Server

l WebSphere SOAP Connector Port (Default 8880) Enter SOAP connector port

of WebSphere Server

Port details for a particular server can be contained from the Server Configuration

page as shown in the following



l WebSphere Administration Server User (Default wasadmin) Enter the log-in

username for WebSphere Administrator Server

b Press Enter The installer prompts forWebSphereManagement Server User

Password details as follows

=============================================================

==================

WebSphere Management Server User Password

--------------------------




c Enter the log-in password for WebSphere Administrator Server and press Enter The

Keystore Details of WebSphere details appear

=============================================================

==================

Keystore Details of WebSphere

-----------------------------

Please enter keystore file location of your preconfigured

WebSphere server

This is needed to create the remote connection to your

WebSphere server

Keystore file location (Default ) downloadskeystore_

truststoreDummyClientKeyFilejks

d Enter the Keystore file location and press Enter The installer prompts for Password

Keystore Details of WebSphere details as follows

=============================================================

==================


-----------------------------

Please provide password of keystore

e Enter the password for Keystore file location and press Enter The installer prompts for

Trustore Details of WebSphere details as follows



=============================================================

==================

TrusStore Details of WebSphere

-----------------------------

Please enter truststore file location of your preconfigured

WebSphere server


WebSphere server

Truststore file location (Default ) downloadskeystore_

truststoreDummyClientTrustFilejks

f Enter the truststore file location and press Enter The installer prompts for Password for

Truststore for WebSphere details as follows

=============================================================

==================


-----------------------------

Please provide password of truststore

g Enter the password for truststore file location and press Enter The Server Groups

details appear

=============================================================

==================

Server Groups

-------------

A WebSphere server group is a set of application servers that



you manage

together as a way to balance workload This will usually

affect more than a

single node instance Select a standalone server or a cluster

from the available

server groups displayed Please make sure the standalone

server you select is

not a part of any cluster

1

WebSpherecell=KH2013Node01Cellnode=KH2013Node01server=serv

er1

Enter server groups number you want to use (eg 1 or 2)

(Default 1)

h Enter server groupswith a comma separated - for example 1 2 shown above


=============================================================

==================


---------------------


1




er1




ACCEPT THE

DEFAULT

i If themaximumheap size is less than 6GB the following error message appears

=============================================================

==================

Insufficient maximum heap size

------------------------------

Please make sure that JVM maximum heap size is set atleast

6GB


Note You can choose to continue with the installation by accepting and pressing

ENTER to avoid roll back during installation due to the OutofMemory warning

when all the components are selected


=================================================================

=======

Database Choice

-----------------------------------------




-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2


DEFAULT



=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57



=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1521)








to 1521 for oracle




user


as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------






=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------





l Data Tablespace






================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL




example dbclient




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=================================================================

==============


-------------------------------

Please enter database name prefix and suffix If prefix is Kony

and suffix is 1 then database names will be KonyXXXXX1 Please

provide existing prefix and suffix if you intend to upgrade to the

new Kony Fabric Database







16 Enter the prefix and suffix for the database press Enter The Important Information details

appear

=================================================================

==============


---------------------



following

manual steps




successful





If a database exists the system displays the warningmessage One or more databases

already exist Do you want to use existing databases If yes then

the schema may be upgraded shown below

Important If you are installing Kony Fabric V8 on an application server using the existing

database and in case if there is a change in server details youmust update the

management_server details in the admin database with the application server instance

details for theWebAapp publish to work Youmust update the following fields in the

server_configuration table of the admin DB

- management_server_host_name ltapplication_instance hostnamegt

- management_server_port ltsoap port of application_instancegt

- management_server_user ltapplication_instance admin usernamegt

- management_server_password ltapplication_instance admin passwordgt

- management_server_groups ltapplication_instance groups detailsgt

17 Press Enter

The Kony Fabric server startup details appear

=================================================================

==============


-----------------------------------


installation of



Kony Fabric

-gt1- Yes

2- No


DEFAULT





=================================================================

==============


------------------------


Install Components


Install Folder



rootKonyFabric

Application Server

ltApp Servergt



Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names




=================================================================

=======

Ready To Install

-----------------------------------------




system


homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------




homeuser1KonyFabric



















authenticated








62 Installing Kony Fabric - Silent-mode

Kony Fabric can also be installed through UnattendedSilent Installation process




Fabric Console










To install Kony Fabric UnattendedSilent Installation follow these steps

1 Download KonyFabricSetuptargz file from httpcommunitykonycomdownloads and

extract the file

2 Open the Linux terminal and navigate to the location where the installer is located

3 Open the installerproperties file and provide inputs for the required properties You

can follow the comments in the properties file for more details

4 Save the installerproperties file

5 At the prompt type KonyFabricInstaller-8xxxGAbin -f

rootinstallerproperties -i silent and press Enter

Note If the file name is installerproperties and is in the same location as KonyFabricInstaller-

8000GAbin file then the option -f is not required in the silent installation But if the file name is

changed to other than installerproperties then youmust use -f option irrespective of file location


7 Installing Kony Fabric on IBM AIX Kony Fabric Installation Guide - LinuxVersion111

7 Installing Kony Fabric on IBM AIX

Kony Fabric is supported for install on IBMAIX Operating SystemVersion 7200 Currently Kony

Fabric support is available on IBMAIX withWebSphere


Fabric components

The primary purpose of Kony Fabric installer user interface is to display information to a user prompt

the user for information needed to install and configure Kony Fabric components on the system Kony

Fabric installer user interface also displays information about the progress of system changes as they

are installed This section explains new installation on the IBM AIX platform

Important You need the required hardware and access to the supporting software asmentioned

in the Prerequisites section

Make sure that you have proper administrative rights to install Kony Fabric on your computer with

Server Administrator privileges required to run the Kony Fabric Installer

71 Prerequisites

Before you install Kony Fabric on AIX ensure that youmet the following

l Set AIX Locale to UTF8

l Minimum space required at root - 5GB

l Minimum space required at tmp - 5GB

l IBM JAVA 17 required for installingMobileFabric 73

l IBM JAVA 18 required for installing Kony Fabric V8

72 Download Kony Fabric installers for AIX platform

The following files are required to install Kony Fabric components on IBMAIX



Note Please contact supportkonycom for approval and to obtain access to download the Kony

Fabric install artifacts for AIX platform

l KonyFabricInstaller-Console_Identity_Engagementzip to install Console

Identity Services and Engagement Services (required to install Kony Fabric Console)

l KonyFabricInstaller-Serverzip to install Integration Services


Note Before stating installer - run getServergroup utility and confirm server group showing as

expected

1 Extract the installer from KonyFabricInstaller-Console_Identity_

Engagementzip that you downloaded and navigate to the folder

2 Grant execute rights to KonyFabricInstallerbin file

3 Run the LAX_VM command to run the Installer

For example KonyFabricInstallerbin LAX_VM ltIBM JAVA LOCATIONgt

74 Post Installation

After a successful installation perform the following steps to work Kony Fabric Console properly on

AIX

1 Go to your WebSphereWAR deployment location

2 Remove the javassist-3200-GAjar in the adminwar

3 Remove the javassist-3200-GAjar in the kpnswar

4 Restart WebSphere Server

5 Start Kony Fabric Console war fromWebSphere admin console





75 Upgrading Kony Fabric

Perform the following actions to upgrade your Kony Fabric instance

1 Take a backup of the existing Database

2 Download and Extract the Kony Fabric Installer






5 Provide the sameDatabase name prefix and suffix details as provided during the initial

installation when the installer prompts

6 Select Yes when the installer prompts to Use an existing Database


8 How to Stop and Start Kony Fabric Kony Fabric Installation Guide - LinuxVersion111

8 How to Stop and Start Kony Fabric

After you install Kony Fabric youmust restart your application server to take effect all installed

configurations

81 Tomcat Server

To stop and start Tomcat Server follow these steps

l Stop server AppServer Locationtomcatbin gt shutdownsh

l Start server AppServer Locationtomcatbin gt startupsh

82 JBoss Server

To stop and start JBoss Server follow these steps

1 Stop server Kill running Kony Fabric on JBoss service using command in Linux

2 Start server [rootFabric83JBOSSSINGLEjbossbin] startjbosssh

821 For Multinode - JBoss

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

Management Console from themaster node

For more detailed information on administration of the app server refer to the JBoss Server

Documentation

83 WebLogic Server

To stop and start WebLogic Server follow these steps



1 Stop server WebLogic InstallationUser Projectsdomain_

namebingtstopWebLogicsh

2 Start server WebLogic InstallationUser Projectsdomain_

namegtstartWebLogicsh

For more detailed information on administration of the app server refer to theWebLogic Server

documentation

84 WebSphere Server

To stop and start WebSphere Server follow these steps

1 Stop server WebSphere Instalaltion

AppServerprofilesAppSrvltnumbergtbingtstopServersh

2 Start server WebSphere Instalaltion

AppServerprofilesAppSrvltnumbergtbingtstartServersh

For more detailed information on administration of the app server refer to theWebSphere Server

documentation


9 Upgrading Kony Fabric Kony Fabric Installation Guide - LinuxVersion111


This section explains upgrading Kony Fabric Components through the installer For upgrade to work

minimum installation version should be KonyMobileFabric 652GA

l Upgrading Kony Fabric using V8 You can upgrade an existing Kony Fabric instance in the

following two ways

l Upgrade the existing instance

l Install Kony Fabric afresh with connecting to the existing database

l Upgrading Kony Fabric using V8 SP2 onwards FromKony Fabric V8 SP2 onwards the

upgrade support is not available You can install Kony Fabric afresh with connecting to the

existing database

91 Prerequisites for Upgrade from MobileFabric 7x to Kony Fabric 8x

While upgrading fromMobileFabric 7x to Kony Fabric V8x Follow these steps

Remove the version_rank column from the schema_version table in the authglobaldb by

passing the following queries before the upgrade

l Oracle

DROP INDEX schema_version_ir_idx

DROP INDEX schema_version_vr_idx

ALTER TABLE schema_version DROP constraint schema_version_pk

drop index

ALTER TABLE schema_version DROP COLUMN version_rank

ALTER TABLE schema_version modify(version null)

ALTER TABLE schema_version add constraint schema_version_pk

primary key(installed_rank)

l MySQL



ALTER TABLE schema_version DROP INDEX schema_version_vr_idx

ALTER TABLE schema_version DROP INDEX schema_version_ir_idx

ALTER TABLE schema_version DROP PRIMARY KEY


ALTER TABLE schema_version CHANGE version version VARCHAR(50)

ALTER TABLE schema_version ADD PRIMARY KEY (installed_rank)

l DB2



ALTER TABLE schema_version DROP CONSTRAINT schema_version_

pk

ALTER TABLE schema_version drop column version_rank

ALTER TABLE schema_version ALTER COLUMN version DROP NOT

NULL

REORG TABLE schema_version

ALTER TABLE schema_version ADD CONSTRAINT SCHEMA_VERSION_PK

PRIMARY KEY(installed_rank)


l MS SQL Server

DROP INDEX [schema_version_ir_idx] ON [dboschema_version]

GO

DROP INDEX [schema_version_vr_idx] ON [dboschema_version]

GO

ALTER TABLE [dboschema_version] DROP CONSTRAINT [schema_

version_pk]

GO

ALTER TABLE [dboschema_version] DROP COLUMN [version_rank]

GO



ALTER TABLE [dboschema_version] ADD CONSTRAINT [schema_version_

pk] PRIMARY KEY CLUSTERED ([installed_rank])

GO

ALTER TABLE [dboschema_version] ALTER COLUMN version nvarchar

(50) NULL

GO

92 Upgrading Kony Fabric using V8



l If you are upgrading from MobileFabric 652GA the installer supports upgrading of

Console Identity services and Integration services only

l If you are upgrading from MobileFabric 70GA or higher the installer supports upgrading

of Console Identity services Integration services and Engagement Services

Important The Installer does not support automatic backups of database and other artifacts The

Installer does not support rollback in case of a failure during the upgrade

- Youmust take backup of your database and other artifacts before upgrading

- After the upgrade republish your Kony Fabric applications



Important You need to upgrade Kony Fabric installation from themaster node



921 Prerequisites

l You can download the Kony Fabric Installer 80 from httpcommunitykonycomdownloads

with your credentials

l Ensure that KonyFabricInstallerbin (xx) file has execute permission

To upgrade Kony Fabric Console using the installer follow these steps


su - username




Linux

5 Start the KonyFabricInstallerGAbin file by executing the following commandKonyFabricInstaller-GAbin



Unpacking the JRE


archive


Launching installer



=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -



1 Database server with admin user for installation Supported

database server

are MySQL Oracle and MS SQL Server

2 If you want to use existing SSL certificate then have it

ready

3 If you want to install in JBoss domain mode or WebLogic or

WebSphere then have the application server preconfigured





tm





httpsupportkonycom






THE

DEFAULT

6 To continue the installation type 1 and press Enter Otherwise to abort type 2 and press

Enter The Software License Agreement details appear

=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS


THE I




ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE


7 Press Y to accept the agreement TheGet User Input details appear

=================================================================

======

Get User Input

------------------

Please select whether to upgrade an existing installation or do a

new

installation

Console and Identity Services are mandatory components of Kony

Fabric In a



development scenario all components can be installed on the same

box However

it is recommended to install these components on separate boxes

for production

environment


-gt2- Upgrade an existing installation


DEFAULT 1

8 Type 2 and press Enter to continue the installation The Previous Install Folder details appear

=================================================================

======

Previous Install Folder

---------------------

Please provide the location of the existing MobileFabric component

that you

wish to upgrade to this version

Please take a backup of your database and other artifacts before

upgrade The

installer does not support rollback and does not take automatic

backups

Please republish your Kony Fabric application after installing

your upgrade



Location of the existing install (Default ) rootUP652TO70



9 Provide the location of the existingMobileFabric component that you wish to upgrade to this

version and press Enter The Pre-Installation Summary details appear

=================================================================

==============


------------------------


Install Type

Upgrade Installation

Install Components

Console Identity Services and Integration Services

Install Folder

rootUP652TO70

Application Server



ltApp Server Installation Modegt



Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names




The installer takes backup of the current install folder The backup folder will have a suffix of _

previous_installed_version Press Enter to complete the upgrade

=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]



[------------------|------------------|------------------|-------

-----------]

=================================================================

==============

Backup completed

----------------

Backup of user install directory has been completed successfully

In case of

any failure during installation please rename this back up folder

rootUP652TO70_652GA to rootUP652TO70 before you continue


------------------|------------------|------------------|---------

---------]


=================================================================

=======


-----------------------------------------




rootUP652TO70











93 Upgrading Kony Fabric to V8 SP4





Important The new Kony Fabric Upgrade processworks by upgrading the current database to

the latest version and by installing fresh application server artifacts

l For bundled Tomcat or Standalone JBoss - Stop the running application server A new

application server will be configured as a fresh installation Ensure that you provide the

same prefix suffix Hostname and IP ports as of the previous install

l For remote servers like Pre-Configured JBoss Multi-Node JBossWeblogic or

WebSphere - Delete the existing Applications and Datasources

Additionally for WebSphere youmust also delete the database provider and shared

library







- Youmust back up of your database and other artifacts before upgrading





931 Prerequisites

l You can download the Kony Fabric Installer from httpcommunitykonycomdownloadswith

your credentials




l Ensure that you have the path of your Previous Install Directory


1 Ensure that you stop the application server of your existingMobileFabricKony Fabric instance

which you want to upgrade


su - username




Linux


7 Continue the installation until you reach the Database Choice screen

Note Upgrade steps for Kony Fabric until the Database Choice section are same that as a

fresh installation

For more details on how to install Kony Fabric components on an application server with a

database refer InstallationModes - Kony Fabric

8 From the Please select the database provider of your choice choose one of the databases to

display database details and fill the details

=================================================================

=======

Database Choice

-----------------------------------------




-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT

9 Enter the database server details such as hostname port user and password


=================================================================

==============


-------------------------------

Please enter database name prefix and suffix

If prefix is Kony and suffix is 1 then database names will be

KonyXXXXX1



Please provide existing Prefix and Suffix if you intend to upgrade

to the new


Database Name Prefix (Default )

Database Name Suffix (Default )

l Database NamePrefix Enter the prefix of an existing Kony Fabric database - for

example Kony

l Database NameSuffix Enter the suffix of an existing Kony Fabric database- for

example 1

11 Press Enter TheWarningmessage appears

=================================================================

==============

Warning - Database already exists

---------------------------------

One or more databases already exist Do you want to use existing

databases

If yes then the schema may be upgraded

-gt1- No Go back



2- Yes Use existing


THE

DEFAULT 2

12 Press 2 to accept use existing database TheWarningmessage appears

=================================================================

==============

Copy encryption keys and other required data from prior Kony

Fabric instance

You can skip this now and manually update your instance after the

installation

is complete

1- SKIP

-gt2- OK


DEFAULT

13 Press 2 to update the encryption keys and other required data from your existing Kony Fabric



Instance

=================================================================

==============

Previous Installation Directory

-------------------------------

Please choose the previous installation directory

Previous Installation Directory (Default root)

=================================================================

==============


----------------------------------


installation of

Kony Fabric

-gt1- Yes

2- No




DEFAULT

If you choose to skip providing the keys go to your upgraded Kony Fabric install location and

paste the following details that you copied from the previousMobileFabric install folder

l authServicekey

l workspaceServicekey

l ACCOUNTS_ENCRYPTION_KEY

Restart or redeploy the war components after you update the keys

14 Press Enter Skip the Administrator Account Configuration details

While installing Kony Fabric using an existing database youmust not configure your super

administrator account again

Note You can directly log in to Kony Fabric Console using the existing credentials after a

successful upgrade

15 If you do not skip configuring the Administrator Account Configuration details the following

screen appears

=================================================================

==============

AdministratorAccount Configuration

-------------------------------




Name Last Name Email Address and Password We use your email

address as a login name and we do not use it to send unsolicited

emails



Latest Name (Default )

Email (Default )



Note The existing schemas and upgraded for the new instance The databases for the

selected components are created based on the prefix and suffix that you provided

=================================================================

==============


------------------------


Install Type




Install Components


Install Folder

rootUP652TO70

Application Server




Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names

konyxxxx1 konyxxxx1 konyxxxx1 amp konyxxxx1





=================================================================

=======


-----------------------------------------


rootUP652TO70




Engagement Services URL https000000000portkpns










19 You can now access Kony Fabric Console by using the URLs For more details refer to


94 Upgrade from Kony Fabric V8 SP2 to V8 SP4

Before upgrading to V8 SP4 run the following scripts for your database

l Oracle

delete from ltadmindbgtschema_version where script = V621__

konyadmin-oracle-8200sql

l MySQL


konyadmin-mysql-8200sql

l DB2


konyadmin-db2-8200sql

l MS SQL Server



95 Upgrading Custom Metrics Component

FromV9 onwards the custom_metrics_master table has beenmade independent by adding the

application related columns in the custom_metrics_master table itself for better performance These

columns are available as part of themiddleware_requests tableTo have the data for these new fields

for the existing records in the custom_metrics_master table migrate the data from themiddleware_



requests table To do so follow these steps

1 Connect to reports DB and check if theMIGRATEDATATOCMMTABLE procedure is created

It is created when Kony Fabric V9 is installed or upgraded to V9

2 Execute the following procedures for the Fabric database that you have installed

l MySQL CALLMIGRATEDATATOCMMTABLE()

l Oracle EXECUTEMIGRATEDATATOCMMTABLE

l SQL Server EXEC MIGRATEDATATOCMMTABLE

This proceduremigrates the data for new columns of existing rows in the custom_metrics_

master table To do this it creates an intermediate table

3 After the procedure is executed for one of the rows in the custom_metrics_master table check if

the data is populated for the new columns

Note You can now create the custom reports by pulling the columns from the CustomMetrics

view itself If you do not migrate the data the data for the new columnswill not be available

For more information about custommetrics refer to CustomMetrics


10 Installing Hotfix Archives for Kony Fabric - Linux Kony Fabric Installation Guide - LinuxVersion111

10 Installing Hotfix Archives for Kony Fabric - Linux

The Kony Fabric Patch Installer can be used to apply patches (software updates) to Kony Fabric

components for a specific GA release The Patch Installer supports applying patches from

MobileFabric 701 (GA) onwards

For example

To apply any 701x patches to versions below 701 GA (MobileFabric 70 GA o r 65x) you need

to upgrade from V 65x or V 70GA to 701 GA by using the installer and then apply

701x patches

The Patch Installer uses hotfix archives and applies the software updates to an existing Kony Fabric

Installation A hotfix archive (which is a zip file) file can have artifacts for one or more components

While installing hotfix archives all components in the zip are installed to your existing Kony Fabric

installation

101 Patch Installer GA Versions

The followingGA versions are supported for patch installer and hotfix archives

l 701 GA

l 71 GA

l 72 GA

l 73 GA

l V8

l V8 SP2

l V8 SP3 FP1



102 Prerequisites

l Ensure that you have a previous version of Kony Fabric GA installed on your system at an

accessible network location

Important If you are required to install hotfix archives to a set of components for a specific

release youmust have the supported Kony Fabric GA version (for example MobileFabric

701) with required components installed on your system

For example if you are required to install hotfix archive for Console version V 701 you

must have theMobileFabric 701 GA with Console installed on your system

l Download the patchinstaller(binary) and hotfix archives from

httpcommunitykonycomdownloadsmanual with your credentials

l Ensure that KonyFabricPatchInstallerbin file has execute permission

To download Kony Fabric Patch Installer and hotfixes follow these steps

1 Log in to httpcommunitykonycomdownloadsmanual You can obtain a user name and


2 Navigate to the Kony Fabric section

3 From the Kony Fabric Patch Installer select the specific release from the Version drop-down

list and then click on the specific release related files you want to download based on your

platform (Windows or Linux)

For example if you want to downloadKony Fabric Patch Installer 80 GA

select the80 GA version from the drop-down list and then click the Installer_Linux link

4 For the required hotfix components select the specific release from the Version drop-down list



and then click Download The following is a sample screen

To install Kony Fabric patch using the installer follow these steps


su - username



4 Unzip the KonyFabricSetup-8xxGAtargz file and navigate to the KonyFabric_

Patch_Installer_Linux folder



5 Start the KonyFabricPatchInstaller-8xxGAbin file by executing the following

commandKonyFabricPatchInstaller-8xxGAbin

[rootmbaastest11 ~] chmod +x KonyFabricPatchInstaller-

8xxGAbin

[rootmbaastest11 ~] KonyFabricPatchInstaller-8xxGAbin



archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


6 To continue the installation press Enter The Introduction page appears asking for following

details Enter the details to proceed with the upgrade



l Please provide the location of the patch file Provide the patch file location of the Kony

Fabric component that you wish to install to current version For example samplezip

l Please provide the location of existing installation The default install location appears

in this field

Provide the location of existing Kony Fabric installation that you wish to upgrade with the

selected patch version

=============================================================

==================

Introduction

------------

Thank you for choosing to upgrade Kony Fabric

Please provide the below details to proceed with the upgrade

Please provide the location of the patch file (Default )

rootsamplezip

Please provide the location of existing installation

(Default ) rootMFJB6525132

7 Press Enter The Pre-Installation Summary details appear

=================================================================

==============


------------------------



This patch will update the following components

ltList of componentsgt

To see detailed release notes please refer

httpdocskonycomkonylibrarykonyfabrickony_fabric_release_

notesDefaulthtm

A copy of your installation will be placed in rootltPrevious-

MobileFabric-install-folder_PatchNamegt

To revert to the previous version of your installation please

replace the

contents from the above mentioned folder

If you accept terms and conditions httpdocskony

comkonylibrarykonyfabricresourceslicensehtm

To proceed with the update please press ldquoenter






Patch_File_Name For example if the hotfix name is KPNSXXX then the suffix of the

backup folder will be _KPNSXXX

Important The Installer does not support automatic backups of database and other

artifacts The Installer does not support rollback in case of a failure during the upgrade



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[-----------------

The Installation Complete details appear

=================================================================

=======


-----------------------------------------




rootMFJB6525132

ltList of components installedgt URL https00000000portkpns





The ltInstall Locationgt directory contains the log files logging each invocation of the installer

Tomake problem identification easier provide these log files to Konywhen reporting an issue




For troubleshooting tips to resolve problems that youmay encounter during installation refer to

the following

l FAQs and Troubleshooting

l FAQs and Troubleshooting (WebSphere)


11 Uninstalling Kony Fabric Kony Fabric Installation Guide - LinuxVersion111

11 Uninstalling Kony Fabric

This section explains how to uninstall Kony Fabric

To uninstall the Kony Fabric follow these steps

1 Go to your Kony Fabric installation location (Default location KonyKony Fabric)

2 Run Uninstall file

[rootlocalhost mfdemo] ls

jboss jre Kony_Fabric_Console_Install_01_21_2015_05_10_47log _

Kony Fabric Console_installation logs Uninstall

[rootlocalhost mfdemo] Uninstall

The following console appears

=================================================================

==============


------------------------------------------------------------------

-------------

Preparing CONSOLE Mode Uninstallation



=================================================================

==============

Uninstall Kony Fabric

-----------------------------------

Thanks for choosing Kony Fabric

You are about to uninstall Kony Fabric This will uninstall all

components It will also remove any file or folder created in

Kony Fabric installation directory


3 Press Enter

The Delete Database console displays the alert message asking if you want to delete the

database

=================================================================

==============

Delete Database

---------------

Please select whether you want to delete all Kony Fabric data

including



the database or retain data Note that you cannot recover the

data after it

has been deleted

Do you want to delete the database

-gt1- Delete all data

2- Retain all data


DEFAULT

4 To remove database type 1 and press Enter Otherwise to continue without removing the

database type 2 and press Enter

A progress console appears with the progress of Kony Fabric uninstallation

=================================================================

==============

Uninstalling

---------------



=================================================================

==============

Uninstall Complete

------------------

All items were successfully uninstalled

Kony Fabric is uninstalled


12 Post-Installation Tasks Kony Fabric Installation Guide - LinuxVersion111

12 Post-Installation Tasks

121 Configuring Secure Sockets Layer (SSL) Certificate

You can troubleshoot trusted certification issues

Important Apples App Transport Security (ATS) mandatesHTTPS for all communication and

requires the use of TLS v12 or higher for all SSL certificates and load balancers

For Apple apps to work properly and adhere to App Store guidelines youmust enable your Kony

Fabric on-premises instance with SSL and configure your network infrastructure to use TLS

version 12 or higher For more information please refer the following

httpcommunitykonycomblogsmadpapp-transport-security-ats-compliance

After installing Kony Fabric on HTTPS import your SSL certificate (for example

domainsubdomaincrt) into your Kony Fabric 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 For

details refer to Troubleshoot with SSLCertificate Issues

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

Fabric Integration Services and Kony Fabric Engagement Services follow these steps

l import each products certificate (Kony Fabric Integration Services and Kony Fabric

Engagement Services) into the Kony Fabric console (for example ltINSTALL_

DIRgtjrelibsecuritycacerts)

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

Engagement Services and Kony FabricManagement

1211 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 Kony Fabric installed system open the Linux terminal and run the following

command to generate an intermediatecrt file from the keystore

ltUSERINSTALLDIRgtjrebinkeytool -export -alias ltHOST_URL_SSL_

CONFgt -file ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtkeystorejks -storepass ltPasssword_of_keystoregt

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 the intermediatecrt certificate file into your Kony

Fabric Installers JRE trusted certificate authority (CA) certificates file

ltUSERINSTALLDIRgtjrebinkeytool -import -noprompt -trustcacerts

-alias ltHOST_URL_SSL_CONFgt -file

ltUSERINSTALLDIRgtintermediatecrt -keystore

ltUSERINSTALLDIRgtjrelibsecuritycacerts -storepass changeit

1212 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


command to add an intermediatecrt 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 the intermediatecrt certificate file into your Kony



-alias ltyourcertificate_domaingt -file



122 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 Kony Fabrics 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_


2 Make the following changes in the middlewareproperties file

l ssltrustStore=ltjava_homegtjrelibsecuritycacerts

l sslkeyStore=ltjava_homegtjrelibsecuritycacerts



123 How to Configure Memcached for Integration Services

l For KonyFabric version 73 or above you can configure thememcache fromAdmin console

To configure memcache in MobileFabric 73 or above versions follow these steps

1 Open Admin console (httphttpsltserver-hostgtltserver-portgtadmin)

2 In the left pane go to the Settings tab

3 Under the Runtime Configuration tab expand theMemcache Configuration key

4 In theMemcache Cluster field provide your memcache hostnameIP and port details

separated with a colon For example lthostnameIPgtltPortgt

5 Save the changes

l For below MobileFabric 73 you can configure thememcache using queries on konyadmindb

To configure memcache in below MobileFabric 73 follow these steps



Since UI is not available in version below 73 youmust update the property value in the server_

configuration table of KONYADMINDB database

Note Name of the KONYADMINDB depends on the suffix and prefix provided which you

provided during the installation

1 Execute the following steps

UPDATE ltKONYADMINDBgtserver_configuration set prop_value =

ltmemcache_hostnamegtrsquorsquoltmemcache_portgtrsquo created_date =

CURRENT_TIMESTAMP updated_date

= CURRENT_TIMESTAMP WHERE prop_name = memcachecluster

Verification To verify whether thememcache configuration is successfully done go to

the Health Check page and look for Access to Cache entry

Note It may take up to 5minutes for the healthcheck to reflect the cache status If you

are still unable to find the particular entry in the Health Check page try clearing the

healthcheck cache using the following URL

httpsltserver-hostgtltserver-portgtadminhealthcheckoutput=json



124 Configure Deployment of mbaasportalwar File for Multi-Node

Once Kony Fabric installation succeeds the Kony Fabric Console will not be displayed as the enable-

welcome-root value is set true in the domainxml file

To configure mbaasportalwar follow these steps

1 In themaster node open the domainxml file from

JBOSSDIRdomainconfiguration and search for enable-welcome-root=true

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

125 Remote Installation Pre-requisites

After you have installed Kony Fabric youmust retain the Installation folder for upgradesWhile

upgrading the Kony Fabric installer requires the installvariablesproperties file under the

ltUSER_INSTALL_DIRgt_Kony Fabric_installation folder



1251 Installing Kony Fabric Remotely

You can install Kony Fabric remotely on the following supported application servers

l JBossMulti-node

l JBoss Standalone Existing

l WebLogic

l WebSphere

126 How to Turn off the Send usage data anonymously feature

AllowsKony to collect product usage information tomake your Kony Fabric experience better

1 Go to the Accounts database configured for the Kony Fabric installation

2 Open the account_configurations table

3 Find the row entry in the name columnwith name as analyticsEnabled



4 Modify it to truefalse

5 Refresh Kony Fabric Console

You should be able to figure out if analytics data that is sentout by trying to check in the Network

tab in the Browser Developer Tools

127 Configuring Datasource for performance improvements for JBoss

pre-existing and Domain Mode

While using pre-configured JBoss or JBoss in DomainMode add the following snippet to the

datasource to improve the performance

ltpoolgt

ltmin-pool-sizegt10ltmin-pool-sizegt

ltmax-pool-sizegt30ltmax-pool-sizegt

ltflush-strategygtIdleConnectionsltflush-strategygt

ltpoolgt



Note For the bundled version the installer will add the default size to the datasources

128 Health Check URL

The following is the Component Health CheckURL if the initial setup is success

lthttphttpsgtltDomainnamegtltportgtmfconsolehealth_checkall

workspacepassedaccountspassedportalpassed

lthttphttpsgtltDomainnamegtltportgtauthServicev1managecheckhealth

Passed

lthttphttpsgtltDomainnamegtltportgtadminhealthcheckoutput=json

healthCheckPASSEDhealthDetail

Access to Reporting QueuePASSEDAccess to Admin

DBPASSEDAccess to Reports DBPASSEDAccess to Storage

DBPASSED

versionV8 SP2 FP1 HF1

lthttphttpsgtltDomainnamegtltportgtserviceshealthcheckoutput=json

healthDetail

appIDservicesAccess to Reporting QueuePASSEDAccess to

Admin DBPASSEDAccess to Storage DBPASSED

applicationHealthCheckPASSEDversionMiddleware Ver-

sionKonyFabricInstaller-GA-8211

lthttphttpsgtltDomainnamegtltportgtkpnsservicehealthcheckjson


Quartz jobsPASSEDAccess to Database Server-

PASSEDSecurity CredentialsPASSED

version8211_GA

129 Steps to enable SAPJCo

The installer provides the following artifacts



1 SapJCoDestinationProviderjar

2 Modulexml (for JBoss)

You can download the other artifacts libsapjco3so (for Linux) or sapjco3dll (for Windows) and

sapjco3jar from httpswebsmp204sap-agdeconnectors

The SapJCoDestinationProviderjar can be located at

l ltUSER_INSTALL_DIRgtIntegrationsapjcomain - for JBoss

l ltUSER_INSTALL_DIRgt Integration - for Weblogic andWebSphere

TheModulexml can be located at

l ltUSER_INSTALL_DIRgtIntegrationsapjcomain

1291 Steps for Tomcat

1 Navigate to ltUSER_INSTALL_DIRgttomcatlib and add the following files

l sapjco3jar

l libsapjco3sosapjco3dll

Note The SapJCoDestinationProviderjar is already placed in the ltUSER_INSTALL_

DIRgttomcatlib by the installer


1292 Steps for JBoss

For Windows Place the sapjco3dll in the jbossbin folder or CUsersltUSER_NAMEgtSystem32

folder

For Linux Place the libsapjco3so in the usrbin folder or any location on themachine and append

the path to the $LD_LIBRARY_PATH variable



12921 JBoss - Standalone (Bundled)

1 Navigate to ltUSER_INSTALL_DIRgtjbossmodulesorgsapjcomain and add the

following files

l sapjco3jar

l SapJCoDestinationProviderjar

2 Navigate to ltUSER_INSTALL_DIRgtjbossmodulesorgsapjcomain

l In modulexml under the ltresourcesgt tag add ltresource-root

path=sapjco3jargt

l In standalone-fullxml under the ltglobal-modulesgt tag add ltmodule

name=orgsapjco slot=maingt

12922 JBoss - Standalone(Pre-configured)Domain mode

1 Navigate to ltJBOSS_DIRgtmodulesorgsapjcomain and add the following files

l sapjco3jar


2 Navigate to ltJBOSS_DIRgtmodulesorgsapjcomain


path=sapjco3jargt

l In standalonexml or domainxml in the subsystem add ltsubsystem

xmlns=urnjbossdomainee40gt Add the following tag

ltglobal-modulesgt

ltmodule name=orgsapjco slot=maingt

ltglobal-modulesgt



1293 Steps for Weblogic

1 Navigate to ltWL_HOMEgtwlserverserverlib and add the following files

l sapjco3jar



2 Go to ltWL_HOMEgtuser_projectsdomainsbase_domainbin and edit the

startWeblogic script file using one of the following commands

l For Windows startWeblogiccmd

l For Linux startWeblogicsh

3 Prepend your JAR files to the SAVE_CLASSPATH environment variable

For example in startWeblogicsh add

SAVE_CLASSPATH=$WL_HOME

serverlibSapJCoDestinationProviderjar$WL_HOME

serverlibsapjco3jar$WL_HOME

serverliblibsapjco3so$CLASSPATH


1294 Steps for Websphere

1 Navigate to ltWAS_LOCATIONgtAppServerlib and add the following files

l sapjco3jar


2 Navigate to ltWAS_LOCATIONgtAppServerbin and add the libsapjco3sosapjco3dll



file



13 FAQs and Troubleshooting Kony Fabric Installation Guide - LinuxVersion111

13 FAQs and Troubleshooting

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

installation

l Issue

The upgrade installation is rolling backwith Validate failed from 8213

Workaround

Before Upgrade execute below SQL statement from admin database

For MySQL

------------



For SQLServer

---------------


konyadmin-sqlserver-8200sql

For Oracle

----------





For DB2

--------



l Issue

If you enter an incorrect password in theWebSphereManagement Server User Password field

an Unreachable Fully Qualified URL error is displayed and the error does not get resolved

even after entering the correct password

Workaround

Youmust relaunch the installer and provide the correct credentials in the first attempt

l Issue

If you upgrade the integration service or install on new server using the existing database but

with a different server details like fully qualified URL port and when you publish an app the app

publish fails

Workaround

Youmust updatemanagement server details in the server_configuration table in admin

database

l Issue

If you upgradeMobileFabric 73 or older version on JBoss (Standalone existing JBoss or pre-

configured JBoss) to Kony Fabric V8 the upgrade gets completed with errors for JBoss



Workaround

Youmust remove the database connector jar from the JBoss deployments

l How to change the HostnameIP address and port details of the existing Kony Fabric

Server

After the installation of Kony Fabric if you want to change the existing HostnameIP address

that was used during the installation of Kony Fabric follow these steps

1 Go to your Kony Fabric install folder

2 Go to scripts folder - for example ltMFinstallfoldergtscripts The scripts

folder contains a sql file for the database type that you selected while installing Kony

Fabric

3 Open the sql file in a text editor

Important If you want to access Kony Fabric Console with a new port change the

value for the NEW_PORT with the new value Otherwise assign the value of the OLD_

PORT to the NEW_PORT variable

Important If you want to access Kony Fabric Console with a hostnameIP address

change the value for the NEW_HOST with the new value Otherwise assign the value

of the OLD_HOST to the NEW_HOST variable

4 Change the values for the following variables

l For MySQL MariaDB DB2 and SQL Server replace the values for the NEW_

HOST and the NEW_PORT with new values

l For Oracle replace all the occurrences of the NEW_HOST and the NEW_PORT with

new values



Important If you have selected your database asDB2 follow the steps provided in

the sql file in the ltMFinstallfoldergtscripts folder

5 Run the SQL script on the database where you have installed Kony Fabric

l Issue

If the javasql BatchUpdateException Prepared statement needs to be

re-prepared error is logged in the Identity service logs or if certain operations fail to work

properly when an identity service is invoked do the following

Workaround

Add the following server variable in MariaDB ini file located in theMariaDB installation folder

table_open_cache=64

Path for MariaDB ini file ltUSER_INSTALL_DIRgtMariaDB 101datamyini

l Issue

If you face the error dialogue Windows error 2 occurred while loading the

Java VM while launching the Kony Fabric Patch Installer because of the following

Kony Fabric Patch Installer runswith your systems default Java If an user machine has Java 8

installed then check if themachines System Environment Path for Java or JAVA_

HOME is set to cprogramdataoraclejavajavapath

Workaround



1 Remove the current path from JAVA_HOME and set the new path as CProgramFiles (x86)Javajre180_40bin

2 Launch the Kony Fabric Patch Installer

3 After the installation completed reset themachines System Environment Path

for Java or JAVA_HOME path to its original path For examplecprogramdataoraclejavajavapath

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 installing Kony Fabric 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 increase TABLE_DEFINITION_CACHE and TABLE_OPEN_CACHEand

MAX_CONNECTIONS of your MySQL

Kony recommends a dedicatedMySQLDB Server for Kony Fabric



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

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

Fabric

In multinode environment user should be adding new node with same version of Kony Fabric

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

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

configuration

o In the accountsproperties file the ACCOUNTS_ENCRYPTION_KEY value

should be configured with the same value as in all nodes

Path for the accountsproperties fileltInstaller FoldergttomcatwebappsaccountsWEB-

INFclasses



o The Authservicekey should be configured with the same value in all nodes

Path for the authservicekey fileltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses

o The workspaceservicekey value should be configured with the same value

in all nodes

Path for the workspaceservicekey fileltInstaller FoldergttomcatwebappsworkspaceWEB-

INFclasses

l Issue - Kony Engagement Services fails to start after installation with Oracle DB

Hibernate Dialect needs to be set manually For more details refer to Configuring Hibernate

Dialect inWebLogic (only for WebLogic)

Workaround




configuration




INFclasses


Path for the authservicekey file



ltInstaller FoldergttomcatwebappsauthServiceWEB-

INFclasses


in all nodes


INFclasses

l Issue - During design time of your app the system throws errors due to several reasons

For example

Caused by

commysqljdbcexceptionsjdbc4MySQLSyntaxErrorException The

size of BLOBTEXT data inserted in one transaction is greater than

10 of redo log size Increase the redo log size using innodb_log_

file_size

Workaround

Increase the innodb_log_file_size For more details refer to Increase innodb_log_file_size in

themycnf file

l Issue - When you publish a number of apps the system throws the error - too many open

files

For example

Workaround

Update some of the default kernel parameter settings in your Linux environment For more

details refer to Tuning File Descriptor Limits on Linux



l Issue

When customer wants to install Kony Fabric with Oracle as database type the system throws

the error Invalid Data Type SDO_GEOMENTRY

Workaround

Install Oracle locator which is required for Kony Fabric installation For more details refer to

Pre-installation Tasks gt Create Locator Component for Oracle Database

l Issue

Upgrading fromMobileFabric 652 701 or 711 with MS SQLServer fails Installer is rolling

back as the schema version table is not migrating properly while upgrade

Workaround

To avoid this issue follow these step

Remove the version_rank column from schema_version table in each schema by

following queries before upgrade

drop index schema_version_vr_idx on masterltSCHEMA_NAMEgtschema_

version

alter table masterltSCHEMA_NAMEgtschema_version drop column

version_rank



l Issue

Uninstallation of Kony Fabric onWebLogic with Oracle does not drop createdOracle

databases If a user tries to uninstall and selects Delete All Data during installation datasource

are not getting deleted fromWebLogic instance aswell as databases are not getting dropped

from oracle

Workaround

l Delete databases fromWebLogic Console

l Drop all schemas crated in Database related to Kony Fabric installer

l Issue

Installer fails to upgrade admindb scripts as admindb name is not available in

installvariablesproperties file

Workaround

Update the below property installvariablesproperties

From ADMIN_DB=$CONSOLE_SERVER_DB_1$ to ADMIN_DB=ltactual db namegt

l Issue

Auth (Kony Identity Service) datasources are not created when upgraded fromKony Fabric

652GA to 72GA

Workaround

Create datasource for authconfigdb and authglobaldb For more details refer to

Configuring_JNDI_for_Database gt Data Source for Single Node and Multinode gt Kony

Identity Service Data Source section



l Issue

If you have installedMobileFabric 73 or older and when you use the existing database for Kony

Fabric V8 on JBoss theWeb Application publish fails

Workaround

Update the management_server_port in the server_configuration table of

admindb with the jbossmanagementhttpport in the ltUSER_INSTALL_

DIRgtjbossstandaloneconfigurationstandalonexml

l Issue

If you do not want to use a DB user with DBA role or Equivalent privileges for the Kony Fabric

installation onORACLE database follow these steps

Workaround

Manual Steps

1 Create Component Users (schema) with the required grants as below

CREATE USER ltprefixgtMFCONSOLEDBltsuffixgt identified by ltpasswordgt

default tablespace ltdataTablespacegt profile default

ALTER USER ltprefixgtMFCONSOLEDBltsuffixgt QUOTA UNLIMITED ON USERS

GRANT CONNECTRESOURCECREATE VIEW TO ltprefixgtMFCONSOLEDBltsuffixgt

GRANT CREATE JOB TO ltprefixgtMFCONSOLEDBltsuffixgt

GRANT MANAGE SCHEDULER TO ltprefixgtMFCONSOLEDBltsuffixgt

CREATE USER ltprefixgtMFACCOUNTSDBltsuffixgt identified by ltpasswordgt


ALTER USER ltprefixgtMFACCOUNTSDBltsuffixgt QUOTA UNLIMITED ON USERS



GRANT CONNECTRESOURCECREATE VIEW TO

ltprefixgtMFACCOUNTSDBltsuffixgt

GRANT CREATE JOB TO ltprefixgtMFACCOUNTSDBltsuffixgt

GRANT MANAGE SCHEDULER TO ltprefixgtMFACCOUNTSDBltsuffixgt

CREATE USER ltprefixgtMFREPORTSDBltsuffixgt identified by ltpasswordgt


ALTER USER ltprefixgtMFREPORTSDBltsuffixgt QUOTA UNLIMITED ON USERS

GRANT CONNECTRESOURCECREATE VIEW TO ltprefixgtMFREPORTSDBltsuffixgt

GRANT CREATE JOB TO ltprefixgtMFREPORTSDBltsuffixgt

GRANT MANAGE SCHEDULER TO ltprefixgtMFREPORTSDBltsuffixgt

CREATE USER ltprefixgtIDCONFIGDBltsuffixgt identified by ltpasswordgt


ALTER USER ltprefixgtIDCONFIGDBltsuffixgt QUOTA UNLIMITED ON USERS

GRANT CONNECTRESOURCECREATE VIEW TO ltprefixgtIDCONFIGDBltsuffixgt

GRANT CREATE JOB TO ltprefixgtIDCONFIGDBltsuffixgt

GRANT MANAGE SCHEDULER TO ltprefixgtIDCONFIGDBltsuffixgt

GRANT CREATE TABLE TO ltprefixgtIDCONFIGDBltsuffixgt

GRANT CREATE ANY INDEX TO ltprefixgtIDCONFIGDBltsuffixgt

GRANT ALTER ANY TABLE TO ltprefixgtIDCONFIGDBltsuffixgt

CREATE USER ltprefixgtADMINDBltsuffixgt identified by ltpasswordgt


ALTER USER ltprefixgtADMINDBltsuffixgt QUOTA UNLIMITED ON USERS

GRANT CONNECTRESOURCECREATE VIEW TO ltprefixgtADMINDBltsuffixgt

GRANT CREATE JOB TO ltprefixgtADMINDBltsuffixgt

GRANT MANAGE SCHEDULER TO ltprefixgtADMINDBltsuffixgt

CREATE USER ltprefixgtKPNSDBltsuffixgt identified by ltpasswordgt


ALTER USER ltprefixgtKPNSDBltsuffixgt QUOTA UNLIMITED ON USERS

GRANT CONNECTRESOURCECREATE VIEW TO ltprefixgtKPNSDBltsuffixgt

GRANT CREATE JOB TO ltprefixgtKPNSDBltsuffixgt

GRANT MANAGE SCHEDULER TO ltprefixgtKPNSDBltsuffixgt



2 Create a non DBA user with the below grants This user will be given to the Installer

CREATE USER ltINSTALLER_USERgt IDENTIFIED BY ltpasswordgt

GRANT CREATE SESSION TO ltINSTALLER_USERgt WITH ADMIN OPTION

GRANT SELECT ANY DICTIONARY TO ltINSTALLER_USERgt

ALTER USER ltINSTALLER_USERgt QUOTA UNLIMITED ON ltdataTablespacegt

ALTER USER ltINSTALLER_USERgt QUOTA UNLIMITED ON ltindexTablespacegt

ALTER USER ltINSTALLER_USERgt QUOTA UNLIMITED ON ltlobTablespacegt

Note The password for the component users and the installer user have to be same

l Issue

For storage services to work change the following storagedb entries in the admindb

Workaround

Manual Steps

storage_database_type - oracle

storage_database_hostname - Database hostnameIP

storage_database_port - Database Port

storage_database_username - DBA username

storage_database_password - DBA Password

storage_database_instance - service IDservice name

storage_data_tablespace - Data Tablespace name

storage_index_tablespace - Index Tablespace name

storage_lob_tablespace - Lob Tablespace name



l Issue


installation onMSSQL follow these steps

Workaround

Manual Steps

Create database ltprefixgtmfreportsdbltsuffixgt

Create database ltprefixgtmfaccountsdbltsuffixgt

Create database ltprefixgtmfconsoledbltsuffixgt

Create database ltprefixgtadmindbltsuffixgt

Create database ltprefixgtkpnsdbltsuffixgt

Create database ltprefixgtidconfigdbltsuffixgt

CREATE LOGIN loginId WITH PASSWORD = loginpwd

GO

use msdb

GO

create user userId from LOGIN loginId

GO

EXEC sp_addrolemember SQLAgentUserRole userId



EXEC sp_addrolemember SQLAgentReaderRole userId

EXEC sp_addrolemember SQLAgentOperatorRole userId

GO

use ltprefixgtmfreportsdbANltsuffixgt

GO


GO

GRANT ALTER ANY DATABASE DDL TRIGGER TO userId

GO

GRANT CREATE TABLECREATE TYPECREATE

PROCEDURESELECTUPDATEDELETEINSERTEXECUTEREFERENCESCREATE

VIEWALTERVIEW Definition TO userId

GO

use ltprefixgtmfaccountsdbltsuffixgt

GO


GO




GO




GO

use ltprefixgtmfconsoledbltsuffixgt

GO


GO


GO




GO

use ltprefixgtadmindbltsuffixgt

GO




GO



VIEWALTER TO userId

GO

use ltprefixgtkpnsdbltsuffixgt

GO

CREATE SCHEMA ltprefixgtkpnsdbltsuffixgt

GO


GO



VIEWALTER TO userId

GO

use ltprefixgtidconfigdbltsuffixgt

GO




GO



VIEWALTER TO userId

GO

Note The whole script must be run at once

Note The loginId and passwordmust be the same as used for Kony Fabric Installation

Note The ltprefixgt and ltsuffixgt providedmust be the same across the script andmust also

be provided at the time of the Kony fabric Installation

Note You can use the same loginId and userId to avoid confusion

Note The userIdmust be same across the script

l Issue


installation on IBM DB2 follow these steps

Workaround

Manual Steps



Important Only DB2 database administrator (DBA) or equivalent DB user will have access

to a create database

1 Create a user based on your Operating System level

l Refer for linux Creating group and user IDs for a DB2 database installation (Linux

and UNIX)

l Refer for Windows Creating a dedicated DB2 user (Windows)

2 Create databases by logging as Admin with following queries

CREATE SCHEMA ltprefixgtADMINDBltsuffixgt AUTHORIZATION userid

CREATE SCHEMA ltprefixgtMFCONSOLEDBltsuffixgt AUTHORIZATION

userid

CREATE SCHEMA ltprefixgtMFACCOUNTSDBltsuffixgt AUTHORIZATION

userid

CREATE SCHEMA ltprefixgtMFREPORTSDBltsuffixgt AUTHORIZATION

userid

CREATE SCHEMA ltprefixgtKPNSDBltsuffixgt AUTHORIZATION userid

CREATE SCHEMA ltprefixgtIDCONFIGDBltsuffixgt AUTHORIZATION userid

3 Grant database level permissions to the user

GRANT CREATEINALTERINDROPIN ON SCHEMA

ltprefixgtADMINDBltsuffixgt TO userid




ltprefixgtMFCONSOLEDBltsuffix TO userid


ltprefixgtMFACCOUNTSDBltsuffixgt TO userid


ltprefixgtMFREPORTSDBltsuffixgt TO userid


ltprefixgtKPNSDBltsuffixgt TO userid


ltprefixgtIDCONFIGDBltsuffixgt TO userid

4 Grant schema level permissions to the user

GRANT createtabCONNECTDATAACCESSIMPLICIT_SCHEMAACCESSCTRL

ON database TO USER userid




l Issue

Authmigrations fail with the following AccessDenied error

ERRORmainactionLogFlywayJavaMigrations17installCoreERROR

Unable to obtain Jdbc connection from DataSource



(jdbcmariadbodc3dmv-mf-

db01indcgov3306relaxAutoCommit=true) for user madmin

Could not connect Access denied for user madminodc3dmv-mf-

web02indcgov (using password YES)

Workaround

The password used for the Authmigrationsmust not contain exclamationmarks ()

l Issue

If you are using any lower versions of MySQL 57 such as v5712 or lower during installation

youmay encounter an error due to which the installation rolls back This error occurs due to a

bug in theMySQL database





l SQL State HY000

l Error Code 1093



Workaround

To resolve this issue refer Prerequisites for Kony Fabric with MySQL- Applicable for Identity

Services



131 HostnamePort changes for Tomcat Application Server

Kony Fabric On-Premises Installer provides a script to change the Hostname or Port of the installed

Kony Fabric instance In your installed Tomcat Application Server youmust also perform the following

changes

In tomcatwebappsapiportalWEB-INFclassesconfigproperties replace

the existing URLwith the new URL in the following fields

l KONY_ACCOUNT_API_BASE_URL=

l KONY_DEVELOPER_PORTAL_BASE_URL=

In tomcatwebappsmfconsoleWEB-INFclassesconfigproperties replace

the existing URLwith the new URL in the KONY_ACCOUNT_API_BASE_URL= field

In tomcatconfserverxml replace the port number with the new port number in the

ltConnector server=Kony port= field

In tomcatwebappsaccountsWEB-INFclassesaccountsproperties replace

the port number with the new port number in the following fields

l KONY_INTEGRATION_SERVICE_PORT=

l KONY_MESSAGING_SERVICE_PORT=

132 HostnamePort changes for JBoss Application Server


Kony Fabric instance The script can be found in the installation folder In your installed JBoss

Application Server youmust follow the instructions in the script and also perform the following steps

1 In the standalonexml file replace the IP addressport number with the new IP addressport

number



2 In mfconsolewarWEB-INFclassesconfigproperties replace the existing

URLwith the new URL in the KONY_ACCOUNT_API_BASE_URL= field

3 In apiportalwarWEB-INFclassesconfigproperties replace the existing

URLwith the new URL in the following fields



4 In accountswarWEB-INFclassesaccountsproperties replace the port

number with the new port number in the KONY_INTEGRATION_SERVICE_PORT= field

133 How to Configure JBoss Cluster

l Refer to httpsaccessredhatcomsolutions218053 to setup EAP in Domainmode

l Refer to httpsdocsjbossorgmod_cluster110htmlQuick_Start_Guidehtml to configure the

mod_cluster

l Refer to httpsaccessredhatcomsolutions2332111 to integrate themod_cluster with

JBoss

134 How to Configure a Custom JAR File on WebLogic

When an administrator installs only integration services onWeblogic and would like to use it as a

standalone server (without integrating to Kony Fabric) for Kony Studio apps then app serviceswhich

use custom code for pre-processor and post-processor will fail For these services to work properly

add the custom code jar file to middlewarewar and redeploy

To add custom jar to middlewarewar after installation follow these steps

1 Uninstall themiddlewarewar file fromWebLogic Console gt Deployments tab

2 Go to your Kony Integration Server install location and Deployments folder

3 Open themiddlewarewar file and do the following



4 In the middlewarewar file go to WEB-INFlib folder and add custom jar file

5 Save the middlewarewar file

6 Deploy the middlewarewar file back to server

135 How to Configure Heap and PermGen Size

1351 Configuring Heap and PermGen Size for Tomcat

By default the heap settings for Tomcat allocated areMin -Xms1024m Max - Xmx2048m and default

permgen settings are -XXPermSize=1024m -XXMaxPermSize=1024m

For better performance in case of several publishes update the following heap and permgen settings

in the file Installation directorytomcatbincatalinash

l heap settings Min -Xms1024m Max - Xmx1024m

Important While installing Kony Fabric Components including Integration services set the

heap settings to Min -Xms2048m Max - Xmx2048m

l permgen settings -XXPermSize=1024m -XXMaxPermSize=2048m

1352 Configuring Heap and PermGen Size for JBoss

In case of multinode do the following

l Configure theMin -Xms2048m Max - Xmx4096m heap settings in the file Serverdirectory domainconfigurationhostxml

l Configure theMin -Xms2048m Max - Xmx4096m heap settings in the file Serverdirectory domainconfigurationdomainxml

l Configure permgen settings -XXPermSize=1024m -XXMaxPermSize=2048m

In case of single node configure the settings in Install directory

jbossstandaloneconfigurationstandalonexml



1353 Configuring Heap and PermGen Size for WebLogic

l Configure theMin -Xms2048m Max - Xmx4096m heap settings in the file Serverdirectory user_projectsdomainsbinsetDomainEnvsh


1354 Configuring Heap and PermGen Size for WebSphere

For configuring Heap Size inWebSphere click How to Configure Heap Size - WebSphere

136 How to Configure Kony Fabric Behind a Reverse Proxy

If you want to access everything via a proxyURL including Kony Fabric Console (for example design

time for your app developers) and authService and integration services (for example runtime from

users using your apps) follow these steps

1 Install Kony Fabric with internal details like your internal IP and HTTP port

2 After installation stop the Kony Fabric Console (without configuring authservice details) and

update following property files

a In the accountswarWEB-INFclasses folder open the

accountsproperties file and update the WAAS_BASE_URL=ltPUBLIC_URL_

OF_YOUR_APACHEgtworkspace property with a public URL instead of the private

URL By default the private URL is set during installation

Examples of proxyURLs

l WAAS_BASE_URL=httptestkonycomworkspace

l WAAS_BASE_URL=httpstestkonycom8443workspace

l WAAS_BASE_URL=httptestkonycom8080workspace



b Following are the changes to bemade in the war for each App Server

l Tomcat In mfconsolewarWEB-INFclasses open the

configproperties file and update the KONY_ACCOUNT_API_BASE_

URL=ltPUBLIC_URL_OF_YOUR_APACHEgtaccountsapiv1_0 property

with a public URL instead of the private URL that was generated during

installation

l JBoss - Standalone (Bundled JBoss) In

Standalonedeploymentsmfconsolewar open the




installation

l JBoss - Pre-configured and Domain mode Take a backup of the existing war

Undeploy mfconsolewar In mfconsolewarWEB-INFclasses open

the configproperties file update the KONY_ACCOUNT_API_BASE_



installation and re-deploy the war file

l WebSphere Take a backup of the existing war Undeploy mfconsolewar In

mfconsolewarWEB-INFclasses open the configproperties file

update the KONY_ACCOUNT_API_BASE_URL=ltPUBLIC_URL_OF_YOUR_

APACHEgtaccountsapiv1_0 property with a public URL instead of the

private URL that was generated during installation and re-deploy the war file

l WebLogic In mfconsolewarWEB-INFclasses open the




installation

3 Start Kony Fabric Console



4 Launch your Kony Fabric Console in browser by using ltPUBLIC_URL_OF_YOUR_

APACHEgtmfconsole Now auth setup pages comes up

5 Enter auth URLwith public URL like ltPUBLIC_URL_OF_YOUR_APACHEgtauthService If

you provide an internal IP here appconfig will show internal IPs

6 Also after log in to Kony Fabric Console while registering server provide the PUBLIC_URL to

register integration server Now all the URLswill have the public hostnames

If you want to give public access only to runtime services like authservice and integration

services you can skip step 2 and step 3 from the above procedure This will make sure service

docwill have all public URLs

Note Proxy configuration should have preserver host directive for Kony Fabric to work

correctly after start up

For example in case of apache proxy use ProxyPreserveHost On

and in case of NGINX use proxy_set_header Host $host (For more information

refer Passing request headers)

137 Preserving Proxy if Load Balancer or Proxy Server is Configured

When you use a load balancer or a proxy server inWebSphere the port number on which the web

application server is listening is added to an incoming request This addition redirects the load balancer

to the load balancer host It also adds the default port number (Port Number 9443) to the request

To stop the load balancer from redirecting to the load balancer host add the following properties in

Application Servers gt Server name gt Web Container Settings gt Custom Properties

l comibmwswebcontainerextractHostHeaderPort

l trusthostheaderport

For more information you can refer to IBMSupport



138 How to Configure Frontend HTTPS to Tomcat HTTP Redirection

If you are installing Kony Fabric on Tomcat on HTTP and wants to route requests via HTTPS apache

or loadbalancer add a connector in the tomcatserverxmlwith the following attributes

proxyName=ltProxyHostgt proxyPort=ltProxyPortgt scheme=https secure=true

Example

ltConnector server=KonyTEST port=8080 protocol=HTTP11

proxyName=mbaastest10konylabsnet proxyPort=443 scheme=https

secure=true maxHttpHeaderSize=8192 maxThreads=150

enableLookups=false acceptCount=25 disableUploadTimeout=true

tcpNoDelay=true compression=on

compressableMimeType=textcsstextjavascripttexthtml

connectionTimeout=20000 URIEncoding=UTF-8gt

139 WebSphere FAQs

For more information refer toWebSphere FAQs

1310 How to Change Log Levels

Kony Fabric Console contains three components portal accounts and workspace

For console log files by default log level value is set to INFO

l The following are the log file names for the console components

o mbaasportallog (for mbaas portal)

o accountsServicelog (for accounts)

o and workspaceServicelog (for workspace)



l For Identity services the log file is authServicelog The default log level for identity

services is set to INFO

l For Integration services the log file is middlewarelog The default log level for integration


l For Engagement Services the log file is kmslog The default log level for Engagement

Service is set to INFO

To change log levels for mbaasportallog follow these steps

1 Go to ltKony Fabric install directorygtdeploymentsmfconsolewarWEB-

INFclasses and open the configproperties file

2 Change the log level to the required value


To change log levels for accountsServicelog follow these steps

1 Go to accountsdb -gt accounts_configurations table search for key KONY_

ACCOUNTS_LOG_LEVEL


To change log levels for workspaceServicelog follow these steps

1 Go to ltmfconsoledb -gt property table search for key LOG_LEVEL


To change log levels for authServicelog follow these steps

1 Go to ltKony Fabric install

directorygtdeploymentsauthServicewarWEB-INFclasses and open the



authServiceproperties file


3 Redeploy the authServicewar file

To change log levels for middleware logs follow these steps

1 Go to admin db gt server_configuration table and search for ltKony Fabric

install diSERVER_LOG_LEVEL


To change log levels for metricslog follow these steps

1 Go to reportsdb -gt metrics_configuration search for key KONY_METRICS_LOG_

LEVEL


To change log levels for Engagement Services logs follow these steps

1 Go to ltKony Fabric install directorygtdeploymentskpnswarWEB-INF

and open the kms-log4j2xml file



1311 Context Root-path

A context root identifies aWeb application archive (WAR) file in an application server The context root

of aWeb application determineswhich URLs application server will delegate to your web application



When Kony Fabric installed the required components WARs are deployed to an app server By

default a default context path based on the name of the deployment is usedWhen you reinstall Kony

Fabric on the same app server the newly installed instance overrides the first instance

With context root configuration for Kony Fabric you can install multiple sets of Kony Fabric instances

on one app server such as for Dev_Instance QA_Instnace and Prod_Instance

A context root for eachWebmodule of Kony Fabric (for example mfconsolewar

accountswar workspacewar adminwar serviceswar middlewarewar

and kpnswar) is defined in the application deployment descriptor during application assembly

You can use this field to assign a different context root to aWebmodule The context root is combined

with the defined servlet mapping (from theWAR file) to compose the full URL that users type to access

the servlet For example if the context root is myapphome and the servlet mapping is

MyFirstPage then the URL is httphostportmyapphomeMyFirstPage

For example You have installed the Kony Fabric Console and the integration services on one app

server AppServer1 And you are required to install Kony Fabric Components (console identity

services integration services and engagement services) to the same AppServer1 You can install

multiple instances of Kony Fabric on the AppServer1 app server by configuring the context root-path

for each instance separately The following sections help you configure context root path for Kony

Fabric

l Approach 1 Changing Context Root Path after the installation using the Installer

l Approach 2 Changing Context Root usingManual Install Steps

l Accessing Context Based Root Kony Fabric Instance through Visualizer Enterprise (after you

setup context root path as above you can also access context based root Kony Fabric in

Visualizer)



13111 Approach 1 Changing Context Root Path after the installation using the

Installer

1 Install Kony Fabric using the Installer

Important During Kony Fabric installation or after installation is completed you should not

configure details in the Administrator Account Configuration window

2 Rename the war files for required components

l For Tomcat standalone and JBoss standalonemodes rename theWARs directly from proper

install location

l For WebLogic andWebSphere and JBoss domainmode follow these steps to rename

WARs

i Rename the requiredWARs from the installation location

ii Go to Console

iii DeleteWARs for those you have renamed

iv Redeploy the renamedWARs to the Console

The following table details the list of installedWAR files and installation locations for Kony Fabric

Components



Component

File Name RenamedWAR files

Path for installed WAR files forKony Fabric

Consol

e

workspacewa

r

workspace

1war

l Tomcat (standalonemode)

ltKony Fabric Install

Pathgttomcatwebapps

l JBoss (standalonemode) ltKony

Fabric Install

Pathgtjboss gt

standalonedeployments

l WebLogic

ltUserInstallDirectorygt

deployments

l WebSphere lt

UserInstallDirectorygt

deployments

mfconsolewar mfconsole

1war

accountswar accounts

1war

Identity authServicew

ar

authServic

e1war

Integra

tion

Admin

Server

l middle

warew

ar

l service

swar

l admin

war

l mid

dlew

are

1

war

l serv

ices

1

war

l adm

in

1

war

Engag

ement

Service

s

kpnswar kpns1war



3 Update WAAS_BASE_URL in the accounts_configurations table by using the following

SQL query

For example ltprefixgtmfaccountsdbltsuffixgt

Sample query for UPDATE STATEMENT

l MySQL

UPDATE accounts_configurations SET value=lthttp or

httpsgtltserver_hostgtltserver_portgtworkspace1 WHERE

name=WAAS_BASE_URL

l Oracle



name=WAAS_BASE_URL

l SQLServer



name=WAAS_BASE_URL

l DB2



name=WAAS_BASE_URL


and JBoss servers



4 Open the renamed mfconsole1war and do the following

a Update the following property in the configproperties file

l KONY_ACCOUNT_API_BASE_URL=lthttp or httpsgtltserver_

hostgtltserver_portgtaccounts1apiv1_0

The location for configproperties mfconsole1warWEB-INFclasses

Note AWAR file location varies based on an app server - for example for

Tomcat WARs are found at ltINSTALL_DIRgttomcatwebapps

b Add the following properties in the configproperties file

l KONY_ACCOUNTS_HEALTHCHECK_URL=lthttp or

httpsgtltserver_hostgtltserver_portgtaccounts1health_

check

l KONY_WORKSPACE_HEALTHCHECK_URL=lthttp or

httpsgtltserver_hostgtltserver_

portgtworkspace1apiv1healthcheck

5 Update the following property in the KONY_SERVER_SERVICES_CONTEXT_PATH in the

admindb configuration table

KONY_SERVER_SERVICES_CONTEXT_PATH=services1

For example ltprefixgtadmindbltsuffixgt


l MySQL

UPDATE server_configuration SET prop_value =services1 WHERE

prop_name = KONY_SERVER_SERVICES_CONTEXT_PATH



l Oracle



l SQLServer



l DB2



Note If the property does not exist create KONY_SERVER_SERVICES_

CONTEXT_PATH


and JBoss servers

6 Configure the following settings for application server as follows

l For Tomcat In case you have renamed a war modify the following datasource file

names as per the respective renamedwar files

Path for datasource files

ltINSTALL_DIRgtltApp_ServergtconfCatalinalocalhost

l Rename accountsxml to account1xml

l Rename workspacexml to workspace1xml

l Rename authServicexml to authService1xml

l Rename adminxml to admin1xml



l For JBoss update serviceswarWEB-INFjboss-webxml with the new

serviceswar name

For example if services is renamed to services1 then services1warWEB-

INFjboss-webxml

From

ltcontext-rootgtservicesltcontext-rootgt

To

ltcontext-rootgtservices1ltcontext-rootgt

l For WebLogic update the new context path in the mfconsole1warWEB-

INFweblogicxmlwith the new serviceswar name

For example If mfconsole is renamed to mfconsole1 then

mfconsole1warWEB-INFweblogicxml

From

ltcontext-rootgtmfconsoleltcontext-rootgt

To

ltcontext-rootgtmfconsole1ltcontext-rootgt

l For WebSphere while deployingWARs toWebSphere enter the context root values for

renamedWARs as required

For more details on deployment of WARs inWebSphere refer to DeployingWAR Files

toWebSphere

7 Restart your app server

8 Launch Kony Fabric Console with new context path and do the registration using the new auth



service URL formatlthttp or httpsgtltserver_hostgtltserver_portgtltnew mfconsole

context pathgt

For example lthttp or httpsgtltserver_hostgtltserver_

portgtltmfconsole1gt

Note You will need to launch Kony Fabric through a browser and complete the registration

for the context based root instance

For more details refer to How to Get StartedWith Kony Fabric Console

Note After you complete registration you can now also launch a context based root Kony

Fabric through Visualizer Enterprise Refer to Access Kony Fabric Instance through

Visualizer Enterprise

9 After you logged in to Console create an environment with the new URLs

To create server feature with new context path the URL format is lthttp or

httpsgtltserver_hostgtltserver_portgtltnew admin context pathgt

If admin is renamed to admin1 then the sample URL format is as follows

lthttp or httpsgtltserver_hostgtltserver_portgtadmin1

10 Update service_url after an environment is registered in the accountsdb table as

follows

Sample query for UPDATE STATEMENT (for MySQLOracleMSSQLDB2)

l UPDATE features SET service_url = lsquolthttp or httpsgtltserver_

hostgtltserver_portgtadminservices1rsquo WHERE type = server


hostgtltserver_portgtkpns1rsquo WHERE type = kpns



Note You can now use Kony Fabric Console with new context paths for your app

development

11 Create an app in Kony Fabric Console

12 Publish the app

13112 Approach 2 Changing Context Root using Manual Install Steps

1 Install Kony Fabric usingmanual steps provided in Kony FabricManual Installation Guide


l For Tomcat standalone and JBoss standalonemodes rename theWARs directly from

proper install location


WARs


ii Go to Console



The following table details the list of installedWAR files and installation locations for Kony

Fabric Components



Component

File Name RenamedWARfiles


Conso

le

workspace

war

workspac

e1war



Pathgttomcatwebapps

l JBoss (standalonemode)


Pathgtjboss gt

standalonedeploymen

ts

l WebLogic

ltUserInstallDirector

ygtdeployments

l WebSphere lt

UserInstallDirectory

gtdeployments



Component



mfconsolew

ar

mfconsole

1war



Component



accountswa

r

accounts

1war

Identit

y

authService

war

authServi

ce1war

Integr

ation

Admin

Server

l middl

eware

war

l servic

eswa

r

l admin

war

l mi

ddl

ew

are

1

w

ar

l ser

vic

es

1

w

ar

l ad

mi

n1

w

ar

Engag

ement

Servic

es

kpnswar kpns

1war




SQL query



l MySQL



name=WAAS_BASE_URL

l Oracle



name=WAAS_BASE_URL

l SQLServer



name=WAAS_BASE_URL

l DB2



name=WAAS_BASE_URL


and JBoss servers













check









l MySQL





l Oracle



l SQLServer



l DB2




CONTEXT_PATH


and JBoss servers



6 Configure the following properties with the customized JNDI names

Component

File Name File Name Properties to beaddedupdated

authS

ervice

authServiceproper

ties

authServicewar

WEB-INFclasses

l WEBSPHERE_

AUTHCONFIGDB_

JNDI_

NAME=jdbcauthconfig

l WEBSPHERE_

AUTHGLOBALDB_

JNDI_

NAME=jdbcauthglobal

db

Works

pace

workspaceService

properties

WorkspacewarW

EB-INFclasses

l WEBSPHERE_

WAASGLOBALDB_

JNDI_

NAME=jdbcworkspac

esglobaldb

l WEBSPHERE_

WORKSPACESDB_

JNDI_

NAME=jdbcworkspac

esglobaldb



Component


Accou

nts

accountspropertie

s

AccountswarWE

B-INFclasses

l ACCOUNTS_DB_

JNDI_

NAME=jdbckonyacco

unts REPORTS_DB_

JNDI_

NAME=jdbckonyreport

s

Integr

ation

Admin

Server

serverconsoleprop

erties

adminwarWEB-

INFmiddlewarem

iddleware-

bootconfigadmin

l admindbjndiname=jdb

ckonyadmindb

l reportsdbjndiname=jd

bckonyreports













serviceswar name


INFjboss-webxml

From


To






From


To





toWebSphere






context pathgt







Fabric through Visualizer Enterprise refer to Access Kony Fabric Instance through








follows









development


13 Publish the app

13113 Accessing Context Based Root Kony Fabric Instance through Visualizer Enter-

prise

After you complete registration for a context based root for a Kony Fabric instance by using the

installer or manual steps you can now also launch the context based Kony Fabric through Visualizer

Enterprise

To access a context based root Kony Fabric instance through Visualizer follow these steps

1 Add the below keys in the eclipseini file as follows

a Navigate to the folder where Kony Visualizer is installed

For example ltVisualizerEnterpriseInstallFoldergt_KonyVisualizer_installation

b Open the eclipseini file and add the following keys at the end of the file

-Dkonymfconsolecontext=ltnew mfconsole context pathgt For

example mfconsole1

-Dkonymfaccountscontext=ltnew accounts context pathgt For

example accounts1

-Dkonymfworkspacecontext=ltnew workspace context pathgt

For example mfworkspace1



-Dkonymfidentitycontext=ltnew identity context pathgt For

example mfidentity1

2 Save the eclipseini file

3 Launch Visualizer Enterprise

4 Configure Kony Fabric in Kony Visualizer

For more details refer to Configure Kony Fabric in Kony Visualizer

You can now access context based root Kony Fabric Console through Visualizer

5 Configure the HeadlessBuildproperties file for contexts that you have configured for

Kony Fabric as follows

a Open the HeadlessBuildproperties file Refer to Configure the

HeadlessBuildproperties File

b In the HeadlessBuildproperties file add the required contexts at the end of the

file

For example

l For console the URL contextpathconsole=console1

l For identity the URL contextpathidentity=identity1

l For workspace the URL contextpathworkspace=workspace1

l For accounts the URL contextpathidentity=accounts1

Note The headless-buildproperties configuration is required only for CI

build

6 Save the file



7 Launch Kony Fabric Console through Visualizer You can now build apps using new context

based Kony Fabric instance

For more details on how to add applications refer to Kony Fabric User Guide

For more details on designing an app adding actions and skins and building apps using

Visualizer refer to Kony Visualizer User Guide


1 Preface

11 Purpose




15 Contact Us

2 Prerequisites



23 Network Settings














56 Memcached Server

57 Configure Load Balancers for Sending Host Information in Multinode





61 Installing Kony Fabric - Console-mode (for command-line-driven installations)



71 Prerequisites






81 Tomcat Server

82 JBoss Server

83 WebLogic Server

84 WebSphere Server









102 Prerequisites









127 Configuring Datasource for performance improvements for JBoss pre-existing and Domain Mode












139 WebSphere FAQs




Copyright copy 2014 by Kony Inc

All rights reserved

February 2020

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

Fabric KonyNitro and Kony Visualizer are trademarks of Kony Inc MobileFabric is a registered

trademark of Kony Inc Microsoft theMicrosoft logo Internet Explorer Windows andWindowsVista

are registered trademarks of Microsoft Corporation Apple the Apple logo iTunes iPhone iPad OS

X Objective-C Safari Apple Pay AppleWatch and Xcode are trademarks or registered trademarks

of Apple Inc Google the Google logo Android and the Android logo are registered trademarks of

Google Inc Chrome is a trademark of Google Inc BlackBerry PlayBook Research inMotion and

RIM are registered trademarks of BlackBerry SAPreg and SAPreg Business Suitereg are registered

trademarks of SAP SE in Germany and in several other countries All other terms trademarks or

servicemarksmentioned in this document have been capitalized and are to be considered the

property of their respective owners



Revision History





Kony Fabric 82



8x



WebSphere
















Table of Contents

1 Preface 9

11 Purpose 10




15 Contact Us 12

2 Prerequisites 13



































82 JBoss Server 366























DomainMode 412



















1 Preface







centralized console












andOAuth Provider


Yahoo













services They are



met


Objects







11 Purpose












l File path

l Commands

l Program code

l File names

Italic l Emphasis


l New terminology

Bold l Windows

l Menus

l Buttons

l Icons

l Fields

l Tabs







data


Document Purpose

Kony Fabric User

Guide



15 Contact Us






2 Prerequisites


Fabric Console






Memory 16GB





23 Network Settings



Protocol

Direction

Action

Description

Engageme

nt Server


ce


Engageme

nt Server

to access

Apple

APNS

HTTP2

production

URL

Engageme

nt Server


d

Allow Allow the

Engageme

nt Server

to access

the JPush

notification

server

URL

Engageme

nt Server


m4433device


Engageme

nt Server

to access

Apple

APNS

HTTP2

developme

nt URL




Protocol

Direction

Action

Description

Engage

ment

Server


3

TCP Outb

ound

All

o

w

Allow

the

Engage

ment

Server

to

access

Firebas

e Cloud

Messa

ging

(FCM)

service

Engage

ment

Server



m 170008 (17001 to

17255255254)

21

96

TCP Outb

ound

All

o

w

Allow

the

Engage

ment

Server

to

access

APNS

feedba

ck

service




Protocol

Direction

Action

Description

Engage

ment

Server

gatewaypushapplecom


170008 (17001 to

17255255254)

21

95

TCP Outb

ound

All

o

w

Allow

the

Engage

ment

Server

to

access

Apples

APNS

Engage

ment

Server

All subdomains of


Sample Push URL



mmssPD_pushRequest

44

3

TCP Outb

ound

All

o

w

Allow

connec

t to

Blackb

erry

Cloud

through

this

port

Engage

ment

Server


3

TCP Outb

ound

All

o

w

Allow

connec

t to

Windo

ws

Cloud

(MPN

S)

through

this

port




Protocol

Direction

Action

Description

Engage

ment

Server


3

TCP Outb

ound

All

o

w

Allow

connec

t to

Windo

ws

Cloud

(WNS)

through

this

port

Internal

Corpor

ate

WiFi

router

for

Android

Mobile

Device

s






Addresses

httpbgphenetAS15169

52

2

8

52

2

9

52

30

TC

P

HTT

P

HTT

PS

UD

P

Both All

o

w

Android

device

s will

connec

t to

GCM

through

this

port

Internal

Corpor

ate

WiFi

router

for iOS

Device

s

gatewaypushapplecom




m 170008 (17001 to

17255255254)

52

23

TCP Both All

o

w

Apple

device

s

connec

t to

APNS

servers

through

this

port




Protocol

Direction

Action

Description

Internal

Corpor

ate

WiFi

router

for iOS

Device

s


ocspapplecom

8

0

44

3

TCP Both All

o

w

Apple

device

s will

connec

t to

public

Apple

OCSP

and

iTunes

service

through

this

port

Internal

Corpor

ate

WiFi

router

for

Windo

w

Device

s


followingWNS URL



8

TC

P

HTT

P

HTT

PS

UD

P

Both All

o

w

Windo

ws

device

s will

connec

t to

WNS

through

this

port




Protocol

Direction

Action

Description

Internal

Corpor

ate

WiFi

router

for

Windo

w

Device

s


followingMPNS URL



5

TC

P

HTT

P

HTT

PS

UD

P

Both All

o

w

Windo

ws

device

s will

connec

t to

MPNS

through

this

port


























Auth Servicerdquo



l 5420819284

l 54208192248





non-root user




adduser core

passwd core






use


















objects
































CONTAINER=CURRENT


CONTAINER=CURRENT


CONTAINER=CURRENT













servers







version










big pagesize of 32k





COMMIT



IBMDEFAULTGROUP


AUTOMATIC



COMMIT





IBMDEFAULTGROUP


AUTOMATIC



COMMIT



IBMDEFAULTGROUP


AUTOMATIC



COMMIT


IBMTEMPGROUP


EXTENTSIZE 1M


COMMIT

CONNECT RESET


























both editions










collation support





[client]


[mysql]


[mysqld]|






+----------------------+-----------------+


+----------------------+-----------------+




+----------------------+-----------------+





+--------------------------+----------------------------+


+--------------------------+----------------------------+









+--------------------------+----------------------------+




database





l SQL State HY000

l Error Code 1093























temp folder)



































servers






servers








masterslavemachines










ltglobal-modulesgt


ltglobal-modulesgt

6 Save the changes




JBoss



ltinterfacesgt



ltinterfacegt



ltinterfacegt

ltinterfacesgt














inheritance=DEEPgt|

ltsubsystemgt



l standalonebat


l standalonesh










realms section



ltsslgt




ltsslgt


ltsecurity-realmgt


































binding=connectgt











credentialsgt


















D parameter






JVM arguments

















l Set JVM heap size
















(for Java7)










































and authorization



role






roles

Workspace

(WaaS)






application

API Developer

Portal








Environments

(Engagement

Services

Integration

Services)








optional component


















on separate nodes





Installation



Install Guide


node (Domain Mode)














Multinode


LinuxVersion111



local environment


installations


Console

l Workspace

l Accounts

Identity

Integration

l Admin

l Middleware

l Services

l Metrics


Engagement Services


















n READMEtxt


database















temp folder)
















whereis libevent






configure

make

make install




56 Memcached Server










cd memcached-126

configure

make

make install



listen to p = port)


Multinode



the headers




For example









































l local_policyjar






policyfileshtml












l local_policyjar


l READMEtxt


homegtlibsecurity











591 MySQL




application size










592 Oracle




component


















i Connect as SYSDBA

sqlplus as sysdba



sysaux


creation






Conn mdsyssecret


creation






like SDO














edition licensing



593 Maria DB







minimum value


5101 JBoss


Load Balancer)





proxy-port details



secure=truegt





ltinterfacesgt



ltinterfacegt



ltinterfacegt



figuration



ltinterfacegt



ltinterfacegt

ltinterfacesgt








domainxml file




ltsubsystemgt --gt






JBoss







-Xms2048m

-Xmx4096m



shown below






gt

ltsubsystemgt









settings







5102 WebLogic



























5103 WebSphere











Custom Properties





















java executablegt



changes




























installations)


Fabric on Linux



































su - username




Linux






Unpacking the JRE


archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------




of Kony Fabric


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom




THE



DEFAULT


servers


=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS




THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type



--------------





grade environment

1- Development

2- Non-Production

-gt3-

Production


DEFAULT




=================================================================

==============


--------------

------------







-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs









front-end app






-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT







usersxml






configuration table


=================================================================

=======

HTTP or HTTPS

-------------



-gt1- HTTP

2- HTTPS




DEFAULT



=============================================================

==================


------------------------------


use The default



ltIP addressgt


8181







=============================================================

==================


------------------------------


use The default



please have the



ltIP addressgt
















=========================================================

======================


-------------------------








TO ACCEPT THE

DEFAULT


=========================================================

======================

Port Validation

---------------


65535




TO ACCEPT THE

DEFAULT


error message

=========================================================

======================


---------------------------







TO ACCEPT THE

DEFAULT




=================================================================

=======


-----------------------------------------







DEFAULT





=============================================================

===========


-----------------------------------------


certificate All the









City (DEFAULT ) HYD

State (DEFAULT ) AP






=============================================================

===========


-----------------------







=============================================================

===========


-----------------------------------------


contain space





=========================================================

===============


-----------------------------------------

=========================================================

===============




-------------------------


should not contain

space




=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT




JBoss servers



=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57



=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)










to 1521 for oracle




user


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------








=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT






following

====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL


example dbclient




as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------












location




install folder









ltContextgt



SQLServerDriver




maxWait=10000






testWhileIdle=true



url=jdbcsqlserver










SQLServerDriver




maxWait=10000






testWhileIdle=true



url=jdbcsqlserver






ltContextgt



and JBoss servers

=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=================================================================

==============


-------------------------------









=================================================================

==============


---------------------





following

manual steps




successful











=================================================================

==============


-------------------------------










Email (Default )














=============================================================

==================


-------------------------------






=============================================================

==================




-------------------------------



appear

=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes

2- No


DEFAULT







==================================================


------------------------


Installation Type

New Installation

Install Components



Install Folder




Application Server

Tomcat 8532



8080

Database Choice

MySQL 57

Database Details


Port 3306

Database Names








===========================================================

Installing

-------------

[==================|==================|==================]


=================================================================

=======

Ready To Install

-----------------------------------------


system




homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------


homeuser1KonyFabric



















authenticated











ations)






Mode)










Fabric Console










su - username




Linux






Unpacking the JRE


archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric




services


support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom






THE

DEFAULT


=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE




BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type

--------------







grade environment

1- Development

2- Non-Production

-gt3-

Production


DEFAULT




=================================================================

==============


--------------

------------







-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs









front-end app






-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT





usersxml








configuration table


=================================================================

==============

Installation Mode

-----------------








(Single Node)

2- Standalone Mode

(Existing)

3- Domain Mode



(Multi Node)


DEFAULT














=================================================================

=======

HTTP or HTTPS

-------------



-gt1- HTTP



2- HTTPS


DEFAULT



=============================================================

==================


------------------------------

=============================================================

==================


use The default



ltIP addressgt


8181





=============================================================

==================


------------------------------


use The default



please have the



ltIP addressgt















=========================================================

======================


-------------------------






TO ACCEPT THE

DEFAULT




=========================================================

======================

Port Validation

---------------


65535




TO ACCEPT THE

DEFAULT


error message

=========================================================

======================


---------------------------







TO ACCEPT THE

DEFAULT




=================================================================

=======


-----------------------------------------







DEFAULT





=============================================================

===========


-----------------------------------------


certificate All the









City (DEFAULT ) HYD

State (DEFAULT ) AP






=============================================================

===========


-----------------------







=============================================================

===========


-----------------------------------------


contain space





=========================================================

===============


-----------------------------------------

=========================================================

===============


-------------------------




should not contain

space




=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT


JBoss servers





=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------









====================================================

===========================




------------------------------------


57



=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)










to 1521 for oracle




user


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------








=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT






following

====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL


example dbclient




as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------



ltHostnameIPgt





Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------





l Data Tablespace






================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=================================================================

==============


-------------------------------











=================================================================

==============


---------------------



following

manual steps




successful













=================================================================

==============


-------------------------------








Email (Default )














=============================================================

==================


-------------------------------








=============================================================

==================


-------------------------------



appear

=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes



2- No


DEFAULT





=================================================================

==============


------------------------


Installation Type

New Installation

Install Components



Install Folder


Application Server






Database Choice

MySQL 57

Database Details


Database Names



testkpnsdbjboss



=================================================================

=======

Ready To Install

-----------------------------------------


system


homeuser1KonyFabric





=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------


homeuser1KonyFabric



















authenticated













For Tomcat


following locations


















For JBoss


following locations




















For WebLogic


following locations






























For WebSphere


following locations








































su - username




Linux




Unpacking the JRE




archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric


services




support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom






THE

DEFAULT


JBoss servers


=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS




THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type



--------------





grade environment

1- Production

2- Non-Production

-gt3- Development


DEFAULT




=================================================================

==============


--------------

------------







-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs









front-end app






-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT





=================================================================

==============

Installation Mode

-----------------



development and



typically used for




setup please



(Single Node)

2- Standalone Mode

(Existing)

3- Domain Mode



(Multi Node)


DEFAULT2










=================================================================

=======


--------------------------


default value





It should


(FQDN)


Port

(Default )








portgt










=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT


JBoss servers





=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------









====================================================

===========================




------------------------------------


57



=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)










to 1521 for oracle




user


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------








=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT






following

====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL


example dbclient




as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------



ltHostnameIPgt





Username(Default )



license_cujar


and JBoss servers






for DB2



















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------







l Data Tablespace




================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=================================================================

==============


-------------------------------











=================================================================

==============


---------------------



following

manual steps




successful













=================================================================

==============


-------------------------------








Email (Default )














=============================================================

==================


-------------------------------








=============================================================

==================


-------------------------------



appear

=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes



2- No


DEFAULT





=================================================================

==============


------------------------


Install Components


Install Folder

rootKonyFabric



Application Server

ltApp Servergt



Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names




=================================================================

=======

Ready To Install

-----------------------------------------




system


homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------




homeuser1KonyFabric



















authenticated













su - username






Linux




Unpacking the JRE


archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction



------------


of Kony Fabric


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required





have the SSL

certificate












tm






httpsupportkonycom






THE

DEFAULT


JBoss servers


=================================================================

=======

License Agreement

-----------------


the


KONY INC





AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE









=================================================================

==============

Installation Type

-----------------


existing

installation




DEFAULT




=================================================================

==============

Licensing Type

--------------


select the



larger


instance

1- Development

2- Non-Production

-gt3-

Production


DEFAULT






=================================================================

==============


--------------

------------





-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------










as APIs







front-end app






-gt1- Console






DEFAULT



















Kony Fabric Console


Enter



Reports Database











For example











=================================================================

======

Install Folder

---------------------





characters



rootmfdomainmode





=================================================================

==============

Application Server

------------------




-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT



=================================================================

==============

Installation Mode

-----------------









3- Domain Mode

(Multi Node)




DEFAULT










=================================================================

=======


--------------------------


default value is



or localhost


(FQDN)




addressportgt







communication









=================================================================

=======


---------------------------------



details appear

=================================================================

==============

Server Groups

-------------


configured


member of a


list of


application

1 main-server-group





12 or

all) (Default all)



=================================================================

==============


---------------------


1 main-server-group





THE

DEFAULT




=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT



=============================================================

===========


-----------------------------------------





Port (DEFAULT 3306)









example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57



=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1521)








to 1521 for oracle




user




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------






=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------





l Data Tablespace






================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1433)

Username 9Default )









1433 for SQL


example dbclient




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )





and JBoss servers






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=================================================================

==============


-------------------------------









details appear

=================================================================

==============




------------------------


Install Folder

rootKonyFabric

Components

Console


Installation Mode

Domain Mode


httpslthostnamegt


lthostnamegt

Database Server



ltIP addressgt

Database Names




=================================================================

=======

Ready To Install

-----------------------------------------


system


homeuser1KonyFabric





=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------


homeuser1KonyFabric

















authenticated













For Tomcat













(middleware)







For JBoss















(middleware)







For WebLogic














(middleware)


















For WebSphere















(middleware)

















Fabric Console










su - username




Linux




Unpacking the JRE


archive




Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric


services


support all of


scalable and


dramatically reduce





prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom




THE

DEFAULT


=================================================================

=======

License Agreement

-----------------




the


KONY INC



AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS




INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type

--------------





grade environment



1- Production

2- Non-Production

-gt3- Development


DEFAULT




=================================================================

==============


--------------

------------





-gt1- Yes



2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs







front-end app








-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT



=================================================================

==============


--------------------------






test201)









Management Server




details as follows

=============================================================

==================


--------------------------





details appear

=============================================================

==================

Server Groups

-------------




is a member of a


mentioned list of


this application

1 AdminServer


(eg 12 or

all) (Default all)



=============================================================

==================




---------------------


1 AdminServer




ACCEPT THE

DEFAULT





=============================================================

==================


---------------------





MS SQL database


WebLogic Server


continuing with

installation -







commEnv file







For Example








DEFAULT




=============================================================

==================


---------------------



DB2 database




Server


continuing with

installation -




commEnv file





For Example











=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2


DEFAULT



=============================================================

===========


-----------------------------------------





Port (DEFAULT 3306)









example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57





=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)








to 1521 for oracle






user


as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------






=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------







l Data Tablespace




================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1433)

Username 9Default )









1433 for SQL


example dbclient




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=================================================================

==============


-------------------------------











appear

=================================================================

==============


---------------------



following

manual steps




successful






=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes

2- No


DEFAULT





=================================================================

==============


------------------------




Installation Type

New Installation

Install

Components



Install Folder


Application Server






Database Choice

MySQL 57

Database Details


Database Names






=================================================================

=======

Ready To Install

-----------------------------------------




system


homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------




homeuser1KonyFabric

















authenticated














Fabric Console












su - username




Linux




Unpacking the JRE


archive


Launching installer

=================================================================

==============




------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -




SQL Server

and DB2 are the


only


have all required



have the SSL

certificate












tm








httpsupportkonycom




THE

DEFAULT


=================================================================

=======

License Agreement

-----------------


the


KONY INC





AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE









=================================================================

==============

Licensing Type

--------------


Database


updated to the






grade environment

1- Production

2- Non-Production



-gt3- Development


DEFAULT




=================================================================

==============


--------------

------------





-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components



------------------








as APIs







front-end app






-gt1- Console

























Kony Fabric Console


Enter





Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters





as follows

=================================================================

==============

Application Server

------------------




-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT


WebSphere appear



=================================================================

==============


--------------------------



select




Name] gt




101025

251)








Server


of WebSphere Server









=============================================================

==================


--------------------------






=============================================================

==================


-----------------------------


WebSphere server


WebSphere server





=============================================================

==================


-----------------------------






=============================================================

==================


-----------------------------


WebSphere server


WebSphere server





=============================================================

==================


-----------------------------



details appear

=============================================================

==================

Server Groups

-------------




you manage


affect more than a


from the available




1


er1


(Default 1)



=============================================================

==================


---------------------


1




er1




ACCEPT THE

DEFAULT


=============================================================

==================


------------------------------


6GB






=================================================================

=======

Database Choice

-----------------------------------------




-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2


DEFAULT



=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57



=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1521)








to 1521 for oracle




user


as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------






=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------





l Data Tablespace






================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL




example dbclient




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=================================================================

==============


-------------------------------












appear

=================================================================

==============


---------------------



following

manual steps




successful


















17 Press Enter


=================================================================

==============


-----------------------------------


installation of



Kony Fabric

-gt1- Yes

2- No


DEFAULT





=================================================================

==============


------------------------


Install Components


Install Folder



rootKonyFabric

Application Server

ltApp Servergt



Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names




=================================================================

=======

Ready To Install

-----------------------------------------




system


homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------




homeuser1KonyFabric



















authenticated













Fabric Console












extract the file
















Fabric components









71 Prerequisites


















expected








AIX


























configurations

81 Tomcat Server




82 JBoss Server








Documentation

83 WebLogic Server









documentation

84 WebSphere Server







documentation







following two ways





existing database





l Oracle




drop index





l MySQL









l DB2




pk



NULL





l MS SQL Server


GO


GO


version_pk]

GO


GO





GO


(50) NULL

GO

















921 Prerequisites






su - username




Linux




Unpacking the JRE


archive


Launching installer



=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -




database server



ready







tm





httpsupportkonycom






THE

DEFAULT



=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS


THE I




ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE



=================================================================

======

Get User Input

------------------


new

installation


Fabric In a




box However


for production

environment




DEFAULT 1


=================================================================

======


---------------------


that you



upgrade The


backups


your upgrade








=================================================================

==============


------------------------


Install Type


Install Components


Install Folder

rootUP652TO70

Application Server






Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names






=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]



[------------------|------------------|------------------|-------

-----------]

=================================================================

==============

Backup completed

----------------


In case of




------------------|------------------|------------------|---------

---------]


=================================================================

=======


-----------------------------------------




rootUP652TO70
























library












931 Prerequisites


your credentials









su - username




Linux




fresh installation





=================================================================

=======

Database Choice

-----------------------------------------




-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT



=================================================================

==============


-------------------------------



KonyXXXXX1




to the new





example Kony


example 1


=================================================================

==============


---------------------------------


databases


-gt1- No Go back



2- Yes Use existing


THE

DEFAULT 2


=================================================================

==============


Fabric instance


installation

is complete

1- SKIP

-gt2- OK


DEFAULT




Instance

=================================================================

==============


-------------------------------



=================================================================

==============


----------------------------------


installation of

Kony Fabric

-gt1- Yes

2- No




DEFAULT



l authServicekey








successful upgrade


screen appears

=================================================================

==============


-------------------------------






emails




Email (Default )





=================================================================

==============


------------------------


Install Type




Install Components


Install Folder

rootUP652TO70

Application Server




Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names






=================================================================

=======


-----------------------------------------


rootUP652TO70


















l Oracle



l MySQL



l DB2



l MS SQL Server






























For example



701x patches




installation



l 701 GA

l 71 GA

l 72 GA

l 73 GA

l V8

l V8 SP2

l V8 SP3 FP1



102 Prerequisites


























su - username










8xxGAbin




archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------









in this field



=============================================================

==================

Introduction

------------




rootsamplezip




=================================================================

==============


------------------------







notesDefaulthtm




replace the
















=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[-----------------


=================================================================

=======


-----------------------------------------




rootMFJB6525132












the following















=================================================================

==============


------------------------------------------------------------------

-------------




=================================================================

==============


-----------------------------------






3 Press Enter


database

=================================================================

==============

Delete Database

---------------


including




data after it

has been deleted



2- Retain all data


DEFAULT




=================================================================

==============

Uninstalling

---------------



=================================================================

==============

Uninstall Complete

------------------
























































































5 Save the changes





































l JBossMulti-node


l WebLogic

l WebSphere
















ltpoolgt




ltpoolgt









Passed





DBPASSED



healthDetail









version8211_GA
















l sapjco3jar







folder







following files

l sapjco3jar




path=sapjco3jargt





l sapjco3jar




path=sapjco3jargt



ltglobal-modulesgt


ltglobal-modulesgt





l sapjco3jar
















l sapjco3jar





file






installation

l Issue


Workaround


For MySQL

------------



For SQLServer

---------------



For Oracle

----------





For DB2

--------



l Issue




Workaround


l Issue



publish fails

Workaround


database

l Issue





Workaround



Server






Fabric












new values






l Issue




Workaround


table_open_cache=64


l Issue






Workaround







l Issue


authenticated

Workaround






Workaround










null



Workaround



Fabric



Workaround




configuration




INFclasses





INFclasses


in all nodes


INFclasses




Workaround




configuration




INFclasses






INFclasses


in all nodes


INFclasses


For example

Caused by




file_size

Workaround


themycnf file


files

For example

Workaround





l Issue



Workaround



l Issue



Workaround





version


version_rank



l Issue




from oracle

Workaround



l Issue



Workaround



l Issue


652GA to 72GA

Workaround






l Issue



Workaround




l Issue



Workaround

Manual Steps






















































l Issue


Workaround

Manual Steps












l Issue



Workaround

Manual Steps








GO

use msdb

GO


GO






GO


GO


GO


GO




GO


GO


GO




GO




GO


GO


GO


GO




GO


GO




GO



VIEWALTER TO userId

GO


GO


GO


GO



VIEWALTER TO userId

GO


GO




GO



VIEWALTER TO userId

GO







l Issue



Workaround

Manual Steps







and UNIX)





userid


userid


userid
























l Issue










Workaround


l Issue








l SQL State HY000

l Error Code 1093



Workaround


Services






changes


















number














mod_cluster


JBoss





























































installation






installation
















installation

































Example








139 WebSphere FAQs
























ACCOUNTS_LOG_LEVEL



















LEVEL





























Fabric





Visualizer)




Installer






install location


WARs


ii Go to Console




Components



Component



Consol

e

workspacewa

r

workspace

1war



Pathgttomcatwebapps


Fabric Install

Pathgtjboss gt


l WebLogic


deployments

l WebSphere lt


deployments


1war


1war


ar

authServic

e1war

Integra

tion

Admin

Server

l middle

warew

ar

l service

swar

l admin

war

l mid

dlew

are

1

war

l serv

ices

1

war

l adm

in

1

war

Engag

ement

Service

s

kpnswar kpns1war




SQL query



l MySQL



name=WAAS_BASE_URL

l Oracle



name=WAAS_BASE_URL

l SQLServer



name=WAAS_BASE_URL

l DB2



name=WAAS_BASE_URL


and JBoss servers













check









l MySQL





l Oracle



l SQLServer



l DB2




CONTEXT_PATH


and JBoss servers













serviceswar name


INFjboss-webxml

From


To






From


To





toWebSphere






context pathgt















follows









development


12 Publish the app







WARs


ii Go to Console




Fabric Components



Component



Conso

le

workspace

war

workspac

e1war



Pathgttomcatwebapps



Pathgtjboss gt

standalonedeploymen

ts

l WebLogic


ygtdeployments

l WebSphere lt


gtdeployments



Component



mfconsolew

ar

mfconsole

1war



Component



accountswa

r

accounts

1war

Identit

y

authService

war

authServi

ce1war

Integr

ation

Admin

Server

l middl

eware

war

l servic

eswa

r

l admin

war

l mi

ddl

ew

are

1

w

ar

l ser

vic

es

1

w

ar

l ad

mi

n1

w

ar

Engag

ement

Servic

es

kpnswar kpns

1war




SQL query



l MySQL



name=WAAS_BASE_URL

l Oracle



name=WAAS_BASE_URL

l SQLServer



name=WAAS_BASE_URL

l DB2



name=WAAS_BASE_URL


and JBoss servers













check









l MySQL





l Oracle



l SQLServer



l DB2




CONTEXT_PATH


and JBoss servers




Component


authS

ervice

authServiceproper

ties

authServicewar

WEB-INFclasses

l WEBSPHERE_

AUTHCONFIGDB_

JNDI_

NAME=jdbcauthconfig

l WEBSPHERE_

AUTHGLOBALDB_

JNDI_

NAME=jdbcauthglobal

db

Works

pace

workspaceService

properties

WorkspacewarW

EB-INFclasses

l WEBSPHERE_

WAASGLOBALDB_

JNDI_

NAME=jdbcworkspac

esglobaldb

l WEBSPHERE_

WORKSPACESDB_

JNDI_

NAME=jdbcworkspac

esglobaldb



Component


Accou

nts

accountspropertie

s

AccountswarWE

B-INFclasses

l ACCOUNTS_DB_

JNDI_

NAME=jdbckonyacco

unts REPORTS_DB_

JNDI_

NAME=jdbckonyreport

s

Integr

ation

Admin

Server

serverconsoleprop

erties

adminwarWEB-

INFmiddlewarem

iddleware-

bootconfigadmin


ckonyadmindb


bckonyreports













serviceswar name


INFjboss-webxml

From


To






From


To





toWebSphere






context pathgt















follows









development


13 Publish the app


prise



Enterprise







example mfconsole1


example accounts1






example mfidentity1











file

For example






build

6 Save the file









1 Preface

11 Purpose




15 Contact Us

2 Prerequisites



23 Network Settings














56 Memcached Server









71 Prerequisites






81 Tomcat Server

82 JBoss Server

83 WebLogic Server

84 WebSphere Server









102 Prerequisites





















139 WebSphere FAQs




Revision History





Kony Fabric 82



8x



WebSphere
















Table of Contents

1 Preface 9

11 Purpose 10




15 Contact Us 12

2 Prerequisites 13



































82 JBoss Server 366























DomainMode 412



















1 Preface







centralized console












andOAuth Provider


Yahoo













services They are



met


Objects







11 Purpose












l File path

l Commands

l Program code

l File names

Italic l Emphasis


l New terminology

Bold l Windows

l Menus

l Buttons

l Icons

l Fields

l Tabs







data


Document Purpose

Kony Fabric User

Guide



15 Contact Us






2 Prerequisites


Fabric Console






Memory 16GB





23 Network Settings



Protocol

Direction

Action

Description

Engageme

nt Server


ce


Engageme

nt Server

to access

Apple

APNS

HTTP2

production

URL

Engageme

nt Server


d

Allow Allow the

Engageme

nt Server

to access

the JPush

notification

server

URL

Engageme

nt Server


m4433device


Engageme

nt Server

to access

Apple

APNS

HTTP2

developme

nt URL




Protocol

Direction

Action

Description

Engage

ment

Server


3

TCP Outb

ound

All

o

w

Allow

the

Engage

ment

Server

to

access

Firebas

e Cloud

Messa

ging

(FCM)

service

Engage

ment

Server



m 170008 (17001 to

17255255254)

21

96

TCP Outb

ound

All

o

w

Allow

the

Engage

ment

Server

to

access

APNS

feedba

ck

service




Protocol

Direction

Action

Description

Engage

ment

Server

gatewaypushapplecom


170008 (17001 to

17255255254)

21

95

TCP Outb

ound

All

o

w

Allow

the

Engage

ment

Server

to

access

Apples

APNS

Engage

ment

Server

All subdomains of


Sample Push URL



mmssPD_pushRequest

44

3

TCP Outb

ound

All

o

w

Allow

connec

t to

Blackb

erry

Cloud

through

this

port

Engage

ment

Server


3

TCP Outb

ound

All

o

w

Allow

connec

t to

Windo

ws

Cloud

(MPN

S)

through

this

port




Protocol

Direction

Action

Description

Engage

ment

Server


3

TCP Outb

ound

All

o

w

Allow

connec

t to

Windo

ws

Cloud

(WNS)

through

this

port

Internal

Corpor

ate

WiFi

router

for

Android

Mobile

Device

s






Addresses

httpbgphenetAS15169

52

2

8

52

2

9

52

30

TC

P

HTT

P

HTT

PS

UD

P

Both All

o

w

Android

device

s will

connec

t to

GCM

through

this

port

Internal

Corpor

ate

WiFi

router

for iOS

Device

s

gatewaypushapplecom




m 170008 (17001 to

17255255254)

52

23

TCP Both All

o

w

Apple

device

s

connec

t to

APNS

servers

through

this

port




Protocol

Direction

Action

Description

Internal

Corpor

ate

WiFi

router

for iOS

Device

s


ocspapplecom

8

0

44

3

TCP Both All

o

w

Apple

device

s will

connec

t to

public

Apple

OCSP

and

iTunes

service

through

this

port

Internal

Corpor

ate

WiFi

router

for

Windo

w

Device

s


followingWNS URL



8

TC

P

HTT

P

HTT

PS

UD

P

Both All

o

w

Windo

ws

device

s will

connec

t to

WNS

through

this

port




Protocol

Direction

Action

Description

Internal

Corpor

ate

WiFi

router

for

Windo

w

Device

s


followingMPNS URL



5

TC

P

HTT

P

HTT

PS

UD

P

Both All

o

w

Windo

ws

device

s will

connec

t to

MPNS

through

this

port


























Auth Servicerdquo



l 5420819284

l 54208192248





non-root user




adduser core

passwd core






use


















objects
































CONTAINER=CURRENT


CONTAINER=CURRENT


CONTAINER=CURRENT













servers







version










big pagesize of 32k





COMMIT



IBMDEFAULTGROUP


AUTOMATIC



COMMIT





IBMDEFAULTGROUP


AUTOMATIC



COMMIT



IBMDEFAULTGROUP


AUTOMATIC



COMMIT


IBMTEMPGROUP


EXTENTSIZE 1M


COMMIT

CONNECT RESET


























both editions










collation support





[client]


[mysql]


[mysqld]|






+----------------------+-----------------+


+----------------------+-----------------+




+----------------------+-----------------+





+--------------------------+----------------------------+


+--------------------------+----------------------------+









+--------------------------+----------------------------+




database





l SQL State HY000

l Error Code 1093























temp folder)



































servers






servers








masterslavemachines










ltglobal-modulesgt


ltglobal-modulesgt

6 Save the changes




JBoss



ltinterfacesgt



ltinterfacegt



ltinterfacegt

ltinterfacesgt














inheritance=DEEPgt|

ltsubsystemgt



l standalonebat


l standalonesh










realms section



ltsslgt




ltsslgt


ltsecurity-realmgt


































binding=connectgt











credentialsgt


















D parameter






JVM arguments

















l Set JVM heap size
















(for Java7)










































and authorization



role






roles

Workspace

(WaaS)






application

API Developer

Portal








Environments

(Engagement

Services

Integration

Services)








optional component


















on separate nodes





Installation



Install Guide


node (Domain Mode)














Multinode


LinuxVersion111



local environment


installations


Console

l Workspace

l Accounts

Identity

Integration

l Admin

l Middleware

l Services

l Metrics


Engagement Services


















n READMEtxt


database















temp folder)
















whereis libevent






configure

make

make install




56 Memcached Server










cd memcached-126

configure

make

make install



listen to p = port)


Multinode



the headers




For example









































l local_policyjar






policyfileshtml












l local_policyjar


l READMEtxt


homegtlibsecurity











591 MySQL




application size










592 Oracle




component


















i Connect as SYSDBA

sqlplus as sysdba



sysaux


creation






Conn mdsyssecret


creation






like SDO














edition licensing



593 Maria DB







minimum value


5101 JBoss


Load Balancer)





proxy-port details



secure=truegt





ltinterfacesgt



ltinterfacegt



ltinterfacegt



figuration



ltinterfacegt



ltinterfacegt

ltinterfacesgt








domainxml file




ltsubsystemgt --gt






JBoss







-Xms2048m

-Xmx4096m



shown below






gt

ltsubsystemgt









settings







5102 WebLogic



























5103 WebSphere











Custom Properties





















java executablegt



changes




























installations)


Fabric on Linux



































su - username




Linux






Unpacking the JRE


archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------




of Kony Fabric


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom




THE



DEFAULT


servers


=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS




THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type



--------------





grade environment

1- Development

2- Non-Production

-gt3-

Production


DEFAULT




=================================================================

==============


--------------

------------







-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs









front-end app






-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT







usersxml






configuration table


=================================================================

=======

HTTP or HTTPS

-------------



-gt1- HTTP

2- HTTPS




DEFAULT



=============================================================

==================


------------------------------


use The default



ltIP addressgt


8181







=============================================================

==================


------------------------------


use The default



please have the



ltIP addressgt
















=========================================================

======================


-------------------------








TO ACCEPT THE

DEFAULT


=========================================================

======================

Port Validation

---------------


65535




TO ACCEPT THE

DEFAULT


error message

=========================================================

======================


---------------------------







TO ACCEPT THE

DEFAULT




=================================================================

=======


-----------------------------------------







DEFAULT





=============================================================

===========


-----------------------------------------


certificate All the









City (DEFAULT ) HYD

State (DEFAULT ) AP






=============================================================

===========


-----------------------







=============================================================

===========


-----------------------------------------


contain space





=========================================================

===============


-----------------------------------------

=========================================================

===============




-------------------------


should not contain

space




=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT




JBoss servers



=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57



=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)










to 1521 for oracle




user


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------








=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT






following

====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL


example dbclient




as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------












location




install folder









ltContextgt



SQLServerDriver




maxWait=10000






testWhileIdle=true



url=jdbcsqlserver










SQLServerDriver




maxWait=10000






testWhileIdle=true



url=jdbcsqlserver






ltContextgt



and JBoss servers

=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=================================================================

==============


-------------------------------









=================================================================

==============


---------------------





following

manual steps




successful











=================================================================

==============


-------------------------------










Email (Default )














=============================================================

==================


-------------------------------






=============================================================

==================




-------------------------------



appear

=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes

2- No


DEFAULT







==================================================


------------------------


Installation Type

New Installation

Install Components



Install Folder




Application Server

Tomcat 8532



8080

Database Choice

MySQL 57

Database Details


Port 3306

Database Names








===========================================================

Installing

-------------

[==================|==================|==================]


=================================================================

=======

Ready To Install

-----------------------------------------


system




homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------


homeuser1KonyFabric



















authenticated











ations)






Mode)










Fabric Console










su - username




Linux






Unpacking the JRE


archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric




services


support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom






THE

DEFAULT


=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE




BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type

--------------







grade environment

1- Development

2- Non-Production

-gt3-

Production


DEFAULT




=================================================================

==============


--------------

------------







-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs









front-end app






-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT





usersxml








configuration table


=================================================================

==============

Installation Mode

-----------------








(Single Node)

2- Standalone Mode

(Existing)

3- Domain Mode



(Multi Node)


DEFAULT














=================================================================

=======

HTTP or HTTPS

-------------



-gt1- HTTP



2- HTTPS


DEFAULT



=============================================================

==================


------------------------------

=============================================================

==================


use The default



ltIP addressgt


8181





=============================================================

==================


------------------------------


use The default



please have the



ltIP addressgt















=========================================================

======================


-------------------------






TO ACCEPT THE

DEFAULT




=========================================================

======================

Port Validation

---------------


65535




TO ACCEPT THE

DEFAULT


error message

=========================================================

======================


---------------------------







TO ACCEPT THE

DEFAULT




=================================================================

=======


-----------------------------------------







DEFAULT





=============================================================

===========


-----------------------------------------


certificate All the









City (DEFAULT ) HYD

State (DEFAULT ) AP






=============================================================

===========


-----------------------







=============================================================

===========


-----------------------------------------


contain space





=========================================================

===============


-----------------------------------------

=========================================================

===============


-------------------------




should not contain

space




=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT


JBoss servers





=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------









====================================================

===========================




------------------------------------


57



=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)










to 1521 for oracle




user


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------








=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT






following

====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL


example dbclient




as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------



ltHostnameIPgt





Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------





l Data Tablespace






================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=================================================================

==============


-------------------------------











=================================================================

==============


---------------------



following

manual steps




successful













=================================================================

==============


-------------------------------








Email (Default )














=============================================================

==================


-------------------------------








=============================================================

==================


-------------------------------



appear

=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes



2- No


DEFAULT





=================================================================

==============


------------------------


Installation Type

New Installation

Install Components



Install Folder


Application Server






Database Choice

MySQL 57

Database Details


Database Names



testkpnsdbjboss



=================================================================

=======

Ready To Install

-----------------------------------------


system


homeuser1KonyFabric





=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------


homeuser1KonyFabric



















authenticated













For Tomcat


following locations


















For JBoss


following locations




















For WebLogic


following locations






























For WebSphere


following locations








































su - username




Linux




Unpacking the JRE




archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric


services




support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom






THE

DEFAULT


JBoss servers


=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS




THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type



--------------





grade environment

1- Production

2- Non-Production

-gt3- Development


DEFAULT




=================================================================

==============


--------------

------------







-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs









front-end app






-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT





=================================================================

==============

Installation Mode

-----------------



development and



typically used for




setup please



(Single Node)

2- Standalone Mode

(Existing)

3- Domain Mode



(Multi Node)


DEFAULT2










=================================================================

=======


--------------------------


default value





It should


(FQDN)


Port

(Default )








portgt










=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT


JBoss servers





=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------









====================================================

===========================




------------------------------------


57



=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)










to 1521 for oracle




user


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------








=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT






following

====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL


example dbclient




as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------



ltHostnameIPgt





Username(Default )



license_cujar


and JBoss servers






for DB2



















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------







l Data Tablespace




================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=================================================================

==============


-------------------------------











=================================================================

==============


---------------------



following

manual steps




successful













=================================================================

==============


-------------------------------








Email (Default )














=============================================================

==================


-------------------------------








=============================================================

==================


-------------------------------



appear

=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes



2- No


DEFAULT





=================================================================

==============


------------------------


Install Components


Install Folder

rootKonyFabric



Application Server

ltApp Servergt



Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names




=================================================================

=======

Ready To Install

-----------------------------------------




system


homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------




homeuser1KonyFabric



















authenticated













su - username






Linux




Unpacking the JRE


archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction



------------


of Kony Fabric


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required





have the SSL

certificate












tm






httpsupportkonycom






THE

DEFAULT


JBoss servers


=================================================================

=======

License Agreement

-----------------


the


KONY INC





AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE









=================================================================

==============

Installation Type

-----------------


existing

installation




DEFAULT




=================================================================

==============

Licensing Type

--------------


select the



larger


instance

1- Development

2- Non-Production

-gt3-

Production


DEFAULT






=================================================================

==============


--------------

------------





-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------










as APIs







front-end app






-gt1- Console






DEFAULT



















Kony Fabric Console


Enter



Reports Database











For example











=================================================================

======

Install Folder

---------------------





characters



rootmfdomainmode





=================================================================

==============

Application Server

------------------




-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT



=================================================================

==============

Installation Mode

-----------------









3- Domain Mode

(Multi Node)




DEFAULT










=================================================================

=======


--------------------------


default value is



or localhost


(FQDN)




addressportgt







communication









=================================================================

=======


---------------------------------



details appear

=================================================================

==============

Server Groups

-------------


configured


member of a


list of


application

1 main-server-group





12 or

all) (Default all)



=================================================================

==============


---------------------


1 main-server-group





THE

DEFAULT




=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT



=============================================================

===========


-----------------------------------------





Port (DEFAULT 3306)









example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57



=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1521)








to 1521 for oracle




user




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------






=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------





l Data Tablespace






================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1433)

Username 9Default )









1433 for SQL


example dbclient




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )





and JBoss servers






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=================================================================

==============


-------------------------------









details appear

=================================================================

==============




------------------------


Install Folder

rootKonyFabric

Components

Console


Installation Mode

Domain Mode


httpslthostnamegt


lthostnamegt

Database Server



ltIP addressgt

Database Names




=================================================================

=======

Ready To Install

-----------------------------------------


system


homeuser1KonyFabric





=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------


homeuser1KonyFabric

















authenticated













For Tomcat













(middleware)







For JBoss















(middleware)







For WebLogic














(middleware)


















For WebSphere















(middleware)

















Fabric Console










su - username




Linux




Unpacking the JRE


archive




Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric


services


support all of


scalable and


dramatically reduce





prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom




THE

DEFAULT


=================================================================

=======

License Agreement

-----------------




the


KONY INC



AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS




INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type

--------------





grade environment



1- Production

2- Non-Production

-gt3- Development


DEFAULT




=================================================================

==============


--------------

------------





-gt1- Yes



2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs







front-end app








-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT



=================================================================

==============


--------------------------






test201)









Management Server




details as follows

=============================================================

==================


--------------------------





details appear

=============================================================

==================

Server Groups

-------------




is a member of a


mentioned list of


this application

1 AdminServer


(eg 12 or

all) (Default all)



=============================================================

==================




---------------------


1 AdminServer




ACCEPT THE

DEFAULT





=============================================================

==================


---------------------





MS SQL database


WebLogic Server


continuing with

installation -







commEnv file







For Example








DEFAULT




=============================================================

==================


---------------------



DB2 database




Server


continuing with

installation -




commEnv file





For Example











=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2


DEFAULT



=============================================================

===========


-----------------------------------------





Port (DEFAULT 3306)









example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57





=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)








to 1521 for oracle






user


as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------






=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------







l Data Tablespace




================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1433)

Username 9Default )









1433 for SQL


example dbclient




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=================================================================

==============


-------------------------------











appear

=================================================================

==============


---------------------



following

manual steps




successful






=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes

2- No


DEFAULT





=================================================================

==============


------------------------




Installation Type

New Installation

Install

Components



Install Folder


Application Server






Database Choice

MySQL 57

Database Details


Database Names






=================================================================

=======

Ready To Install

-----------------------------------------




system


homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------




homeuser1KonyFabric

















authenticated














Fabric Console












su - username




Linux




Unpacking the JRE


archive


Launching installer

=================================================================

==============




------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -




SQL Server

and DB2 are the


only


have all required



have the SSL

certificate












tm








httpsupportkonycom




THE

DEFAULT


=================================================================

=======

License Agreement

-----------------


the


KONY INC





AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE









=================================================================

==============

Licensing Type

--------------


Database


updated to the






grade environment

1- Production

2- Non-Production



-gt3- Development


DEFAULT




=================================================================

==============


--------------

------------





-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components



------------------








as APIs







front-end app






-gt1- Console

























Kony Fabric Console


Enter





Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters





as follows

=================================================================

==============

Application Server

------------------




-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT


WebSphere appear



=================================================================

==============


--------------------------



select




Name] gt




101025

251)








Server


of WebSphere Server









=============================================================

==================


--------------------------






=============================================================

==================


-----------------------------


WebSphere server


WebSphere server





=============================================================

==================


-----------------------------






=============================================================

==================


-----------------------------


WebSphere server


WebSphere server





=============================================================

==================


-----------------------------



details appear

=============================================================

==================

Server Groups

-------------




you manage


affect more than a


from the available




1


er1


(Default 1)



=============================================================

==================


---------------------


1




er1




ACCEPT THE

DEFAULT


=============================================================

==================


------------------------------


6GB






=================================================================

=======

Database Choice

-----------------------------------------




-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2


DEFAULT



=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57



=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1521)








to 1521 for oracle




user


as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------






=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------





l Data Tablespace






================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL




example dbclient




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=================================================================

==============


-------------------------------












appear

=================================================================

==============


---------------------



following

manual steps




successful


















17 Press Enter


=================================================================

==============


-----------------------------------


installation of



Kony Fabric

-gt1- Yes

2- No


DEFAULT





=================================================================

==============


------------------------


Install Components


Install Folder



rootKonyFabric

Application Server

ltApp Servergt



Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names




=================================================================

=======

Ready To Install

-----------------------------------------




system


homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------




homeuser1KonyFabric



















authenticated













Fabric Console












extract the file
















Fabric components









71 Prerequisites


















expected








AIX


























configurations

81 Tomcat Server




82 JBoss Server








Documentation

83 WebLogic Server









documentation

84 WebSphere Server







documentation







following two ways





existing database





l Oracle




drop index





l MySQL









l DB2




pk



NULL





l MS SQL Server


GO


GO


version_pk]

GO


GO





GO


(50) NULL

GO

















921 Prerequisites






su - username




Linux




Unpacking the JRE


archive


Launching installer



=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -




database server



ready







tm





httpsupportkonycom






THE

DEFAULT



=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS


THE I




ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE



=================================================================

======

Get User Input

------------------


new

installation


Fabric In a




box However


for production

environment




DEFAULT 1


=================================================================

======


---------------------


that you



upgrade The


backups


your upgrade








=================================================================

==============


------------------------


Install Type


Install Components


Install Folder

rootUP652TO70

Application Server






Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names






=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]



[------------------|------------------|------------------|-------

-----------]

=================================================================

==============

Backup completed

----------------


In case of




------------------|------------------|------------------|---------

---------]


=================================================================

=======


-----------------------------------------




rootUP652TO70
























library












931 Prerequisites


your credentials









su - username




Linux




fresh installation





=================================================================

=======

Database Choice

-----------------------------------------




-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT



=================================================================

==============


-------------------------------



KonyXXXXX1




to the new





example Kony


example 1


=================================================================

==============


---------------------------------


databases


-gt1- No Go back



2- Yes Use existing


THE

DEFAULT 2


=================================================================

==============


Fabric instance


installation

is complete

1- SKIP

-gt2- OK


DEFAULT




Instance

=================================================================

==============


-------------------------------



=================================================================

==============


----------------------------------


installation of

Kony Fabric

-gt1- Yes

2- No




DEFAULT



l authServicekey








successful upgrade


screen appears

=================================================================

==============


-------------------------------






emails




Email (Default )





=================================================================

==============


------------------------


Install Type




Install Components


Install Folder

rootUP652TO70

Application Server




Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names






=================================================================

=======


-----------------------------------------


rootUP652TO70


















l Oracle



l MySQL



l DB2



l MS SQL Server






























For example



701x patches




installation



l 701 GA

l 71 GA

l 72 GA

l 73 GA

l V8

l V8 SP2

l V8 SP3 FP1



102 Prerequisites


























su - username










8xxGAbin




archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------









in this field



=============================================================

==================

Introduction

------------




rootsamplezip




=================================================================

==============


------------------------







notesDefaulthtm




replace the
















=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[-----------------


=================================================================

=======


-----------------------------------------




rootMFJB6525132












the following















=================================================================

==============


------------------------------------------------------------------

-------------




=================================================================

==============


-----------------------------------






3 Press Enter


database

=================================================================

==============

Delete Database

---------------


including




data after it

has been deleted



2- Retain all data


DEFAULT




=================================================================

==============

Uninstalling

---------------



=================================================================

==============

Uninstall Complete

------------------
























































































5 Save the changes





































l JBossMulti-node


l WebLogic

l WebSphere
















ltpoolgt




ltpoolgt









Passed





DBPASSED



healthDetail









version8211_GA
















l sapjco3jar







folder







following files

l sapjco3jar




path=sapjco3jargt





l sapjco3jar




path=sapjco3jargt



ltglobal-modulesgt


ltglobal-modulesgt





l sapjco3jar
















l sapjco3jar





file






installation

l Issue


Workaround


For MySQL

------------



For SQLServer

---------------



For Oracle

----------





For DB2

--------



l Issue




Workaround


l Issue



publish fails

Workaround


database

l Issue





Workaround



Server






Fabric












new values






l Issue




Workaround


table_open_cache=64


l Issue






Workaround







l Issue


authenticated

Workaround






Workaround










null



Workaround



Fabric



Workaround




configuration




INFclasses





INFclasses


in all nodes


INFclasses




Workaround




configuration




INFclasses






INFclasses


in all nodes


INFclasses


For example

Caused by




file_size

Workaround


themycnf file


files

For example

Workaround





l Issue



Workaround



l Issue



Workaround





version


version_rank



l Issue




from oracle

Workaround



l Issue



Workaround



l Issue


652GA to 72GA

Workaround






l Issue



Workaround




l Issue



Workaround

Manual Steps






















































l Issue


Workaround

Manual Steps












l Issue



Workaround

Manual Steps








GO

use msdb

GO


GO






GO


GO


GO


GO




GO


GO


GO




GO




GO


GO


GO


GO




GO


GO




GO



VIEWALTER TO userId

GO


GO


GO


GO



VIEWALTER TO userId

GO


GO




GO



VIEWALTER TO userId

GO







l Issue



Workaround

Manual Steps







and UNIX)





userid


userid


userid
























l Issue










Workaround


l Issue








l SQL State HY000

l Error Code 1093



Workaround


Services






changes


















number














mod_cluster


JBoss





























































installation






installation
















installation

































Example








139 WebSphere FAQs
























ACCOUNTS_LOG_LEVEL



















LEVEL





























Fabric





Visualizer)




Installer






install location


WARs


ii Go to Console




Components



Component



Consol

e

workspacewa

r

workspace

1war



Pathgttomcatwebapps


Fabric Install

Pathgtjboss gt


l WebLogic


deployments

l WebSphere lt


deployments


1war


1war


ar

authServic

e1war

Integra

tion

Admin

Server

l middle

warew

ar

l service

swar

l admin

war

l mid

dlew

are

1

war

l serv

ices

1

war

l adm

in

1

war

Engag

ement

Service

s

kpnswar kpns1war




SQL query



l MySQL



name=WAAS_BASE_URL

l Oracle



name=WAAS_BASE_URL

l SQLServer



name=WAAS_BASE_URL

l DB2



name=WAAS_BASE_URL


and JBoss servers













check









l MySQL





l Oracle



l SQLServer



l DB2




CONTEXT_PATH


and JBoss servers













serviceswar name


INFjboss-webxml

From


To






From


To





toWebSphere






context pathgt















follows









development


12 Publish the app







WARs


ii Go to Console




Fabric Components



Component



Conso

le

workspace

war

workspac

e1war



Pathgttomcatwebapps



Pathgtjboss gt

standalonedeploymen

ts

l WebLogic


ygtdeployments

l WebSphere lt


gtdeployments



Component



mfconsolew

ar

mfconsole

1war



Component



accountswa

r

accounts

1war

Identit

y

authService

war

authServi

ce1war

Integr

ation

Admin

Server

l middl

eware

war

l servic

eswa

r

l admin

war

l mi

ddl

ew

are

1

w

ar

l ser

vic

es

1

w

ar

l ad

mi

n1

w

ar

Engag

ement

Servic

es

kpnswar kpns

1war




SQL query



l MySQL



name=WAAS_BASE_URL

l Oracle



name=WAAS_BASE_URL

l SQLServer



name=WAAS_BASE_URL

l DB2



name=WAAS_BASE_URL


and JBoss servers













check









l MySQL





l Oracle



l SQLServer



l DB2




CONTEXT_PATH


and JBoss servers




Component


authS

ervice

authServiceproper

ties

authServicewar

WEB-INFclasses

l WEBSPHERE_

AUTHCONFIGDB_

JNDI_

NAME=jdbcauthconfig

l WEBSPHERE_

AUTHGLOBALDB_

JNDI_

NAME=jdbcauthglobal

db

Works

pace

workspaceService

properties

WorkspacewarW

EB-INFclasses

l WEBSPHERE_

WAASGLOBALDB_

JNDI_

NAME=jdbcworkspac

esglobaldb

l WEBSPHERE_

WORKSPACESDB_

JNDI_

NAME=jdbcworkspac

esglobaldb



Component


Accou

nts

accountspropertie

s

AccountswarWE

B-INFclasses

l ACCOUNTS_DB_

JNDI_

NAME=jdbckonyacco

unts REPORTS_DB_

JNDI_

NAME=jdbckonyreport

s

Integr

ation

Admin

Server

serverconsoleprop

erties

adminwarWEB-

INFmiddlewarem

iddleware-

bootconfigadmin


ckonyadmindb


bckonyreports













serviceswar name


INFjboss-webxml

From


To






From


To





toWebSphere






context pathgt















follows









development


13 Publish the app


prise



Enterprise







example mfconsole1


example accounts1






example mfidentity1











file

For example






build

6 Save the file









1 Preface

11 Purpose




15 Contact Us

2 Prerequisites



23 Network Settings














56 Memcached Server









71 Prerequisites






81 Tomcat Server

82 JBoss Server

83 WebLogic Server

84 WebSphere Server









102 Prerequisites





















139 WebSphere FAQs






Table of Contents

1 Preface 9

11 Purpose 10




15 Contact Us 12

2 Prerequisites 13



































82 JBoss Server 366























DomainMode 412



















1 Preface







centralized console












andOAuth Provider


Yahoo













services They are



met


Objects







11 Purpose












l File path

l Commands

l Program code

l File names

Italic l Emphasis


l New terminology

Bold l Windows

l Menus

l Buttons

l Icons

l Fields

l Tabs







data


Document Purpose

Kony Fabric User

Guide



15 Contact Us






2 Prerequisites


Fabric Console






Memory 16GB





23 Network Settings



Protocol

Direction

Action

Description

Engageme

nt Server


ce


Engageme

nt Server

to access

Apple

APNS

HTTP2

production

URL

Engageme

nt Server


d

Allow Allow the

Engageme

nt Server

to access

the JPush

notification

server

URL

Engageme

nt Server


m4433device


Engageme

nt Server

to access

Apple

APNS

HTTP2

developme

nt URL




Protocol

Direction

Action

Description

Engage

ment

Server


3

TCP Outb

ound

All

o

w

Allow

the

Engage

ment

Server

to

access

Firebas

e Cloud

Messa

ging

(FCM)

service

Engage

ment

Server



m 170008 (17001 to

17255255254)

21

96

TCP Outb

ound

All

o

w

Allow

the

Engage

ment

Server

to

access

APNS

feedba

ck

service




Protocol

Direction

Action

Description

Engage

ment

Server

gatewaypushapplecom


170008 (17001 to

17255255254)

21

95

TCP Outb

ound

All

o

w

Allow

the

Engage

ment

Server

to

access

Apples

APNS

Engage

ment

Server

All subdomains of


Sample Push URL



mmssPD_pushRequest

44

3

TCP Outb

ound

All

o

w

Allow

connec

t to

Blackb

erry

Cloud

through

this

port

Engage

ment

Server


3

TCP Outb

ound

All

o

w

Allow

connec

t to

Windo

ws

Cloud

(MPN

S)

through

this

port




Protocol

Direction

Action

Description

Engage

ment

Server


3

TCP Outb

ound

All

o

w

Allow

connec

t to

Windo

ws

Cloud

(WNS)

through

this

port

Internal

Corpor

ate

WiFi

router

for

Android

Mobile

Device

s






Addresses

httpbgphenetAS15169

52

2

8

52

2

9

52

30

TC

P

HTT

P

HTT

PS

UD

P

Both All

o

w

Android

device

s will

connec

t to

GCM

through

this

port

Internal

Corpor

ate

WiFi

router

for iOS

Device

s

gatewaypushapplecom




m 170008 (17001 to

17255255254)

52

23

TCP Both All

o

w

Apple

device

s

connec

t to

APNS

servers

through

this

port




Protocol

Direction

Action

Description

Internal

Corpor

ate

WiFi

router

for iOS

Device

s


ocspapplecom

8

0

44

3

TCP Both All

o

w

Apple

device

s will

connec

t to

public

Apple

OCSP

and

iTunes

service

through

this

port

Internal

Corpor

ate

WiFi

router

for

Windo

w

Device

s


followingWNS URL



8

TC

P

HTT

P

HTT

PS

UD

P

Both All

o

w

Windo

ws

device

s will

connec

t to

WNS

through

this

port




Protocol

Direction

Action

Description

Internal

Corpor

ate

WiFi

router

for

Windo

w

Device

s


followingMPNS URL



5

TC

P

HTT

P

HTT

PS

UD

P

Both All

o

w

Windo

ws

device

s will

connec

t to

MPNS

through

this

port


























Auth Servicerdquo



l 5420819284

l 54208192248





non-root user




adduser core

passwd core






use


















objects
































CONTAINER=CURRENT


CONTAINER=CURRENT


CONTAINER=CURRENT













servers







version










big pagesize of 32k





COMMIT



IBMDEFAULTGROUP


AUTOMATIC



COMMIT





IBMDEFAULTGROUP


AUTOMATIC



COMMIT



IBMDEFAULTGROUP


AUTOMATIC



COMMIT


IBMTEMPGROUP


EXTENTSIZE 1M


COMMIT

CONNECT RESET


























both editions










collation support





[client]


[mysql]


[mysqld]|






+----------------------+-----------------+


+----------------------+-----------------+




+----------------------+-----------------+





+--------------------------+----------------------------+


+--------------------------+----------------------------+









+--------------------------+----------------------------+




database





l SQL State HY000

l Error Code 1093























temp folder)



































servers






servers








masterslavemachines










ltglobal-modulesgt


ltglobal-modulesgt

6 Save the changes




JBoss



ltinterfacesgt



ltinterfacegt



ltinterfacegt

ltinterfacesgt














inheritance=DEEPgt|

ltsubsystemgt



l standalonebat


l standalonesh










realms section



ltsslgt




ltsslgt


ltsecurity-realmgt


































binding=connectgt











credentialsgt


















D parameter






JVM arguments

















l Set JVM heap size
















(for Java7)










































and authorization



role






roles

Workspace

(WaaS)






application

API Developer

Portal








Environments

(Engagement

Services

Integration

Services)








optional component


















on separate nodes





Installation



Install Guide


node (Domain Mode)














Multinode


LinuxVersion111



local environment


installations


Console

l Workspace

l Accounts

Identity

Integration

l Admin

l Middleware

l Services

l Metrics


Engagement Services


















n READMEtxt


database















temp folder)
















whereis libevent






configure

make

make install




56 Memcached Server










cd memcached-126

configure

make

make install



listen to p = port)


Multinode



the headers




For example









































l local_policyjar






policyfileshtml












l local_policyjar


l READMEtxt


homegtlibsecurity











591 MySQL




application size










592 Oracle




component


















i Connect as SYSDBA

sqlplus as sysdba



sysaux


creation






Conn mdsyssecret


creation






like SDO














edition licensing



593 Maria DB







minimum value


5101 JBoss


Load Balancer)





proxy-port details



secure=truegt





ltinterfacesgt



ltinterfacegt



ltinterfacegt



figuration



ltinterfacegt



ltinterfacegt

ltinterfacesgt








domainxml file




ltsubsystemgt --gt






JBoss







-Xms2048m

-Xmx4096m



shown below






gt

ltsubsystemgt









settings







5102 WebLogic



























5103 WebSphere











Custom Properties





















java executablegt



changes




























installations)


Fabric on Linux



































su - username




Linux






Unpacking the JRE


archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------




of Kony Fabric


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom




THE



DEFAULT


servers


=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS




THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type



--------------





grade environment

1- Development

2- Non-Production

-gt3-

Production


DEFAULT




=================================================================

==============


--------------

------------







-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs









front-end app






-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT







usersxml






configuration table


=================================================================

=======

HTTP or HTTPS

-------------



-gt1- HTTP

2- HTTPS




DEFAULT



=============================================================

==================


------------------------------


use The default



ltIP addressgt


8181







=============================================================

==================


------------------------------


use The default



please have the



ltIP addressgt
















=========================================================

======================


-------------------------








TO ACCEPT THE

DEFAULT


=========================================================

======================

Port Validation

---------------


65535




TO ACCEPT THE

DEFAULT


error message

=========================================================

======================


---------------------------







TO ACCEPT THE

DEFAULT




=================================================================

=======


-----------------------------------------







DEFAULT





=============================================================

===========


-----------------------------------------


certificate All the









City (DEFAULT ) HYD

State (DEFAULT ) AP






=============================================================

===========


-----------------------







=============================================================

===========


-----------------------------------------


contain space





=========================================================

===============


-----------------------------------------

=========================================================

===============




-------------------------


should not contain

space




=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT




JBoss servers



=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57



=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)










to 1521 for oracle




user


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------








=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT






following

====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL


example dbclient




as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------












location




install folder









ltContextgt



SQLServerDriver




maxWait=10000






testWhileIdle=true



url=jdbcsqlserver










SQLServerDriver




maxWait=10000






testWhileIdle=true



url=jdbcsqlserver






ltContextgt



and JBoss servers

=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=================================================================

==============


-------------------------------









=================================================================

==============


---------------------





following

manual steps




successful











=================================================================

==============


-------------------------------










Email (Default )














=============================================================

==================


-------------------------------






=============================================================

==================




-------------------------------



appear

=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes

2- No


DEFAULT







==================================================


------------------------


Installation Type

New Installation

Install Components



Install Folder




Application Server

Tomcat 8532



8080

Database Choice

MySQL 57

Database Details


Port 3306

Database Names








===========================================================

Installing

-------------

[==================|==================|==================]


=================================================================

=======

Ready To Install

-----------------------------------------


system




homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------


homeuser1KonyFabric



















authenticated











ations)






Mode)










Fabric Console










su - username




Linux






Unpacking the JRE


archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric




services


support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom






THE

DEFAULT


=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE




BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type

--------------







grade environment

1- Development

2- Non-Production

-gt3-

Production


DEFAULT




=================================================================

==============


--------------

------------







-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs









front-end app






-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT





usersxml








configuration table


=================================================================

==============

Installation Mode

-----------------








(Single Node)

2- Standalone Mode

(Existing)

3- Domain Mode



(Multi Node)


DEFAULT














=================================================================

=======

HTTP or HTTPS

-------------



-gt1- HTTP



2- HTTPS


DEFAULT



=============================================================

==================


------------------------------

=============================================================

==================


use The default



ltIP addressgt


8181





=============================================================

==================


------------------------------


use The default



please have the



ltIP addressgt















=========================================================

======================


-------------------------






TO ACCEPT THE

DEFAULT




=========================================================

======================

Port Validation

---------------


65535




TO ACCEPT THE

DEFAULT


error message

=========================================================

======================


---------------------------







TO ACCEPT THE

DEFAULT




=================================================================

=======


-----------------------------------------







DEFAULT





=============================================================

===========


-----------------------------------------


certificate All the









City (DEFAULT ) HYD

State (DEFAULT ) AP






=============================================================

===========


-----------------------







=============================================================

===========


-----------------------------------------


contain space





=========================================================

===============


-----------------------------------------

=========================================================

===============


-------------------------




should not contain

space




=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT


JBoss servers





=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------









====================================================

===========================




------------------------------------


57



=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)










to 1521 for oracle




user


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------








=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT






following

====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL


example dbclient




as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------



ltHostnameIPgt





Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------





l Data Tablespace






================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=================================================================

==============


-------------------------------











=================================================================

==============


---------------------



following

manual steps




successful













=================================================================

==============


-------------------------------








Email (Default )














=============================================================

==================


-------------------------------








=============================================================

==================


-------------------------------



appear

=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes



2- No


DEFAULT





=================================================================

==============


------------------------


Installation Type

New Installation

Install Components



Install Folder


Application Server






Database Choice

MySQL 57

Database Details


Database Names



testkpnsdbjboss



=================================================================

=======

Ready To Install

-----------------------------------------


system


homeuser1KonyFabric





=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------


homeuser1KonyFabric



















authenticated













For Tomcat


following locations


















For JBoss


following locations




















For WebLogic


following locations






























For WebSphere


following locations








































su - username




Linux




Unpacking the JRE




archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric


services




support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom






THE

DEFAULT


JBoss servers


=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS




THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type



--------------





grade environment

1- Production

2- Non-Production

-gt3- Development


DEFAULT




=================================================================

==============


--------------

------------







-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs









front-end app






-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT





=================================================================

==============

Installation Mode

-----------------



development and



typically used for




setup please



(Single Node)

2- Standalone Mode

(Existing)

3- Domain Mode



(Multi Node)


DEFAULT2










=================================================================

=======


--------------------------


default value





It should


(FQDN)


Port

(Default )








portgt










=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT


JBoss servers





=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------









====================================================

===========================




------------------------------------


57



=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)










to 1521 for oracle




user


as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------








=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT






following

====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL


example dbclient




as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------



ltHostnameIPgt





Username(Default )



license_cujar


and JBoss servers






for DB2



















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------







l Data Tablespace




================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=================================================================

==============


-------------------------------











=================================================================

==============


---------------------



following

manual steps




successful













=================================================================

==============


-------------------------------








Email (Default )














=============================================================

==================


-------------------------------








=============================================================

==================


-------------------------------



appear

=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes



2- No


DEFAULT





=================================================================

==============


------------------------


Install Components


Install Folder

rootKonyFabric



Application Server

ltApp Servergt



Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names




=================================================================

=======

Ready To Install

-----------------------------------------




system


homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------




homeuser1KonyFabric



















authenticated













su - username






Linux




Unpacking the JRE


archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction



------------


of Kony Fabric


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required





have the SSL

certificate












tm






httpsupportkonycom






THE

DEFAULT


JBoss servers


=================================================================

=======

License Agreement

-----------------


the


KONY INC





AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE









=================================================================

==============

Installation Type

-----------------


existing

installation




DEFAULT




=================================================================

==============

Licensing Type

--------------


select the



larger


instance

1- Development

2- Non-Production

-gt3-

Production


DEFAULT






=================================================================

==============


--------------

------------





-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components

------------------










as APIs







front-end app






-gt1- Console






DEFAULT



















Kony Fabric Console


Enter



Reports Database











For example











=================================================================

======

Install Folder

---------------------





characters



rootmfdomainmode





=================================================================

==============

Application Server

------------------




-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT



=================================================================

==============

Installation Mode

-----------------









3- Domain Mode

(Multi Node)




DEFAULT










=================================================================

=======


--------------------------


default value is



or localhost


(FQDN)




addressportgt







communication









=================================================================

=======


---------------------------------



details appear

=================================================================

==============

Server Groups

-------------


configured


member of a


list of


application

1 main-server-group





12 or

all) (Default all)



=================================================================

==============


---------------------


1 main-server-group





THE

DEFAULT




=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT



=============================================================

===========


-----------------------------------------





Port (DEFAULT 3306)









example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57



=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1521)








to 1521 for oracle




user




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------






=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------





l Data Tablespace






================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1433)

Username 9Default )









1433 for SQL


example dbclient




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )





and JBoss servers






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=============================================================

===========


-----------------------------------------



ltHostnameIPgt















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=================================================================

==============


-------------------------------









details appear

=================================================================

==============




------------------------


Install Folder

rootKonyFabric

Components

Console


Installation Mode

Domain Mode


httpslthostnamegt


lthostnamegt

Database Server



ltIP addressgt

Database Names




=================================================================

=======

Ready To Install

-----------------------------------------


system


homeuser1KonyFabric





=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------


homeuser1KonyFabric

















authenticated













For Tomcat













(middleware)







For JBoss















(middleware)







For WebLogic














(middleware)


















For WebSphere















(middleware)

















Fabric Console










su - username




Linux




Unpacking the JRE


archive




Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric


services


support all of


scalable and


dramatically reduce





prerequisites

have been met -


SQL Server

and DB2 are the


only


have all required



have the SSL

certificate














tm






httpsupportkonycom




THE

DEFAULT


=================================================================

=======

License Agreement

-----------------




the


KONY INC



AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS




INSTALLATION

WILL TERMINATE







=================================================================

==============

Licensing Type

--------------





grade environment



1- Production

2- Non-Production

-gt3- Development


DEFAULT




=================================================================

==============


--------------

------------





-gt1- Yes



2- No


DEFAULT


=================================================================

======

Install Components

------------------








as APIs







front-end app








-gt1- Console

























Kony Fabric Console


Enter



Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters







as follows

=================================================================

==============

Application Server

------------------


-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT



=================================================================

==============


--------------------------






test201)









Management Server




details as follows

=============================================================

==================


--------------------------





details appear

=============================================================

==================

Server Groups

-------------




is a member of a


mentioned list of


this application

1 AdminServer


(eg 12 or

all) (Default all)



=============================================================

==================




---------------------


1 AdminServer




ACCEPT THE

DEFAULT





=============================================================

==================


---------------------





MS SQL database


WebLogic Server


continuing with

installation -







commEnv file







For Example








DEFAULT




=============================================================

==================


---------------------



DB2 database




Server


continuing with

installation -




commEnv file





For Example











=================================================================

=======

Database Choice

-----------------------------------------


-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2


DEFAULT



=============================================================

===========


-----------------------------------------





Port (DEFAULT 3306)









example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57





=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1521)








to 1521 for oracle






user


as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------






=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------







l Data Tablespace




================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1433)

Username 9Default )









1433 for SQL


example dbclient




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=================================================================

==============


-------------------------------











appear

=================================================================

==============


---------------------



following

manual steps




successful






=================================================================

==============


-----------------------------------


installation of

Kony Fabric

-gt1- Yes

2- No


DEFAULT





=================================================================

==============


------------------------




Installation Type

New Installation

Install

Components



Install Folder


Application Server






Database Choice

MySQL 57

Database Details


Database Names






=================================================================

=======

Ready To Install

-----------------------------------------




system


homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------




homeuser1KonyFabric

















authenticated














Fabric Console












su - username




Linux




Unpacking the JRE


archive


Launching installer

=================================================================

==============




------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


of Kony Fabric


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -




SQL Server

and DB2 are the


only


have all required



have the SSL

certificate












tm








httpsupportkonycom




THE

DEFAULT


=================================================================

=======

License Agreement

-----------------


the


KONY INC





AGREEMENT


YOU


CONDITIONS


THE I


ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE









=================================================================

==============

Licensing Type

--------------


Database


updated to the






grade environment

1- Production

2- Non-Production



-gt3- Development


DEFAULT




=================================================================

==============


--------------

------------





-gt1- Yes

2- No


DEFAULT


=================================================================

======

Install Components



------------------








as APIs







front-end app






-gt1- Console

























Kony Fabric Console


Enter





Reports Database









For example













=================================================================

======

Install Folder

---------------------



characters





as follows

=================================================================

==============

Application Server

------------------




-gt1- Tomcat

2- JBoss

3- WebLogic

4- WebSphere


DEFAULT


WebSphere appear



=================================================================

==============


--------------------------



select




Name] gt




101025

251)








Server


of WebSphere Server









=============================================================

==================


--------------------------






=============================================================

==================


-----------------------------


WebSphere server


WebSphere server





=============================================================

==================


-----------------------------






=============================================================

==================


-----------------------------


WebSphere server


WebSphere server





=============================================================

==================


-----------------------------



details appear

=============================================================

==================

Server Groups

-------------




you manage


affect more than a


from the available




1


er1


(Default 1)



=============================================================

==================


---------------------


1




er1




ACCEPT THE

DEFAULT


=============================================================

==================


------------------------------


6GB






=================================================================

=======

Database Choice

-----------------------------------------




-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2


DEFAULT



=============================================================

===========


-----------------------------------------



Port (DEFAULT 3306)











example dbclient



====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------


57



=============================================================

===========


-----------------------------------------





ltHostnameIPgt

Port (Default 1521)








to 1521 for oracle




user


as follows



=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------






=========================================================

===============

Tablespace Choice

-----------------------------------------







ACCEPT THE DEFAULT




following

====================================================

====================


-----------------------------------------





l Data Tablespace






================================================

========================


---------------------------------------







================================================

========================


---------------------------------------




again











=============================================================

===========


-----------------------------------------



ltHostnameIPgt

Port (Default 1433)

Username 9Default )







1433 for SQL




example dbclient




as follows

=========================================================

===============


-----------------------------------------




====================================================

===========================


--------------------------











====================================================

===========================


------------------------------------



=============================================================

===========


-----------------------------------------





ltHostnameIPgt



Username(Default )



license_cujar






for DB2



















as follows

=========================================================

===============


-----------------------------------------






====================================================

===========================


--------------------------









====================================================

===========================


------------------------------------





=========================================================

===============

Tablespace Choice

-----------------------------------------





ACCEPT THE DEFAULT




following



====================================================

====================


-----------------------------------------





l Data Tablespace




================================================

========================


---------------------------------------









================================================

========================


---------------------------------------




again









=================================================================

==============


-------------------------------












appear

=================================================================

==============


---------------------



following

manual steps




successful


















17 Press Enter


=================================================================

==============


-----------------------------------


installation of



Kony Fabric

-gt1- Yes

2- No


DEFAULT





=================================================================

==============


------------------------


Install Components


Install Folder



rootKonyFabric

Application Server

ltApp Servergt



Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names




=================================================================

=======

Ready To Install

-----------------------------------------




system


homeuser1KonyFabric



=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[------------------|------------------|------------------|-------

-----------]


=================================================================

=======


-----------------------------------------




homeuser1KonyFabric



















authenticated













Fabric Console












extract the file
















Fabric components









71 Prerequisites


















expected








AIX


























configurations

81 Tomcat Server




82 JBoss Server








Documentation

83 WebLogic Server









documentation

84 WebSphere Server







documentation







following two ways





existing database





l Oracle




drop index





l MySQL









l DB2




pk



NULL





l MS SQL Server


GO


GO


version_pk]

GO


GO





GO


(50) NULL

GO

















921 Prerequisites






su - username




Linux




Unpacking the JRE


archive


Launching installer



=================================================================

==============


------------------------------------------------------------------

-------------


=================================================================

==============

Introduction

------------


services


support all of


scalable and


dramatically reduce



prerequisites

have been met -




database server



ready







tm





httpsupportkonycom






THE

DEFAULT



=================================================================

=======

License Agreement

-----------------


the


KONY INC



AGREEMENT


YOU


CONDITIONS


THE I




ACKNOWLEDGE


BEHALF OF YOUR


AND AGREE THAT


AND ALL


THESE TERMS


INSTALLATION

WILL TERMINATE



=================================================================

======

Get User Input

------------------


new

installation


Fabric In a




box However


for production

environment




DEFAULT 1


=================================================================

======


---------------------


that you



upgrade The


backups


your upgrade








=================================================================

==============


------------------------


Install Type


Install Components


Install Folder

rootUP652TO70

Application Server






Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names






=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]



[------------------|------------------|------------------|-------

-----------]

=================================================================

==============

Backup completed

----------------


In case of




------------------|------------------|------------------|---------

---------]


=================================================================

=======


-----------------------------------------




rootUP652TO70
























library












931 Prerequisites


your credentials









su - username




Linux




fresh installation





=================================================================

=======

Database Choice

-----------------------------------------




-gt1- MySQL

2- Oracle

3- SQL Server

4- DB2

5- MariaDB


DEFAULT



=================================================================

==============


-------------------------------



KonyXXXXX1




to the new





example Kony


example 1


=================================================================

==============


---------------------------------


databases


-gt1- No Go back



2- Yes Use existing


THE

DEFAULT 2


=================================================================

==============


Fabric instance


installation

is complete

1- SKIP

-gt2- OK


DEFAULT




Instance

=================================================================

==============


-------------------------------



=================================================================

==============


----------------------------------


installation of

Kony Fabric

-gt1- Yes

2- No




DEFAULT



l authServicekey








successful upgrade


screen appears

=================================================================

==============


-------------------------------






emails




Email (Default )





=================================================================

==============


------------------------


Install Type




Install Components


Install Folder

rootUP652TO70

Application Server




Database Choice

ltdatabasegt

Database Details

ltIP addressgt

Database Names






=================================================================

=======


-----------------------------------------


rootUP652TO70


















l Oracle



l MySQL



l DB2



l MS SQL Server






























For example



701x patches




installation



l 701 GA

l 71 GA

l 72 GA

l 73 GA

l V8

l V8 SP2

l V8 SP3 FP1



102 Prerequisites


























su - username










8xxGAbin




archive


Launching installer

=================================================================

==============


------------------------------------------------------------------

-------------









in this field



=============================================================

==================

Introduction

------------




rootsamplezip




=================================================================

==============


------------------------







notesDefaulthtm




replace the
















=================================================================

=======

Installing

-----------------------------------------

[==================|==================|==================|=======

===========]

[-----------------


=================================================================

=======


-----------------------------------------




rootMFJB6525132












the following















=================================================================

==============


------------------------------------------------------------------

-------------




=================================================================

==============


-----------------------------------






3 Press Enter


database

=================================================================

==============

Delete Database

---------------


including




data after it

has been deleted



2- Retain all data


DEFAULT




=================================================================

==============

Uninstalling

---------------



=================================================================

==============

Uninstall Complete

------------------
























































































5 Save the changes





































l JBossMulti-node


l WebLogic

l WebSphere
















ltpoolgt




ltpoolgt









Passed





DBPASSED



healthDetail









version8211_GA
















l sapjco3jar







folder







following files

l sapjco3jar




path=sapjco3jargt





l sapjco3jar




path=sapjco3jargt



ltglobal-modulesgt


ltglobal-modulesgt





l sapjco3jar
















l sapjco3jar





file






installation

l Issue


Workaround


For MySQL

------------



For SQLServer

---------------



For Oracle

----------





For DB2

--------



l Issue




Workaround


l Issue



publish fails

Workaround


database

l Issue





Workaround



Server






Fabric












new values






l Issue




Workaround


table_open_cache=64


l Issue






Workaround







l Issue


authenticated

Workaround






Workaround










null



Workaround



Fabric



Workaround




configuration




INFclasses





INFclasses


in all nodes


INFclasses




Workaround




configuration




INFclasses






INFclasses


in all nodes


INFclasses


For example

Caused by




file_size

Workaround


themycnf file


files

For example

Workaround





l Issue



Workaround



l Issue



Workaround





version


version_rank



l Issue




from oracle

Workaround



l Issue



Workaround



l Issue


652GA to 72GA

Workaround






l Issue



Workaround




l Issue



Workaround

Manual Steps






















































l Issue


Workaround

Manual Steps












l Issue



Workaround

Manual Steps








GO

use msdb

GO


GO






GO


GO


GO


GO




GO


GO


GO




GO




GO


GO


GO


GO




GO


GO




GO



VIEWALTER TO userId

GO


GO


GO


GO



VIEWALTER TO userId

GO


GO




GO



VIEWALTER TO userId

GO







l Issue



Workaround

Manual Steps







and UNIX)





userid


userid


userid
























l Issue










Workaround


l Issue








l SQL State HY000

l Error Code 1093



Workaround


Services






changes


















number














mod_cluster


JBoss





























































installation






installation
















installation

































Example








139 WebSphere FAQs
























ACCOUNTS_LOG_LEVEL



















LEVEL





























Fabric





Visualizer)




Installer






install location


WARs


ii Go to Console




Components



Component



Consol

e

workspacewa

r

workspace

1war



Pathgttomcatwebapps


Fabric Install

Pathgtjboss gt


l WebLogic


deployments

l WebSphere lt


deployments


1war


1war


ar

authServic

e1war

Integra

tion

Admin

Server

l middle

warew

ar

l service

swar

l admin

war

l mid

dlew

are

1

war

l serv

ices

1

war

l adm

in

1

war

Engag

ement

Service

s

kpnswar kpns1war




SQL query



l MySQL



name=WAAS_BASE_URL

l Oracle



name=WAAS_BASE_URL

l SQLServer



name=WAAS_BASE_URL

l DB2



name=WAAS_BASE_URL


and JBoss servers













check









l MySQL





l Oracle



l SQLServer



l DB2




CONTEXT_PATH


and JBoss servers













serviceswar name


INFjboss-webxml

From


To






From


To





toWebSphere






context pathgt















follows









development


12 Publish the app







WARs


ii Go to Console




Fabric Components



Component



Conso

le

workspace

war

workspac

e1war



Pathgttomcatwebapps



Pathgtjboss gt

standalonedeploymen

ts

l WebLogic


ygtdeployments

l WebSphere lt


gtdeployments



Component



mfconsolew

ar

mfconsole

1war



Component



accountswa

r

accounts

1war

Identit

y

authService

war

authServi

ce1war

Integr

ation

Admin

Server

l middl

eware

war

l servic

eswa

r

l admin

war

l mi

ddl

ew

are

1

w

ar

l ser

vic

es

1

w

ar

l ad

mi

n1

w

ar

Engag

ement

Servic

es

kpnswar kpns

1war




SQL query



l MySQL



name=WAAS_BASE_URL

l Oracle



name=WAAS_BASE_URL

l SQLServer



name=WAAS_BASE_URL

l DB2



name=WAAS_BASE_URL


and JBoss servers













check









l MySQL





l Oracle



l SQLServer



l DB2




CONTEXT_PATH


and JBoss servers




Component


authS

ervice

authServiceproper

ties

authServicewar

WEB-INFclasses

l WEBSPHERE_

AUTHCONFIGDB_

JNDI_

NAME=jdbcauthconfig

l WEBSPHERE_

AUTHGLOBALDB_

JNDI_

NAME=jdbcauthglobal

db

Works

pace

workspaceService

properties

WorkspacewarW

EB-INFclasses

l WEBSPHERE_

WAASGLOBALDB_

JNDI_

NAME=jdbcworkspac

esglobaldb

l WEBSPHERE_

WORKSPACESDB_

JNDI_

NAME=jdbcworkspac

esglobaldb



Component


Accou

nts

accountspropertie

s

AccountswarWE

B-INFclasses

l ACCOUNTS_DB_

JNDI_

NAME=jdbckonyacco

unts REPORTS_DB_

JNDI_

NAME=jdbckonyreport

s

Integr

ation

Admin

Server

serverconsoleprop

erties

adminwarWEB-

INFmiddlewarem

iddleware-

bootconfigadmin


ckonyadmindb


bckonyreports













serviceswar name


INFjboss-webxml

From


To






From


To





toWebSphere






context pathgt















follows









development


13 Publish the app


prise



Enterprise







example mfconsole1


example accounts1






example mfidentity1











file

For example






build

6 Save the file









1 Preface

11 Purpose




15 Contact Us

2 Prerequisites



23 Network Settings














56 Memcached Server









71 Prerequisites






81 Tomcat Server

82 JBoss Server

83 WebLogic Server

84 WebSphere Server









102 Prerequisites





















139 WebSphere FAQs

