Kony MobileFabric™ Sync Installation - Manual - WebLogic On-Premises 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 61 Kony MobileFabric Sync Installation - Manual - WebLogic 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 Modeler, 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. © 2016 by Kony, Inc. All rights reserved 2 of 61 Kony MobileFabric Sync Installation - Manual - WebLogic Version 1.3 Revision History Date Document Description of Modifications/Release Version 10/19/2016 1.3 Document updated for release 7.2 07/13/2016 1.2 Appended new topic Upgrading WebLogic Manually from 7.0.x to 7.1.x. Document release for 7.1. 05/12/2016 1.1 Removed Download files section in Deploying Kony Sync Server and Upgrade sections. 02/26/2016 1.0 Document for Release 7.0. Appended steps for Upgrading WebLogic manually from 6.0.x / 6.5.x to 7.0.x. © 2016 by Kony, Inc. All rights reserved 3 of 61 Kony MobileFabric Sync Installation - Manual - WebLogic Version 1.3 Table of Contents 1. Preface 6 1.1 Purpose 6 1.2 Intended Audience 6 1.3 Formatting conventions used in this guide 6 1.4 Contact Us 8 2. Prerequisites 9 2.1 Hardware Requirements (per physical instance) 9 2.2 Software System Requirements (per physical instance) 10 2.3 Create a WebLogic Domain 10 2.4 Configure MobileFabric Sync Middleware Home 10 3. Deploying Kony MobileFabric Sync Server 11 3.1 Create SyncConsole Database 11 3.2 Setting up Sync Home Directory 12 3.3 Adding Messages Factory Class (Linux) 14 3.4 Creating Data Source for SyncConsole 14 3.5 Configuring Connection Pool Settings for SyncConsole DataSource 22 3.6 Configuring Sync Console JNDI and Hibernate Dialect 26 3.7 Deploying SyncConsole WAR File 29 3.8 Deploying SyncService WAR File 36 4. Upgrading WebLogic Manually from 5.5.x / 5.6.x to 6.5.x 44 © 2016 by Kony, Inc. All rights reserved 4 of 61 Kony MobileFabric Sync Installation - Manual - WebLogic Version 1.3 4.1 How to Upgrade Kony MobileFabric Sync 44 5. Upgrading WebLogic Manually from 6.x / 6.5.x to 7.x 47 5.1 How to Upgrade Kony MobileFabric Sync 47 6. Upgrading WebLogic Manually from 7.0.x to 7.1.x 50 6.1 How to Upgrade Kony MobileFabric Sync 50 7. Appendix: Upgrading the WebLogic Server to Support Java 1.8 59 8. Appendix: Setting Up Multiple Sync Home Directories 61 © 2016 by Kony, Inc. All rights reserved 5 of 61 1. Preface Kony MobileFabric Sync Installation - Manual - WebLogic Version 1.3 1. Preface Kony MobileFabric Sync product has two important components - Kony MobileFabric Sync Management Console and Kony MobileFabric Sync Services. These two applications and corresponding database schema run on various platforms such asTomcat Apache, WebLogic and WebSphere and the database such as MS SQL Server, Oracle, MySQL, and PostgreSQL. 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 provides instructions for installing and configuring Kony MobileFabric Sync Server using WebLogic. 1.2 Intended Audience This document is intended for Administrators and Developers responsible for installing and configuring Kony MobileFabric Sync Server. It is assumed that the reader of this document is familiar with deploying software on Java application servers/WebLogic application server and installing database software 1.3 Formatting conventions used in this guide The following formatting conventions are used throughout the document: © 2016 by Kony, Inc. All rights reserved 6 of 61 1. Preface Kony MobileFabric Sync Installation - Manual - WebLogic Version 1.3 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 © 2016 by Kony, Inc. All rights reserved 7 of 61 1. Preface Kony MobileFabric Sync Installation - Manual - WebLogic 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 product line, contact [email protected]. © 2016 by Kony, Inc. All rights reserved 8 of 61 2. Prerequisites Kony MobileFabric Sync Installation - Manual - WebLogic Version 1.3 2. Prerequisites Read this section to understand the system requirements before installing and configuring Kony MobileFabric Sync Server. You need to ensure that the below software is installed on the machine on which you want to install Kony MobileFabric Sync. 2.1 Hardware Requirements (per physical instance) Component Specification per Instance Standard Standard QA or Standard Development Certification Production Environment Environment Environment Windows Windows Server 2008 Windows Server 2008 Windows Server 2008 Operating / Windows 8 / Windows 8 / Windows 8 System Professional / Professional / Professional / Windows 7 Windows 7 Windows 7 Professional, 64 bit, 4 Professional, 64 bit, 4 Professional, 64 bit, 4 Cores Cores Cores Linux Red Hat Linux Red Hat Linux Red Hat Linux Operating Enterprise 6.0, 64 bit, Enterprise 6.0, 64 bit, Enterprise 6.0, 64 bit, System 4 Cores 4 Cores 4 Cores Minimum 8 GB or more 16 GB or more 32 GB or more Recommended RAM Minimum 40 GB or more 40 GB or more 80 GB or more Recommended Hard Disk Space © 2016 by Kony, Inc. All rights reserved 9 of 61 2. Prerequisites Kony MobileFabric Sync Installation - Manual - WebLogic Version 1.3 For detailed information on hardware requirements, refer to Kony MobileFabric Sync Server Installation Options section of Kony MobileFabric Sync On-Premises Server Planning Guide. 2.2 Software System Requirements (per physical instance) For software system requirements, click here. 2.3 Create a WebLogic Domain Create a new domain using WebLogic Configuration Wizard or use default domain (base_domain) to deploy Kony MobileFabric Sync Server. 2.4 Configure MobileFabric Sync Middleware Home Configuring the MobileFabric Sync Middleware home on WebLogic where MobileFabric (with integrated server) installed, includes the following steps: 1. Deploy the MobileFabric Sync on same WebLogic where Kony MobileFabric (with integrated server) installed. 2. Configure -D parameter for sync middleware home pointing to the existing MobileFabric middleware home created while installing MobileFabric. For example: Add the -Dsync.home=<path of the Kony MobileFabric middleware home directory> parameter for sync middleware home. © 2016 by Kony, Inc. All rights reserved 10 of 61 3. Deploying Kony MobileFabric Sync Kony MobileFabric Sync Installation - Manual - Server WebLogic Version 1.3 3. Deploying Kony MobileFabric Sync Server You have to perform the following procedures to deploy Kony MobileFabric Sync Server: 1. Creating SyncConsole Database 2. Setting up Sync Home Directory 3. Adding Messages Factory Class (Linux) 4. Creating Data source for SyncConsole 5. Configuring Connection Pool Setting for SyncConsole Datasource 6. Configuring Sync Console JNDI and Hibernate Dialect 7. Deploying synconsole.war 8. Deploying syncservice.war 3.1 Create SyncConsole Database Run the downloaded Sync Console script file for each database from your server. It creates syncconsole database. For example l For MS SQL Server: console-schema-sqlserver.sql l For My SQL Server: console-schema-mysql.sql l For Oracle Server: console-schema-oracle.sql l For Postgre SQL Server: console-schema-postgresql.sql l For DB2 Server: console-schema-db2.sql © 2016 by Kony, Inc. All rights reserved 11 of 61 3. Deploying Kony MobileFabric Sync Kony MobileFabric Sync Installation - Manual - Server WebLogic Version 1.3 To execute database scripts using flyway command-line tool, refer Configuring Flyway Command-line Tool section in the MobileFabric Manual Install Guide. 3.2 Setting up Sync Home Directory Note: To setup multiple sync home versions on the same directory skip the below steps and refer Setting Up Multiple Sync Home Directories. To set up Sync home directory, follow these steps: 1. Create a folder in your directory structure (For example: D:\Kony\KonySync in Windows, /Kony/KonySync in Linux) and assume it as sync.home.