Installation Guide - Linux

Transcription

1 Kony MobileFabric Installation Guide - Linux 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 by Kony, Inc. All rights reserved 1 of 123

2 Copyright 2014 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 by Kony, Inc. All rights reserved 2 of 123

3 Kony MobileFabric On-Premises Installation Guide Linux Ver Revision History Date Document Version Description of Modifications/Release 08/31/ Updated for hot fix. Added support for WebSphere 07/14/ Document Release for 6.5 GA: Added support for Oracle DB Added support for WebLogic Added support for Kony Integration Service 03/30/ Document is updated for Release /19/ Document updated for Release (Added support for Apache Tomcat and JDK 1.6) 01/22/ Document Release for Fall Wave Release 6.0 Copyright 2014 Kony, Inc., All rights reserved. Page 3 of 123

4 Kony MobileFabric On-Premises Installation Guide Linux Ver Table of Contents 1. Preface Purpose Intended Audience Formatting Conventions Used in This Guide Related Documents Contact Us 9 2. Prerequisites Software Requirements Hardware Requirements Creating the Installation User for Linux MobileFabric Topology and Components Developer Environment Production Environment Preinstallation Tasks Prerequisites for MobileFabric with Oracle Download MobileFabric Installer How to Configure Deployment of mbaasportal.war File for Multi-Node How to Install Memcached Server libevent (memcached dependency) Memcached Server 24 Copyright 2014 Kony, Inc., All rights reserved. Page 4 of 123

5 Kony MobileFabric On-Premises Installation Guide Linux Ver How to Increase JVM memory for WebLogic Server How to Place MS SQL Server Connector JAR in WebLogic Classpath How to Deploy Metrics in Domain Mode for WebLogic or JBoss How to Configure Load Balancers for Sending Host Information in Multinode How to Create Locator Component for Oracle Database How to Configure Load balancer as Proxy in JBoss Multinode Setup (Optional if SSL Offloading at Load Balancer) Installation Modes - Kony MobileFabric Installing Kony MobileFabric Standalone Mode (Single Node) Installation Logs for Single Node Installation JBoss Domain Mode (Multinode) Installation Logs for Multinode Installation Installing Kony MobileFabric - Silent-mode Uninstalling Kony MobileFabric Post-Installation Tasks Configuring Secure Sockets Layer (SSL) Certificate How to Add an Installer Generated Self-Signed SSL Certificate to Cacerts How to Add an Existing SSL Certificate to Cacerts JDK Version Compatibility How to Switch between JDK Versions How to Configure Memcached for Integration Service 112 Copyright 2014 Kony, Inc., All rights reserved. Page 5 of 123

6 Kony MobileFabric On-Premises Installation Guide Linux Ver FAQs and Troubleshooting How to Configure Custom JAR File on Weblogic How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileFabric Products Running on JDK How to Enable SSLv2Hello Protocol in the standalone.xml File for Single Node How to Enable SSLv2Hello Protocol in the domain.xml File for Multinode WebSphere FAQs How to Change Log Levels 120 Copyright 2014 Kony, Inc., All rights reserved. Page 6 of 123

7 1. Preface Kony MobileFabric Installation Guide - Linux 1. Preface Kony MobileFabric is a Mobile Back-end 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 backend services instantly. MobileFabric has multiple features that can be used - Identity, Integration, Orchestration, Sync, and Messaging. These features can be accessed through a common, centralized console. For successful authentication with users, and to access centralized features of MobileFabric, Kony recommends that you install the following MobileFabric features on premises: Kony MobileFabric Identity and Console Kony MobileFabric Integration Kony MobileFabric Messaging Kony MobileFabric Sync Kony MobileFabric supports the following back-end services for your applications: Identity: This feature allows you to define the type of authentication used for granting access to your application. MobileFabric supports the following authentication services: Microsoft Active Directory, Salesforce, Security Assertion Markup Language (SAML), Kony SAP Gateway, Kony Facebook, and Kony User Repository. 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. Orchestration: This feature allows you to create two types of orchestration services. They are: Composite: Allows you to run two or more services concurrently or sequentially. Looping: Allows you to run a single service in a loop until the loop ends or an exit criteria is met by Kony, Inc. All rights reserved 7 of 123

8 1. Preface Kony MobileFabric Installation Guide - Linux Synchronization: This feature allows you to define the synchronization services for your application. Sync supports only Web Services, except SAP Sky. Messaging: This feature allows you to define and configure push messaging services for your application. 1.1 Purpose This document explains how to install the Kony MobileFabric Console. 1.2 Intended Audience This document is intended for engineers or developers who are responsible for installing and configuring Kony MobileFabric. We assume that the reader of this document is familiar with installing applications in a Linux environment. 1.3 Formatting Conventions Used in This Guide The following formatting conventions are used throughout the document: Convention 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 2014 by Kony, Inc. All rights reserved 8 of 123

9 1. Preface Kony MobileFabric Installation Guide - Linux Convention Explanation Bold Windows Menus Buttons Icons Fields 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. us at techpubs@kony.com. For technical questions, suggestions, and comments or to report problems on Kony's product line, contact productsupport@kony.com by Kony, Inc. All rights reserved 9 of 123

