Kony Upgrade Hub Guide - Base Camp Community › konylibrary › beta › v8upgrade65.pdf · Kony...

Kony Upgrade Hub Guide

Document Relevance and Accuracy

This document is considered relevant to the Release stated on this title page and the document version stated on the

Revision History page. Remember to always view and download the latest document version relevant to the software

release you are using.

© 2017 by Kony, Inc. All rights reserved 1 of 92

Kony Upgrade Hub GuideVersion1.0

Copyright © 2014 by Kony, Inc.

All rights reserved.

November, 2017

This document contains information proprietary to Kony, Inc., is bound by the Kony license

agreements, and may not be used except in the context of understanding the use and methods of

Kony, Inc., software without prior, express, written permission. Kony, Empowering Everywhere, Kony

Fabric, Kony Nitro, and Kony Visualizer are trademarks of Kony, Inc. MobileFabric is a registered

trademark of Kony, Inc. Microsoft, the Microsoft logo, Internet Explorer, Windows, and Windows Vista

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

X, Objective-C, Safari, Apple Pay, Apple Watch, 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 in Motion, and

RIM are registered trademarks of BlackBerry. SAP® and SAP® Business Suite® are registered

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

service marks mentioned in this document have been capitalized and are to be considered the

property of their respective owners.



Revision History

Date Document Version

Description of Modifications/Release

12/01/2017 1.0 Document Released for V8



Table of Contents

1. Preface 7

1.1 Purpose 8

1.2 Intended Audience 8

1.3 Formatting Conventions 8

1.4 Related Documents 10

1.5 Contact Us 10

2. Why Upgrade to Latest Kony Products? 11

2.1 Pre-Upgrade Process 11

2.1.1 Upgrade Value Proposition 11

2.1.2 Key Features from 6.5 Onwards 16

2.1.3 Kony Releases - Support End of Life (EOL) 25

3. Upgrade Process 26

3.1 Upgrade the Visualizer App 26

3.1.1 Prerequisites 26

3.1.2 Upgrade Steps 31

3.1.3 Upgrade Legacy Platforms 47

3.1.4 Resources 48

3.1.5 Known Issues 57

3.2 Upgrade from Kony Server (middleware) to latest version of MobileFabric (now, Kony

Fabric) 58



3.2.1 Software and Hardware Requirements 58

3.2.2 Approaches to upgrade to latest Kony Fabric on-premises 58

3.2.3 Post-installation Steps 61

3.2.4 Resources - Kony Fabric 64

3.2.5 Upgrade Sync Server from Pre-7.x to latest Kony Fabric 67

3.2.6 Upgrade KMS (Engagement Server) from Pre-7.x to latest Kony Fabric 70

4. Upgrade Readiness: Tool and Information 74

4.1 Validating Image Resources 74

4.2 Duplicate Support - V4 JAR 75

4.3 Validating androidprecompiletask.xml Dependencies 75

4.4 Validating Android Custom Widgets 75

4.5 Validating iOS Custom Widgets 76

4.6 Validating controllerdef.xml File for Custom-Connectors 76

4.7 Validating servicedef.xml File 76

4.8 Deprecated APIs 77

4.9 API Level Changes 77

4.10 JAR Version Conflict 77

5. Upgrade FAQs 78

5.1 MADP 78

5.1.1 For Business Needs 78

5.1.2 For Developers 79



5.2 Kony Fabric 82

5.2.1 For Business Needs 82

5.2.2 For Developers 86


1. Preface Kony Upgrade Hub GuideVersion1.0

1. Preface

Kony MobileFabric is a Mobile Backend as a Service (MBaaS) provider that helps developers build

native and web apps for mobile. MobileFabric allows you to define the back-end to build native mobile

apps for iOS, Android, and HTML5-based apps for modern browsers. MobileFabric ensures that

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

end services instantly. MobileFabric has multiple features that can be used - Identity, Integration,

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

centralized console.

For successful authentication with users, and to access the centralized features of MobileFabric, Kony

recommends that you install the following MobileFabric features on premises:

l Kony MobileFabric Identity and Console

l Kony MobileFabric Integration Services

l Kony MobileFabric Engagement Services

l Kony MobileFabric Sync Services

Kony MobileFabric supports the following back-end services for your applications:

l Identity: This feature allows you to define the type of authentication that grants access to your

application. MobileFabric supports the following authentication services: Microsoft Active

Directory, Salesforce, Security Assertion Markup Language (SAML), Kony SAP Gateway,

Facebook, and Kony User Repository.

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

You can define the service in XML, SOAP, JSON, Java, Salesforce, and Kony SAP Gateway.

l Orchestration: This feature allows you to create two types of orchestration services. They are:

o Composite: You can run two or more services concurrently or sequentially.

o Looping: You can run a single service in a loop until the loop ends or an exit criteria is met.



l Synchronization: This feature allows you to define the synchronization services for your

application. Sync supports only Web Services, except SAP Sky.

l Engagement Services: This feature allows you to define and configure push messaging

services for your application.

Important: Kony recommends using the MobileFabric Installer for deploying MobileFabric 7.0

onwards.

If you are required to install MobileFabric manually due to your business rules and policies, please

contact [email protected] for approval and to obtain access to the MobileFabric manual install

artifacts. Manual installs not approved by Kony will not be supported.

1.1 Purpose

This document helps you install and configure Kony MobileFabric manually.

1.2 Intended Audience

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

configuring Kony MobileFabric. It is assumed that the reader of this document is familiar with installing

applications in a Windows or Linux environment, and deploying software on Java application servers

and installing database software.

1.3 Formatting Conventions

The following formatting conventions are used throughout the document:


mailto:[email protected]?subject=Request to obtain access to the MobileFabric manual install artifacts.


Convention Explanation

Monospace n User input text, system prompts, and responses

n File path

n Commands

n Program code

n File names

Italic n Emphasis

n Names of books and documents

n New terminology

Bold n Windows

n Menus

n Buttons

n Icons

n Fields

n Tabs

URL Active link to a URL

Note: Provides helpful hints or additional information

Important:

Highlights actions or information that might cause problems to systems or

data



1.4 Related Documents

Document Purpose

Kony MobileFabric

User Guide

This guide helps you understand how to create a Kony MobileFabric

account, add services, and publish apps.

1.5 Contact Us

We welcome your feedback on our documentation. Email us at [email protected].

For technical questions, suggestions, and comments or to report problems on Kony's product line,

contact [email protected].


mailto:[email protected]?subject=Documentation Feedbackmailto:[email protected]

2. Why Upgrade to Latest Kony Products? Kony Upgrade Hub GuideVersion1.0

2. Why Upgrade to Latest Kony Products?

Kony suggests its customers to upgrade from existing Kony products to latest ones. Upgrading Kony

products is easy and you can make use of additional benefits post the upgrade. Following are the

benefits that you will experience after the upgrade:

2.1 Pre-Upgrade Process

2.1.1 Upgrade Value Proposition

The value proposition for the upgrade process is as follows:

2.1.1.1 Modern User Experience

l Day 0 availability of 100 percent iOS and Android features.

l 3D transitions and animations.

