2o2wsi2t ‘manuel viewsr kony Kony MobileFabric™ Installation Guide - Linux On-Premises Release 6.5 Document Relevance and Accuracy Ts tctmentla fier jit i atau ston a fap in i rt yor att fs Revision History page. Remember to alvays view and download the latest document version relevantto the software release you are using. ©2014 by Kony, Inc. allrights reserved lof1lg ntips:[Link]/7483728/kony-mobilefabric-installe-quide?_cf_chl jschl tk_=2efS96a2tecb1726c49b055=90'9a72d05¢0183-16... 111182o2wsi2t ‘manual viewar Kony MobileFabric Installation Guide - Linux Copyright © 2014 by Kony, Inc. Allrights 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. Chromeis 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 document have been capitalized and are to be considered the property of their respective owners. ©2014 by Kony, Inc. All rights reserved 2o0f 118 hitps:[Link]!7493728ikory-mobileabric-instlle-quide?__cf_chl jschl k_=2ef596a2tec61725a46b65c6a30'%a72d054e183-16... 2/1182o2wsi2t ‘manual viewar Kony MobileFabric On-Premises Installation Guide —Linux Ver- 1.0 Revision History Date Document Version | Description of Modifications/Release 08/31/2015, 5.0 Updated for 6.5.2 hot fix. ‘Added support for WebSphere, 07/14/2015, 40 Document Release for 6.5 GA: + Added support for Oracle DB, + Added support for WebLogic + Added support for Kony Integration Sewice 03/30/2015 3.0 Document is updated for Release 6.0.3 02/19/2015 20 Document updated for 6.0.2 Release (Added Support for Apache Tomcat 7.0.52 and JDK 1.6) 01/22/2015 1.0 Document Release for Fall Wave Release 6.0 Copyright © 2014 Kony, Inc., Allrights reserved. Page 3of 118 hitps:[Link]!7493728ikory-mobileabric-instller-quide? {hl jsch =2e159682 1606 1725d46065e5830387240540183-16... 3/1182o2wsi2t ‘manual viewar Kony MobileFabric On-Premises Installation Guide —Linux Ver- 1.0 Table of Contents 1. Preface 7 4.1 Purpose .. ns . 8 1.2 Intended Audience 8 1.3 Formatting Conventions Used in This Guide eee B 1.4 Related Documents: 9 1.5 Contact Us 9 2. Prerequisites ..... 2.1 Software Requirements 10 2.2 Hardware Requirements " 2.3 Creating the Installation User for Linux. 12 3. MobileFabric Topology and Components 13 3.1 Developer Environment 7 3.2 Production Environment 18 4. Preinstallation Tasks .. 19 4.1 How to Configure Deployment of [Link] File for Multi-Node 20 4.2 How to Install Memeached Server ...... earcaaasseceamares cf stasismanncasuvaccaxes ZY 4.2.1 libevent (memcached dependency)... vesessseeeseseneeeee 21 4.2.2 Memeached Server 22 4.3 How to Increase JVM memory for WebLogic Server ...........2.2..... science 4.4 How to Place MS SQL Server Connector JAR in WebLogic Classpath 24 Copyright © 2014 Kony, Inc., All rights reserved. Page 4 of 118 hitps:[Link]!7493728ikory-mobileabricinstalle-quide? {hl jschl tk _=2ef596a2tec61726q46b65c6a30'3a72d054e183-16.... 4/118,2o2wsi2t ‘manual viewar Kony MobileFabric On-Premises Installation Guide —Linux Ver- 1.0 4.5 How to Deploy Metrics in Domain Mode for WebLogic of JBoss oo... 4.6 How to Configure Load Balancers for Sending Host information in Multinode .............28 4.7 How to Create Locator Component for Oracle Database .. 29 4.8 How to Configure Load balancer as Proxy in JBoss Multinode Setup (Optional if SSL Officading at Load Balancer) 34 5. Installing Kony MobileFabric ......... ect 32 5.1 Standalone Mode (Single Node) Installation 32 5.1.1 Logs for Single Node Installation ...... eeseesssesseesseseeees6B BAA For Tomeat ......-eeense 68 [Link] For JBoss 69 BA1.1.3 For WebLogic «.....eeecneeeeeneeeeees eevee 70 [Link] For WebSphere ....... 5.2 Domain Mode (Multinode) Installation 72 5.2.1 Logs for Multinode Installation ... [Link] For Tomeat 96 [Link] For JBoss 7 [Link] For WebLogic 98 [Link] For WebSphere 99 6. Uninstalling Kony MobileFabric 101 7. Post-nstallation Tasks 104 7.1 Configuring Secure Sockets Layer (SSL) Certificate ..... 104 7.1.1 How to Add an Installer Generated Selt-Signed SSL Certificate to Cacerts, 104 Copyright © 2014 Kony, Ine., All rights reserved. Page Sof 118 hitps:[Link]!7493728ikory-mobileabric-instller-quide? {hl jsch =2e159682 1606 1725446065e5880°387 240540 183-16,2o2wsi2t hitps:[Link]!7493728ikory-mobileabric-instller-quide? {hl jsch Kony MobileFabric On-Premises Installation Guide —Linux Ver- 1.0 7.1.2 How to Add an Existing SSL Certificate to Cacerts .... 2.105 7.2. JDK Version Compatibility .......--eecsessseee eevee 106 7.3 How to Switch between JDK Versions 108 7.4 How to Configure Memcached for Integration Servics 107 8. FAQs and Troubleshooting 109 8.1 Howto Configure Custom JAR File on Weblogic 112 8.2 How to Enable SSLv3 (SSLv2Hello) Protocol on Kony MobileF abric Products Running on JDK 1.6 113 8.2.1 How to Enable SSLv2Hello Protocol in the [Link] File for Single Node ....113, 8.2.2 How to Enable SSLv2Hello Protocol in the domain xml File for Multinode 114 8.3 WebSphere FAQS .....-sscccccscssseeseeeenssseneeeeeeennenneeee ceceeeeeennnneeeeed 15 8.4 How to Change Log Levels ....... 115 Copyright © 2014 Kony, Inc., Allrights reserved. Page 6 of 118 =2e159682 1606 1725446065e5830°387 240540 183-16 ome2o2wsi2t ‘manual viewar Kony MobileFabric Installation Guide - Linux 1. Preface Kony MobileFabricis a Mobile Back-end asa Service (MBaaS) provider that helps developers build native and web apps for mobile. MobileF abric allows you to define the back-end to build native mobile apps for iOS, Android, and HTMLS-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 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 MobileF abric 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 unti the loop ends or an exit criteria is met. ©214by Kony, nc. Allrights reserved 7ofs hitps:[Link]!7493728ikory-mobileabric-instlle-quide?__cf_¢hl jschl tk _=2ef596a2tec61725646b65c6a30'%a72d054e163-16.... 7/1182o2wsi2t ‘manual viewar Kony MobileFabric Installation Guide - Linux «Synchronization: This feature allows you to define the synchronization services for your application. Syne supports only Web Services, except SAP Sky. + Messaging: This feature allows you to define and configure push messaging services for your application. BP yt) This document explains how to install the Kony MobileFabric Console. Bee le) This documents intended for engineers or developers who are responsible for installing and configuring Kony MobileFabric, We assume that the reader of this documents 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 + Filenames ale + Emphasis + Names of books and documents + New terminology ©2014 by Kony, nc. Allrights reserved softs hitps:[Link]!7493728ikory-mobiletabric-installe-quide?__cf_¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e183-16... 8/1182o2wsi2t ‘manual viewar Dae uke LC emtg Convention Explanation Bold + Windows: + Menus + Buttons. + Fields + Tabs Rt Active link toa URL Provides helpful hints or additional information re | i. Important: Highlights actions or information that might cause problems to systems or i data 1.4 Related Documents Document Purpose Kony MobileFabric | This guide helps you understand how to create a Kony MobileFabric User Guide account, add services, and publish apps. 1.5 Contact Us We welcome your feedback on our documentation. Email us at techpubs@[Link]. For technical questions, suggestions, and comments or to report problems on Kony's product line, contact productsupport@[Link]. ©2014 by Kony, Inc. allrights reserved 9of 118 hitps:[Link]!7493728ikory-mobiletabric-installe-quide?__cf_¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d0540163-16... 9/1182o2wsi2t ‘manual viewar 2. Prerequisites Dae uke LC emtg 2. Prerequisites The following sections provide information about the software and hardware required to install Kony MobileFabric Console. PCIe) irements Purpose Software Requirement Kony [Link] MobileFabric installer Database MysaLs.6 Server *Databaseis | Oracle 12:.0(121.0) sharedacross | Ms Sai Server2012R2 instances, | 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. Forexample: Toincrease MySQL database connection limit, execute the following ‘command: ‘SET global max_connections = 350; "Note: Ensure that a database user should be granted all privileges ike create update, and delete database schema, views, jobs, and manage schedulers. ©2014by Kony, Inc. Allrights reserved loof 118 hitps:[Link]!7493728ikory-mobileabric-instlle-quide?__cf_¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e183-1.. 10/1182o2wsi2t ‘manual viewar Dae uke LC emtg Purpose Software Requirement SSLcettificate | Touse your existing SSL certificate, map the SSL certificate to the domain name you want to use. Application + Apache Tomeat 7.0.52 Server Stack + 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 forall on-premises products. Kony supports Oracle JDK 1.7.71 orhigher for WebLogic. + WebLogic 12.1.3 (12.1.3) + WebSphere [Link] Hardware Requirements ‘Component Requirement Processor Quad-core processor Memory 16GB Internal Storage | 008 Network 4100 Mbps Ethemet interface card Operating System Red Hat Enterprise Linux 6.0, ©214by Kony, nc. Allrights reserved nofs hitps:[Link]!7493728ikory-mobiletabricinstlle-quide?__c_chl jschl k_=2ef596a2tec61725e46b65c6a30'Ga72d054e163-1.. 11/1182o2wsi2t ‘manuel viewsr 2. Prerequisites Dae uke LC emtg 2.3 Creating the Installation User for Linux To create a user, follow these steps: 1. From your MobileFabric install system, open Linux terminal SS install and run Kony MobileFabric Installer 2. Run the following commands: ©2014 by Kony, Inc. allrights reserved 120f 18 nips: [Link]/7483728/kony-mobilefabric-insalle-quide?__cf_chl jschl tk_=2efS96a2tecb1726c40b055=90'9a72d05¢0189-1... 12/1182o2wsi2t ‘manual viewar Seng arene Deed Fe eae ake ang 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. ©2014 by Kony, Inc. allrights reserved 130f 18 hitps:[Link]!7493728ikory-mobiletabric-installe-quide?___chl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e163-1.. 13/1182o2wsi2t ‘manual viewar Seng arene Deed Fe eae ake ang An overview of the MobileFabric architecture and components follows: Topology ©2014 by Kony, nc. Allrights reserved Moh 118 hitps:[Link]!7493728ikory-mobiletabric-instlle-quide?_f_¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e163-1.. 14/1182o2wsi2t ‘manual viewar Seng arene Deed Fe eae ake ang An overview of the MobileFabric deployment architecture follows: Architecture fieetas Pree ie ena Identity Manager 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. ©214by Kony, nc. Allrights reserved Isof 118 hitps:[Link]!7493728ikory-mobileabric-instlle-quide?__cf_chl jschl k_=2ef596a2tec61725646b65c6a30°%a72d054e163-1.. 15/1182o2wsi2t ‘manual viewar Deeg name eet Fe eae ake ang 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 Workspace configures MBaaS services (applications, identity, integration, (Weas) orchestration, synchronization, and messaging). After these services are configured, these services must be published o respective clouds/environments so that the services are available for runtime use. Console/Portal ‘The console/portalis the user interface for configuring services for an application. ‘This component adds runtime capabilites 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 end 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 hitp://[Link]/konylibrary/integration/kony mobilefabric_integration_service_admin_console_user_quide/Default,ntm 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 tothe device in the JSON format. ©214by Kony, nc. Allrights reserved 16of 18, hitps:[Link]!7493728ikory-mobileabric-instlle-quide?__cf_chl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e163-1.. 16/1182o2wsi2t ‘manual viewar Seng arene Deed Fe eae ake ang Convention Description Services Services component is used only when MobileFabric is integrated. It has same runtime capabilities as the middleware. Note: Touse Kony Severwith MobileFabric integrated, you can ignore the [Link]. Similarly when you use only standalone Kony ‘Server, you can ignore the services. war For more details, refer to hitp://[Link]/konylibrary/[Link]! ‘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 © 2014by Kony, Inc. All rights reserved of lle hitps:[Link]!7493728ikory-mobileabric-instlle-quide?__chl jschl k_=2ef596a2tec61725e46be5c6a30'%a72d054e183-1.. 17/1182o2wsi2t ‘manual viewar Seng arene Deed Fe eae ake ang ‘ony MobileFabric Consolidated installer supports JBoss on single node (Standalone Mode) and uti-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 memeached server, follow manual steps provided at How to Install Memcached Server. Ra leg For production environment, domain mode (multinode) installation with HTTPs protocol is preferred Multinods installation helps to enable better performancs, high availabilty, and load balancing. For more details, refer to Multinode installation © 2014by Kony, Inc. All rights reserved Iwof 118 hitps:[Link]!7493728ikory-mobiletabric-instlle-quide?__f_¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e163-1.. 18/1182o2wsi2t ‘manual viewar Od 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 multinode mode. + Download KonyMobileFabricSetup. tar. yz file (for release 6.5 GA) from [Link] [Link]/downloads and extract the file. To download Kony MobileFabric. installer from the community portal, follow these steps: 1. Log in to hitp://community. [Link]/downloads. 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. Selectthe 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 Keni Mobilefabric [Link]) GA, click the Kony v6.5 GA tab, select the 615) 3 GA version from the drop-down lst, and then click the Download button. ©2014 by Kony, nc. Allrights teserved W0f 118 hitps:[Link]!7493728ikory-mobiletabric-instlle-quide?__cf_chl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e163-1.. 19/1182o2wsi2t Od Dae uke LC emtg 1D community Kony/com/aounlon Downloads Kony MobileFabric Forolserverions click here The [Link]. a7 file contains the following files: ® KonyMobileFabricInstaller [Link] = [Link] ies - Thisfile is required for silent installation. ® [Link] Ma ROR CBee mre OR Let) ‘Once MobileFabric installation succeeds, the MobileFabric Console will not be displayed as the enable-welcome-root value is set true inthe domain. xm! file, To configure [Link], follow these steps: ©214by Kony, nc. Allrights reserved 2of118 hitps:[Link]!7483728ikory-mobiletabric-installe-quide?_f_chl jschl tk _=2ef596a21ec61725a46b65c6a30'%a72d0540183-1 2oitts2o2wsi2t ‘manual viewar Od Kony MobileFabric Installation Guide - Linux 1. Inthe master node, open the comain. xm! file from JBOSSDIR/domain/contiguration, and search for enable-welcome-root="true." 2. Replace enable-welcome-root="true" with enable-welcome-root="false.” OAM CMe Lag 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. POG eT) The libevent API provides a mechanism to execute a callback function when a specific event occurs ona file descriptor or after a timeout has been reached. Furthermore, libevent also support callbacks due to signals or regular timeouts. ibevent. ismeantto 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 hitp:/[Link]/ To install libevent (memcached dependency), follow these steps: 1. First, check whether 1 ibevent is installed on your computer. To check, type the below ‘command in your Linux terminal: weezeis/ Tibevene 2. Ifyoudo notfind 1 ibevent on your system, download and install it. Download 1ibevent - 1.4, 8-stable. tar. gz, Referto httpi/[Link]/ ©214by Kony, nc. Allrights reserved 210f 118 hitps:[Link]!7493728ikory-mobiletabricinstlle-quide?___chl jschl k_=2ef596a2tec61725e46b65c6a30'%a72d054e163-1.. 21/1182o2wsi2t Od Dae uke LC emtg 3. 4. Extract the libevent-1.4.8-stable, In your Linux terminal, type the below command: Ga libevent-1. 4. 8-etable - /configure make make install ‘Type the below command to create a symlink to libevent In -s /usr/local/lib/libevent-1.4.s0.2 /ust/1ib Now that you have installled the dependencies, install the memcahced server. 2. Memcached Server To install Memcached Server, follow these steps: 1 2 Download the memcached server. Extract the zip file. Open the Linux terminal Goto... /memcache directory. Run the following command: tar xfz [Link] ed memeached-1.2.6 ©214by Kony, nc. Allrights reserved 20118 hitps:[Link]!7493728ikory-mobiletabric-installe-quide?__cf_chl jschl k_=2ef596a21ec61725a46b65c6a30'%a72d0540183-1 zits2o2wsi2t ‘manual viewar Od Dae uke LC emtg -/configure make make install memcached -d -m 1024 -u root -1 [Link] -p 11211 Important: Run Memcached as a daemon (d= daemon, m= memory, u= user, |= IP to listen to, p= port) 4.3 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. Goto"sDOMAIN HOME %\bin\"folder, open the set [Link] file. 2. Inthe set DomainEnv. 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 - Xrmx512m. 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 © 2014by Kony, Inc. All rights reserved Bo 118 hitps:[Link]!7493728ikory-mobiletabric-installe-quide?__f_¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e183-1.. 23/1182o2wsi2t ‘manual viewar Od Kony MobileFabric Installation Guide - Linux 3. Savethe setDomainEny. cmd file. 4. Execute the command set [Link]. 5, Start Weblogic server. 4.4 How to Place MS SQL Server Connector JAR in WebLogic Classpath If you wantto install MS SQL Server Database with WebLogic, then you need to manually place the sqljdbc4. jar fileinthe WebLogic classpath, Important: To add the 71 jdbc4.. jax 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 sql jdbe4. jar inthe /server/1ib folder. 2. Editthe [Link]/sh scriptin the /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_ HOMES\1ib\tools.j CONTRIBS\1ib\ant-contrib. jar;%CAM_NODEMANAGER_JAR_PATHS PROFIL CLASSPATHS; SANT_ 4. Restart the server. Cea ROR yA Cie EMC m es Bm mes llekel me ole y In App Services console, Healthcheck for access to reporting queue fails for WebLogic and JBoss. cluster. ©2014 by Kony, nc. Allrights reserved of 18 hitps:[Link]!7493728ikory-mobileabric-instlle-quide?__c_¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e163-1.. 24/1182o2wsi2t manual viewer Od Dae uke LC emtg + For WebLogic: While installing WebLogic cluster, user should select both admin server and cluster options. + For JBoss, To deploy metries in domain mode, follow the: a. Create Application User: To create an application user, goto ni folder and run the acid. file, shown below: y Kony, Ine. all rights hitps:[Link]!7499728ikony-mobileabric-installr-quide?__cf_chl jachl = ef596a2 90617 2604sv6SeHaI0Ka72d054e109-1... 25/1182o2wsi2t ‘manual viewar Od Kony MobileFabric Installation Guide - Linux b. Inthe Queues/Topics tab, create JMS topic, shown below: ieee PA c. Inthe Security Settings tab, create a role for jms, shown below. q © 2014by Kony, Inc. All rights reserved 260f 118 hitps:[Link]!7493728ikory-mobiletabric-instlle-quide?_c_chl jschl tk _=2ef596a2tec61725a46b65c6a30'%a72d054e183-1.. 26/1182o2wsi2t Od Dae uke LC emtg a. Inthe Connection Factories tab, create connection factory, shown below: Verify the configuration to access admin health check. The system should show all pass including Access to Reporting Queue mainly. Settings Console Users Configuration Health check Item ‘Status ‘Acces to Repots DB PASSED Access to Adnin DB PASSED Access to Cache PASSED ISTE You have successfully configured the metrics. 2014 by Kony, Inc. Allrights reserved wofi8 hitps:[Link]!7483728ikory-mobileabric-installe-quide?__cf_chl jschl tk _=2ef596a2tec61725646b65c6a30'%a72d054e183-1 aris2o2wsi2t ‘manual viewar Od Kony MobileFabric Installation Guide - Linux {. Inthe Global Modules, add the required modules, shown below: EE Subsystem eleadShrnyne See 4.6 How to Configure Load Balancers for Sending Host Information in Letter) When users installing MobileFabric on multinode environment, the user should check whether the parameter: proxypreserveliost is setto Oi in the Loadbalancer configuration file to send host in the headers. Ifthe proxypreserveHostis 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 © 2014by Kony, Inc. All rights reserved 2Bof 118 hitps:[Link]!7493728ikory-mobileabric-instlle-quide?__cf_¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e163-1.. 28/1182o2wsi2t ‘manual viewar Od Kony MobileFabric Installation Guide - Linux CMa ROMO a meee ee (melt le BBL le-t iy 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. Ifthe 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 ‘SMEDIA'; (comp_name) 1il Select username from dba_users where username = ‘MDSYS' Ifthe 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. ©214by Kony, nc. Allrights reserved 20f 118 hitps:[Link]!7493728ikory-mobiletabric-instlle-quide?___¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e183-1... 29/1182o2wsi2t ‘manual viewar Od Dae uke LC emtg i. Connectas SYSDBA sqlplus "/as sysdba" ji. 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 ii, 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 thatis used during MDSYS user creation. v. Run the below SQL to create the locator objects: SQL>@?/md/admin/catmdloc. sql Allthe above . sq] files executed will be available as part of database software iid folder. (Once the Oracle locator is installed, run the Installer to setup MobileFabric. The system should notthrow the error: Invalid Data Type SDO_GEOMENTRY ©2014 by Kony, nc. Allrights reserved aoof 118 hitps:[Link]!7493728ikory-mobiletabric-instlle-quide?___¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e183-1.. 30/1182o2wsi2t ‘manuel viewsr Od Dae uke LC emtg 4.8 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 coma in . m1 file 2. Inthe coma in. xm, update all the HEED GSAHESESE EAGS to include the scheme and proxy-port details. For example, socket-binding="http" proxy-port: ©2014 by Kony, Inc. allrights reserved sof 118 nips: [Link]/7483728/kony-mobilefabric-insalle-quide?_cf chi jschl tk_=2efS96a2tecb1726c40b055=90'9a72005¢0189-1... 31/1182o2wsi2t ‘manual viewar Pe og es ozs Dae uke LC emtg 5. Installing Kony MobileFabric Note: Ifa 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 Pre Make sure you have proper administrative rights to install Kony MobileFabric on your computer. Youalso need a user where Kony MobileFabric will be installed. The directory contains the log files documenting each invocation ofthe installer. To make problem identification easier, provide these log files to Kony when reporting an issue. Boma Me) Cele murs Mole l (a ere BUC To install Kony MobileFabric Console using the installer, follow these steps: 1. Execute the following command to switch to the user that you created, # Sa > username 2. Press Enter. You will be prompted to enter the password, 3. Enter the password, and press Enter. 4. Unzip the KonyMobileFabricsetup. [Link] file, and navigate to the folder KonyMobileFabric_Installer_Linux. 5. Start the /[Link] file by executing the following command: © 2014by Kony, Inc. All rights reserved a20f 118 hitps:[Link]!7493728ikory-mobiletabric-instlle-quide?___chl jschl k_=2ef596a2tec61725e46b65c6a30'Ga72d054e163-1.. 32/1182o2wsi2t ‘manual viewar Ce hendeclogad Fe eae ker 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 12 (12.1.0) and MS SOL 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 12¢ by Kony, Inc. Allrights reserved Bof 118 hitps:[Link]!7493728ikory-mobileabric-instlle-quide?__cf_¢hl jschl k_=2ef596a2tec61725646b65c6a30'Ga72d054e163-1.. 33/1182o2wsi2t ‘manual viewar Se ona gi Dae uke LC emtg (12.1.3) or WebSphere [Link] 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: //[Link]/konyonpremises/#[Link]. For getting started on Kony MobileFabric, refer /docs. [Link]/Konyonpremises/#welcome_mobilefabric.ntm. Tf you have more questions or feedback, you can join our /[Link]/ or, raise a [Link] ->1- Continue with Installation. Abort Installation. ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS TO ACCEPT ‘THE DEFAULT: 6. [Link] 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 by Kony, Inc. Allrights reserved 34of 118 hitps:[Link]!7483728ikory-mobiletabric-instlle-quide?__¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e163-1.. 34/1182o2wsi2t ‘manual viewar Se ona gi Dae uke LC emtg Neen) 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, non- transferable license to use, for developmental purposes only, the Kony software program(s), PRESS 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 by Kony, Inc. Allrights reserved 350f 118 hitps:[Link]!7483728ikory-mobiletabric-installe-quide?_f_chl jschl tk _=2ef596a21ec61725a46b65c6a30'%a72d0540183-1 35/1182o2wsi2t ‘manual viewar Ce hendeclogad Fe eae ker 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 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 by Kony, Inc. Allrights reserved 360f 118 hitps:[Link]!7493728ikory-mobiletabric-instlle-quide?__c_¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e163-1.. 36/1182o2wsi2t ‘manual viewar Ce hendeclogad Fe eae ker 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 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. Allrights reserved a7 of 118 hitps:[Link]!7493728ikory-mobileabric-instlle-quide?___chl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e163-1.. 37/1182o2wsi2t ‘manual viewar Se ona gi Dae uke LC emtg Neen) 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 SOETWARE 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 RY LAW, IN NO EVENT SHALL KONY BE LIABLE FOR PERSONAL INJURY, OR ANY INCIDENTAL, SPECIAL, INDIRECT PRESS 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 by Kony, Inc. Allrights reserved 38 of 118 hitps:[Link]!7493728ikory-mobiletabric-installe-quide?__f_¢hl jschl k_=2ef596a2tec61725646b65c6a30'%a72d054e183-1.. 38/118