10 2. Prerequisites Kony MobileFabric Installation Guide - Linux 2. Prerequisites The following sections provide information about the software and hardware required to install Kony MobileFabric Console. 2.1 Software Requirements Purpose Software Requirement Kony MobileFabric installer KonyMobileFabricInstaller GA.bin Database Server * Database is shared across instances. MySQL 5.6 Oracle (12.1.0) MS SQL Server 2012 R2 Note: A database user should be granted all permissions. Note: Increase your database connection limit to use the same database for all components - such as Kony MobileFabric Console, Kony Identity Service, and Kony Integration Service. For example: To increase MySQL database connection limit, execute the following command: SET global max_connections = 350; Note: Ensure that a database user should be granted all privileges like create update, and delete database schema, views, jobs, and manage schedulers by Kony, Inc. All rights reserved 10 of 123

11 2. Prerequisites Kony MobileFabric Installation Guide - Linux Purpose Software Requirement SSL certificate To use your existing SSL certificate, map the SSL certificate to the domain name you want to use. Application Server Stack Apache Tomcat JBoss Enterprise Application Platform 6.2 Important: If you are running JBoss in Domain node (multi node)for a production setup, get the appropriate licenses from Red Hat. Important: Kony supports Oracle JDK 1.6 and JDK 1.7 for Tomcat and JBoss, and for all on-premises products. Kony supports Oracle JDK or higher for WebLogic. WebLogic (12.1.3) WebSphere Hardware Requirements Component Requirement Processor Quad-core processor Memory 16 GB Internal Storage 150 GB Network 100 Mbps Ethernet interface card Operating System Red Hat Enterprise Linux by Kony, Inc. All rights reserved 11 of 123

12 2. Prerequisites Kony MobileFabric Installation Guide - Linux 2.3 Creating the Installation User for Linux To create a user, follow these steps: 1. From your MobileFabric install system, open Linux terminal. Note: For security and administrative reasons, install and run Kony MobileFabric Installer as a non-root user. 2. Run the following commands: # adduser core # passwd core 2014 by Kony, Inc. All rights reserved 12 of 123

13 3. MobileFabric Topology and Components Kony MobileFabric Installation Guide - Linux 3. MobileFabric Topology and Components MobileFabric topology explains the logical arrangement of various components, such as, console, identity services, developer environment, and production environment. In design time you configure apps with services, and publish them to a developer environment. After you confirm the changes in the apps, these apps will need to be published to a production environment. Authorized users can access apps on mobile devices from a production environment by Kony, Inc. All rights reserved 13 of 123

14 3. MobileFabric Topology and Components Kony MobileFabric Installation Guide - Linux An overview of the MobileFabric architecture and components follows: 2014 by Kony, Inc. All rights reserved 14 of 123

15 3. MobileFabric Topology and Components Kony MobileFabric Installation Guide - Linux An overview of the MobileFabric deployment architecture follows: The following table describes the components of MobileFabric: Convention Description Identity This component validates user accounts and applications for authentication and authorization. Authentication identifies log-on credentials of a user. Authorization allows or denies access to resources based on a user's role. Identity is used to authenticate and authorize runtime and design-time users by Kony, Inc. All rights reserved 15 of 123

16 3. MobileFabric Topology and Components Kony MobileFabric Installation Guide - Linux Convention Description Accounts The accounts component contains information about what a user can do, such as create other users, delete users, create environments, delete environments, and publish apps to an environment. This component uses auth service for authorizing requests based on user roles. Workspace (WaaS) Workspace configures MBaaS services (applications, identity, integration, orchestration, synchronization, and messaging). After these services are configured, these services must be published to respective clouds/environments so that the services are available for run-time use. Console/Portal The console/portal is the user interface for configuring services for an application. Environments (KMS, Sync, Integration Service) This component adds runtime capabilities to apps, such as messaging services, synchronization services, and integration services. Admin Admin provides the capability to list down the set of services published and test the services shown as well. Also you can view list of published apps and provides the delete apps functionality. In Kony Cloud, changing the log levels and checking the logs features are available as the cloud is managed by Kony. You can also view reports if you are using metrics module. This is an optional component. For more details, refer to mobilefabric_integration_ service_admin_console_user_guide/default.htm Middleware This component exists between a mobile device and an endpoint server. It receives a request from a mobile device, sends it to an endpoint server, fetches the response from the backend and provides the required information to the device in the JSON format by Kony, Inc. All rights reserved 16 of 123

17 3. MobileFabric Topology and Components Kony MobileFabric Installation Guide - Linux Convention Description Services Services component is used only when MobileFabric is integrated. It has same runtime capabilities as the middleware. Note: To use Kony Sever with MobileFabric integrated, you can ignore the middleware.war. Similarly when you use only standalone Kony Server, you can ignore the services.war. For more details, refer to Note: The MobileFabric components can be configured on one node or separate nodes - for example, you can use one of the following choices: - Install All Components on one node. - Install Kony MobileFabric Console, Kony Identity Service, and Kony Integration Service on separate nodes. For frequently asked questions and troubleshooting, refer to FAQs and Troubleshooting. 3.1 Developer Environment For development environment, a developer can preferably install MobileFabric components in a standalone mode (single node) on a local environment. For more details, refer to Single Node Installation. Important: Kony MobileFabric Installer supports Tomcat, JBoss, and Weblogic. Tomcat on single-node only. For multi-node installation on Tomcat, refer to MobileFabric Manual 2014 by Kony, Inc. All rights reserved 17 of 123