l Instant previews - What you see is what you mobilize!

l Fast and Fluid UX performance.

2.1.1.2 Savings

l Free basic upgrade from product team.

l Reuse of web investments with Nitro engine.

l Reusable cross-channel UI components.

l Reduced project cost with reference architecture.

2.1.1.3 Time to Market

l 40 percent improvement in developer productivity.

l Seamless photoshop import integration.



l Reduced effort to integrate with diverse back-end systems.

l Reduce back end complexity via object services.

2.1.1.4 Know your Customer Better

l User journey and drop-off analysis.

l Automatic crash reporting is always switched.

l Rich notifications and user targeting.

l Customer- centric business insights.

2.1.1.5 Security

l Tamper proof binaries.

l Throttling to prevent denial of service attacks.

l Default service protection for all service end points.

l Integration with all popular identity providers.

Kony Mobility Platform: Following are the key features of Kony Mobility platform.

Omni-Channel and Web:

l Web Tools and Third Party Library Support

o Embed HTML, CSS, and Javascript within the Kony application.

o Visualizer Code Editor enhancements for HTML, CSS, and JS.

o Real time preview of HTML 5 content within Visualizer Canvas.

l Cordova Plugin Support

o Kony Framework Support for any custom Cordova plugin.

o Ability to import custom plugins from Cordova NPM for Visualizer.



l Omni-channel Widget and API Enhancements

o Material design enhancements such as ripple color, shadow and elevation, view clipping,

navigation color, and immersive mode are added for Android.

o Ability to drag and reorder rows within a list (segment widget).

o Capture and control push notifications.

o Accessibility (ADA) support for desktop web.

o Vertical pagination for Flex scroll container in Android.

o Image transformation APIs for Windows.

l App Preview Enhancements

o Real-time local preview of native Kony apps.

o Local caching of preview apps – offline mode.

o Access the local preview without logging on to Kony Cloud account.

l Masters Enhancements

o Define masters as self-contained models across an application.

o Usability improvements in Visualizer.

l Reference Architecture Enhancements (Beta) – Kony introduces an architecture to create

structured and modularized Kony applications using the MVC paradigm.

o Use Kony forms as views and client-side business logic as controllers.

o Ability to create model-driven apps using object services as model.

o Ability to use RequireJS for module loading.

Micro Services and Composite Apps



l Node.js Runtime Environment

o Write logic in JavaScript to build APIs on back-end using Node.js.

o Leverage a broad ecosystem of community-developed NPM modules.

l Object and Storage Service Enhancements

o Offline sync and large binary file support.

o Enhancements for handling large binary files that are part of objects.

l API Management Enhancements

o Throttle APIs with a global rate limit and per IP address limit.

l Custom Data Adapter Support

o A custom data adapter SDK to build business adapters with meta data discovery and

drop that into MobileFabric.

Production Management and Insights

l Analytics and Engagement Enhancements

o Ability to build funnel reports to track the user journey through a specific sequence of

events and analyze user drop off.

l Security and Management Enhancements

o Use the user back-end identity session and user profile attributes in APIs so the client

does not have to send them, which is less secure.

o Configure your Kony Cloud Account to authenticate console users via your Enterprise

Identity for corporate SSO (OAuth 2.0 and Okta in 7.2).

o Additional Identity Connectors (Okta, Google, Instagram, Microsoft, Box, LinkedIn,

Amazon and Yahoo).

l Telemetry, Debugging and Unit Test Enhancements



o New logging service will be created with Kony Cloud environments that provides log

indexing with real time log view and searching.

o Kony provides on-prem data file capture support to easily pull environment specifics to

help the support team understand the current environment configuration.

l Licensing Enhancements

o Licensing services is provided for on-prem customers to simplify licensing the on-prem

and local developer installation of MobileFabric.

IoT and Connected Devices

l iOS10 and Android N Support

o Kony offers compatibility support for iOS 10 and Android N as per the industry-leading

SLA (includes support for new Apple Watch OS2 requirements).

l 100 percent Native API support for iOS and Android

o Support for 100 percent of the native iOS 10 and Android N APIs through the Native

Function Interface. Access to the native APIs through JavaScript.

o Mix and match Kony Native UX with Native UX Views and Custom View Code.

l Amazon SDK and Mobile Services Support

o Import and/or Embed Amazon Web Services SDK within Kony application.

o Invoke Amazon SDK from Kony Javascript, including Cognito, Lambda, DynamoDB, and

more.

l Security and Performance Enhancements

o Support for Application Transport Security (ATS) as per Apple guidelines.

o Performance enhancements for Windows and SPA applications.



2.1.2 Key Features from 6.5 Onwards

2.1.2.1 MADP

The following table details the pre-release overview of Kony Visualizer and Kony MobileFabric.

Kony Visualizer: Kony Visualizer is an integrated, intuitive development environment to build native,

HTML5, and hybrid apps across phones, tablets, wearables, and desktops – all from a single code

base.

The release overview features listed in the following table are from the release version 2.5 (August

2015) to release version V8 (April 2017).

For more information on Kony Visualizer features, refer Kony Visualizer Release Notes.


http://docs.kony.com/konylibrary/visualizer/viz_rel_notes/Default.htm


Visualizer 2.5/Studio 6.5August 2015

Visualizer 7.0February 2016

Visualizer 2.5

l Conditional Operations

l UX Refresh and/or Multi-pane flow

l Named Actions

l Productivity Enhancements

Studio 6.5

l Wearables Support

l Mobile First APIs

l Security Enhancements

l APM

Kony Visualizer 7.0

l Visualizer Enterprise (formerly Studio)

l Masters

l Photoshop Integration Extension

l Requirements Tools

l Mapping Editor

l Updates for iOS9, Android M, Windows

10, and Blackberry

l Widget Enhancements

o Segment

o Maps

o Video Widget

o Camera

l API Enhancements

l Additional Mobile First APIs

l Security Enhancements



Visualizer 7.1August 2016

Visualizer 7.2November 2016

Visualizer 7.3April 2017

Kony Visualizer 7.1

l HTML5 Web Packaging

l App Preview

Enhancements

l Real Time Preview

l Improved Publish

l Productivity and Design

Tools

l Widget and API

Enhancements

o Android

Fingerprint API

o 3D Touch

l Apple Watch 2 Support

l Windows 10 Mobile

Support

l Windows Optimizations

l Framework Testing

Improvements

l APM Enhancements

l Security

Enhancements

Kony Visualizer 7.2

l App Preview

Enhancements

l Redesigned App

Preview

l Offline Caching

l Masters Enhancements

l Desktop and Web

Enhancements

l Support for all iOS and

Android Native

frameworks

l AWS Integration

l Widget and API

Enhancements

o Material design

views

o Drag and sort

Segment rows

l Cordova API Support &

Import

l ADA Support in

Desktop Web

l Silent Notifications

l Updates for iOS 10 and

Android N

l APM Enhancements

l Security

Enhancements

l Performance

Improvements in

Windows

Kony Visualizer 7.3

l Kony Reference

Architecture

l Masters and

Components

l App Preview

Enhancements

