Kony MobileFabric Reporting and Analytics Installation Guide On-Premises Release 7.3 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. 2017 by Kony, Inc. All rights reserved 1 of 39
Kony Analytics and Reporting Installation Guide Copyright 2015 by Kony, Inc. All rights reserved. April, 2017 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 Nitro, and Kony Visualizer are trademarks of Kony, Inc. MobileFabric is a registered trademark of Kony, Inc. Microsoft, the Microsoft logo, Internet Explorer, Windows, and Windows Vista are registered trademarks of Microsoft Corporation. Apple, the Apple logo, itunes, iphone, ipad, OS X, Objective-C, Safari, Apple Pay, Apple Watch, and Xcode are trademarks or registered trademarks of Apple, Inc. Google, the Google logo, Android, and the Android logo are registered trademarks of Google, Inc. Chrome is a trademark of Google, Inc. BlackBerry, PlayBook, Research in Motion, and RIM are registered trademarks of BlackBerry. SAP and SAP Business Suite are registered trademarks of SAP SE in Germany and in several other countries. All other terms, trademarks, or service marks mentioned in this document have been capitalized and are to be considered the property of their respective owners. 2017 by Kony, Inc. All rights reserved 2 of 39
Kony Analytics and Reporting Installation Guide Revision History Date Document Version Description of Modifications/Release 04/10/2017 1.4 Document updated for 7.3 GA 10/24/2016 1.3 Document updated for 7.2 GA 08/22/2016 1.2 Document updated for Kony MobileFabric 7.1 GA 02/29/2016 1.0 Document updated for Kony MobileFabric Release 7.0 GA 2017 by Kony, Inc. All rights reserved 3 of 39
Kony Analytics and Reporting Installation Guide Table of Contents 1. Preface 5 1.1 Purpose 5 1.2 Intended Audience 5 1.3 Formatting Conventions in This Guide 6 1.4 Contact Us 7 2. Prerequisites 8 2.1 Software Requirements 8 2.2 Supported Databases and Drivers 10 2.3 Hardware Requirements 10 2.4 Reports Database 11 3. How to Set Up the JasperReports Server 13 4. How to Upgrade Jasper Reports Server 18 5. Post-Installation Tasks 24 5.1 How to Download and Import a Package into the JasperReports Server 24 5.2 How to Set Up JNDI Data Sources 26 5.3 How to Start or Stop JasperReports Server 31 5.4 How to Run Reports 33 6. How to Configure MobileFabric in the JasperReports Server 37 2017 by Kony, Inc. All rights reserved 4 of 39
1. Preface Kony Analytics and Reporting Installation Guide 1. Preface Kony MobileFabric captures a set of standard metrics and provides a set of APIs for capturing custom metrics and events. This data is processed and stored in a relational data model that can be analyzed by any business intelligence (BI) or reporting engine. Kony provides a set of standard reports for TIBCO Software s Jaspersoft BI server that can help you analyze and report on this data, and even design your own custom reports. The results of these reports can be viewed in various chart types or exported to PDF, Excel, or a comma separated value (CSV) file. For successful configuration with reports database, and to access data sources of MobileFabric, Kony recommends that you follow the below order to install MobileFabric features for on-premises: 1. Install all components such as, Kony MobileFabric Console, Kony MobileFabric Identity, and Kony Integration Service. For more details, refer to Kony MobileFabric Installation Guide. 2. Install Kony Analytics and Reporting. For more details, refer to the sections in the current guide (Kony Analytics and Reporting Installation Guide). Note: Kony Products support only Jasper Professional or Jasper Enterprise edition and not the community edition. 1.1 Purpose The document explains how to install and set up JasperReports Server 6.0 or 6.2 that runs out-of-thebox reports for Kony Server 7.3 for on-premise customers. 1.2 Intended Audience This document is intended for engineers or developers who are responsible for installing and configuring JasperReports Server. We assume that the reader of this document is familiar with installing applications in Windows and Linux environments. 2017 by Kony, Inc. All rights reserved 5 of 39
1. Preface Kony Analytics and Reporting Installation Guide 1.3 Formatting Conventions 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 Bold Windows Menus Buttons Icons Fields Tabs URL Active link to a URL Note: Provides helpful hints or additional information 2017 by Kony, Inc. All rights reserved 6 of 39
1. Preface Kony Analytics and Reporting Installation Guide Convention Explanation Important: Highlights actions or information that might cause problems to systems or data 1.4 Contact Us We welcome your feedback on our documentation. Email us at techpubs@kony.com. For technical questions, suggestions and comments, or to report problems on Kony's product line, contact support@kony.com. 2017 by Kony, Inc. All rights reserved 7 of 39
2. Prerequisites Kony Analytics and Reporting Installation Guide 2. Prerequisites The following sections explain the software and hardware required to install JasperReports Server. 2.1 Software Requirements Purpose Software Requirement Installer Windows: jasperreports-server- 6.0-windows-x64- Note: Kony Products support only Jasper Professional or Jasper Enterprise edition and not the community edition. installer.exe jasperreports-server- 6.2-windows-x64- installer.exe Linux: jasperreports-server- 6.0-linux-x64- installer.run jasperreports-server- 6.2-linux-x64- installer.run JasperSoft License Jasperserver.license file Important: Ensure that you have downloaded TIBCO JasperReports Server version 6.0.0 or 6.2.0, and installed it before configuring user attributes in How to Set Up the JasperReports 2017 by Kony, Inc. All rights reserved 8 of 39
2. Prerequisites Kony Analytics and Reporting Installation Guide Server. The license key for JasperSoft on-premises is provided by Kony as part of the software subscription license for Kony MobileFabric Analytics Server. For JasperReports Server Distributions, refer to Note: For JasperReports Server Installation Documentation, refer to https://community.jaspersoft.com/documentation/jasperreports-server-installguide/v561/introduction. http://community.jaspersoft.com/documentation/tibco-jasperreports-server-installationguide/v60/introduction http://community.jaspersoft.com/documentation/tibco-jasperreports-server-installationguide/v62/introduction https://community.jaspersoft.com/documentation/jasperreports-server-installguide/v561/jasperreports-server-distributions. http://community.jaspersoft.com/documentation/tibco-jasperreports-server-installationguide/v60/jasperreports-server-distributions http://community.jaspersoft.com/documentation/tibco-jasperreports-server-installationguide/v62/jasperreports-server-distributions 2017 by Kony, Inc. All rights reserved 9 of 39
2. Prerequisites Kony Analytics and Reporting Installation Guide 2.2 Supported Databases and Drivers Database Version Database Connectivity Drivers MySQL 5.6.X mysql-connector-java-5.1.33-bin.jar Click the below link to download the.jar: http://dev.mysql.com/downloads/connector/j/5.0.html Microsoft SQL Server 2012, 2014 sqljdbc4.jar Click the below link to download the.jar: https://msdn.microsoft.com/en-us/sqlserver/aa937724.aspx Oracle 11g, 12c ojdbc7.jar Click the below link to download the.jar: http://www.oracle.com/technetwork/database/features/jdbc/jdbcdrivers-12c-download-1958347.html IBM - DB2 10.1 db2jcc4.jar Click the below link to download the.jar: http://www-01.ibm.com/support/docview.wss?uid=swg21363866 2.3 Hardware Requirements Supported OS Resource Footprint Minimum Recommended Windows Disk 600 MB 10 GB free 40 GB+ - Windows 2008 RAM 512 MB 1 GB + - Windows 7 Processor 1 GHz (single 1.5 GHz + (multi- - Windows 8 Pentium) core Pentium) 2017 by Kony, Inc. All rights reserved 10 of 39
2. Prerequisites Kony Analytics and Reporting Installation Guide Supported OS Resource Footprint Minimum Recommended Linux Disk 600 MB 10 GB free 40 GB+ - Red Hat Enterprise Linux 5, 6 RAM 512 MB 1 GB + - Novell SUSE Linux Enterprise 10, 11 - Debian 6 Processor 1 GHz (single Pentium) 1.5 GHz + (multicore Pentium) - Ubuntu 10 2.4 Reports Database While installing Kony MobileFabric, the system creates the reports database, <prefix>mfreports<suffix>, based on the following choices only: If you select Console check box, the system creates the reports database. If you select Console and Integration Service check boxes, the system creates the reports database. If you select all (components: Console, Identity Service, and Integration Service) check boxes, the system creates the reports database. For more details, refer to Kony MobileFabric_Installer_Guide > Installing Kony MobileFabric > Install Components window. Note: In the Installing Kony MobileFabric page, scroll down to the Install Components window. A reports database is created in the MobileFabric Installation > Pre-Installation Summary window, shown below: 2017 by Kony, Inc. All rights reserved 11 of 39
2. Prerequisites Kony Analytics and Reporting Installation Guide 2017 by Kony, Inc. All rights reserved 12 of 39
3. How to Set Up the JasperReports Server Kony Analytics and Reporting Installation Guide 3. How to Set Up the JasperReports Server After JasperReports Server is installed, attributes such as timezone, location, and account information must be configured for the logged-in user. The Jasper reports internally use the attributes to give accurate results for account and location. Important: Ensure that you have the required hardware and access to the supporting software as provided in the Prerequisites section. To set up the JasperReports Server, follow these steps: 1. Once the JasperReports Server is installed, the Install Complete window appears with the confirmation message. Select the Launch check box to launch the JasperReports Server. The Welcome to Jaspersoft page appears. Note: To remember the URL of this portal, shown in the image below, bookmark the URL by adding it to your favorites. 2017 by Kony, Inc. All rights reserved 13 of 39
3. How to Set Up the JasperReports Server Kony Analytics and Reporting Installation Guide 2. Provide your default log-in credentials (username as superuser and password as superuser), and then click Login. The Getting Started page appears. 3. On the Manage menu, click Users. Note: You need to edit superuser attributes only if reports are going to be run outside of the MobileFabric Console's context for users of MobileFabric 6.5 and above. For most users of MobileFabric 6.5 and above, reports can be directly accessed from MobileFabric Console after following the setup steps as mentioned in the Post-Installation Tasks and How to Configure MobileFabric in the JasperReports Server sections to finish the post-installation tasks and configuring MobileFabric Console to communicate with JasperReports Server. 2017 by Kony, Inc. All rights reserved 14 of 39
3. How to Set Up the JasperReports Server Kony Analytics and Reporting Installation Guide 4. From the Users list, click superuser, and then click Edit to continue. 5. In the Attributes tab, click the Add button to add a row for the attribute. 6. Add the following details: 2017 by Kony, Inc. All rights reserved 15 of 39
3. How to Set Up the JasperReports Server Kony Analytics and Reporting Installation Guide Attribute Name Attribut Value kaid - Kony Account ID. This value needs to match the Account Id generated by Kony MobileFabric Installer. Example: 100000002 The value of Account ID field generated for MobileFabric Server can be viewed from the Settings page in Appservices. The Settings URL format is as follows: http://<mfconsoleip:port>/admin/console/config/config uration.html Note: For MobileFabri c 6.5, the default kaid value is always 100000 002. tz_display_name - The timezone display name attribute appears on all reports as a footer indicating the timezone in which a report was generated. It is generally set to the Country/City Example: America/N ew_york tz_offset - The timezone offset attribute indicates the offset in minutes from UTC time. Date calculations are adjusted according to this attribute while running reports to ensure that time is based on a user's timezone. Example: - 300 The offset contains sign (+ or -) with minutes to indicate if it is behind or ahead of UTC. For example: UTC - 5:00 for New York City would be set as -300 minutes varies for Japan which is at UTC + 9:00 would be set as 540 minutes. 7. Click Save to save the new attributes. Note: To change the default password of a user, you can change the password from the edit section of the user as well (optional). 8. Re-login to JasperReports portal with the user to test the reports. 2017 by Kony, Inc. All rights reserved 16 of 39
3. How to Set Up the JasperReports Server Kony Analytics and Reporting Installation Guide 9. To modify attributes of a user, repeat Step 1 through Step 7 in this procedure. After modifying attributes, re-login to JasperReports portal. 2017 by Kony, Inc. All rights reserved 17 of 39
4. How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation Guide 4. How to Upgrade Jasper Reports Server This section explains how to upgrade Jasper Reports Server from V 5.6 or 6.0 to V 6.2. Note: The following are common steps for upgrading Jasper Reports Server from V 5.6 to V 6.2 or V 6.0 to V 6.2. To Upgrade JasperReports Server, follow these steps: 1. Back up your JRS War file, as follows: a. Create a folder where you can save your jasperserver-pro.war file. For example, C:\JS_60_BACKUP or /opt/js_60_backup. a. Copy the <tomcat>/webapps/jasperserver-pro to <path>/js_60_backup. 2. Back up your JasperServer Database. a. Create a folder where you can save your JasperServer database. For example, C:\JS_ 60_BACKUP or /opt/js_60_backup. b. Run the following commands for PostgreSQL. i. cd <path>/js_60_backup ii. <jrs-server-home>/postgresql/bin/pg_dump.exe --host=<host> --port=<port> --username=<username> jasperserver > js-db- 6.06.2-dump.sql 3. Export the current Repository Data, as follows: 2017 by Kony, Inc. All rights reserved 18 of 39
4. How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation Guide Command for Windows i. cd <js-install-6.0>/buildomatic ii. js-export.bat --everything --output-zip js-export-6.0.zip Command for Linux. i. cd <js-install-6.0>/buildomatic ii. js-export.sh --everything --output-zip js-export- 6.0.zip 4. Download the JRS 6.2 WAR file from http://support.jaspersoft.com. 5. Extract all files from the jasperreports-server-6.2-bin.zip to a the local system - for example, <js-install-6.2>(c:\jaspersoft on Windows, /home/<user> on Linux) Important: If the system displays the error The filename or extension is too long, change the parent folder name to a smaller one. 6. Configure the buildomatic for your Database and Application Server, as follows: a. Copy the postgresql_master.properties configuration file located in <jsinstall-6.2>/buildomatic/sample_conf/postgresql_ master.properties b. Paste the postgresql_master.properties file to <js-install- 6.2>/buildomatic. 2017 by Kony, Inc. All rights reserved 19 of 39
4. How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation Guide c. Rename the postgresql_master.properties to default_ master.properties. For example, From <js-install-6.2>/buildomatic/postgresql_master.properties to <js-install-6.2>/buildomatic/default_master.properties. d. Edit the default_master.properties with your database and application server details. appserverdir=<your Tomcat Server location where you have deployed JasperServer> dbusername=postgres dbpassword=postgres dbhost=localhost dbport=<port of the database server/postgresql> 7. Upgrade to JasperReports Server 6.2 a. Stop your application server (Tomcat Server) b. Start your database server (Postgres Server) c. Run the following command: Command to run in Windows cd <js-install-6.2>/buildomatic js-upgrade-newdb.bat <path>\js-export-6.0.zip 2017 by Kony, Inc. All rights reserved 20 of 39
4. How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation Guide Command to run in Linux $ cd <js-install-6.2>/buildomatic $./js-upgrade-newdb.sh <path>/js-export-6.0.zip Output Log Location: The output logs are available at <js-install- 6.2>/buildomatic/logs/js-upgrade-<date>-<number>.log 8. Start and Log into JasperReports Server 6.2. a. Start your application server(tomcat server). b. Clear your browsing cache. c. Log in to the JasperReports Server. You can view the JasperServer version upgraded to V6.2. To check the upgraded version of the Jasper Reports Server, click the link specified in the footer immediately after the upgrade. The About TIBCO JasperReports Server dialog appears with upgraded details, shown below: 2017 by Kony, Inc. All rights reserved 21 of 39
4. How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation Guide 9. Perform the Post-Installation tasks as specified in the Post-Installation Tasks. 10. Clear the application server's Work and Temp folder. a. Go to <tomcat>/work folder and delete all the files and folders in that directory. b. Go to <tomcat>/temp folder and delete all the files and folders in that directory. 11. Clear the Repository Cache Database table. 2017 by Kony, Inc. All rights reserved 22 of 39
4. How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation Guide a. Run the following commands in the JasperServer's PostgreSQL DB with postgres user. i. update JIRepositoryCache set item_reference = null; ii. delete from JIRepositoryCache; Now your JasperServer is upgraded to V 6.2, and all the analytics information from the previous version is available in the upgraded version. 2017 by Kony, Inc. All rights reserved 23 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide 5. Post-Installation Tasks After you install the JasperReports Server, follow these steps to view the out-of-box reports generated with data for Kony Server 6.0.x: How to Download and Import a Package to JasperReports Server How to Set Up JNDI Data Sources How to Start or Stop JasperReports Server How to Run Reports 5.1 How to Download and Import a Package into the JasperReports Server To generate reports, the package.zip files must be downloaded and imported into the JasperReports Server. A package (.zip) contains the Jasper Reports source code for respective databases, such as MySQL, Oracle, MSSQL, and DB2. 5.1.1 How to Download Package Files Currently Kony supports JasperReports Server 6.0 and 6.2. Download the following appropriate package for your JasperReports Server. To download a package, follow these steps: 1. Log in to http://community.kony.com/downloads/manual. You can obtain a user name and password from your sales representative or partner. 2. Click the Kony MobileFabric tab. 2017 by Kony, Inc. All rights reserved 24 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide 3. From the Kony Metrics-Jasper Reports list, select the specific release and then click Download. The jasper-reports zip is downloaded to you local system For example, if you want to download Kony Metrics-Jasper Reports 7.0.1, click the Kony MobileFabric > tab, select the 7.0.1 version from the Kony Metrics-Jasper Reports drop-down list, and then click the Download button. The jasper-reports zip is downloaded to you local system. 4. Extract the downloaded zip files. The jasper-reports zip folder contains supported database repositories (for MySQL, Oracle, MS SQL, and DB2) for JasperReports Server 6.0 or JasperReports Server 6.2. 5.1.2 How to Run Database Scripts to Import Packages To import a package to the JasperReports Server, follow these steps: Important: Ensure that the user must have read/write execute permissions to the JasperReports Server install folder. 5.1.2.1 Windows 1. In the Jasper installed system, open the Windows command prompt. 2. Go to the <path of the extracted package> of the required database. 3. Run the kony_imports.bat script followed by the JasperServer location as the input. konyreports_import.bat <jasperinstall-dir> C:/Jaspersoft/jasperreports-server-<6.0> or <6.2.0> 2017 by Kony, Inc. All rights reserved 25 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide 5.1.2.2 Linux 1. Open the Linux terminal. 2. Go to the <path of the extracted package> of the required database. 3. Run the konyreports_import.sh script followed by the JasperServer location as the input. konyreports_import.sh <jasperinstall-dir> /usr/jaspersoft 5.2 How to Set Up JNDI Data Sources The Java Naming and Directory Interface (JNDI) configuration allows the JasperReports Server connectivity to appropriate databases using JDBC drivers. To run reports, the JNDI configuration is required. To set up the Jasper data sources, follow these steps: 1. From your Jasper install location, open the context.xml file. For example, \Jaspersoft\jasperreports-server-<6.0 or 6.2.0>\apache-tomcat\webapps\jasperserver-pro\META- INF\context.xml. 2017 by Kony, Inc. All rights reserved 26 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide 2. In the context.xml file, add the following JNDI configurations for the reports to access the reports database. You must replace the following fields with appropriate values to access the reports database details. For more details, refer to Kony MobileFabric_Installer_Guide > Installing Kony MobileFabric > Database Details window. Note: In the Installing Kony MobileFabric page, scroll down to the Database Details window. Field Name Value <username> Database User <Database Server IP : Database Server Hostname/IP Database PORT> <password> Database Password 2017 by Kony, Inc. All rights reserved 27 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide Field Name Value <database_name> Reports Database Name The following JNDI configuration is for the DB2 Server: <!-- Add the following to the existing context.xml --> <Resource name="jdbc/onpremdb2" auth="container" type="javax.sql.datasource" maxactive="100" maxidle="30" maxwait="10000" username="<username>" password="<password>" driverclassname="com.ibm.db2.jcc.db2driver" validationquery="select 1 from SYSIBM.SYSDUMMY1" testonborrow="true" url="jdbc:db2://<database Server IP: Database PORT>/<database_name>:driverType=4; currentschema=<schema_ name>; factory="com.jaspersoft.jasperserver.tomcat.jndi.jsbasicdat asourcefactory"/> The following JNDI configuration is for the MSSQL: <!-- Add the following to the existing context.xml --> <Resource name="jdbc/onpremmssql" auth="container" type="javax.sql.datasource" maxactive="100" maxidle="30" maxwait="10000" username="<username>" password="<password>" 2017 by Kony, Inc. All rights reserved 28 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide driverclassname="com.microsoft.sqlserver.jdbc.sqlserverdriv er" validationquery="select 1" testonborrow="true" url="jdbc:sqlserver://<database Server IP: Database PORT>;databaseName=<database_name>" factory="com.jaspersoft.jasperserver.tomcat.jndi.jsbasicdat asourcefactory"/> The following JNDI configuration is for the MySQL: //Sample code for MySQL <Resource name="jdbc/onpremmysql" auth="container" type="javax.sql.datasource" maxactive="100" maxidle="30" maxwait="10000" username="<username>" password="<password>" driverclassname="com.mysql.jdbc.driver" validationquery="select 1" testonborrow="true" url="jdbc:mysql://<database Server IP: Database PORT>/<database_name>" factory="com.jaspersoft.jasperserver.tomcat.jndi.jsbasicdat asourcefactory"/> The following JNDI configuration is for the Oracle: //Sample code for Oracle <Resource name="jdbc/onpremoracle" auth="container" type="javax.sql.datasource" 2017 by Kony, Inc. All rights reserved 29 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide maxactive="100" maxidle="30" maxwait="10000" username="<reportdatabasename>" password="<password>" driverclassname="oracle.jdbc.oracledriver" validationquery="select 1 from Dual" testonborrow="true" url="jdbc:oracle:thin:@ <Database Server IP: Database PORT>:Service_ID factory="com.jaspersoft.jasperserver.tomcat.jndi.jsb asicdatasourcefactory"/> Important: For versions of Oracle 12 c and earlier, where the database service ID is used instead of service name, used the following URL: "url="jdbc:oracle:thin:@ <Database Server IP: Database PORT>:<database_name." 3. Download appropriate database drivers for your database from the Jasper website link http://support.jaspersoft.com/download_preview.php?rl=60 4. Add appropriate database drivers into the \Jaspersoft\jasperreports-server- <6.0> or <6.2.0>\apachetomcat\lib folder. 2017 by Kony, Inc. All rights reserved 30 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide 5.3 How to Start or Stop JasperReports Server Restart the JasperReports Server for the configurations changes to take effect. To start or stop JasperReports Server, follow these steps: 5.3.1 Windows 1. Click Start, and then click Run (Win+R). 2. In the Run box, type service.msc, and then click OK. The Services window appears. Important: Ensure that the Extended tab is selected. 2017 by Kony, Inc. All rights reserved 31 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide 3. From the services list, click jasperreportstomcat. 4. Click Restart. The system restarts the service. 2017 by Kony, Inc. All rights reserved 32 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide 5.3.2 Linux 1. To start the JasperReports Server, run the following command: cd <js-install>./ctlscript.sh start 2. To stop the JasperReports Server, run the following command: cd <js-install>./ctlscript.sh stop 3. To start and stop individual components, run the following command: cd <js-install>./ctlscript.sh start stop postgresql./ctlscript.sh start stop tomcat For more information, refer to https://community.jaspersoft.com/documentation/jasperreportsserver-install-guide/v561/startstop-scripts-linux 5.4 How to Run Reports This section explains how to run reports. Reports are generated based on the inputs provided, such as month, year, environment ID, aggregation level, and session_request. To run reports, follow these steps: 2017 by Kony, Inc. All rights reserved 33 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide 1. Log in to the JasperReports Server. 2. Click View > Repository. 3. In the left pane, expand Public, and then click Reports. In the right pane, the Repository section displays reports. 4. In the Repository section, click the report - for example, Sessions per Device. The Options left pane for the report displays. 2017 by Kony, Inc. All rights reserved 34 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide 5. In the Options pane, configure the following parameters as required. Month Year Environment ID Aggregation level Session_Request Note: The Environment ID parameter refers to a Development, QA, or Production environment for which you want to view the report data. 2017 by Kony, Inc. All rights reserved 35 of 39
5. Post-Installation Tasks Kony Analytics and Reporting Installation Guide 6. After you configure the parameters, click Save and Apply. 7. From the toolbar, click View > Export > As PDF to export the report to a.pdf file. A.PDF file for the report is created. 2017 by Kony, Inc. All rights reserved 36 of 39
6. How to Configure MobileFabric in the JasperReports Server Kony Analytics and Reporting Installation Guide 6. How to Configure MobileFabric in the JasperReports Server This section explains how to configure MobileFabric components in the JasperReports Server. Based on the configuration of MobileFabric components, such as, accounts, server_url, the JasperReports Server provides data to MobileFabric Console. The data is displayed in MobileFabric Console's Reports page. To configure MobileFabric in the JasperReports Server, follow these steps: 1. From your Jasper install location, open the applicationcontext-security-weboauth.xml file. For example, <jasperinstall-dir>/apachetomcat/webapps/jasperserver-pro/web-inf/applicationcontextsecurity-web-oauth.xml 2. In the applicationcontext-security-web-oauth.xml file, configure the following: Replace %%ACCOUNTS_URL% with the MobileFabric-URL. For example, https://<mobilefabric-ip>:<port> Note: The JasperServer URL is required to be configured in MobileFarbic Console. For more details, refer to the image at the end of this section. Configure the value for the <property name> to enable the JasperServer Professional Edition or JasperServer Enterprise Edition. For example, if you set to the value to true, the JasperServer Professional Edition is configured. If you set to the value to false, the JasperServer Enterprise Edition is configured. 2017 by Kony, Inc. All rights reserved 37 of 39
6. How to Configure MobileFabric in the JasperReports Server Kony Analytics and Reporting Installation Guide <property name="singletenant" value="<enter the value -for example, true or false>" /> 3. From your Jasper install location, open the js-config.properties file. For example, <jasperinstall-dir>/apachetomcat/webapps/jasperserver-pro/web-inf/jsconfig.properties. 4. In the js-config.properties file, replace %%SERVER_URL% with the JasperServer URL. For example, https://<jasperip>:<port>/jasperserver-pro 2017 by Kony, Inc. All rights reserved 38 of 39
6. How to Configure MobileFabric in the JasperReports Server Kony Analytics and Reporting Installation Guide Note: Enter credentials for jasperadmin. The default credentials for jasper admin are: username = jasperadmin%7c<ornganization_name>. For example, jasperadmin%7corganization _1 In general, the URLs encoding involves the pipe symbol ( ) to %7C. password = jasperadmin Note: This section is only applicable for MobileFabric Console 6.5 and above. 2017 by Kony, Inc. All rights reserved 39 of 39