18 3. MobileFabric Topology and Components Kony MobileFabric Installation Guide - Linux Install Guide. Kony MobileFabric Consolidated installer supports JBoss on single node (Standalone Mode) and multi-node (Domain Mode). Important: By default Kony MobileFabric Consolidated installer supports memcached server only in case of multinode installation. By default Kony MobileFabric Consolidated installer is not enabled with memcached server for single node installation (Tomcat and JBoss.) If you want use memcached server, follow manual steps provided at How to Install Memcached Server. 3.2 Production Environment For production environment, domain mode (multinode) installation with HTTPs protocol is preferred. Multinode installation helps to enable better performance, high availability, and load balancing. For more details, refer to Multinode Installation by Kony, Inc. All rights reserved 18 of 123

19 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux 4. Preinstallation Tasks Before you install MobileFabric Console Installer, you must perform the following preinstallation tasks: Ensure access to MySQL 5.6 database server. Ensure a corresponding database user with all privileges. Map the SSL certificate to the domain name you want to use if you want to use your existing SSL certificate. Configure the JBoss cluster if you want to install in multi-node mode. 4.1 Prerequisites for MobileFabric with Oracle For installing MobileFabric Database for Oracle, complete the following steps: Note: Only a qualified Oracle Database Administrator (DBA) must handle the Oracle Database setup in order to successfully complete the MobileFabric database deployment. Oracle software must be installed and basic database must be created before to continue with MobileFabric database schema setup. Unicode support needs to be enabled in Database. This is possible only while creating a database needed for MobileFabric with a Unicode character set with the properties for Database character set as AL32UTF8 and National character set as AL16UTF16. Important: Ensure that a dedicated database user must not be an application user (for example, konydevicedb) for installation of database. A dedicated user gets logged into audit logs. A dedicated user must be granted with privileges, shown in the following section. After granting privileges, disconnect existing session, and use new session in order to get the new privileges loaded to the user by Kony, Inc. All rights reserved 19 of 123

20 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux Create a dedicated database user. o To create a user based on your Oracle 11g or 12c without PDB, which will be used in the JDBC. Using an SQLPlus or another Database client, connect to you Oracle database as Sysdba. CREATE USER <install-user> IDENTIFIED BY <password> DEFAULT TABLESPACE USERS TEMPORARY TABLESPACE TEMP PROFILE DEFAULT; GRANT <*Grants list> TO <install-user> with admin option; <*Grants list for Oracle 11g or 12c without PDB> CREATE JOB, CREATE PROCEDURE, CREATE SEQUENCE, CREATE SESSION, CREATE TABLE, CREATE TABLESPACE, CREATE TRIGGER, CREATE TYPE, CREATE USER, CREATE VIEW, CREATE SESSION, ALTER SESSION, ALTER TABLESPACE, ALTER USER Important: Ensure that a dedicated database user must not be an application user (for example, konydevicedb) for installation of database. A dedicated user gets logged into audit logs. A dedicated user must be granted with privileges, shown in the following section. After granting privileges, disconnect existing session, and use new session in order to get the new privileges loaded to the user. o To create a dedicated database user based on your Oracle 12c with PDB, then create a dedicated database local user inside PDB, which will be used in the Java Database Connectivity (JDBC) authentication. Alter session set container = PDB<MF_DB> ; CREATE USER <dedicated-database-local-user> 2014 by Kony, Inc. All rights reserved 20 of 123

21 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux IDENTIFIED BY <password> DEFAULT TABLESPACE USERS TEMPORARY TABLESPACE TEMP PROFILE DEFAULT CONTAINER=CURRENT; GRANT <**Grants list> TO <install-local-user> with admin option CONTAINER=CURRENT; <**Grants list for Oracle 12c with PDB> CREATE JOB, CREATE PROCEDURE, CREATE SEQUENCE, CREATE SESSION, CREATE TABLE, CREATE TABLESPACE, CREATE TRIGGER, CREATE TYPE, CREATE USER, CREATE VIEW, CREATE PLUGGABLE DATABASE, CREATE SESSION, ALTER SESSION, ALTER TABLESPACE, ALTER USER If you are using MobileFabric installer to setup MobileFabric database, then please choose the below options based on your Oracle database version. o If Oracle database is created with PDB option of Oracle 12c, use service name pointing to PDB in the JDBC URL such as pdborcl or pdbmfdb jdbc:oracle:thin:@<database_host_ip>:1521:pdbmfdb For example: jdbc:oracle:thin:@ :1521:pdbmfdb o But if your database is 11g or 12c without PDB, then you can use ORACLE_SID in the JDBC URL such as orcl or mfdb. jdbc:oracle:thin:@<database_host_ip>:1521/mfdb For example: jdbc:oracle:thin:@ :1521/mfdb 4.2 Download MobileFabric Installer Download KonyMobileFabricSetup.tar.gz file (for release 6.5 GA) from and extract the file. To download Kony MobileFabric 2014 by Kony, Inc. All rights reserved 21 of 123