o Tethered App

Preview

l App Extensions

l Upgraded Native

Widgets and APIs

o Nav Bar

o Action Sheets

o Tool Bar and

Toasts

l Omni Channel Widget

and API Enhancements

l Geo-boundary

notifications

l iOS Universal Links

l Support for GIF and

JPEG

l Chrome Debugger

l Android Build

Enhancements

l Native Function APIs –

3rd Party

l Many more FTRs…..


http://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Content/PreviewAnAppOnADevice.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Content/PreviewAnAppOnADevice.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Content/PreviewAnAppOnADevice.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Content/PreviewAnAppOnADevice.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Content/Masters.htmhttp://docs.kony.com/konylibrary/visualizer/viz_rel_notes/Content/7.2_New_Features.htm#DesktopWhttp://docs.kony.com/konylibrary/visualizer/viz_rel_notes/Content/7.2_New_Features.htm#DesktopWhttp://docs.kony.com/konylibrary/visualizer/viz_rel_notes/Default.htm#7.2_New_Features.htm%23CordovaWebhttp://docs.kony.com/konylibrary/visualizer/viz_rel_notes/Default.htm#7.2_New_Features.htm%23CordovaWebhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Content/CreateKRAProject.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Content/CreateKRAProject.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Content/PreviewAnAppOnADevice.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Content/PreviewAnAppOnADevice.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Content/CreateApplicationExtension.htmhttp://docs.kony.com/konylibrary/visualizer/viz_rel_notes/Default.htm#7.3_New_Features.htm%23AndroidBuildEnhttp://docs.kony.com/konylibrary/visualizer/viz_rel_notes/Default.htm#7.3_New_Features.htm%23AndroidBuildEn


Visualizer V8

Kony Visualizer V8

l Kony Platform

Components

l Component Builder

l Visualizer Viewer App

Enhancements

l Universal Binary

Support

l OS upgrades

l CI Improvements

l App Groups

l Security

Enhancements

l Integrated Kony

Marketplace

l Component Target

Container

l Flex Property Forking

l Widget Enhancements

l Android Wear Support

l App Wizard

l Automatic Updates

l Visualizer UX Pattern

Library

l Improved Visualizer

Library Palette

l Visualizer Performance

Enhancements

l Nitro Native Function

Interface

Enhancements

l APM Enhancements

l Photoshop Import

Improvements

l Multi-Project Workflow

l Visualizer GIT Client


http://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#C_DesigningWorkingWithComponents.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#C_DesigningWorkingWithComponents.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#C_CreatingComponent.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#FunctionalPreviewEnterprise.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#FunctionalPreviewEnterprise.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#BuildUniversalApp.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#BuildUniversalApp.htmhttp://community.kony.com/announcement/kony-os-upgrade-programhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#CI_BUILD.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#C_DesigningWorkingWithComponents.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#C_DesigningWorkingWithComponents.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Content/C_CreatingComponent.htm#Targethttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Content/C_CreatingComponent.htm#Targethttp://docs.kony.com/konylibrary/visualizer/viz_wearables_dev_guide/Default.htm#androidwearoverviews.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#CreateFromSampleApp.htmhttp://docs.kony.com/konylibrary/visualizer/viz_enterprise_install_win/Default.htm#autoupdate_kv_.htmhttp://docs.kony.com/konylibrary/visualizer/viz_nf_api_dev_guide/Default.htmhttp://docs.kony.com/konylibrary/visualizer/viz_nf_api_dev_guide/Default.htmhttp://docs.kony.com/konylibrary/visualizer/viz_nf_api_dev_guide/Default.htm


2.1.2.2 MobileFabric (now, Kony Fabric)

Kony MobileFabric: Kony MobileFabric is a mobile back-end as a service (MBaaS) provider that

helps developers build the native and web apps for mobile.

The release overview features listed in the following table are explained from release version 6.5

(August 2015) to release version V8 (April 2017).



MobileFabric 6.5August 2015

MobileFabric 7.0February 2016

MobileFabric 7.1July 2016

MobileFabric 7.2October 2016

Analytics

l Criticism

Integration

l Kony APM

APIs

l User Journey

and/or Events

API

MobileFabric

Console

l Client Binary

Management

l Direct Publish

to App

Management

(EMM)

l Import and/or

Export to

Source

Control

Integration

l API

Management

View

l Improved

Service

Designer

Identity & Security

l Facebook

Identity

Service

l Custom

Identity

Connector

l Role

Management

of Console

Users

l API Security

(Public,

Protected,

Authentciated)

l Environment

specific re-

configuration

during publish

Engagement

l Engagement

Console UX

Refresh

l 2-way SMS

Object Services

l App Data

Model &

Mapping

Engine

l Code

Generation

MobileFabric

Console

l Analytics

Dashboard

l Publish

Binary as

Developer

Preview

l CLI Tool for

Automated

Deployments

Integration

l IoT Services

(CoAP)

l JavaScript

Pre/Post

Processors

l AWS API

Gateway

Connector

l Improved

Database

Adapter

API Management

l API Proxy

Connector

l API

Versioning

Identity & Security

l OAuth 2.0

with User

Profile

Attributes

l Console

User Access

Control

l CA

Siteminder

Integration

for Console

Login

Engagement

l Rich Push

Notifications

l JPush

Network for

Android in

China

Object Services

l Additional

mapping

transformation

s

l Storage

Objects (built-

in storage

service)

MobileFabric

Console

l OAuth2

Console

Testing

l Automated

Support Data

File Creation

Integration

l Mongo DB

Connector

l JavaScript

Integration

Service

l Legacy

WebScraper

and SAP JCO

support.

Identity and Security

l Client App

Single Sign-On

l LDAP Identity

Connector

l Azure ADFS

Identity

Connector

Engagement

l Engagement

Console UX

Enhancements

l Enhanced

Geoboundary

Management

l API

Simplification.

Object Services

l JavaScript

Support in

Mapper

l Object Service

Verb in

Orchestration

MobileFabric

Console

l Logging

Service

l Robust

Publish

l Automated

Support Data

File Creation

Integration

l Node.js run

time

l API Throttling

l Admin console

Enhancement

s

Identity and

Security

l Additional

Identity

Connectors

l Enterprise

Identity for

Cloud Console

Login

EMM

l SSO for

mobile Apps

l Identity

Integration

with Appstore.

Analytics

l Funnel

Reports

Engagement

l Rich push

notifications

l Support for

silent push -

Android


