Kony MobileFabric Integration Service Database Installation Guide - Oracle On-Premises Release 6.5 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. 2015 by Kony, Inc. All rights reserved 1 of 21
Integration Service Database Installation Guide - Oracle Copyright 2013 by Kony, Inc. All rights reserved. August, 2015 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 Modeler, 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. 2015 by Kony, Inc. All rights reserved 2 of 21
Revision History Date Document Version Description of Modifications/Release 08/10/2015 2.0 Document release for Integration Service Database Installation Guide - Oracle 6.5 GA
Table of Contents 1. Preface 6 1.1 Kony Server 6 1.2 Purpose 7 1.3 Intended Audience 7 1.4 Formatting Conventions Used in this Guide 7 1.5 Contact Us 8 2. Prerequisites 9 3. System Requirements for Kony Database Setup 10 3.1 Software Requirements: 10 3.2 Hardware Requirements: 10 4. Database Sizing and Configuration 12 4.1 Kony Database Sizing Details 13 4.2 Scripts for Kony Database Setup 13 4.3 Approach for Kony Database Setup 14 4.4 Deployment Architecture 15 5. Database Setup 16 5.1 Configure tnsnames.ora 16 5.2 Set up database 17 5.3 Database Setup Complete 18 6. Kony Admin ER Diagram 20
7. Kony Reports ER Diagram 21
1. Preface Integration Service Database Installation Guide - Oracle 1. Preface Kony Platform provides an integrated approach in the mobile application design, development and management. The Platform facilitates the design and development of mobile applications in a device independent manner and delivers them in different formats that run on all the major device platforms. The Kony Platform consists of three main components: Kony Studio: Used to design and develop the mobile applications. Kony Server: Provides server side functionality for the applications, common data integration and device support services. Client Runtime component for each major device platform that enables the same mobile application to execute directly on the device. 1.1 Kony Server 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, to be downloaded by the device. The Application Server has the following features: A sophisticated device database that enables it to detect and deliver the appropriate binary to a requesting device. Inbuilt backend data services integration capability, with out-of-the-box support for Web Services, XML feeds and HTML extraction. Integration with optional third party connector libraries that offer access to a large number of ERP, database and legacy systems. Built in usage tracking and analysis capability that provides a wide range of reports on system and application use. 2015 by Kony, Inc. All rights reserved 6 of 21
1. Preface Integration Service Database Installation Guide - Oracle Kony Database Setup Guide This document provides the database setup instructions for Kony Database. 1.2 Purpose The Kony Database Installation Guide Oracle is designed specifically to provide you with complete installation instructions when installing the Oracle database. 1.3 Intended Audience This document is intended for engineers or system administrators who are responsible for installing and deploying Kony Server and its related databases. We assume that the reader of this document is familiar with deploying software on Java application servers/tomcat application server. The reader of this document must understand how to install the Oracle Database software on the Sun Solaris/Unix platform. 1.4 Formatting Conventions Used in this Guide Following are the formatting conventions used throughout the document: Conventions Explanation Monospace User input text, system prompts and responses File Path Commands Program Code File Names. Italic Emphasis Names of Books and Documents New Terminology. 2015 by Kony, Inc. All rights reserved 7 of 21
1. Preface Integration Service Database Installation Guide - Oracle Conventions Explanation Bold Windows Menus Buttons Icons Fields Tabs Folders. URL Active link to a URL. Note: Note Provides helpful hints or additional information. Important: Highlights actions or information that might cause problems to systems or data. 1.5 Contact Us We welcome your feedback on our documentation. Write to us at techpubs@kony.com. For technical questions, suggestions, comments or to report problems on Kony's product line, contact productsupport@kony.com. 2015 by Kony, Inc. All rights reserved 8 of 21
2. Prerequisites Integration Service Database Installation Guide - Oracle 2. Prerequisites Prerequisites for installing the Kony Database for Oracle: 1. Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database setup in order to successfully complete the Kony database deployment. 2. Customer with Oracle standard edition should install Oracle Locator feature. For more information, see http://docs.oracle.com/cd/b28359_01/appdev.111/b28400/sdo_locator.htm 3. Oracle software must be installed and basic database must have been already created either using Database Configuration Assistant (DBCA) or manually with necessary tablespaces, to continue with Kony database schema setup. 4. From Kony Platform 3.1 onwards, Device DB is used only for Mobile Web. It is not required if you are planning to develop the Native Applications only. 2015 by Kony, Inc. All rights reserved 9 of 21
3. System Requirements for Kony Database Setup Integration Service Database Installation Guide - Oracle 3. System Requirements for Kony Database Setup Below are the system requirements for Kony Database setup: 3.1 Software Requirements: Supported Components Requirement Databases Oracle 11g, Oracle 12c Operating System Any variant of Linux, IBM AIX, Sun Solaris, HP-UX 3.2 Hardware Requirements: For Proof of Concept/Proof of Technology/Demo: Any physical/logical/vm machine with minimum 1 CPU (either physical/logical). Minimum 2 GB RAM and storage up to 100 GB. No need to install Kony reporting modules for POC/POT. For Development and QA Environments: Any physical/logical/vm machine with minimum 1 CPU (either physical/logical). Minimum 2 GB RAM and storage up to 100 GB. 2015 by Kony, Inc. All rights reserved 10 of 21
3. System Requirements for Kony Database Setup Integration Service Database Installation Guide - Oracle For Production: Minimum Requirement: A machine with 2 CPU 4 GB RAM and 250 GB Storage Recommended: A machine with 4 CPU 8 GB RAM and 500 GB Storage Note: Storage is upto 500 GB (for medium business systems) / 2000 GB (for large business systems) with appropriate retention policies with regular purging/data movement to DW systems. 2015 by Kony, Inc. All rights reserved 11 of 21
4. Database Sizing and Configuration Integration Service Database Installation Guide - Oracle 4. Database Sizing and Configuration The following is the sample sizing information. You could also use it for standard setups. Storage sizing for Kony Database Storage Elements Space Required System Tablespace 500 MB to 1000 MB Sysaux Tablespace 550 MB to 1000 MB Undo Tablespace: 500 MB to 4000 MB USERS Tablespace Upto 500 GB (for medium business systems), 2000 GB (for large business systems) and Data files each of size 2 GB. Please use n*2 GB (where n is number of data files). Temp Tablespace 500 MB to 2000 MB Number of redo log groups 3 Number of members in each redo log group 2 Each redolog file size 50 MB Oracle DB software installation space required 1.4 GB to 2 GB CRS installation space required 600 MB to 1000 MB (only for Oracle RAC) OCR size 2 files (100 MB to 200 MB) Voting Disk 3 files (20 MB) 2015 by Kony, Inc. All rights reserved 12 of 21
4. Database Sizing and Configuration Integration Service Database Installation Guide - Oracle Memory sizing for Kony Database RAM (MB) System Global Area max size (MB) System Global Area target size (MB) No. of concurrent connections (numbers) 2048 1343.2 843.2 100 4096 2686.4 1686.4 200 8192 5372.8 3372.8 400 4.1 Kony Database Sizing Details Database Growth Each unique user request from a device logs approximately 2 KB of data into the database. For example, if the application has 60,000 user requests from device per week, then the database grows, approximately, at the following rate: 60,000 user requests from device per week = 2 KB * 60000 = 117 MB 60,000 * 4 weeks = 468 MB (approximate) The above data does not include session error logging. For each device error/exception 2 KB data is generated. 2 GB of database space is used for initial database setup. From then on, the database grows as per the data volume that gets populated into it. To accommodate the data volume, it is ideal to set the storage allocation at 500 GB. 4.2 Scripts for Kony Database Setup The Database (Oracle) scripts are available at the Kony Developer Portal: http://developer.kony.com/konydbscripts 2015 by Kony, Inc. All rights reserved 13 of 21
4. Database Sizing and Configuration Integration Service Database Installation Guide - Oracle Navigate to the relevant database section and click on Standard Database Scripts to download the scripts - Kony_Database_Setup_Oracle_<version>.zip. The Device Data scripts are available at: http://developer.kony.com/devicedb Navigate to the Oracle section and download devicestore_build_ora.zip. Approximate time for Kony database setup: 2 hrs (excluding Oracle software installation). 4.3 Approach for Kony Database Setup You need to follow the "bottom>up" approach to perform the Kony database setup. It would be performed in the following order: 1. Operating System 2. Storage 3. Clusterware (if any) 4. Database software and Database 5. Finally, Web-App servers and JDBC configuration 2015 by Kony, Inc. All rights reserved 14 of 21
4. Database Sizing and Configuration Integration Service Database Installation Guide - Oracle 4.4 Deployment Architecture 2015 by Kony, Inc. All rights reserved 15 of 21
5. Database Setup Integration Service Database Installation Guide - Oracle 5. Database Setup You can perform the database setup by executing the following scripts provided by Kony. konyadmin-oracle.sql V1 konydevicedb-oracle-master.sql (available at flyway/devicedb_oracle) Copy these scripts at some location on the system. Here after, the location where the files are copied is referred to as <Files_Location>. After the execution of the scripts, spool files are created at this location. You can use the spool files to verify the smooth execution of the script files. 5.1 Configure tnsnames.ora Copy the following code into tnsnames.orathe file to the path of your database environment - $ORACLE_HOME/network/admin. KONYDB = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = xx.xx.xx.xx)(port = xxxx)) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = <database-service-name>) ) ) Edit the file and configure the following information: HOST - Provide the database server IP or host name. PORT - Provide the port number configured for the database connection. SERVICE_NAME - Provide the Database Name or ORACLE_SID or Database Service Name. 2015 by Kony, Inc. All rights reserved 16 of 21
5. Database Setup Integration Service Database Installation Guide - Oracle Important: KONYDB is the connection string that is used to connect to the database while executing the scripts. It is used in the following way: conn <username>/<password>@konydb Make sure not to change the connection string name KONYDB. Important: The scripts contain default values for the following items. Modify these default values with your DB environment specific values using find and replace.: users for tablespace. This is the default tablespace name. default for profile-name. This is the default profile name. kony123 for passwords of respective schemas. This is the default password. If you want to change the default values, modify as mentioned above with the actual values as per your database setup before running the scripts. 5.2 Set up database Perform the following tasks to set up the database: 1. Log on to Oracle Server as Sysdba. 2. Go to the file location where the scripts are copied. $ cd <Files_Location> 3. Open the konyadmin-oracle.sql script and add the following code at line number 6. conn konyadmin/kony123@konydb 4. Save the file and execute the script in following order. sqlplus /nolog sql> conn /as sysdba sql> set echo on; 2015 by Kony, Inc. All rights reserved 17 of 21
5. Database Setup Integration Service Database Installation Guide - Oracle sql> spool spool_konyadmin.log sql> @konyadmin-oracle.sql sql> spool off 5. Open the V1 konydevicedb-oracle-master.sql script and add the following code at the beginning of the script. conn konyadmin/kony123@konydb CREATE USER konydevicedb identified by kony123 default TABLESPACE USERS PROFILE default; ALTER USER konydevicedb QUOTA UNLIMITED ON USERS; GRANT CONNECT, RESOURCE TO konydevicedb; conn konydevicedb/kony123@konydb 6. Save the file and execute the script in following order. sqlplus /nolog sql> conn /as sysdba sql> set echo on; sql> spool spool_konydevicedb.log sql> @V1 konydevicedb-oracle-master.sql sql> spool off 7. Verify both the spool files. 5.3 Database Setup Complete Important: If you are planning for the Kony Reports Portal, setup the Kony Reports Database by following the section Reports Portal Database Deployment 2015 by Kony, Inc. All rights reserved 18 of 21
5. Database Setup Integration Service Database Installation Guide - Oracle Once you are done with all the database setup procedures, you can now proceed with the installation of Kony Server. Please follow one of the following documents to install Kony Server. Use the document relevant to the Application Server at your end. 1. Kony MobileFabric Installation Guide - WebLogic 2. Kony MobileFabric Installation Guide - WebSphere 3. Kony MobileFabric Installation Guide - JBoss 4. Kony MobileFabric Installation Guide - Tomcat 2015 by Kony, Inc. All rights reserved 19 of 21
6. Kony Admin ER Diagram Integration Service Database Installation Guide - Oracle 6. Kony Admin ER Diagram Click here for more details on Admin ER Diagram 2015 by Kony, Inc. All rights reserved 20 of 21
7. Kony Reports ER Diagram Integration Service Database Installation Guide - Oracle 7. Kony Reports ER Diagram Click here for more details on Kony Reports ER Diagram 2015 by Kony, Inc. All rights reserved 21 of 21