22 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux installer from the community portal, follow these steps: 1. Log in to You can obtain a user name and password from your sales representative or partner. 2. Navigate to the Kony MobileFabric section and click the Kony v6.5 GA version tab. 3. Select the specific release from the Version drop-down list and then click on the specific release related files you want to download. For example, if you want to download Kony MobileFabric GA, click the Kony v6.5 GA tab, select the GA version from the drop-down list, and then click the Download button. The KonyMobileFabricSetup.tar.gz file contains the following files: KonyMobileFabricInstaller GA.bin installer.properties - This file is required for silent installation by Kony, Inc. All rights reserved 22 of 123

23 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux README.txt 4.3 How to Configure Deployment of mbaasportal.war File for Multi- Node Once MobileFabric installation succeeds, the MobileFabric Console will not be displayed as the enable-welcome-root value is set true in the domain.xml file. To configure mbaasportal.war, follow these steps: 1. In the master node, open the domain.xml file from JBOSSDIR/domain/configuration, and search for enable-welcome-root="true." 2. Replace enable-welcome-root="true" with enable-welcome-root="false." 4.4 How to Install Memcached Server Memcached is a high-performance, distributed memory object caching system, generic in nature, but intended for use in speeding up dynamic web applications by alleviating database load libevent (memcached dependency) The libevent API provides a mechanism to execute a callback function when a specific event occurs on a file descriptor or after a timeout has been reached. Furthermore, libevent also support callbacks due to signals or regular timeouts. libevent is meant to replace the event loop found in event driven network servers. An application just needs to call event_dispatch() and then add or remove events dynamically without having to change the event loop. Refer to To install libevent (memcached dependency), follow these steps: 2014 by Kony, Inc. All rights reserved 23 of 123

24 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux 1. First, check whether libevent is installed on your computer. To check, type the below command in your Linux terminal: whereis libevent 2. If you do not find libevent on your system, download and install it. Download libevent stable.tar.gz. Refer to 3. Extract the libevent stable. 4. In your Linux terminal, type the below command: cd libevent stable./configure make make install 5. Type the below command to create a symlink to libevent ln -s /usr/local/lib/libevent-1.4.so.2 /usr/lib Now that you have installed the dependencies, install the memcahced server Memcached Server To install Memcached Server, follow these steps: 1. Download the memcached server. 2. Extract the zip file. 3. Open the Linux terminal by Kony, Inc. All rights reserved 24 of 123

25 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux 4. Go to../memcache directory. 5. Run the following command: tar xfz memcached tar.gz cd memcached /configure make make install memcached -d -m u root -l p Important: Run Memcached as a daemon (d = daemon, m = memory, u = user, l = IP to listen to, p = port) 4.5 How to Increase JVM memory for WebLogic Server For a successful deployment of MobileFabric War files on Weblogic server, increase the PermGen memory in Weblogic memory arguments To increase the PermGen memory in your Weblogic memory arguments, follow these steps: 1. Go to "%DOMAIN_HOME%\bin\" folder, open the setdomainenv.cmd file. 2. In the setdomainenv.cmd file, search and edit the default values for the following attributes. For example, for the attribute: WLS_MEM_ARGS_64BIT, the default value is Xms256m - Xmx512m by Kony, Inc. All rights reserved 25 of 123

26 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux set WLS_MEM_ARGS_64BIT=-Xms512m -Xmx1024m set WLS_MEM_ARGS_32BIT=-Xms512m -Xmx1024m set MEM_PERM_SIZE_64BIT=-XX:PermSize=512m set MEM_PERM_SIZE_32BIT=-XX:PermSize=512m set MEM_MAX_PERM_SIZE_64BIT=-XX:MaxPermSize=1024m set MEM_MAX_PERM_SIZE_32BIT=-XX:MaxPermSize=1024m 3. Save the setdomainenv.cmd file. 4. Execute the command setdomainenc.cmd. 5. Start Weblogic server. 4.6 How to Place MS SQL Server Connector JAR in WebLogic Classpath If you want to install MS SQL Server Database with WebLogic, then you need to manually place the sqljdbc4.jar file in the WebLogic classpath. Important: To add the sqljdbc4.jar file in the WebLogic classpath, perform the following steps before starting MobileFabric installation. To add sqljdbc4.jar file in the WebLogic classpath, follow these steps: 1. Place the sqljdbc4.jar in the <WL_HOME>/server/lib folder. 2. Edit the commenv.cmd/sh script in the <WL_HOME>/oracle_common/common/bin. 3. Prepend your JAR file to the WEBLOGIC_CLASSPATH environment variable like set WEBLOGIC_CLASSPATH=%WL_HOME%\server\lib\sqljdbc4.jar;%JAVA_ 2014 by Kony, Inc. All rights reserved 26 of 123