http://docs.kony.com/konylibrary/messaging/2waysms_quick_start_guide/Default.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Objectservices.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Objectservices.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Objectservices.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Objectservices.htmhttp://docs.kony.com/konylibrary/mobilefabric/standard_metrics_reports_guide/Default.htm#AnalyticsDashboard.htm?TocPath=Analytics%2520Dashboard|_____0http://docs.kony.com/konylibrary/mobilefabric/standard_metrics_reports_guide/Default.htm#AnalyticsDashboard.htm?TocPath=Analytics%2520Dashboard|_____0http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/CLI_Analytics.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/CLI_Analytics.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/CLI_Analytics.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#JSPrePosthttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#JSPrePosthttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#JSPrePosthttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#Howhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#Howhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#Howhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#AddingAPIProxyhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#AddingAPIProxyhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/API_Versioning.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/API_Versioning.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Default.htm#Identity.htm%23OAuth2ID?TocPath=Features|Identity|_____10http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Default.htm#Identity.htm%23OAuth2ID?TocPath=Features|Identity|_____10http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Default.htm#Identity.htm%23OAuth2ID?TocPath=Features|Identity|_____10http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Default.htm#Identity.htm%23OAuth2ID?TocPath=Features|Identity|_____10http://docs.kony.com/konylibrary/messaging/kmf_msg_jpush_quick_start_guide/Default.htmhttp://docs.kony.com/konylibrary/messaging/kmf_msg_jpush_quick_start_guide/Default.htmhttp://docs.kony.com/konylibrary/messaging/kmf_msg_jpush_quick_start_guide/Default.htmhttp://docs.kony.com/konylibrary/messaging/kmf_msg_jpush_quick_start_guide/Default.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Default.htm#Objectservices.htm%23Storage_Object_Service?TocPath=Features|Object%2520Services|_____9http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Default.htm#Objectservices.htm%23Storage_Object_Service?TocPath=Features|Object%2520Services|_____9http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Default.htm#Objectservices.htm%23Storage_Object_Service?TocPath=Features|Object%2520Services|_____9http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Default.htm#Objectservices.htm%23Storage_Object_Service?TocPath=Features|Object%2520Services|_____9http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#TestOAuthLoginIntegrationhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#TestOAuthLoginIntegrationhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#TestOAuthLoginIntegrationhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#AddingJSConnectorhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#AddingJSConnectorhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#AddingJSConnectorhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Legacy_Serivces.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Legacy_Serivces.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Legacy_Serivces.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Legacy_Serivces.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Identity.htm#AppSSOoverviewhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Identity.htm#AppSSOoverviewhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Identity.htm#OpenLDAPhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Identity.htm#OpenLDAPhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Identity.htm#AzureADhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Identity.htm#AzureADhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Identity.htm#AzureADhttp://docs.kony.com/konylibrary/messaging/kms_console_user_guide/Default.htm#Geolocation/Geofencing.htm?TocPath=Engagement|%2520Location|Geofencing|_____0http://docs.kony.com/konylibrary/messaging/kms_console_user_guide/Default.htm#Geolocation/Geofencing.htm?TocPath=Engagement|%2520Location|Geofencing|_____0http://docs.kony.com/konylibrary/messaging/kms_console_user_guide/Default.htm#Geolocation/Geofencing.htm?TocPath=Engagement|%2520Location|Geofencing|_____0http://docs.kony.com/konylibrary/messaging/kms_console_user_guide/Default.htm#Geolocation/Geofencing.htm?TocPath=Engagement|%2520Location|Geofencing|_____0http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Objectservices_MapperExampleRef.htm#JSSupportMapperhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Objectservices_MapperExampleRef.htm#JSSupportMapperhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Objectservices_MapperExampleRef.htm#JSSupportMapperhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Orchestration.htm#OrchestrationObjectservicehttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Orchestration.htm#OrchestrationObjectservicehttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Orchestration.htm#OrchestrationObjectservicehttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Logging_as_a_Service.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Logging_as_a_Service.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Logic.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Logic.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#APIThrottlinghttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Appendix_-_App_Services.htm#DownloadAppServiceshttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Appendix_-_App_Services.htm#DownloadAppServiceshttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Appendix_-_App_Services.htm#DownloadAppServiceshttp://docs.kony.com/konylibrary/mobilefabric/user_journey_app_events_apm/Default.htm#FunnelReport.htm?TocPath=Funnel%2520Reports|_____0http://docs.kony.com/konylibrary/mobilefabric/user_journey_app_events_apm/Default.htm#FunnelReport.htm?TocPath=Funnel%2520Reports|_____0http://docs.kony.com/konylibrary/messaging/kms_console_user_guide/Content/Adhoc/General_Channel Type_Push Message.htm#Push_Message_with_Silent_Pushhttp://docs.kony.com/konylibrary/messaging/kms_console_user_guide/Content/Adhoc/General_Channel Type_Push Message.htm#Push_Message_with_Silent_Pushhttp://docs.kony.com/konylibrary/messaging/kms_console_user_guide/Content/Adhoc/General_Channel Type_Push Message.htm#Push_Message_with_Silent_Push


For more information on Kony MobileFabric features, refer Kony MobileFabric Release Notes.


http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_release_notes/Default.htm


MobileFabric 7.3April 2017

Object Services

l Object Services Visual

Designer

l Salesforce Connector

l OpenAPI (Swagger)

Connector

l App Model

Documentation (Beta)

l Database connector

Sync support

l Versioning

l Offline Objects (Beta)

l Mongo connector Sync

support

Data Adapters

l Data Adapter SDK

(GA)

l Code less Data

Adapter

o from Open API

(Swagger)

o from RAML

o from Exported

MF App

l Import adapters from

Marketplace

Integration

l Binary support in

Storage Service

l OpenAPI(Swagger)

Connector

Identity and Security

l Per Environment

Publish

l Access to Enhanced

identity Session

l SDK support for

Multiple Identities

l oAuth Grant-type

support

l Improved testing from

Console

Console Productivity

l JAR Management

l Custom Data Adapter

Management

l Pre-loaded samples

with trial accounts

EMM

l Streamlined App

Deploy

l Enterprise Store

Download with Oauth2

l Enterprise

Authentication with

o ADFS

o Office 365

l 64-bit Enterprise Store

Binary

Engagement

l Fire Cloud Messaging

(FCM) support for

Android

l Enhanced Geo

boundary-based

engagement

l Import and/or export of

events, templates and

geo boundaries

Analytics

l Binary Wrapping

l Custom Dashboard

Scheduled Jobs and API

Healthcheck

l Invoke Published

services

l Schedule Jobs to run

periodically

l Define success criteria

l Review job history

(Pass/Fail, Latency,

etc).

Production Management

and DevOps

l Publish History &

Rollback

l Command Line

Enhancements

l App Key and App

Secret Customization

l MariaDB support


http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Objectservices.htm#VisualObjectMapperhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Objectservices.htm#VisualObjectMapperhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Objectservices.htm#Creatinghttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#Swaggerhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Services.htm#Swaggerhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Objectservices.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Objectservices.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Default.htm#ManagingDataAdapters.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Default.htm#ManagingDataAdapters.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Default.htm#JAR_Management.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/CustomDataConfig.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/CustomDataConfig.htm


Kony Fabric V8

Kony Fabric V8

l API Developer Portal

Creation

l API Developer Portal

Access

l API Security

l OAuth 2.0 Provider

l Visual Data Mapper

l Offline Objects

l Docker Support

l Productivity

Enhancements

l Free Starter Edition

l Kony Marketplace

Integration

l Build New Connectors

l Cloud Hosting

Enhancements


