Kony Mobilefabric Integration Service - Manual Upgrade Version 1.3
Total Page:16
File Type:pdf, Size:1020Kb
Kony MobileFabricTM Integration Service - Manual Upgrade Release 7.2 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. © 2016 by Kony, Inc. All rights reserved 1 of 130 Kony MobileFabric Integration Service - Manual Upgrade Version 1.3 Copyright © 2013 by Kony, Inc. All rights reserved. October, 2016 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 MobileFabric, Kony Nitro, and Kony Visualizer are trademarks 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. 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. © 2016 by Kony, Inc. All rights reserved 2 of 130 Kony MobileFabric Integration Service - Manual Upgrade Version 1.3 Revision History Date Document Description of Modifications/Release Version 10/24/2016 1.3 Document updated for release 7.2 07/20/2016 1.2 Document updated for release 7.1 06/10/2016 1.1 Appended new section Upgrading Tomcat from 5.0.x to 7.0.x. 03/22/2016 1.0 Document updated for 7.0 release. © 2016 by Kony, Inc. All rights reserved 3 of 130 Kony MobileFabric Integration Service - Manual Upgrade Version 1.3 Table of Contents 1. Preface 5 1.1 Purpose 6 1.2 Intended Audience 6 1.3 Formatting Conventions 6 1.4 Contact Us 8 2. Prerequisites 9 2.1 Hardware Requirements 9 2.2 Software System Requirements 9 3. Upgrading Kony MobileFabric Integration Service 10 3.1 Upgrading Kony MobileFabric Integration Service - Tomcat 10 3.2 Upgrading Kony MobileFabric Integration Service - JBoss 39 3.3 Upgrading Kony MobileFabric Integration Service - WebSphere 73 3.4 Upgrading Kony MobileFabric Integration Service - WebLogic 108 © 2016 by Kony, Inc. All rights reserved 4 of 130 1. Preface Kony MobileFabric Integration Service - Manual Upgrade Version 1.3 1. Preface Kony Platform provides an integrated approach in the mobile application design, development, and management in a device independent manner and delivers the applications in different formats that run on all the major device platforms. The Kony Platform consists of three main components: l Kony Visulaizer: Used to design and develop the mobile applications. l Kony MobileFabric Integration Service: Provides server side functionality for the applications, common data integration, and device support services l Client Runtime: A component for each major device platform that enables the same mobile application to execute directly on the device. Kony MobileFabric Integration Service The Kony MobileFabric Integration Service is an important component of the Kony Platform installation. The Kony MobileFabric Integration Service acts as a gateway for Kony applications to access the existing services and web sites in your organization. The application functionality developed and generated by the Kony Studio is enabled and delivered using the Application Server. The SMS and Mobile Web channels are hosted on the Application Server and the Native App binaries are deployed to the server, which can be downloaded to the device. The Application Server has the following features: l A sophisticated device database which enables it to detect and deliver the appropriate binary to a requesting device. l Inbuilt backend data services integration capability, with out-of-the-box support for Web Services, XML feeds and HTML extraction. l Integration with optional third party connector libraries that offer access to a large number of ERP, database and legacy systems. © 2016 by Kony, Inc. All rights reserved 5 of 130 1. Preface Kony MobileFabric Integration Service - Manual Upgrade Version 1.3 l Built in usage tracking and analysis capability that provides a wide range of reports on system and application usage. 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 describes the steps for manual upgrading of the Kony MobileFabric Integration Service. 1.2 Intended Audience This document is intended for engineers or system administrators who are responsible for manually upgrading the Kony MobileFabric Integration Service. We assume that the reader of this document is familiar with deploying and installing MobileFabric application. 1.3 Formatting Conventions Following are the formatting conventions used throughout the document: © 2016 by Kony, Inc. All rights reserved 6 of 130 1. Preface Kony MobileFabric Integration Service - Manual Upgrade Version 1.3 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 Provides helpful hints or additional information Note: Highlights actions or information that might cause Important: problems to systems or data © 2016 by Kony, Inc. All rights reserved 7 of 130 1. Preface Kony MobileFabric Integration Service - Manual Upgrade Version 1.3 1.4 Contact Us We welcome your feedback on our documentation. Write to us at [email protected]. For technical questions, suggestions, comments or to report problems on Kony's product line, contact [email protected]. © 2016 by Kony, Inc. All rights reserved 8 of 130 2. Prerequisites Kony MobileFabric Integration Service - Manual Upgrade Version 1.3 2. Prerequisites The following sections provide you the information to understand the hardware requirements and essential software required to upgrade the Kony MobileFabric Integration Service. 2.1 Hardware Requirements For Hardware requirements, click here. 2.2 Software System Requirements For software system requirements, click here. © 2016 by Kony, Inc. All rights reserved 9 of 130 3. Upgrading Kony MobileFabric Integration Kony MobileFabric Integration Service - Manual Service Upgrade Version 1.3 3. Upgrading Kony MobileFabric Integration Service Assuming that you have prior installation of Integration Service. To upgrade Kony MobileFabric Integration Service manually on different Servers through different versions, follow the below links: Server Versions Tomcat 5.5.x/5.6.x to 6.5.x 6.0.x to 6.5.x 6.5.x to 7.0.x 5.0.x to 7.0.x JBoss 5.5.x/5.6.x to 6.5.x 6.0.x to 6.5.x 6.5.x to 7.0.x WebSphere 5.0.x/5.5.x/5.6.x to 6.0.x 6.0.x to 6.5.x WebLogic 5.5.x/5.6.x to 6.5.x 6.0.x to 6.5.x 6.5.x to 7.0.x 3.1 Upgrading Kony MobileFabric Integration Service - Tomcat Upgrade Kony MobileFabric Integration Service manually on Tomcat server through different versions by following the below links: Server From Version To Version Link Tomcat 5.5.x/5.6.x 6.5.x Click here 5.0.x 7.0.x Click here 6.0.x 6.5.x Click here 6.5.x 7.0.x Click here © 2016 by Kony, Inc. All rights reserved 10 of 130 Kony MobileFabric Integration Service - Manual Upgrade Version 1.3 3.1.1 Upgrade Tomcat Manually from 5.5.x / 5.6.x to 6.5.x This section provides you the steps to upgrade Kony MobileFabric Integration Service manually from 5.6.x to 6.5.x (Tomcat). 3.1.1.1 Prerequisites The following table displays the prerequisites for upgrading Kony MobileFabric Integration Service. Refer to http://community.kony.com/downloads/manual to download the following artifacts: Artifacts Type Purpose Respective Database scripts Database To setup the required Scripts schema l admin.war WAR files To be deployed to Application Server l middleware.war l metrics.ear (applicable only for metrics) (Advantages) l middleware-bootconfig.tar TAR files l libraries-MIDDLEWARE-GA-ver.tar l Thin client JARs from JAR files http://community.kony.com/downloads/manual © 2016 by Kony, Inc. All rights reserved 11 of 130 Kony MobileFabric Integration Service - Manual Upgrade Version 1.3 Advantages of Upgrading with metrics.ear File From Kony MobileFabric Integration Service 6.0 release, metrics.ear is required for reporting. The Admin module is enhanced for a better user experience and instead of depending on server user management, users are now stored in the database. To use the new features, you need to setup a database and install metrics.ear file. Note: It is mandatory to install metrics.ear file along with admin.war. The Kony Reports portal provides the following features: 1. Enhanced User Session - A strong method for reporting the true session count in a given date range. 2. Mechanism for tracking unique users per application. 3. Middleware sends data in the new format to the specified JMS queue. Then metrics.ear processes messages from the JMS queue.