27 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux HOME%\lib\tools.jar;%PROFILE_CLASSPATH%;%ANT_ CONTRIB%\lib\ant-contrib.jar;%CAM_NODEMANAGER_JAR_PATH% 4. Restart the server. 4.7 How to Deploy Metrics in Domain Mode for WebLogic or JBoss In App Services console, Healthcheck for access to reporting queue fails for WebLogic and JBoss cluster. For WebLogic: While installing WebLogic cluster, user should select both admin server and cluster options. For JBoss, To deploy metrics in domain mode, follow these steps: a. Create Application User: To create an application user, go to JBOSS/bin folder and run the add-users.sh file, shown below: 2014 by Kony, Inc. All rights reserved 27 of 123

28 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux b. In the Queues/Topics tab, create JMS topic, shown below: c. In the Security Settings tab, create a role for jms, shown below: 2014 by Kony, Inc. All rights reserved 28 of 123

29 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux d. In the Connection Factories tab, create connection factory, shown below: e. Verify the configuration to access admin health check. The system should show all pass including Access to Reporting Queue mainly. You have successfully configured the metrics by Kony, Inc. All rights reserved 29 of 123

30 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux f. In the Global Modules, add the required modules, shown below: 4.8 How to Configure Load Balancers for Sending Host Information in Multinode When user is installing MobileFabric on multinode environment, the user should check whether the parameter: proxypreservehost is set to On in the Loadbalancer configuration file to send host in the headers. If the proxypreservehost is not configured, the loadbalancer will not send host in the headers. Users cannot launch MobileFabric Console. The above configuration is based on the loadbalancer. For example: For Apache: preservehost On For HAProxy: preserve host flag is not required by Kony, Inc. All rights reserved 30 of 123

31 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux 4.9 How to Create Locator Component for Oracle Database By default when an Oracle database is created using DBCA or Oracle Installer Enterprise Edition with create database option, the SDO_Geometry object type will be default created as part of locator component. If the database is created using scripts by following manual process, then the Locator component will not be created. You need to create the locator component for your Oracle database separately. Verify if the locator component is already installed Run the below queries in the Oracle database used for Installer: Select comp_name, version, status from dba_registry where upper (comp_name) like '%MEDIA'; Select username from dba_users where username = 'MDSYS' If the above statements return zero records and MDSYS schema is not created, then follow these steps to create the MDSYS schema and install the locator component manually. The following steps need to be executed by a SYSDBA only. To create Locator or MDSYS schema, follow these steps in option #1 or option #2: Option #1. Follow DBCA or Oracle Installer enterprise edition with create database option to create Oracle database. Use the same database during MobileFabric Installation. Option #2. Run the following scripts on the database to be used for MobileFabric, where Oracle locator is not installed by Kony, Inc. All rights reserved 31 of 123

32 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux i. Connect as SYSDBA sqlplus "/as sysdba" ii. Create MDSYS User if not exists: Create user mdsys identified by secret default tablespace sysaux A secret is a dummy password. Provide the password that is used during MDSYS user creation. iii. Run the below SQL to grant the privileges: SQL>@?/md/admin/mdprivs.sql iv. Connect to MDSYS user: Conn mdsys/secret A secret is dummy password. Provide the password that is used during MDSYS user creation. v. Run the below SQL to create the locator objects: SQL>@?/md/admin/catmdloc.sql All the above.sql files executed will be available as part of database software md folder. Once the Oracle locator is installed, run the Installer to setup MobileFabric. The system should not throw the error: Invalid Data Type SDO_GEOMENTRY 2014 by Kony, Inc. All rights reserved 32 of 123

33 4. Preinstallation Tasks Kony MobileFabric Installation Guide - Linux Note: For license reference, refer to locator.htm#spatl How to Configure Load balancer as Proxy in JBoss Multinode Setup (Optional if SSL Offloading at Load Balancer) 1. Navigate to your MobileFabric install directory and open the domain.xml file. 2. In the domain.xml, update all the http connector tags to include the scheme and proxy-port details. For example, <connector name="http" protocol="http/1.1" scheme="https" socket-binding="http" proxy-port="443"/> 2014 by Kony, Inc. All rights reserved 33 of 123

34 5. Installation Modes - Kony MobileFabric Kony MobileFabric Installation Guide - Linux 5. Installation Modes - Kony MobileFabric You can install MobileFabric by any of the following modes: Important: Ensure that you have the required hardware and access to the supporting software as mentioned in the Prerequisites section and performed the steps as mentioned in the Preinstallation Tasks section. Installing MobileFabric - Console-mode (for command-line-driven installations) Single Node Installation JBoss Multinode Installation Installing MobileFabric - Silent-mode (for working with limited or no user interaction) 2014 by Kony, Inc. All rights reserved 34 of 123