http://docs.kony.com/konylibrary/konyfabric/kony_fabric_user_guide/Default.htm#KonyDevPortal.htmhttp://docs.kony.com/konylibrary/konyfabric/kony_fabric_user_guide/Default.htm#KonyDevPortal.htmhttp://docs.kony.com/konylibrary/konyfabric/kony_fabric_user_guide/Default.htm#KonyDevPortal.htmhttp://docs.kony.com/konylibrary/konyfabric/kony_fabric_user_guide/Default.htm#KonyDevPortal.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Content/Identity.htm#OAuth2IDhttp://docs.kony.com/konylibrary/konyfabric/kony_fabric_user_guide/Content/Objectservices.htm#VisualObjectMapperhttp://docs.kony.com/konylibrary/konyfabric/offline_objectsapi_reference_guide/Default.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#C_DesigningWorkingWithComponents.htmhttp://docs.kony.com/konylibrary/visualizer/visualizer_user_guide/Default.htm#C_DesigningWorkingWithComponents.htm


2.1.3 Kony Releases - Support End of Life (EOL)

Release# Date of Release Support End of Life (EOL) - Standard

7.0 29 Feb 2016 01 Mar 2018

6.5 14 Jul 2015 01 Aug 2017

6.0 15 Dec 2014 01 Jan 2017

5.6 19 May 2014 01 Jun 2016

5.5 06 Dec 2013 01 Jan 2016

5.0 31 Aug 2012 01 Sep 2014*

4.1 20 Feb 2012 01 Mar 2014*

*Additional EOL Extended duration provided beyond the normal three year window to allow for the

upgrade.

*To request for EOL support extension for other versions, submit a request to Kony support. The

support team will get back to you with the details.


3. Upgrade Process Kony Upgrade Hub GuideVersion1.0

3. Upgrade Process

The following steps help you upgrade Kony Studio and middleware/server from 6.5.x to Kony Fabric

V8:

l Upgrade from Studio to Visualizer

l Upgrade from Middleware to Kony Fabric

3.1 Upgrade the Visualizer App

1. Prerequisites

2. Upgrade Steps

3. Upgrade Legacy Platforms

4. Resources

5. Known Issues

3.1.1 Prerequisites

"Framework-level Prerequisites" below

"Build-specific Prerequisites" on page 29

"Upgrade Guidelines" on page 30

3.1.1.1 Framework-level Prerequisites

FFI Components

If the application uses any FFI components, you must ensure that the following prerequisites are met

and the necessary modifications incorporated before starting the 7.x migration process. The changes

if any are necessitated due to the following reasons:



a. Changes in the underlying OEM's build systems such as Gradle for Android, new XCode

versions, and so on.

b. Changes made by Kony as part of the overall product enhancements, improvements, and

performance optimizations.

This section outlines the checks that you need to make prior to migrating your application to a 7.x

version. The section is organized by platform-wise.

Android

l Convert the library projects to Gradle projects, and generate the .aar file, and use it in the FFI

definition. Refer to the Steps to create an .aar file section for more information.

l FFI components must not contain konywidgets.jar, android.jar, and support-

v4.jar in the Libs folder.

l FFI components must not contain armeabi. So files and should start packing armeabi-v7.

l FFI components must require to be compatible with armeabi-v7 architecture. You must ensure

that the FFI components are compatible with the new arm architecture.

iOS

l All FFI components consumed by the application must be compatible with XCode 8, which is the

mandatory XCode version from Kony 7.x version onwards.

l Memory management of the FFI Components hasbeen changed. So, you may have to make

the changes to the scope of the variable that has been used for FFI objects in your JS code.

In the pre-7.x versions, when an FFI object is created, the corresponding native object used to be

created and used to be active the entire lifetime of the application. This would cause memory issues,

especially in case the object consumes memory such as an object containing image rawbytes.



To avoid this problem, in 7.x versions, it has been implemented in such a way that the native object

would be active as long as the FFI object (js object) is active. This enables you to have more control on

the scope of the native object. If you want the scope of the native object to be local to a function, then

you can declare the FFI object as a local variable. For example, in the following function, we have

declared the ffiObj as local scope, hence the memory for the native object would be released once the

function is executed.

function testfun() {

var ffiObj = new sample.ffi.SampleFFIClass();

ffiObj.method1();|

}

In the following code, the ffiObj has a global scope and hence the native object would also global

scope.

function testfun() {

ffiObj = new sample.ffi.SampleFFIClass();

ffiObj.method1();

}

If you want to release the memory for a native object explicitly, you can assign null to the JS FFI object.

For example, ffiObj = null;

In the cases where the native object is used as a delegate, it can be invoked at any time. So, you must

ensure that the native object is active by the time the delegate is invoked by making the FFI object as

global or by managing the scope appropriately.

l FFI components and other libraries used should be compatible with 64-bit architecture. Using

32-bit versions will lead to run-time crashes.



Build-specific Prerequisites

Due to several changes made in the underlying OEM build processes and tool chains used, numerous

restrictions are imposed at build time, on what can be included within the application. This section

outlines some of the most commonly observed changes and how these should be addressed prior to

migrating to 7.x

Android

The most significant change in Android is the migration to a new build mechanism with Gradle. The

Gradle imposes several restrictions or checks that require you to change the following:

l PNG-based image files should be only PNG format files. It it observed that many time users

reated a .gif and saved it as a PNG file. Previous Android build tools were lenient on this but the

Gradle flags this. Hence all PNG files must only be of PNG format.

l The 9-patch drawable images must include 9-patch regions. The build fails if Gradle detects

discrepancy in this. Refer to the Converting an image to 9-patch image using Android tool on

how to convert an image to a 9-patch image.

l In Visualizer 7.3 onwards, there is support to provide Gradle entries from Visualizer as shown in

. The entries need to be provided from Project Settings->Native->Android. Refer to the relevant

screenshot.

l If the application uses androidprecompiletask or postcompiletask (files would be present in

/ folder) for Gradle-related entries in versions prior to 7.3,

remove those entries and add the entries in Project Settings.

l Gradle needs Android plugin, which gets downloaded when run for the first time. In this case, it

automatically downloads Gradle Android plugin from the jcenter repository

