Kony Analytics and Reporting Installation Guide

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
Version 1.4
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
Version 1.4
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
Version 1.4
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
© 2017 by Kony, Inc. All rights reserved
37
4 of 39
1. Preface
Kony Analytics and Reporting Installation Guide
Version 1.4
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
Kony Analytics and Reporting Installation Guide
1. Preface
Version 1.4
1.3 Formatting Conventions in This Guide
The following formatting conventions are used throughout the document:
Convention
Monospace
Italic
Bold
URL
Note:
Explanation
n
User input text, system prompts, and responses
n
File path
n
Commands
n
Program code
n
File names
n
Emphasis
n
Names of books and documents
n
New terminology
n
Windows
n
Menus
n
Buttons
n
Icons
n
Fields
n
Tabs
Active link to a URL
Provides helpful hints or additional information
© 2017 by Kony, Inc. All rights reserved
6 of 39
Kony Analytics and Reporting Installation Guide
1. Preface
Version 1.4
Convention
Important:
Explanation
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
Kony Analytics and Reporting Installation Guide
2. Prerequisites
Version 1.4
2. Prerequisites
The following sections explain the software and hardware required to install JasperReports Server.
2.1 Software Requirements
Purpose
Installer
Software Requirement
Windows:
l
jasperreports-server6.0-windows-x64installer.exe
Note: Kony Products support only Jasper Professional or
Jasper Enterprise edition and not the community edition.
l
jasperreports-server6.2-windows-x64installer.exe
Linux:
l
jasperreports-server6.0-linux-x64installer.run
l
jasperreports-server6.2-linux-x64installer.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
Version 1.4
Server.
The license key for JasperSoft on-premises is provided by Kony as part of the software
subscription license for Kony MobileFabric Analytics Server.
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
For JasperReports Server Distributions, refer to
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
Kony Analytics and Reporting Installation Guide
2. Prerequisites
Version 1.4
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,
sqljdbc4.jar
2014
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
Windows
- Windows 2008
Resource
Disk
Footprint
600 MB
Minimum
Recommended
10 GB free
40 GB+
RAM
512 MB
1 GB +
Processor
1 GHz (single
1.5 GHz + (multi-
Pentium)
core Pentium)
- Windows 7
- Windows 8
© 2017 by Kony, Inc. All rights reserved
10 of 39
Kony Analytics and Reporting Installation Guide
2. Prerequisites
Version 1.4
Supported OS
Linux Resource
Disk
Footprint
600 MB
Minimum
Recommended
10 GB free
40 GB+
RAM
512 MB
1 GB +
Processor
1 GHz (single
1.5 GHz + (multi-
Pentium)
core Pentium)
- Red Hat Enterprise
Linux 5, 6
- Novell SUSE Linux
Enterprise 10, 11
- Debian 6
- 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:
l
If you select Console check box, the system creates the reports database.
l
If you select Console and Integration Service check boxes, the system creates the reports
database.
l
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
Version 1.4
© 2017 by Kony, Inc. All rights reserved
12 of 39
3. How to Set Up the JasperReports Server
Kony Analytics and Reporting Installation Guide
Version 1.4
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
Version 1.4
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
Version 1.4
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
Version 1.4
Attribute Name
Attribut Value
kaid - Kony Account ID. This value needs to match the Account Id
Example:
generated by Kony MobileFabric Installer.
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:
Note: For
MobileFabri
c 6.5, the
http://<mfconsoleIP:Port>/admin/console/config/config
default kaid
uration.html
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
tz_offset - The timezone offset attribute indicates the offset in minutes from
UTC time. Date calculations are adjusted according to this attribute while
Example:
America/N
ew_York
Example: -
300
running reports to ensure that time is based on a user's timezone.
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
Version 1.4
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
Version 1.4
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.
ii.
cd <path>/JS_60_BACKUP
<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
Version 1.4
l
Command for Windows
i.
ii.
l
cd <js-install-6.0>/buildomatic
js-export.bat --everything --output-zip js-export-6.0.zip
Command for Linux.
i.
ii.
cd <js-install-6.0>/buildomatic
js-export.sh --everything --output-zip js-export6.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-install6.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
Version 1.4
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.
l
appServerDir=<your Tomcat Server location where you have deployed
JasperServer>
l
dbUsername=postgres
l
dbPassword=postgres
l
dbHost=localhost
l
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:
l
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
Version 1.4
l
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-install6.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
Version 1.4
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
Version 1.4
a. Run the following commands in the JasperServer's PostgreSQL DB with postgres
user.
i.
ii.
update JIRepositoryCache set item_reference = null;
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
Version 1.4
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:
l
How to Download and Import a Package to JasperReports Server
l
How to Set Up JNDI Data Sources
l
How to Start or Stop JasperReports Server
l
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
Version 1.4
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
Version 1.4
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\METAINF\context.xml.
© 2017 by Kony, Inc. All rights reserved
26 of 39
5. Post-Installation Tasks
Kony Analytics and Reporting Installation Guide
Version 1.4
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>
© 2017 by Kony, Inc. All rights reserved
Database Password
27 of 39
Kony Analytics and Reporting Installation Guide
5. Post-Installation Tasks
Version 1.4
Field Name
<database_name>
l
Value
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"/>
l
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
Version 1.4
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"/>
l
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"/>
l
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
Version 1.4
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
Version 1.4
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
Version 1.4
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
Version 1.4
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
Version 1.4
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
Version 1.4
5. In the Options pane, configure the following parameters as required.
l
Month
l
Year
l
Environment ID
l
Aggregation level
l
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
Version 1.4
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
Kony Analytics and Reporting
JasperReports Server
Installation Guide
Version 1.4
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-web-
oauth.xml file.
For example, <jasperinstall-dir>/apache-
tomcat/webapps/jasperserver-pro/web-inf/applicationcontextsecurity-web-oauth.xml
2. In the applicationcontext-security-web-oauth.xml file, configure the
following:
l
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.
l
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
Kony Analytics and Reporting
JasperReports Server
Installation Guide
Version 1.4
<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>/apache-
tomcat/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
Kony Analytics and Reporting
JasperReports Server
Installation Guide
Version 1.4
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