35 5.1 Installing Kony MobileFabric Note: If a user installs Kony MobileFabric Console on a partition different from the user's home directory, the user must have read/write execute permissions. This section of the document provides you with the instructions for installing and configuring Kony MobileFabric Console. Important: Ensure that you have the required hardware and access to the supporting software as mentioned in the Prerequisites section and performed the steps as mentioned in the Preinstallation Tasks section. Make sure you have proper administrative rights to install Kony MobileFabric on your computer. You also need a user where Kony MobileFabric will be installed. The <Install Location> directory contains the log files documenting each invocation of the installer. To make problem identification easier, provide these log files to Kony when reporting an issue Standalone Mode (Single Node) Installation To install Kony MobileFabric Console using the installer, follow these steps: 1. Execute the following command to switch to the user that you created. # su - username 2. Press Enter. You will be prompted to enter the password. 3. Enter the password, and press Enter. 4. Unzip the KonyMobileFabricSetup.tar.gz file, and navigate to the folder KonyMobileFabric_Installer_Linux. 5. Start the./konymobilefabricinstaller ga.bin file by executing the following command: 2014 by Kony, Inc. All rights reserved 35 of 123

36 Preparing to install... Extracting the JRE from the installer archive... Unpacking the JRE... Extracting the installation resources from the installer archive... Configuring the installer for this system's environment... Launching installer... ================================================================== ============= Kony MobileFabric (created with InstallAnywhere) Preparing CONSOLE Mode Installation... ================================================================== ============= Introduction Kony MobileFabric is a set of enterprise-grade mobile infrastructure services that makes it easy to build amazing apps that integrate and support all of your backend systems. With open, standards-based development, scalable and secure services, and exceptional agility, enterprises can dramatically reduce the cost and complexity of enterprise mobility projects. To proceed with installation, please confirm that the following prerequisites have been met - 1. Database server with admin user for installation. Supported database server are MySQL 5.6, Oracle 12c (12.1.0) and MS SQL Server 2012 R2. 2. If you want to use existing SSL certificate then have it ready. 3. If you want to install in JBoss domain mode or WebLogic 12c 2014 by Kony, Inc. All rights reserved 36 of 123

37 (12.1.3) or WebSphere then have the application server preconfigured. To change input, type 'back' to go back to the previous step. To cancel the installation, type 'quit' at any time. For troubleshooting & help on the installation, usehttp://docs.kony.com/konyonpremises/#installer.htm. For getting started on Kony MobileFabric, refer If you have more questions or feedback, you can join our or, raise a ->1- Continue with Installation. 2- Abort Installation. ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 6. To continue the installation, type 1 and press Enter. Otherwise, to abort, type 2 and press Enter. The License Agreement option appears. ================================================================== ====== License Agreement Installation and Use of Kony MobileFabric Console Requires Acceptance of the Following License Agreement: KONY, INC. SOFTWARE LICENSE AGREEMENT THE TERMS AND CONDITIONS CONTAINED HEREIN CONSTITUTE A LEGAL 2014 by Kony, Inc. All rights reserved 37 of 123

38 AGREEMENT. THIS AGREEMENT ("AGREEMENT") CONTAINS THE ENTIRE AGREEMENT BETWEEN YOU ("LICENSEE") AND KONY, INC. ("KONY") WITH RESPECT TO THE TERMS AND CONDITIONS DESCRIBED HEREIN. READ THIS AGREEMENT CAREFULLY BEFORE YOU CLICK THE "I ACCEPT" BUTTON BELOW. BY CLICKING ON THE "I ACCEPT" BUTTON, YOU ACKNOWLEDGE THAT (1) YOU ARE AUTHORIZED TO ENTER THIS AGREEMENT FOR AND ON BEHALF OF YOUR COMPANY, AND ARE DOING SO, AND (2) YOU HAVE READ AND UNDERSTAND AND AGREE THAT YOU AND THE COMPANY SHALL BE BOUND BY THESE TERMS AND CONDITIONS AND ALL MODIFICATIONS AND ADDITIONS PROVIDED FOR. IF YOU DO NOT AGREE WITH THESE TERMS AND CONDITIONS, CLICK ON THE "I DO NOT ACCEPT" BUTTON BELOW AND INSTALLATION WILL TERMINATE. Software products included with this product that are not Kony products are licensed to you by the software provider. Please refer to the license contained in the provider's product for the terms of use before using such products. 1. License Grant. Kony grants you a limited, non-exclusive, nontransferable license to use, for developmental purposes only, the Kony software program(s), PRESS <ENTER> TO CONTINUE: known as the KonyTM Platform (the "Software") and related product documentation at no charge subject to the terms and restrictions set forth in this License Agreement. You are not permitted to use the Software in any manner not expressly authorized by this License. You acknowledge and agree that ownership of the Software and all subsequent copies thereof regardless of the form or media are held by Kony. The terms of this License will govern any 2014 by Kony, Inc. All rights reserved 38 of 123