(http://jcenter.bintray.com/com/android/tools/build/gradle/)to your system so you must set

necessary proxy for the command line option of Gradle to work.

iOS

l XCode 8.0 and 64-bit are mandatory for building an application.


http://jcenter.bintray.com/com/android/tools/build/gradle/�


3.1.1.2 Upgrade Guidelines

l If the application is using a combination of flex and box layouts within the same form, this must

be changed. This combination is strictly not supported in 7.x versions. You must ensure that flex

forms have only flex constructs and box forms have only box constructs. From tooling this

combination was never allowed, but if your app is dynamically adding box layouts into flex or

vice versa, then these would cause runtime issues and potential crashes. It is recommended

that you change such instances, if any.

l Raw bytes APIs have been unified. If the app is using rawbytes to store or pass rawbytes

directly into the local/data storage APIs, then you must change the code. It is now mandatory

that you actually convert the rawbytes to base64 (using kony.convertToBase64 api) and vice

versa using (kony.convertToRawBytes).

l The iOS splash screen now supports different screen resolutions. It is mandatory that the

developer provides for all resolutions if he is using splash screen as a part of his application even

if they were not given in the previous version of the app.

l Legacy Studio generates functions when actions are defined using the action editor. The name

of the function is not an exposed API. If applications have taken a dependence on these names,

then you must ensure that you avoid it as these names will be different post the upgrade. This

will result in the app not being launched or functions going missing.

l If the application is using a segment/scroll container within the header/footer templates, then

this combination is no longer supported in 7.x versions. Post the upgrade, you must change the

form to Flex form, along with other widgets in it to Flex and use a flex container with

segment/flex scroll and position using the positional parameters of the flex.

l SPA and Desktopweb have the validation of duplicate widget IDs even during run time. Errors

are thrown on the console if the application is using duplicate widget IDs.

l Due to security reasons, html rendering support has been removed for the Label widget. For

example, label.text = is not supported.



l Post 7.x for SPA and Desktopweb, Jetty server has been discontinued and node js server has

been used instead. To test the SPA/Desktopweb application locally, you need to enable CORS

on the MobileFabric instance where the services are hosted.

l The servicedef.xml contains a list of services used in MobileFabric app. The services in the file

can be edited and renamed. Manual edit/ accidental changes leads to duplication of service IDs

which is not recommended. The servicedef.xml must not contain duplicate service ID’s.

l There are few composite services which internally call integration/object services. In few cases,

the servicedef.xml file may not contain the integration/object service which is being called by the

composite service.

l Many kinds of connectors/services can be defined in the servicedef.xml file. Java is one of the

service for which you need to mention the class for execution. You must upload a jar in the

Server which contains the required class defined in servicedef.xml.

In few cases, wrong jar files are uploaded to server or the Jar does not contain the class defined

in servicedef.xml which results in error.

l ControllerDef.xml file contains all the connectors like JSON/JAVA/XML and the classes which

must be invoked when you use any one of the service. These are Kony's default classes. But

replacing those classes with their custom classes may lead to issues.

l There is a default class for MWServlet which must be used while using middleware/Kony

Fabric. But replacing that class with their own class may lead to many problems during upgrade.

3.1.2 Upgrade Steps

This section outlines the upgrade steps to be performed for upgrading the client application, assuming

the prerequisites have been followed and the app is now in Kony Studio 6.5.x version, and is fully

tested.

Step I - Upgrading Studio Version

Step II - Exporting the Application from Kony Studio 6.5.x version



Step III - Importing the Application to Kony Visualizer Enterprise 7.x Version

Step IV - Exporting the Application from Kony Visualizer Enterprise 7.x Version

Step V - Importing the Application to Kony Visualizer Enterprise V8 Version

Step VI - Creating a MobileFabric Application from Visualizer

Step VII - Saving the Client Application Post-Import

3.1.2.1 Upgrading Studio Version

1. If the app is built in any of the Studio pre-6.5 versions, you must first migrate the app to Studio V

6.5.x latest version.

Important: Upgrade of the application is possible only from the Studio version 6.5.x (with

latest hotfix).

2. Once the project is in 6.5 version, do the following:

a. Right-click the project and select Utilities.

b. From the options available, select Upgrade the project to the current version (if

enabled). A confirmation message appears. Click OK.

c. Right click on the project and Refresh.

3. Then, build the application for the channels you have built the application. Perform a basic sanity

check of your app.

4. Ensure that you take a backup of the working version of the app that is migrated to the 6.5.x

version.

3.1.2.2 Exporting the Application from Kony Studio 6.5.x version

To export an application from Kony Studio, do the following:



1. In Kony Studio 6.5, where your 6.5 project is available, go to File -> Export.

2. Select Archive File.



3. Enter the archive file name and click Finish.

3.1.2.3 Importing the Application to Kony Visualizer Enterprise 7.x Version

1. This step assumes that you have installed Kony Visualizer Enterprise edition on your system.

2. Using the File menu, select the Import option to import the exported zip file created in the

previous step. Alternatively, you can directly point to the 6.5.x project location for the import.

Once selected, click Finish.

Note: Do not select the Import services into MobileFabric check box at this stage as you create

the MobileFabric app in Creating of MobileFabric app from Visualizer.

You can refer the 5.2 Importing the 6.5 project into Visualizer section for relevant screenshots.

While you import the client application, the following tasks are performed in the background:



l For projects imported from Kony Studio, all old widgets (Image, Segment, Image Gallery - all

these widgets have a 2nd version and the app should use them) found in the upgrade process

are deleted from the application.

l Duplicate widgets are renamed automatically.

l Duplicate skins are renamed automatically.

l Reserved keywords are renamed automatically.

l You can find all changes in a log file located in the project root folder. The name of the log file is

_upgradeLog.log. If there are no upgrade changes, the log file is

not created.

l You must take necessary actions on any of the issues in the warning section in the log file.

Importing the 6.5 Project in Visualizer

To export an application Visualizer, do the following:

1. Import the 6.5 exported project to Visualizer Enterprise by using File -> Import -> Local

Project.



2. While importing the app, the system asks you whether you want to upgrade. Click Upgrade.

Now the Studio project is imported to Visualizer.

3.1.2.4 Exporting the Application from Kony Visualizer Enterprise 7.x version

To export an application from Kony Visualizer Enterprise, do the following:

1. In Kony Visualizer Enterprise 7.x, where your 7.x project is available, go to File -> Export->

Local Project.

2. Enter the archive file name and click Save.

3.1.2.5 Importing the Application to Kony Visualizer Enterprise V8 Version

1. This step assumes that you have installed Kony Visualizer Enterprise edition on your system.

2. Using the File menu, select the Import option to import the exported zip file created in the

previous step. Alternatively you can directly point to the 7.x project location for the import. Once



selected, click Finish.

Note: Do not select the Import services into MobileFabric check box at this stage as you create

the MobileFabric app in Creating of MobileFabric app from Visualizer.

While you import the client application, the following tasks are performed in the background:

l For projects imported from Kony Visualizer 7.x, all old widgets (Image, Segment, Image Gallery

- all these widgets have a 2nd version and the app should use them) found in the upgrade

process are deleted from the application.

l Duplicate widgets are renamed automatically.

l Duplicate skins are renamed automatically.

l Reserved keywords are renamed automatically.

l You can find all changes in a log file located in the project root folder. The name of the log file is

_upgradeLog.log. If there are no upgrade changes, the log file is

not created.

l You must take necessary actions on any of the issues in the warning section in the log file.

Importing the 7.x Project in Visualizer

To export an application Visualizer, do the following:

1. Import the 7.x exported project to Visualizer Enterprise by using File -> Import -> Local

Project.



2. While importing the app, the system asks you whether you want to upgrade. Click Upgrade

Now, Kony Visualizer 7.x project is imported to Visualizer V8.

3.1.2.6 Creating a Kony Fabric Application from Visualizer

1. You must install Kony Fabric installed. You can use a Cloud trial for that by going to -

http://www.kony.com/products/KonyFabric/trial

or

You can use the easy-to-use Kony Fabric installer that is available at

http://community.kony.com/downloads


http://www.kony.com/products/mobilefabric/trialhttp://community.kony.com/downloads


2. Copy the following files into/

l servicedef.xml: Servicedef.xml includes all services in the app.

l syncconfig.xml: The syncconfig.xml file contains sync definition (in case Sync is used).

3. Create the following folders in/ and place the following file in the appropriate locations:

l dsl - The dsl folder contains one .properties file and .dsl files. The dsl folder is only for

scraper services.

The name of the properties file should match the app name.

l files - The files folder contains .properties for SAP JCo/Siebel.

l lib - The lib folder contains the dependent jars required by an app

l wsdl - The wsdl folder contains the following additional files for SOAP services.

l mapping.json - contains mapping file for wsdl source to operation names using that wsdl

source (URL/file).

l // The following is a sample entry in the mapping file in JSON format.

{

"partner.wsdl": [

"convertLead",

"create" ],

"http://wsf.cdyne.com/WeatherWS/Weather.asmx?wsdl": [

"GetCityForecastByZIP",

"GetCityWeatherByZIPtest"

]

}

l wsdl: contains wsdl files in the mapping entries mentioned earlier. The mapping entries

refer to json entries present in the mapping.json file.



4. Navigate to Window -> Preferences -> Kony Visualizer -> Kony Fabric.



5. Provide the Kony Fabric Instance URL and validate it.



6. Log on into Kony Fabric from Visualizer by clicking Login at the upper right corner.

7. Import the services to Kony Fabric by selecting File->Import Services into Kony Fabric.

This step creates the Kony Fabric application in the Kony Fabric workspace.



Important: A Kony Fabric application consists of services, and each service contains one or

more operations. But in case of pre-7.x, an app contains only service names. So, in case of

an Kony Fabric app that is created from pre-7.x (by following the earler steps), all the

service names would become operation names. The service names are auto-generated. If

you would like to know the old service name and how it is mapped to the new service

name/operation name, you can refer the _

MWMappings.properties file.

The Import services into Kony Fabric step modifies the JS modules to use the new service

names.

Also, in case you are invoking any services from pre/post processors or Java services, you must

pass the new Service ID wherever you are passing an app ID.



8. Ensure that your application is linked to the newly created Kony Fabric app.



You would see the UNASSOCIATE button against the Kony Fabric app that is linked to your

application.

If the application is using Sync, perform Refresh Sync Client Code, as follows:



3.1.2.7 Saving the Client Application Post-Import

Ensure that the application is checked in to your version control system. You do not need to re-import

the app again. Once the upgrade is done, you do not need to re-upgrade.

3.1.3 Upgrade Legacy Platforms

3.1.3.1 Solution for Thinclient

From 7.0 onwards, Thinclient support has been revoked and you should use SPA.

In previous versions, Kony supported a server-side mobile web platform. This has been unified under

SPA (Single Page Architecture) for better feature richness, performance, and html 5 support. While

moving to this model, any user, who possesses a server-side mobile web must design the forms for

SPA and build the application for a different SPA-supported browser.



Users do not need to redesign the entire application but instead use the native platform mobile/tablet

design and build the app for SPA. All features of native platforms except native device features are

supported in SPA. Over time, browser support has also evolved in Kony's framework. The following

link provides the list of supported browsers:

http://docs.kony.com/konylibrary/general/konyplatform_supported_devices_os_

browsers/Default.htm#HTML5_SPA.htm%3FTocPath%3D_____8

3.1.3.2 Solution for BlackBerry Native Platforms

From 7.0 onwards, support for native BlackBerry or BlackBerry 10 is not available. The following are

the two options for native BlackBerry 10:

l Build the application for BlackBerry 10 hybrid platform.

l Convert APK to BAR.

* The conversion of APK to BAR is based on native BlackBerry 10 support.

Refer to the http://community.kony.com/developer/forum/apk-bar-conversion-and-installation-

process-along-faqs-bb10-and-apk-file for the steps on converting an APK file to BAR.

3.1.3.3 Solution for Sky

3.1.4 Resources

l Visualizer support for providing Gradle Entries

l Upgraded Project – Folders and Files (screenshots)

l Converting an Image to a 9-patch image by using Android Tool

l Steps to create an .aar file


http://docs.kony.com/konylibrary/general/konyplatform_supported_devices_os_browsers/Default.htm#HTML5_SPA.htm?TocPath=_____8http://docs.kony.com/konylibrary/general/konyplatform_supported_devices_os_browsers/Default.htm#HTML5_SPA.htm?TocPath=_____8http://community.kony.com/developer/forum/apk-bar-conversion-and-installation-process-along-faqs-bb10-and-apk-filehttp://community.kony.com/developer/forum/apk-bar-conversion-and-installation-process-along-faqs-bb10-and-apk-file


3.1.4.1 Visualizer Support for Providing Gradle Entries

To add Gradle entries from the project settings of Kony Visualizer by navigating to Project Settings,

do the following:

1. Go to Visualizer, and click Project Settings.

2. In the Project Settings dialog box, click Native -> Android.

3. In the Manifest Properties section, click Gradle Entries.

4. Add the required entries in the Prefix and Suffix text boxes.

5. Click Finish to save the settings and close the dialog box.

3.1.4.2 Converting an image to a 9-patch image by using Android Tool

Convert 9-patch (.9.png) images present in the Resources folder using the Android tool. Otherwise,

you may encounter a Crunching issue during the build for Android platform.



1. Use the draw9patch android tool from the mentioned location to convert images into nine-patch.

2. Drag the image to be converted into the tool and click File> Save 9-patch.

3.1.4.3 Steps to create an .aar file

Prerequisites: Ensure that the gradle path in the environmental variables is supported by Android

Studio.



1. Launch Android Studio -> Create a new Android Studio Project -> Create new android library

module.

2. Open the source folder of FFI and copy the folder in which the FFI code is present.

3. Paste the copied folder in the created Android Studio Library module.

PATH: //src/main/java



4. Open the FFI source and copy the required libraries.

5. Paste the previously copied libs required by your project in the Libs folder in Android Studio.



Path: //libs

6. In the build.gradle file under the created library module, add the dependencies that are

required for the project.



7. Clean and build the project in Android Studio.

After building the project, a .aar file will be generated in the following path:

///build/outputs/aar

Integrating the generated .aar into Kony Visualizer

a. Copy the .aar file from the following path:

///build/outputs/aar

b. Paste it in the following path of the Kony project:

//resources/customlibs/libs/android/



c. Open the .aar file archive and remove the konywidgets.jar file.



3.1.4.4 Upgraded Project – Folders and Files (screenshots)

l Project folder.



l Forms folder.

l Contents of a form folder.

3.1.5 Known Issues

l Issue

Unable to hit the Integration service 'content-type' as header param as the platform is expecting

‘Content-Type’

Workaround

Replace the content-type with Content-Type as shown and MobileFabric the service.

params.httpheaders = {"Content-Type": "application/json",

"accept": "application/json"};



3.2 Upgrade from Kony Server (middleware) to latest version of

MobileFabric (now, Kony Fabric)

The following sections help you upgrade middleware/server from 6.5.x to MobileFabric 7.x:

1. Software and Hardware Requirements

2. Approaches to upgrade to latest Kony Fabric on-premises

3. Post-installation Steps

3.2.1 Software and Hardware Requirements

Refer to the Kony Fabric Deployment Guide for the software requirements and typical deployment

topologies (development and production).

3.2.2 Approaches to upgrade to latest Kony Fabric on-premises

1. If you are using pre-6.5 versions of middleware or a non-MobileFabric version of 6.5 for on-

premises, you need to install MobileFabric. The following are the available options to install

MobileFabric.

l Option 1: Installation support from the Kony Installation Services team:

The Kony Installation Services team provides support to set up MobileFabric for you at a

nominal charge. Refer Cost for the Services Offered for more information.

l Option 2: Install MobileFabric on your own:

a. If you are using Kony Server (middleware) but not KMS and Sync, do the

following:

i. Install MobileFabric using the MobileFabric installer. During installation,

choose New Installation.

Please follow the installation steps from the provided links:


http://docs.kony.com/konylibrary/mobilefabric/kony_mobileFabric_deployment_guide/Default.htm#Deployment.htm


l MobileFabric Installer Guide - Windows: Installing Kony MobileFabric

on Windows

l MobileFabric Installer Guide - Linux: Installing Kony MobileFabric on

Linux

Note: Kony recommends using the MobileFabric Installer for

deploying MobileFabric 7.0 onwards. If you want to install

MobileFabric manually due to your business rules and policies,

please contact [email protected] for approval and to obtain

access to the MobileFabric manual install artifacts. Manual installs

not approved by Kony will not be supported.

Note: If you are installing MobileFabric on AIX, contact

[email protected].

b. If you are using Kony Server (middleware) with KMS or Sync, do the following:

i. If you are using KMS pre-6.5 (non-MobileFabric version of KMS), do the

following:

l Raise a product support request for the DB scripts to be run to

upgrade your current KMS schema to be compatible with flyway.

l Once you receive the scripts from the product support team, run the

scripts.

l Rename the Kony Engagement Services (KMS) database to a name

adhering to the format: kpnsdb. For example,

konykpnsdb29


http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_windows_install_guide/Default.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_windows_install_guide/Default.htmhttp://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_linux_install_guide/Default.htm#Installing_Kony_MobileFabric_on_Linux.htm?TocPath=Installation%2520Modes|Installing%2520Kony%2520MobileFabric%2520on%2520Linux%2520-%2520Console-http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_linux_install_guide/Default.htm#Installing_Kony_MobileFabric_on_Linux.htm?TocPath=Installation%2520Modes|Installing%2520Kony%2520MobileFabric%2520on%2520Linux%2520-%2520Console-mailto:[email protected]:[email protected]


ii. If you are using Sync pre-6.5 (non-MobileFabric version of Sync), you need

to upgrade Sync manually as specified in the Upgrade of Sync Server

section.

iii. Install MobileFabric using the MobileFabric installer. During installation,

choose New Installation. Follow the installation steps from the provided

links:

(In case you have KMS, when the system prompts you for prefix and suffix

during the installation, use the same prefix and suffix as provided earlier).

l MobileFabric Installer Guide - Windows: Installing Kony Fabric on

Windows

l MobileFabric Installer Guide - Linux: Installing Kony Fabric on Linux

iv. Then, link the upgraded Sync server with the MobileFabric server. Refer

Linking KMS/Sync Server with MobileFabric for more information.

2. If you are using pre-6.5 versions of middleware or non-MobileFabric version of 6.5 (On-

premises pre-7.x server) and want to migrate to Kony Cloud, refer Migrating from On-

premises pre-7.x Server to Cloud MobileFabric 7.x

3. If you are using pre-7.x Cloud and want to migrate to 7.x Cloud, refer Migrating from pre-7.x

Cloud to 7.x Cloud


http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_windows_install_guide/Default.htm#Installing_Kony_MobileFabric_on_Windows.htm?TocPath=Installation%2520Modes|Installing%2520Kony%2520MobileFabric%2520on%2520Windows|_____0http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_windows_install_guide/Default.htm#Installing_Kony_MobileFabric_on_Windows.htm?TocPath=Installation%2520Modes|Installing%2520Kony%2520MobileFabric%2520on%2520Windows|_____0http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_linux_install_guide/Default.htm#Installing_Kony_MobileFabric_on_Linux.htm?TocPath=Installation%2520Modes|Installing%2520Kony%2520MobileFabric%2520on%2520Linux%2520-%2520Console-


4. If you are using MobileFabric version of 6.5.2 middleware, do the following:

a. Install MobileFabric using the MobileFabric installer. During installation, select Upgrade.

b. After the upgrade is complete, republish your MobileFabric applications.

Note: For KMS: If you are currently using Kony Engagement Services pre-6.5 (non-

MobileFabric version of KMS), then during the installation do not select Engagement

as you need to upgrade KMS manually as specified in the section Upgrade of Kony

Engagement Server (KMS)and then link to the MobileFabric Server. Refer to Linking

KMS/Sync Server with MobileFabric.

Note: For Sync: If you are currently using Sync pre-6.5 (non-MobileFabric version of

Sync), then during the installation please do not select Sync as you need to upgrade

Sync manually as specified the section Upgrade of Sync Server, and then link to the

MobileFabric Server. Refer to Linking KMS/Sync Server with MobileFabric.

3.2.3 Post-installation Steps

1. If you are using custom servlets, filters, or listeners: As 7.x does not support custom servlets

or filters (for example, the classes that extend HttpServlet or implement ServletContextListener

or Filter), you need to modify them. Refer How to Use Custom Servlets, Filters, and Listeners to

make the changes and create the jar file.

Important: The custom servlets, filters, or listeners must be complied against the latest

compatible middleware-system.jar file , which can be downloaded using the Download

option from Admin Console.

2. Create the MobileFabric application from Visualizer Enterprise by following the MADP Upgrade

document. The created MobileFabric application is displayed in the MobileFabric console, as

follows:


http://docs.kony.com/konylibrary/mobilefabric/kony_mobilefabric_user_guide/Default.htm#UsingCustomServletsFiltersAndListeners.htm?TocPath=Features|Integration|_____18


The service names of your pre-7.x application would become operation names in the

MobileFabric application. Your existing services are grouped based on their service type and

the base URL and given an auto-generated service name. If you want to see how your existing

services are grouped, you can see them in MobileFabric Console or you can refer File

_MWMappings.properties in the Visualizer workspace.

3. Ensure that your client application is linked to the MobileFabric app.

If your client application is linked to MobileFabric app properly, you would see the following UI in

the Visualizer when you click the Project Explorer->MobileFabric->Use existing, where it

shows the UNASSOCITATE against the MobileFabric app to which you have linked your client

app.



4. Copy the custom application-specific properties file

Kony Upgrade Hub Guide - Base Camp Community › konylibrary › beta › v8upgrade65.pdf · Kony...

Documents

Transcript of Kony Upgrade Hub Guide - Base Camp Community › konylibrary › beta › v8upgrade65.pdf · Kony...