39 Software upgrades provided by Kony that replace and/or supplement the original Software, unless such upgrade is accompanied by a separate license in which case the terms of that license will govern. 2. Term of Agreement. Your license is effective until terminated by Kony. The License will terminate automatically if you fail to comply with any of the limitations or other requirements described herein. At termination you shall cease all use of the Software and destroy all copies, full or partial of the Software. 3. Ownership Rights. The Software and related documentation are protected by United States copyright laws and international treaties. Kony, third party component providers and open source component providers own and retain all right, title and interest in and to the Software and related documentation, including all copyrights, patents, trade secret rights, trademarks and other intellectual property rights therein. Your possession, installation, or use of PRESS <ENTER> TO CONTINUE: the Software and related documentation does not transfer to you any title to the intellectual property in the Software and the related documentation, and you will not acquire any rights to the Software and product documentation, except the limited right to use it as expressly set forth in this Agreement. 4. Use of Name and Trademarks. You shall not use the name, trade names or trademarks of Kony or any of its affiliates in any advertising, promotional literature or any other material, whether in written, electronic or other form, distributed to any third 2014 by Kony, Inc. All rights reserved 39 of 123

40 party, except in the form provided by Kony, and then solely for purposes of identifying Kony software. 5. Restrictions. (A) Except as provided in this Agreement, you may not rent, lease, lend, redistribute or sublicense the Software. You may not copy the Software except to make archival or backup copies, provided that the backup copy must include all copyright or other proprietary notices contained on the original. You may not copy the related product documentation. You may not modify, reverse engineer, decompile, or disassemble the Software, except to the extent the foregoing restriction is expressly prohibited by applicable law. The Software is not intended for use in the operation of nuclear facilities, aircraft navigation or communication systems, air traffic control systems, life support PRESS <ENTER> TO CONTINUE: machines or other equipment in which the failure of the Software could lead to death, personal injury or severe physical or environmental damage. (B) Certain components of the Software are provided under various Open Source licenses that have been made available to Kony. You may modify or replace only these Open-Sourced Components; provided that (i) the resultant Software is used in place of the unmodified Software, on a single computer; and (ii) you otherwise comply with the terms of this License and any applicable licensing terms governing use of the Open-Sourced Components. Kony is not obligated to provide any maintenance, technical or other support for the resultant Software by Kony, Inc. All rights reserved 40 of 123

41 6. Exclusion of Warranties. THE SOFTWARE IS PROVIDED TO LICENSEE "AS IS", AND ANY USE BY LICENSEE OF THE SOFTWARE WILL BE AT LICENSEE'S SOLE RISK. KONY MAKES NO WARRANTIES RELATING TO THE SOFTWARE AND EXPRESSLY DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. SOME STATES AND JURISDICTIONS DO NOT ALLOW LIMITATIONS ON IMPLIED WARRANTIES, SO THE ABOVE JURISDICTION MAY NOT APPLY TO YOU. The foregoing provisions shall be enforceable to the maximum extent permitted by applicable law. 7. Limitation of Liability. TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT SHALL KONY BE LIABLE FOR PERSONAL INJURY, OR ANY INCIDENTAL, SPECIAL, INDIRECT PRESS <ENTER> TO CONTINUE: OR CONSEQUENTIAL DAMAGES WHATSOEVER, INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, LOSS OF DATA, BUSINESS INTERRUPTON OR ANY OTHER COMMERCIAL DAMAGES OR LOSSES, ARISING OUT OF OR RELATED TO YOUR USE OR INABILITY TO USE THE KONY SOFTWARE, HOWEVER CAUSED, REGARDLESS OF THE THEORY OF LIABILTY (CONTRACT, TORT OR OTHERWISE) AND EVEN IF KONY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME JUSISDICTIONS DO NOT ALLOW THE LIMITATION OF LIABILITY FOR PERSONAL INJURY, OR FOR INCIDENTIAL OR CONSEQUENTIAL DAMAGES, SO THIS LIMITATION MAY NOT APPLY TO YOU. In no event shall Kony's total liability to you for all damages (other than as may be required by applicable law in cases involving personal injury) exceed the amount of fifty dollars ($50.00). The foregoing limitations will apply even if the above stated remedy fails of its essential purpose. 8. Export Law Assurances. You may not use or otherwise export or 2014 by Kony, Inc. All rights reserved 41 of 123

42 re-export the Software except as authorized by United States law and the laws of the jurisdiction in which the Software was obtained. In particular, but without limitation, the Software may not be exported or re-exported (a) into (or to a national or resident of) any U.S. embargoed countries (currently Cuba, Iran, Iraq, Libya, North Korea, Sudan, and Syria) or (b) to anyone on the U.S. Treasury Department's list of Specially Designated Nationals or the U.S. Department of Commerce Denied Person's List or Entity List. By using the Software, you represent and warrant that you are not located in, under control PRESS <ENTER> TO CONTINUE: of, or a national or resident of any such country or on any such list. 9. United States Government. The Software and related explanatory written materials are "Commercial Items" as that term is defined at 48 C.F.R. ï ½2.101, consisting of "Commercial Computer Software" and "Commercial Computer Software Documentation", as such terms are used in 48 C.F.R. ï ½ or 48 C.F.R. ï ½ , as applicable. Consistent with 48 C.F.R. ï ½ or 48 C.F.R. ï ½ through , as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. 10. Governing Law. This Agreement is governed by the law of the State of Florida, U.S.A., without reference to conflict of laws principles. The application of the United Nations Convention of 2014 by Kony, Inc. All rights reserved 42 of 123

43 Contracts for the International Sale of Goods is expressly excluded. 11. Assignment/Transfers. The parties may not assign or transfer this Agreement, in whole or in part, without the other Party's prior written consent. Any attempted assignment or transfer in violation of this Section will be null and void. PRESS <ENTER> TO CONTINUE: 12. Third Party Acknowledgements. (A) Aspects of the Software utilize or include third party software and other copyrighted material. Acknowledgements, licensing terms and disclaimers for such material are available when accessing the Software on the Kony website, and your use of such material is governed by their respective terms. (B) The Software includes certain software provided under various Open Source licenses. You may obtain complete machine-readable copies of the source code and licenses for the Open Source software at the Kony Open Source website ( Open Source Software is distributed WITHOUT ANY WARRANTY, without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 13. Severability. If any provision of this Agreement is held invalid, illegal or unenforceable, the validity, legality and enforceability of any of the remaining provisions of this Agreement shall not in any way be affected or impaired. 14. Entire Agreement. This Agreement is the entire agreement 2014 by Kony, Inc. All rights reserved 43 of 123

44 between you and Kony concerning the Software and all related documentation and supersedes any PRESS <ENTER> TO CONTINUE: other prior or contemporaneous agreements or communications with respect to the Software and related documentation, whether written or oral. This Agreement may not be modified except by a written addendum issued by a duly authorized representative of Kony. No provision hereof shall be deemed waived unless such waiver shall be in writing and signed by Kony or a duly authorized representative of Kony. Should you have any questions concerning this Agreement, or if you desire to contact Kony for any reason, please write to Kony, Inc., 7380 West Sand Lake Road, Suite 390, Orlando FL 32819, Attention: Legal Services. DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): Y 7. Press Y to accept the agreement. The Install Components option appears. ================================================================== ===== Install Components Please select Kony MobileFabric components to install. The Console is the administrative interface to manage your apps, environments and users. The Identity Service helps you to use a single gateway for all your authentication and authorization requests. The Integration Service helps you connect with any enterprise or third-party system to mobilize and orchestrate your data. In a development scenario, all components can be installed on the same 2014 by Kony, Inc. All rights reserved 44 of 123

45 box. However, it is recommended to install these components on separate boxes for production environment. ->1- Console ->2- Identity Service ->3- Integration Service ENTER A COMMA-SEPARATED LIST OF NUMBERS REPRESENTING THE DESIRED CHOICES, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:: Console - To install Kony MobileFabric Console, choose the Console option. The system creates the following databases: <prefix>mfconsole<suffix>, <prefix>mfaccounts<suffix>, and <prefix>mfreports<suffix>. Identity Service - To install Kony Identity Service, choose the Identity Service option. The system creates the following databases: <prefix>idglobal<suffix> and <prefix>idconfig<suffix>. Integration Service - To install Kony MobileFabric Integration, choose the Integration Service option. The system creates the following databases: <prefix>admin<suffix> and <prefix>mfreports<suffix>. Note: The reports database is used for configuring reports. While installing Kony MobileFabric, the system creates the reports database, <prefix>mfreports<suffix>, based on the following choices only: - If you choose Console, the system creates the reports database. For example, 1 - If you choose Console and Integration Service, the system creates the reports database. For example, 1, by Kony, Inc. All rights reserved 45 of 123

46 - If you choose all components (Console, Identity Service, and Integration Service), the system creates the reports database. For example, 1,2,3 Note: If you have a reports database, you can configure it in the Database Details option > Reports Database Name field. Refer to the Database Details option. Refer to creating a reports database, for example, <prefix>mfreports<suffix>. While installing Kony MobileFabric, the system displays the Reports Database Name field in the Database Details option, based on the following choices only: - If you choose Integration Service, the system displays the Reports Database Name field in the Database Details option. For example, 3 - If you choose Integration Service with Identity Service, the system displays the Reports Database Name field in the Database Details option. For example, 2,3 8. Press Enter to continue the installation. The Install Folder option appears. ================================================================== ===== Install Folder Please choose a destination folder for this installation. NOTE: The installation path should not contain any special characters by Kony, Inc. All rights reserved 46 of 123

47 Default Install Folder: /home/user1/konymobilefabric ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT : Note: By default, Kony MobileFabric is installed at the home directory of the user. 9. Press Enter to continue the installation. The Application Server option appears. It can be Tomcat or JBoss. Important: MobileFabric Installer supports Tomcat, JBoss, WebLogic, and WebSphere. MobileFabric Installer supports Tomcat on single node only. For multinode installation on Tomcat, refer to MobileFabric Manual Install Guide. MobileFabric Installer supports JBoss on single node (Standalone Mode) and multinode (Domain Mode). ================================================================== ============= Application Server Enter requested information ->1- Tomcat JBoss WebLogic 12c (12.1.3) 4- WebSphere ENTER THE NUMBER FOR YOUR CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT:: 2014 by Kony, Inc. All rights reserved 47 of 123