Kony Fabric
Reporting and Analytics
Installation Guide
On-Premises
Release V8 SP4Document 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
copy 2017 by Kony Inc All rights reserved 1 of 56
Kony Analytics and Reporting Installation GuideVersion10
Copyright copy 2015 by Kony Inc
All rights reserved
February 2019
This document contains information proprietary to Kony Inc is bound by the Kony license
agreements andmay not be used except in the context of understanding the use andmethods of
Kony Inc software without prior express written permission Kony Empowering Everywhere Kony
Fabric KonyNitro and Kony Visualizer are trademarks of Kony Inc MobileFabric is a registered
trademark of Kony Inc Microsoft theMicrosoft logo Internet Explorer Windows andWindowsVista
are registered trademarks of Microsoft Corporation Apple the Apple logo iTunes iPhone iPad OS
X Objective-C Safari Apple Pay AppleWatch 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 inMotion and
RIM are registered trademarks of BlackBerry SAPreg and SAPreg Business Suitereg are registered
trademarks of SAP SE in Germany and in several other countries All other terms trademarks or
servicemarksmentioned in this document have been capitalized and are to be considered the
property of their respective owners
copy 2017 by Kony Inc All rights reserved 2 of 56
1 Revision History Kony Analytics and Reporting Installation GuideVersion10
1 Revision History
Date Document Version Description of ModificationsRelease
02252019 14 Document Published for V8 SP4 FixPack
09242018 13 Document Published for V8 SP3
04192018 12 Document Published for V8 SP2
09192017 10 Document published for V8GA
copy 2017 by Kony Inc All rights reserved 3 of 56
Kony Analytics and Reporting Installation GuideVersion10
Table of Contents
1 Revision History 3
2 Prerequisites 5
21 Software Requirements 6
22 Supported Databases and Drivers 10
23 Hardware Requirements 10
24 Reports Database 11
3 How to Set Up the JasperReports Server 13
4 How to Install the JasperReports Server WAR file using js-install Scripts 18
5 How to Upgrade Jasper Reports Server 34
6 Post-Installation Tasks 40
61 How to Download and Import a Package into the JasperReports Server 40
62 How to Set Up JNDI Data Sources 42
63 How to Configure PhantomJS and RequireJS in to the JasperReports Server 48
64 How to Start or Stop JasperReports Server 49
65 How to RunReports 51
7 How to Configure Kony Fabric in the JasperReports Server 54
copy 2017 by Kony Inc All rights reserved 4 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
2 Prerequisites
The following sections explain the software and hardware required to install JasperReports Server
copy 2017 by Kony Inc All rights reserved 5 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
21 Software Requirements
copy 2017 by Kony Inc All rights reserved 6 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Installer
Note Kony Products support only Jasper Professional or
Jasper Enterprise edition and not the community edition
Windows
l jasperreports-server-
71-windows-x64-
installerexe
l jasperreports-server-
62-windows-x64-
installerexe
l jasperreports-server-
60-windows-x64-
installerexe
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
copy 2017 by Kony Inc All rights reserved 7 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Linux
l jasperreports-server-
71-linux-x64-
installerrun
l jasperreports-server-
62-linux-x64-
installerrun
l jasperreports-server-
60-linux-x64-
installerrun
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
JasperSoft License Jasperserverlicense file
Important Ensure that you have downloaded TIBCOJasperReports Server version 600 or 620
or 710 and installed it before configuring user attributes in How to Set Up the JasperReports
Server
The license key for JasperSoft on-premises is provided by Kony as part of the software
subscription license for Kony Fabric Analytics Server
copy 2017 by Kony Inc All rights reserved 8 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Note
For JasperReports Server Installation Documentation refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62introduction
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-user-
guidev71introduction-jasperreports-server
For JasperReports Server Distributions refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62jasperreports-server-distributions
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-community-edition-
release-notesv71release-distributions
copy 2017 by Kony Inc All rights reserved 9 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
22 Supported Databases and Drivers
Database Version Database Connectivity Drivers
MySQL 56X mysql-connector-java-5133-binjar
Click the below link to download the jar
httpdevmysqlcomdownloadsconnectorj50html
Microsoft SQL Server 2012
2014
sqljdbc4jar
Click the below link to download the jar
httpsmsdnmicrosoftcomen-ussqlserveraa937724aspx
Oracle 11g 12c ojdbc7jar
Click the below link to download the jar
httpwwworaclecomtechnetworkdatabasefeaturesjdbcjdbc-
drivers-12c-download-1958347html
IBM - DB2 101 db2jcc4jar
Click the below link to download the jar
httpwww-01ibmcomsupportdocviewwssuid=swg21363866
23 Hardware Requirements
Supported OS Resource Footprint Minimum Recommended
Windows
- Windows 2008
- Windows 7
- Windows 8
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
copy 2017 by Kony Inc All rights reserved 10 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Supported OS Resource Footprint Minimum Recommended
Linux
- Red Hat Enterprise
Linux 5 6
- Novell SUSE Linux
Enterprise 10 11
- Debian 6
- Ubuntu 10
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
24 Reports Database
While installing Kony Fabric the system creates the reports database
ltprefixgtmfreportsltsuffixgt 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 Fabric Installer_Guide gt Installing Kony Fabric gt Install Components
window
Note In the Installing Kony Fabric page scroll down to the Install Components window
A reports database is created in the Kony Fabric Installation gt Pre-Installation Summary window
shown below
copy 2017 by Kony Inc All rights reserved 11 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
copy 2017 by Kony Inc All rights reserved 12 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
Kony Analytics and Reporting Installation GuideVersion10
Copyright copy 2015 by Kony Inc
All rights reserved
February 2019
This document contains information proprietary to Kony Inc is bound by the Kony license
agreements andmay not be used except in the context of understanding the use andmethods of
Kony Inc software without prior express written permission Kony Empowering Everywhere Kony
Fabric KonyNitro and Kony Visualizer are trademarks of Kony Inc MobileFabric is a registered
trademark of Kony Inc Microsoft theMicrosoft logo Internet Explorer Windows andWindowsVista
are registered trademarks of Microsoft Corporation Apple the Apple logo iTunes iPhone iPad OS
X Objective-C Safari Apple Pay AppleWatch 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 inMotion and
RIM are registered trademarks of BlackBerry SAPreg and SAPreg Business Suitereg are registered
trademarks of SAP SE in Germany and in several other countries All other terms trademarks or
servicemarksmentioned in this document have been capitalized and are to be considered the
property of their respective owners
copy 2017 by Kony Inc All rights reserved 2 of 56
1 Revision History Kony Analytics and Reporting Installation GuideVersion10
1 Revision History
Date Document Version Description of ModificationsRelease
02252019 14 Document Published for V8 SP4 FixPack
09242018 13 Document Published for V8 SP3
04192018 12 Document Published for V8 SP2
09192017 10 Document published for V8GA
copy 2017 by Kony Inc All rights reserved 3 of 56
Kony Analytics and Reporting Installation GuideVersion10
Table of Contents
1 Revision History 3
2 Prerequisites 5
21 Software Requirements 6
22 Supported Databases and Drivers 10
23 Hardware Requirements 10
24 Reports Database 11
3 How to Set Up the JasperReports Server 13
4 How to Install the JasperReports Server WAR file using js-install Scripts 18
5 How to Upgrade Jasper Reports Server 34
6 Post-Installation Tasks 40
61 How to Download and Import a Package into the JasperReports Server 40
62 How to Set Up JNDI Data Sources 42
63 How to Configure PhantomJS and RequireJS in to the JasperReports Server 48
64 How to Start or Stop JasperReports Server 49
65 How to RunReports 51
7 How to Configure Kony Fabric in the JasperReports Server 54
copy 2017 by Kony Inc All rights reserved 4 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
2 Prerequisites
The following sections explain the software and hardware required to install JasperReports Server
copy 2017 by Kony Inc All rights reserved 5 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
21 Software Requirements
copy 2017 by Kony Inc All rights reserved 6 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Installer
Note Kony Products support only Jasper Professional or
Jasper Enterprise edition and not the community edition
Windows
l jasperreports-server-
71-windows-x64-
installerexe
l jasperreports-server-
62-windows-x64-
installerexe
l jasperreports-server-
60-windows-x64-
installerexe
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
copy 2017 by Kony Inc All rights reserved 7 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Linux
l jasperreports-server-
71-linux-x64-
installerrun
l jasperreports-server-
62-linux-x64-
installerrun
l jasperreports-server-
60-linux-x64-
installerrun
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
JasperSoft License Jasperserverlicense file
Important Ensure that you have downloaded TIBCOJasperReports Server version 600 or 620
or 710 and installed it before configuring user attributes in How to Set Up the JasperReports
Server
The license key for JasperSoft on-premises is provided by Kony as part of the software
subscription license for Kony Fabric Analytics Server
copy 2017 by Kony Inc All rights reserved 8 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Note
For JasperReports Server Installation Documentation refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62introduction
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-user-
guidev71introduction-jasperreports-server
For JasperReports Server Distributions refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62jasperreports-server-distributions
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-community-edition-
release-notesv71release-distributions
copy 2017 by Kony Inc All rights reserved 9 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
22 Supported Databases and Drivers
Database Version Database Connectivity Drivers
MySQL 56X mysql-connector-java-5133-binjar
Click the below link to download the jar
httpdevmysqlcomdownloadsconnectorj50html
Microsoft SQL Server 2012
2014
sqljdbc4jar
Click the below link to download the jar
httpsmsdnmicrosoftcomen-ussqlserveraa937724aspx
Oracle 11g 12c ojdbc7jar
Click the below link to download the jar
httpwwworaclecomtechnetworkdatabasefeaturesjdbcjdbc-
drivers-12c-download-1958347html
IBM - DB2 101 db2jcc4jar
Click the below link to download the jar
httpwww-01ibmcomsupportdocviewwssuid=swg21363866
23 Hardware Requirements
Supported OS Resource Footprint Minimum Recommended
Windows
- Windows 2008
- Windows 7
- Windows 8
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
copy 2017 by Kony Inc All rights reserved 10 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Supported OS Resource Footprint Minimum Recommended
Linux
- Red Hat Enterprise
Linux 5 6
- Novell SUSE Linux
Enterprise 10 11
- Debian 6
- Ubuntu 10
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
24 Reports Database
While installing Kony Fabric the system creates the reports database
ltprefixgtmfreportsltsuffixgt 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 Fabric Installer_Guide gt Installing Kony Fabric gt Install Components
window
Note In the Installing Kony Fabric page scroll down to the Install Components window
A reports database is created in the Kony Fabric Installation gt Pre-Installation Summary window
shown below
copy 2017 by Kony Inc All rights reserved 11 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
copy 2017 by Kony Inc All rights reserved 12 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
1 Revision History Kony Analytics and Reporting Installation GuideVersion10
1 Revision History
Date Document Version Description of ModificationsRelease
02252019 14 Document Published for V8 SP4 FixPack
09242018 13 Document Published for V8 SP3
04192018 12 Document Published for V8 SP2
09192017 10 Document published for V8GA
copy 2017 by Kony Inc All rights reserved 3 of 56
Kony Analytics and Reporting Installation GuideVersion10
Table of Contents
1 Revision History 3
2 Prerequisites 5
21 Software Requirements 6
22 Supported Databases and Drivers 10
23 Hardware Requirements 10
24 Reports Database 11
3 How to Set Up the JasperReports Server 13
4 How to Install the JasperReports Server WAR file using js-install Scripts 18
5 How to Upgrade Jasper Reports Server 34
6 Post-Installation Tasks 40
61 How to Download and Import a Package into the JasperReports Server 40
62 How to Set Up JNDI Data Sources 42
63 How to Configure PhantomJS and RequireJS in to the JasperReports Server 48
64 How to Start or Stop JasperReports Server 49
65 How to RunReports 51
7 How to Configure Kony Fabric in the JasperReports Server 54
copy 2017 by Kony Inc All rights reserved 4 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
2 Prerequisites
The following sections explain the software and hardware required to install JasperReports Server
copy 2017 by Kony Inc All rights reserved 5 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
21 Software Requirements
copy 2017 by Kony Inc All rights reserved 6 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Installer
Note Kony Products support only Jasper Professional or
Jasper Enterprise edition and not the community edition
Windows
l jasperreports-server-
71-windows-x64-
installerexe
l jasperreports-server-
62-windows-x64-
installerexe
l jasperreports-server-
60-windows-x64-
installerexe
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
copy 2017 by Kony Inc All rights reserved 7 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Linux
l jasperreports-server-
71-linux-x64-
installerrun
l jasperreports-server-
62-linux-x64-
installerrun
l jasperreports-server-
60-linux-x64-
installerrun
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
JasperSoft License Jasperserverlicense file
Important Ensure that you have downloaded TIBCOJasperReports Server version 600 or 620
or 710 and installed it before configuring user attributes in How to Set Up the JasperReports
Server
The license key for JasperSoft on-premises is provided by Kony as part of the software
subscription license for Kony Fabric Analytics Server
copy 2017 by Kony Inc All rights reserved 8 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Note
For JasperReports Server Installation Documentation refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62introduction
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-user-
guidev71introduction-jasperreports-server
For JasperReports Server Distributions refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62jasperreports-server-distributions
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-community-edition-
release-notesv71release-distributions
copy 2017 by Kony Inc All rights reserved 9 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
22 Supported Databases and Drivers
Database Version Database Connectivity Drivers
MySQL 56X mysql-connector-java-5133-binjar
Click the below link to download the jar
httpdevmysqlcomdownloadsconnectorj50html
Microsoft SQL Server 2012
2014
sqljdbc4jar
Click the below link to download the jar
httpsmsdnmicrosoftcomen-ussqlserveraa937724aspx
Oracle 11g 12c ojdbc7jar
Click the below link to download the jar
httpwwworaclecomtechnetworkdatabasefeaturesjdbcjdbc-
drivers-12c-download-1958347html
IBM - DB2 101 db2jcc4jar
Click the below link to download the jar
httpwww-01ibmcomsupportdocviewwssuid=swg21363866
23 Hardware Requirements
Supported OS Resource Footprint Minimum Recommended
Windows
- Windows 2008
- Windows 7
- Windows 8
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
copy 2017 by Kony Inc All rights reserved 10 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Supported OS Resource Footprint Minimum Recommended
Linux
- Red Hat Enterprise
Linux 5 6
- Novell SUSE Linux
Enterprise 10 11
- Debian 6
- Ubuntu 10
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
24 Reports Database
While installing Kony Fabric the system creates the reports database
ltprefixgtmfreportsltsuffixgt 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 Fabric Installer_Guide gt Installing Kony Fabric gt Install Components
window
Note In the Installing Kony Fabric page scroll down to the Install Components window
A reports database is created in the Kony Fabric Installation gt Pre-Installation Summary window
shown below
copy 2017 by Kony Inc All rights reserved 11 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
copy 2017 by Kony Inc All rights reserved 12 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
Kony Analytics and Reporting Installation GuideVersion10
Table of Contents
1 Revision History 3
2 Prerequisites 5
21 Software Requirements 6
22 Supported Databases and Drivers 10
23 Hardware Requirements 10
24 Reports Database 11
3 How to Set Up the JasperReports Server 13
4 How to Install the JasperReports Server WAR file using js-install Scripts 18
5 How to Upgrade Jasper Reports Server 34
6 Post-Installation Tasks 40
61 How to Download and Import a Package into the JasperReports Server 40
62 How to Set Up JNDI Data Sources 42
63 How to Configure PhantomJS and RequireJS in to the JasperReports Server 48
64 How to Start or Stop JasperReports Server 49
65 How to RunReports 51
7 How to Configure Kony Fabric in the JasperReports Server 54
copy 2017 by Kony Inc All rights reserved 4 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
2 Prerequisites
The following sections explain the software and hardware required to install JasperReports Server
copy 2017 by Kony Inc All rights reserved 5 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
21 Software Requirements
copy 2017 by Kony Inc All rights reserved 6 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Installer
Note Kony Products support only Jasper Professional or
Jasper Enterprise edition and not the community edition
Windows
l jasperreports-server-
71-windows-x64-
installerexe
l jasperreports-server-
62-windows-x64-
installerexe
l jasperreports-server-
60-windows-x64-
installerexe
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
copy 2017 by Kony Inc All rights reserved 7 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Linux
l jasperreports-server-
71-linux-x64-
installerrun
l jasperreports-server-
62-linux-x64-
installerrun
l jasperreports-server-
60-linux-x64-
installerrun
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
JasperSoft License Jasperserverlicense file
Important Ensure that you have downloaded TIBCOJasperReports Server version 600 or 620
or 710 and installed it before configuring user attributes in How to Set Up the JasperReports
Server
The license key for JasperSoft on-premises is provided by Kony as part of the software
subscription license for Kony Fabric Analytics Server
copy 2017 by Kony Inc All rights reserved 8 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Note
For JasperReports Server Installation Documentation refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62introduction
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-user-
guidev71introduction-jasperreports-server
For JasperReports Server Distributions refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62jasperreports-server-distributions
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-community-edition-
release-notesv71release-distributions
copy 2017 by Kony Inc All rights reserved 9 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
22 Supported Databases and Drivers
Database Version Database Connectivity Drivers
MySQL 56X mysql-connector-java-5133-binjar
Click the below link to download the jar
httpdevmysqlcomdownloadsconnectorj50html
Microsoft SQL Server 2012
2014
sqljdbc4jar
Click the below link to download the jar
httpsmsdnmicrosoftcomen-ussqlserveraa937724aspx
Oracle 11g 12c ojdbc7jar
Click the below link to download the jar
httpwwworaclecomtechnetworkdatabasefeaturesjdbcjdbc-
drivers-12c-download-1958347html
IBM - DB2 101 db2jcc4jar
Click the below link to download the jar
httpwww-01ibmcomsupportdocviewwssuid=swg21363866
23 Hardware Requirements
Supported OS Resource Footprint Minimum Recommended
Windows
- Windows 2008
- Windows 7
- Windows 8
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
copy 2017 by Kony Inc All rights reserved 10 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Supported OS Resource Footprint Minimum Recommended
Linux
- Red Hat Enterprise
Linux 5 6
- Novell SUSE Linux
Enterprise 10 11
- Debian 6
- Ubuntu 10
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
24 Reports Database
While installing Kony Fabric the system creates the reports database
ltprefixgtmfreportsltsuffixgt 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 Fabric Installer_Guide gt Installing Kony Fabric gt Install Components
window
Note In the Installing Kony Fabric page scroll down to the Install Components window
A reports database is created in the Kony Fabric Installation gt Pre-Installation Summary window
shown below
copy 2017 by Kony Inc All rights reserved 11 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
copy 2017 by Kony Inc All rights reserved 12 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
2 Prerequisites
The following sections explain the software and hardware required to install JasperReports Server
copy 2017 by Kony Inc All rights reserved 5 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
21 Software Requirements
copy 2017 by Kony Inc All rights reserved 6 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Installer
Note Kony Products support only Jasper Professional or
Jasper Enterprise edition and not the community edition
Windows
l jasperreports-server-
71-windows-x64-
installerexe
l jasperreports-server-
62-windows-x64-
installerexe
l jasperreports-server-
60-windows-x64-
installerexe
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
copy 2017 by Kony Inc All rights reserved 7 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Linux
l jasperreports-server-
71-linux-x64-
installerrun
l jasperreports-server-
62-linux-x64-
installerrun
l jasperreports-server-
60-linux-x64-
installerrun
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
JasperSoft License Jasperserverlicense file
Important Ensure that you have downloaded TIBCOJasperReports Server version 600 or 620
or 710 and installed it before configuring user attributes in How to Set Up the JasperReports
Server
The license key for JasperSoft on-premises is provided by Kony as part of the software
subscription license for Kony Fabric Analytics Server
copy 2017 by Kony Inc All rights reserved 8 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Note
For JasperReports Server Installation Documentation refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62introduction
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-user-
guidev71introduction-jasperreports-server
For JasperReports Server Distributions refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62jasperreports-server-distributions
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-community-edition-
release-notesv71release-distributions
copy 2017 by Kony Inc All rights reserved 9 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
22 Supported Databases and Drivers
Database Version Database Connectivity Drivers
MySQL 56X mysql-connector-java-5133-binjar
Click the below link to download the jar
httpdevmysqlcomdownloadsconnectorj50html
Microsoft SQL Server 2012
2014
sqljdbc4jar
Click the below link to download the jar
httpsmsdnmicrosoftcomen-ussqlserveraa937724aspx
Oracle 11g 12c ojdbc7jar
Click the below link to download the jar
httpwwworaclecomtechnetworkdatabasefeaturesjdbcjdbc-
drivers-12c-download-1958347html
IBM - DB2 101 db2jcc4jar
Click the below link to download the jar
httpwww-01ibmcomsupportdocviewwssuid=swg21363866
23 Hardware Requirements
Supported OS Resource Footprint Minimum Recommended
Windows
- Windows 2008
- Windows 7
- Windows 8
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
copy 2017 by Kony Inc All rights reserved 10 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Supported OS Resource Footprint Minimum Recommended
Linux
- Red Hat Enterprise
Linux 5 6
- Novell SUSE Linux
Enterprise 10 11
- Debian 6
- Ubuntu 10
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
24 Reports Database
While installing Kony Fabric the system creates the reports database
ltprefixgtmfreportsltsuffixgt 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 Fabric Installer_Guide gt Installing Kony Fabric gt Install Components
window
Note In the Installing Kony Fabric page scroll down to the Install Components window
A reports database is created in the Kony Fabric Installation gt Pre-Installation Summary window
shown below
copy 2017 by Kony Inc All rights reserved 11 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
copy 2017 by Kony Inc All rights reserved 12 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
21 Software Requirements
copy 2017 by Kony Inc All rights reserved 6 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Installer
Note Kony Products support only Jasper Professional or
Jasper Enterprise edition and not the community edition
Windows
l jasperreports-server-
71-windows-x64-
installerexe
l jasperreports-server-
62-windows-x64-
installerexe
l jasperreports-server-
60-windows-x64-
installerexe
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
copy 2017 by Kony Inc All rights reserved 7 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Linux
l jasperreports-server-
71-linux-x64-
installerrun
l jasperreports-server-
62-linux-x64-
installerrun
l jasperreports-server-
60-linux-x64-
installerrun
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
JasperSoft License Jasperserverlicense file
Important Ensure that you have downloaded TIBCOJasperReports Server version 600 or 620
or 710 and installed it before configuring user attributes in How to Set Up the JasperReports
Server
The license key for JasperSoft on-premises is provided by Kony as part of the software
subscription license for Kony Fabric Analytics Server
copy 2017 by Kony Inc All rights reserved 8 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Note
For JasperReports Server Installation Documentation refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62introduction
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-user-
guidev71introduction-jasperreports-server
For JasperReports Server Distributions refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62jasperreports-server-distributions
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-community-edition-
release-notesv71release-distributions
copy 2017 by Kony Inc All rights reserved 9 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
22 Supported Databases and Drivers
Database Version Database Connectivity Drivers
MySQL 56X mysql-connector-java-5133-binjar
Click the below link to download the jar
httpdevmysqlcomdownloadsconnectorj50html
Microsoft SQL Server 2012
2014
sqljdbc4jar
Click the below link to download the jar
httpsmsdnmicrosoftcomen-ussqlserveraa937724aspx
Oracle 11g 12c ojdbc7jar
Click the below link to download the jar
httpwwworaclecomtechnetworkdatabasefeaturesjdbcjdbc-
drivers-12c-download-1958347html
IBM - DB2 101 db2jcc4jar
Click the below link to download the jar
httpwww-01ibmcomsupportdocviewwssuid=swg21363866
23 Hardware Requirements
Supported OS Resource Footprint Minimum Recommended
Windows
- Windows 2008
- Windows 7
- Windows 8
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
copy 2017 by Kony Inc All rights reserved 10 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Supported OS Resource Footprint Minimum Recommended
Linux
- Red Hat Enterprise
Linux 5 6
- Novell SUSE Linux
Enterprise 10 11
- Debian 6
- Ubuntu 10
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
24 Reports Database
While installing Kony Fabric the system creates the reports database
ltprefixgtmfreportsltsuffixgt 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 Fabric Installer_Guide gt Installing Kony Fabric gt Install Components
window
Note In the Installing Kony Fabric page scroll down to the Install Components window
A reports database is created in the Kony Fabric Installation gt Pre-Installation Summary window
shown below
copy 2017 by Kony Inc All rights reserved 11 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
copy 2017 by Kony Inc All rights reserved 12 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Installer
Note Kony Products support only Jasper Professional or
Jasper Enterprise edition and not the community edition
Windows
l jasperreports-server-
71-windows-x64-
installerexe
l jasperreports-server-
62-windows-x64-
installerexe
l jasperreports-server-
60-windows-x64-
installerexe
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
copy 2017 by Kony Inc All rights reserved 7 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Linux
l jasperreports-server-
71-linux-x64-
installerrun
l jasperreports-server-
62-linux-x64-
installerrun
l jasperreports-server-
60-linux-x64-
installerrun
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
JasperSoft License Jasperserverlicense file
Important Ensure that you have downloaded TIBCOJasperReports Server version 600 or 620
or 710 and installed it before configuring user attributes in How to Set Up the JasperReports
Server
The license key for JasperSoft on-premises is provided by Kony as part of the software
subscription license for Kony Fabric Analytics Server
copy 2017 by Kony Inc All rights reserved 8 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Note
For JasperReports Server Installation Documentation refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62introduction
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-user-
guidev71introduction-jasperreports-server
For JasperReports Server Distributions refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62jasperreports-server-distributions
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-community-edition-
release-notesv71release-distributions
copy 2017 by Kony Inc All rights reserved 9 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
22 Supported Databases and Drivers
Database Version Database Connectivity Drivers
MySQL 56X mysql-connector-java-5133-binjar
Click the below link to download the jar
httpdevmysqlcomdownloadsconnectorj50html
Microsoft SQL Server 2012
2014
sqljdbc4jar
Click the below link to download the jar
httpsmsdnmicrosoftcomen-ussqlserveraa937724aspx
Oracle 11g 12c ojdbc7jar
Click the below link to download the jar
httpwwworaclecomtechnetworkdatabasefeaturesjdbcjdbc-
drivers-12c-download-1958347html
IBM - DB2 101 db2jcc4jar
Click the below link to download the jar
httpwww-01ibmcomsupportdocviewwssuid=swg21363866
23 Hardware Requirements
Supported OS Resource Footprint Minimum Recommended
Windows
- Windows 2008
- Windows 7
- Windows 8
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
copy 2017 by Kony Inc All rights reserved 10 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Supported OS Resource Footprint Minimum Recommended
Linux
- Red Hat Enterprise
Linux 5 6
- Novell SUSE Linux
Enterprise 10 11
- Debian 6
- Ubuntu 10
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
24 Reports Database
While installing Kony Fabric the system creates the reports database
ltprefixgtmfreportsltsuffixgt 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 Fabric Installer_Guide gt Installing Kony Fabric gt Install Components
window
Note In the Installing Kony Fabric page scroll down to the Install Components window
A reports database is created in the Kony Fabric Installation gt Pre-Installation Summary window
shown below
copy 2017 by Kony Inc All rights reserved 11 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
copy 2017 by Kony Inc All rights reserved 12 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Purpose Software Requirement
Linux
l jasperreports-server-
71-linux-x64-
installerrun
l jasperreports-server-
62-linux-x64-
installerrun
l jasperreports-server-
60-linux-x64-
installerrun
Important To get
access to the reports
created with latest
features Kony
recommends to install
Jasper Enterprise
edition 62 or 71 with
Kony Fabric V8 or
latest
JasperSoft License Jasperserverlicense file
Important Ensure that you have downloaded TIBCOJasperReports Server version 600 or 620
or 710 and installed it before configuring user attributes in How to Set Up the JasperReports
Server
The license key for JasperSoft on-premises is provided by Kony as part of the software
subscription license for Kony Fabric Analytics Server
copy 2017 by Kony Inc All rights reserved 8 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Note
For JasperReports Server Installation Documentation refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62introduction
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-user-
guidev71introduction-jasperreports-server
For JasperReports Server Distributions refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62jasperreports-server-distributions
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-community-edition-
release-notesv71release-distributions
copy 2017 by Kony Inc All rights reserved 9 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
22 Supported Databases and Drivers
Database Version Database Connectivity Drivers
MySQL 56X mysql-connector-java-5133-binjar
Click the below link to download the jar
httpdevmysqlcomdownloadsconnectorj50html
Microsoft SQL Server 2012
2014
sqljdbc4jar
Click the below link to download the jar
httpsmsdnmicrosoftcomen-ussqlserveraa937724aspx
Oracle 11g 12c ojdbc7jar
Click the below link to download the jar
httpwwworaclecomtechnetworkdatabasefeaturesjdbcjdbc-
drivers-12c-download-1958347html
IBM - DB2 101 db2jcc4jar
Click the below link to download the jar
httpwww-01ibmcomsupportdocviewwssuid=swg21363866
23 Hardware Requirements
Supported OS Resource Footprint Minimum Recommended
Windows
- Windows 2008
- Windows 7
- Windows 8
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
copy 2017 by Kony Inc All rights reserved 10 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Supported OS Resource Footprint Minimum Recommended
Linux
- Red Hat Enterprise
Linux 5 6
- Novell SUSE Linux
Enterprise 10 11
- Debian 6
- Ubuntu 10
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
24 Reports Database
While installing Kony Fabric the system creates the reports database
ltprefixgtmfreportsltsuffixgt 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 Fabric Installer_Guide gt Installing Kony Fabric gt Install Components
window
Note In the Installing Kony Fabric page scroll down to the Install Components window
A reports database is created in the Kony Fabric Installation gt Pre-Installation Summary window
shown below
copy 2017 by Kony Inc All rights reserved 11 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
copy 2017 by Kony Inc All rights reserved 12 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Note
For JasperReports Server Installation Documentation refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60introduction
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62introduction
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-user-
guidev71introduction-jasperreports-server
For JasperReports Server Distributions refer to the following
httpscommunityjaspersoftcomdocumentationjasperreports-server-install-
guidev561jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev60jasperreports-server-distributions
httpcommunityjaspersoftcomdocumentationtibco-jasperreports-server-installation-
guidev62jasperreports-server-distributions
httpscommunityjaspersoftcomdocumentationtibco-jasperreports-server-community-edition-
release-notesv71release-distributions
copy 2017 by Kony Inc All rights reserved 9 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
22 Supported Databases and Drivers
Database Version Database Connectivity Drivers
MySQL 56X mysql-connector-java-5133-binjar
Click the below link to download the jar
httpdevmysqlcomdownloadsconnectorj50html
Microsoft SQL Server 2012
2014
sqljdbc4jar
Click the below link to download the jar
httpsmsdnmicrosoftcomen-ussqlserveraa937724aspx
Oracle 11g 12c ojdbc7jar
Click the below link to download the jar
httpwwworaclecomtechnetworkdatabasefeaturesjdbcjdbc-
drivers-12c-download-1958347html
IBM - DB2 101 db2jcc4jar
Click the below link to download the jar
httpwww-01ibmcomsupportdocviewwssuid=swg21363866
23 Hardware Requirements
Supported OS Resource Footprint Minimum Recommended
Windows
- Windows 2008
- Windows 7
- Windows 8
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
copy 2017 by Kony Inc All rights reserved 10 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Supported OS Resource Footprint Minimum Recommended
Linux
- Red Hat Enterprise
Linux 5 6
- Novell SUSE Linux
Enterprise 10 11
- Debian 6
- Ubuntu 10
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
24 Reports Database
While installing Kony Fabric the system creates the reports database
ltprefixgtmfreportsltsuffixgt 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 Fabric Installer_Guide gt Installing Kony Fabric gt Install Components
window
Note In the Installing Kony Fabric page scroll down to the Install Components window
A reports database is created in the Kony Fabric Installation gt Pre-Installation Summary window
shown below
copy 2017 by Kony Inc All rights reserved 11 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
copy 2017 by Kony Inc All rights reserved 12 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
22 Supported Databases and Drivers
Database Version Database Connectivity Drivers
MySQL 56X mysql-connector-java-5133-binjar
Click the below link to download the jar
httpdevmysqlcomdownloadsconnectorj50html
Microsoft SQL Server 2012
2014
sqljdbc4jar
Click the below link to download the jar
httpsmsdnmicrosoftcomen-ussqlserveraa937724aspx
Oracle 11g 12c ojdbc7jar
Click the below link to download the jar
httpwwworaclecomtechnetworkdatabasefeaturesjdbcjdbc-
drivers-12c-download-1958347html
IBM - DB2 101 db2jcc4jar
Click the below link to download the jar
httpwww-01ibmcomsupportdocviewwssuid=swg21363866
23 Hardware Requirements
Supported OS Resource Footprint Minimum Recommended
Windows
- Windows 2008
- Windows 7
- Windows 8
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
copy 2017 by Kony Inc All rights reserved 10 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Supported OS Resource Footprint Minimum Recommended
Linux
- Red Hat Enterprise
Linux 5 6
- Novell SUSE Linux
Enterprise 10 11
- Debian 6
- Ubuntu 10
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
24 Reports Database
While installing Kony Fabric the system creates the reports database
ltprefixgtmfreportsltsuffixgt 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 Fabric Installer_Guide gt Installing Kony Fabric gt Install Components
window
Note In the Installing Kony Fabric page scroll down to the Install Components window
A reports database is created in the Kony Fabric Installation gt Pre-Installation Summary window
shown below
copy 2017 by Kony Inc All rights reserved 11 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
copy 2017 by Kony Inc All rights reserved 12 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
Supported OS Resource Footprint Minimum Recommended
Linux
- Red Hat Enterprise
Linux 5 6
- Novell SUSE Linux
Enterprise 10 11
- Debian 6
- Ubuntu 10
Disk 600MB 10GB free 40GB+
RAM 512MB 1GB +
Processor 1 GHz (single
Pentium)
15 GHz + (multi-
core Pentium)
24 Reports Database
While installing Kony Fabric the system creates the reports database
ltprefixgtmfreportsltsuffixgt 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 Fabric Installer_Guide gt Installing Kony Fabric gt Install Components
window
Note In the Installing Kony Fabric page scroll down to the Install Components window
A reports database is created in the Kony Fabric Installation gt Pre-Installation Summary window
shown below
copy 2017 by Kony Inc All rights reserved 11 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
copy 2017 by Kony Inc All rights reserved 12 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
2 Prerequisites Kony Analytics and Reporting Installation GuideVersion10
copy 2017 by Kony Inc All rights reserved 12 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
confirmationmessage Select the Launch check box to launch the JasperReports Server
TheWelcome 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
copy 2017 by Kony Inc All rights reserved 13 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
2 Provide your default log-in credentials (username assuperuser and password as
superuser) and then click Login
TheGetting Started page appears
3 On theManagemenu click Users
Note You need to edit superuser attributes only if reports are going to be run outside
of the Kony Fabric Consoles context for users of MobileFabric 65 and above
For most users of MobileFabric 65 and above reports can be directly accessed fromKony
Fabric (MobileFabric) Console after following the setup steps asmentioned in the Post-
Installation Tasks and How to Configure Kony Fabric in the JasperReports Server sections
to finish the post-installation tasks and configuring Kony Fabric Console to communicate
with JasperReports Server
copy 2017 by Kony Inc All rights reserved 14 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
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
copy 2017 by Kony Inc All rights reserved 15 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
Attribute Name Attribut Value
kaid - Kony Account ID This value needs tomatch the Account Id
generated by Kony Fabric Installer
The value of Account ID field generated for Kony Fabric (MobileFabric)
Server can be viewed from the Settings page in Appservices The Settings
URL format is as follows
httpltmfconsoleIPPortgtadminconsoleconfigconfig
urationhtml
Example
100000002
Note For
MobileFabri
c 65 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 CountryCity
Example
AmericaN
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 users timezone
The offset contains sign (+ or -) with minutes to indicate if it is behind or
ahead of UTC For example UTC - 500 for New York City would be set as
-300minutes varies for Japan which is at UTC + 900 would be set as 540
minutes
Example -
300
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 aswell (optional)
8 Re-login to JasperReports portal with the user to test the reports
copy 2017 by Kony Inc All rights reserved 16 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
3 How to Set Up the JasperReports Server Kony Analytics and Reporting Installation GuideVersion10
9 Tomodify attributes of a user repeat Step 1 through Step 7 in this procedure After modifying
attributes re-login to JasperReports portal
copy 2017 by Kony Inc All rights reserved 17 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 How to Install the JasperReports Server WAR file using js-
install Scripts
The following section details how to install JasperReportsreg Server using theWAR file V62
distribution The steps in this section provide youmore details on js-install shell scripts supported on
Windows and Linux operating systems
Note You can perform the following steps to install JasperReports Server WAR file using js-install
Scripts for V 71 aswell
1 Install Apache Tomcat 7 application servers from the following link
httpstomcatapacheorgdownload-70cgi
Note To install JasperReports Server V71 youmust have Apache Tomcat 8
2 Create a folder in CJaspersoftjasperreports-server-620 apache-
tomcat
3 Extract the content from the Tomcat zip into the folder you created in the previous step
For example Capache-tomcat-7085-windows-x64zipapache-tomcat-
7085 to CJaspersoftjasperreports-server-620apache-tomcat
copy 2017 by Kony Inc All rights reserved 18 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
4 Set the catalina home by using the following command
Set CATALINA_HOME=CJaspersoftjasperreports-server-
620apache-tomcat
Note In Linux these variables will be set in bash profile and executed before going further
5 Set the JRE home by using the following command
set JRE_HOME=ltCProgram FilesJavajdk170_79jre
copy 2017 by Kony Inc All rights reserved 19 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Note In Linux these variables will be set in bash profile and executed before going further
6 Add the CATALINA_HOME and the JRE_HOME to the PATH variable
7 Locate or install the SQL Server database
Note The target database can be on a remote server
Note The application server should reside on the localmachine
copy 2017 by Kony Inc All rights reserved 20 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
8 Extract all the files from the jasperreports-server-620-binzip
a Navigate to the destination for example CJaspersoft onWindows and
homeltusergt on Linux
The directory jasperreports-server-620-bin appears in the file location that
you have chosen
Note The ltjs-installgt refers to ltunzipped-locationgtjasperreports-server-620-bin
9 Copy the ltdatabase namegt_masterproperties file specific to your database from
the sample_conf and paste it to the buildomatic folder
l Copy from mdash ltjs-installgtbuildomaticsample_conf
l Paste at mdash ltjs-installgtbuildomatic
For example if your database is PostgreSQL copy the postgresql_
masterproperties to the ltjsinstallgtbuildomatic
10 Rename the file you copied to the default_masterproperties
11 Edit the default_masterproperties file to add settings specific to for your database and
application server
The following table details for db types and their respective sample property values
copy 2017 by Kony Inc All rights reserved 21 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
PostgreSQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbHost=localhost
l dbUsername=postgres
l dbPassword=postgres
MySQL l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=root
l dbPassword=password
l dbHost=localhost
Oracle 12c with CDBPDB Use settings for Oracle except for the following changes
l dbUsername=cjasperserver
l sid=cdb1
copy 2017 by Kony Inc All rights reserved 22 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
Other supported Oracle
databases
(including 12c non- CDB)
l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=jasperserver
l dbPassword=password
l sysUsername=system
l sysPassword=password
l dbHost=hostname
DB2 l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=db2admin
l dbPassword=password
l dbHost=localhost
copy 2017 by Kony Inc All rights reserved 23 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Database Type Sample Property Values
SQLServer l appServerType=tomcat7 [tomcat6 tomcat8 jboss
jboss-eap-6 jboss-as-7 glassfish3
skipAppServerCheck]
l appServerDir=cProgram FilesApache Software
FoundationTomcat 7
l dbUsername=sa
l dbPassword=sa
l dbHost=localhost
Note When the appServerType property is set to skipAppServerCheck the buildomatic
skips all the application server validations
The following are the limitations
l Youmust add an extra (backslash) to paths in the properties files for example
appServerDir=CApache Software Foundation apache-tomcat-7085
l The dbUsernamemust be the same as the username used in the Oracle DB In addition
buildomatic will not work with the ldquosys as sysdbardquo syntax
l For Oracle 12cwithout CDBPDB do not use the cjasperserver dbUsername Use the
standard jasperserver dbUsername instead
copy 2017 by Kony Inc All rights reserved 24 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
12 Update the encrypt property for password encryption
The default_masterproperties file has a property setting to enable encryption of
passwords that reside on the file system This applies to all the files found in the buildomatic
folder as well as the connection pooling file used by Apache Tomcat (contextxml) Currently
password encryption for connection pooling is supported only on the Tomcat application server
To enable encryption on the file system un-comment the encrypt property so that it looks like
this
encrypt=true
13 Run the js-install Script in test mode
l To run the js-install script in test mode on Windows follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installbat test
l To run the js-install script in test mode on Linux follow these steps
a Navigate to the buildomatic directory
cd ltjs-installgtbuildomatic
b Enter the following command to run the js-install script in test mode
js-installsh test
-------------------------------------------------------------
---------
Running JasperReports Server install script at 2018-02-23_12-
31
-------------------------------------------------------------
copy 2017 by Kony Inc All rights reserved 25 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
---------
[test] Running pre-install-test-pro Ant task
-------------------------------------------------------------
---------
Buildfile CUserskh9266Documentsjasperreports-server-
620-binbuildomaticbuildxml [echo] Filtering properties
(cleaning out blank spaces)
14 Set Java JVMOptions (required)
The following table details JVM options onWindows (64-bit)
copy 2017 by Kony Inc All rights reserved 26 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Opti
ons
for
all
appl
icati
on
serv
ers
l set JAVA_OPTS=JAVA_OPTS -Xms1024m -Xmx2048m -
XXPermSize=32m
l set JAVA_OPTS=JAVA_OPTS -XXMaxPermSize=512m -Xss2m -
XX+UseConcMarkSweepGC
l set JAVA_OPTS=JAVA_OPTS -XX+CMSClassUnloadingEnabled
For
Ora
cle
l set JAVA_OPTS=JAVA_OPTS -
DORACLEJDBCDEFAULTNCHAR=TRUE
Addi
tion
al
opti
ons
for
JBo
ss
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPMESSAGEFACTORY=ORGAPACHEAXISSOAPME
SSAGEFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPCONNECTIONFACTORY=ORGAPACHEAXIS
SOAPSOAPCONNECTIONFACTORYIMPL
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLSOAPSOAPFACTORY=ORGAPACHEAXISSOAPSOAPF
ACTORYIMPL
copy 2017 by Kony Inc All rights reserved 27 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Windows (64-bit)
Addi
tion
al
opti
on
for
JBo
ss
EA
P6
01
l set JAVA_OPTS=JAVA_OPTS -
DJAVAXXMLTRANSFORMTRANSFORMERFACTORY=ORGAPACHEX
ALANPROCESSORTRANSFORMERFACTORYIMPL
Note Add the JAVA_OPTS in ltjs-installgtbincatalinabat
The following table details JVM options on Linux (64-bit)
copy 2017 by Kony Inc All rights reserved 28 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
JVM Options on Linux (64-bit)
Additio
nal
options
for all
applica
tion
servers
l EXPORT JAVA_OPTS=$JAVA_OPTS -XMS1024M -XMX2048M -
XXPERMSIZE=32M
l EXPORT JAVA_OPTS=$JAVA_OPTS -XXMAXPERMSIZE=512M -
XSS2M
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+USECONCMARKSWEEPGC
l EXPORT JAVA_OPTS=$JAVA_OPTS -
XX+CMSCLASSUNLOADINGENABLED
For
Oracle
l export JAVA_OPTS=$JAVA_OPTS -DoraclejdbcdefaultNChar=true
Additio
nal
options
for
JBoss
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapMessageFactory=orgapacheaxissoapMessageFactoryI
mpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPConnectionFactory=orgapacheaxissoapSOAPCo
nnectionFactoryImpl
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmlsoapSOAPFactory=orgapacheaxissoapSOAPFactoryImpl
Additio
nal
options
for
JBoss
EAP
601
l export JAVA_OPTS=$JAVA_OPTS -
DjavaxxmltransformTransformerFactory=orgapachexalanprocessorTran
sformerFactoryImpl
copy 2017 by Kony Inc All rights reserved 29 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
15 Set up the license (required)
Replace the existing license file with the actual license file present in the following location
OPERATING SYSTEMS
Linux homeltusergt
Windows installed fromWAR file CUsersltusergt
Windows installed from binary installer CUsers
Note View the output logs at ltjs-installgtbuildomaticlogsjs-install-ltdategtlog
16 Run the js-install scripts
a Start your database server
b Stop your application server
c Open the Command Prompt as Administrator onWindows or open a terminal window on
Linux
d Type cd ltjs-installgtbuildomatic
e Run the js-install script
copy 2017 by Kony Inc All rights reserved 30 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
Description Commands
Install the JasperReports Server sample data and
sample databases (foodmart and suagrcrm)
l gt js-installbat
(Windows)
l $ js-installsh
(Linux)
Install the JasperReports Server but not the sample
data and sample databases
l gt js-installbat
minimal (Windows)
l $ js-installsh
minimal (Linux)
Note Windows has a path length limitation of 260 characters
Instead of installing JRS from ltLocalDrive_PathgtProjectsJasperReports
Serverjasperreports-server-620-bin try to install it fromCjasperreports-server-620-
bin
copy 2017 by Kony Inc All rights reserved 31 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
17 Start the server
l Use any of the following commands to start your application server and run the
JasperReports Server
copy 2017 by Kony Inc All rights reserved 32 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
4 How to Install the JasperReports Server WAR file
using js-install Scripts
Kony Analytics and Reporting
Installation GuideVersion10
o Tomcat
n Windows lttomcatgtbinstartupbat
n Linux lttomcatgtbinstartupsh
copy 2017 by Kony Inc All rights reserved 33 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
5 How to Upgrade Jasper Reports Server
This section explains how to upgrade Jasper Reports Server from V 60 to V 62 or V 62 to V
71 or V 60 to V 71
Important To get access to the reports created with latest features Kony recommends to
upgrade Jasper Enterprise edition 62 or 71 with V8 or latest
To Upgrade JasperReports Server follow these steps
1 Back up your JRSWar file as follows
a Create a folder where you can save your jasperserver-prowar file For example
CJS_BACKUP or optJS_BACKUP
a Copy the lttomcatgtwebappsjasperserver-pro to ltpathgtJS_BACKUP
2 Back up your JasperServer Database
a Create a folder where you can save your JasperServer database For example CJS_
BACKUP or optJS_BACKUP
b Run the following commands for PostgreSQL
icd ltpathgtJS_BACKUP
iiltjrs-server-homegtpostgresqlbinpg_dumpexe --host=lthostgt
--port=ltportgt --username=ltusernamegt jasperserver gt js-db-
71-dumpsql
3 Export the current Repository Data as follows
copy 2017 by Kony Inc All rights reserved 34 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command for Windows
icd ltjs-install-71gtbuildomatic
iijs-exportbat --everything --output-zip js-export-71zip
l Command for Linux
icd ltjs-install-71gtbuildomatic
iijs-exportsh --everything --output-zip js-export-
71zip
4 Download the JRS 71WAR file from httpsupportjaspersoftcom
5 Extract all files from the jasperreports-server-71-binzip to a the local system - for
example ltjs-install-71gt(CJaspersoft on Windows homeltusergt 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_masterproperties configuration file located in ltjs-install-71gtbuildomaticsample_confpostgresql_
masterproperties
b Paste the postgresql_masterproperties file to ltjs-install-
71gtbuildomatic
copy 2017 by Kony Inc All rights reserved 35 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
c Rename the postgresql_masterproperties to default_
masterproperties
For example
From ltjs-install-71gtbuildomaticpostgresql_masterproperties
to ltjs-install-71gtbuildomaticdefault_masterproperties
d Edit the default_masterpropertieswith your database and application server
details
l appServerDir=ltyour Tomcat Server location where you have deployed
JasperServergt
l dbUsername=postgres
l dbPassword=postgres
l dbHost=localhost
l dbPort=ltport of the database serverpostgresqlgt
7 Upgrade to JasperReports Server 71
a Stop your application server (Tomcat Server)
b Start your database server (Postgres Server)
c Run the following command
l Command to run inWindows
cd ltjs-install-71gtbuildomatic
js-upgrade-newdbbat ltpathgtjs-export-71zip
copy 2017 by Kony Inc All rights reserved 36 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
l Command to run in Linux
$ cd ltjs-install-71gtbuildomatic
$ js-upgrade-newdbsh ltpathgtjs-export-71zip
Output Log Location The output logs are available at ltjs-install-
71gtbuildomaticlogsjs-upgrade-ltdategt-ltnumbergtlog
8 Start and Log into JasperReports Server 71
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
V71
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
copy 2017 by Kony Inc All rights reserved 37 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
9 Perform the Post-Installation tasks as specified in the Post-Installation Tasks
10 Clear the application serversWork and Temp folder
a Go to lttomcatgtwork folder and delete all the files and folders in that directory
b Go to lttomcatgttemp folder and delete all the files and folders in that directory
11 Clear the Repository Cache Database table
a Run the following commands in the JasperServers PostgreSQLDB with postgres
user
copy 2017 by Kony Inc All rights reserved 38 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
5 How to Upgrade Jasper Reports Server Kony Analytics and Reporting Installation GuideVersion10
iupdate JIRepositoryCache set item_reference = null
iidelete from JIRepositoryCache
Now your JasperServer is upgraded to V 71 and all the analytics information from the previous
version is available in the upgraded version
copy 2017 by Kony Inc All rights reserved 39 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
6 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 60x
l How to Download and Import a Package to JasperReports Server
l How to Set Up JNDI Data Sources
l How to Configure PhantomJS and RequireJS in to the JasperReports Server
l How to Start or Stop JasperReports Server
l How to RunReports
61 How to Download and Import a Package into the JasperReports
Server
To generate reports the package zip filesmust 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
611 How to Download Package Files
Currently Kony supports JasperReports Server 60 and 62 and 71 Download the following
appropriate package for your JasperReports Server
Important New features in V60 are not supported with Kony Fabric V8 SP3 or latest
To download a package follow these steps
1 For current version reports log in to httpcommunitykonycomdownloadsmanual You can
obtain a user name and password from your sales representative or partner
copy 2017 by Kony Inc All rights reserved 40 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
l To download older version reports log in to
httpscommunitykonycomdownloadsarchivemanual
2 Click the Kony Fabric tab
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 701 click the
Kony Fabric gt tab select the 701 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 V60 or V62 or
V71
612 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 readwrite execute permissions to the JasperReports
Server install folder
6121 Windows
1 In the Jasper installed system open theWindows command prompt
2 Go to the ltpath of the extracted packagegt of the required database
copy 2017 by Kony Inc All rights reserved 41 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 Run thekony_importsbat script followed by the JasperServer location as the input
konyreports_importbat ltjasperinstall-dirgt
CJaspersoftjasperreports-server-lt60gt or lt620gt or
lt710gt
6122 Linux
1 Open the Linux terminal
2 Go to the ltpath of the extracted packagegt of the required database
3 Run thekonyreports_importsh script followed by the JasperServer location as the
input
konyreports_importsh ltjasperinstall-dirgt
usrjaspersoft
62 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
copy 2017 by Kony Inc All rights reserved 42 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
1 From your Jasper install location open thecontextxml file
For example Jaspersoftjasperreports-server-lt60 or 620 or
710gtapache-tomcatwebappsjasperserver-proMETA-
INFcontextxml
2 In thecontextxml file add the following JNDI configurations for the reports to access the
reports database Youmust replace the following fields with appropriate values to access the
reports database details For more details refer to Kony Fabric_Installer_Guide gt Installing
Kony Fabric gt Database Details window
Important JasperReports Server V620 and V710 uses Tomcat 8 whereas
JasperReports Server V 60 is bundled with Tomcat 7
And data source factory is different for both Tomcat 7 and Tomcat 8
- For JasperReports Server V620 and V710 the data source is as follows
copy 2017 by Kony Inc All rights reserved 43 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
factory=comjaspersoftjasperservertomcatjndiJSCommonsBasic
DataSourceFactory
- For JasperReports Server V60 the data source is as follows
factory=comjaspersoftjasperservertomcatjndiJSBasicDataSou
rceFactory
Note In the Installing Kony Fabric page scroll down to the Database Details window
Field Name Value
ltusernamegt Database User
ltDatabase Server IP
Database PORTgt
Database Server HostnameIP
ltpasswordgt Database Password
ltdatabase_namegt Reports Database Name
l The following JNDI configuration is for the DB2 Server
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremdb2 auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=comibmdb2jccDB2Driver
copy 2017 by Kony Inc All rights reserved 44 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
validationQuery=SELECT 1 from SYSIBMSYSDUMMY1
testOnBorrow=true
url=jdbcdb2ltDatabase Server IP Database
PORTgtltdatabase_namegtdriverType=4 currentSchema=ltSchema_
namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMSSQL
lt-- Add the following to the existing contextxml --gt
ltResource name=jdbconpremmssql auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commicrosoftsqlserverjdbcSQLServerDriv
er
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcsqlserverltDatabase Server IP Database
PORTgtdatabaseName=ltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for theMySQL
Sample code for MySQL
ltResource name=jdbconpremmysql auth=Container
copy 2017 by Kony Inc All rights reserved 45 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltusernamegt password=ltpasswordgt
driverClassName=commysqljdbcDriver
validationQuery=SELECT 1
testOnBorrow=true
url=jdbcmysqlltDatabase Server IP Database
PORTgtltdatabase_namegt
factory=comjaspersoftjasperservertomcatjndiJSBasicDat
aSourceFactorygt
l The following JNDI configuration is for the Oracle
Sample code for Oracle
ltResource name=jdbconpremoracle auth=Container
type=javaxsqlDataSource
maxActive=100 maxIdle=30 maxWait=10000
username=ltreportDatabaseNamegt password=ltpasswordgt
driverClassName=oraclejdbcOracleDriver
validationQuery=SELECT 1 from Dual
testOnBorrow=true
url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
factory=comjaspersoftjasperservertomcatjndiJSB
asicDataSourceFactorygt
copy 2017 by Kony Inc All rights reserved 46 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
Note For versions of Oracle 11g or 12cwithout PDB use the following URL to
configure the JNDI url=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
For versions of Oracle 12c created with PDB option use the following URL to
configure the JNDIurl=jdbcoraclethinltDatabase Server IP Database
PORTgtService_ID
Important For versions of Oracle 12 c and earlier where the database service ID isused instead of service name used the following URL
url=jdbcoraclethin ltDatabase Server IP
Database PORTgtltdatabase_namegt
Important If you are using the latest JasperReports Server V62 or higher add a
new JNDI configuration as custom dashboard feature is available in the latest
package The resource name value should be jdbconpremaccounts for all
supported database types
3 Download appropriate database drivers for your database from the Jasper website link
httpsupportjaspersoftcomdownload_previewphprl=60
4 Add appropriate database drivers into the Jaspersoftjasperreports-server-
lt60gt or lt620gt or lt710gtapachetomcatlib folder
copy 2017 by Kony Inc All rights reserved 47 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
63 How to Configure PhantomJS and RequireJS in to the Jasper-
Reports Server
If you are using JasperReports Server V71 to download reports in PDF format youmust need to
configure the PhantomJS and RequireJS in to the JasperReports Server
1 Download version of PhantomJS and RequireJS script files in to the Jasper Installation location
l Download PhantomJS from httpphantomjsorgdownload (phantomjs-211)
l Download RequireJS from httpsrequirejsorgdocsdownloadhtml (requirejs 236)
2 Navigate to the ltJasper Installation Locationgtapache-
tomcatwebappsjasperserver-proWEB-INFclasses and open the
jasperreportsproperties file
copy 2017 by Kony Inc All rights reserved 48 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 In the jasperreportsproperties do the following
l replace the PHANTOMJS_PATH with the phantomjs path
l replace the REQUIREJS_PATH with the requirejs path
64 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
641 Windows
1 Click Start and then click Run (Win+R)
2 In the Run box typeservicemsc and then clickOK The Services window appears
Important Ensure that the Extended tab is selected
copy 2017 by Kony Inc All rights reserved 49 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 From the services list clickjasperreportsTomcat
4 Click Restart The system restarts the service
642 Linux
1 To start the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh start
2 To stop the JasperReports Server run the following command
cd ltjs-installgt
ctlscriptsh stop
copy 2017 by Kony Inc All rights reserved 50 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
3 To start and stop individual components run the following command
cd ltjs-installgt
ctlscriptsh start|stop postgresql
ctlscriptsh start|stop tomcat
For more information refer to httpscommunityjaspersoftcomdocumentationjasperreports-
server-install-guidev561startstop-scripts-linux
65 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
1 Log in to the JasperReports Server
2 Click View gt Repository
copy 2017 by Kony Inc All rights reserved 51 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
TheOptions left pane for the report displays
5 In the Options pane configure the following parameters as required
l Month
l Year
l Environment ID
copy 2017 by Kony Inc All rights reserved 52 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
6 Post-Installation Tasks Kony Analytics and Reporting Installation GuideVersion10
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
6 After you configure the parameters click Save and Apply
7 From the toolbar click View gt Export gt As PDF to export the report to a PDF file
A PDF file for the report is created
copy 2017 by Kony Inc All rights reserved 53 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
7 How to Configure Kony Fabric in the JasperReports Server
This section explains how to configure Kony Fabric components in the JasperReports Server Based
on the configuration of Kony Fabric components such as accounts server_URL the JasperReports
Server provides data to Kony Fabric Console The data is displayed in Kony Fabric Consoles Reports
page
To configure Kony Fabric in the JasperReports Server follow these steps
1 From your Jasper install location open theapplicationcontext-security-web-
oauthxml file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-INFapplicationcontext-
security-web-oauthxml
2 In theapplicationcontext-security-web-oauthxml file configure the
following
l Replace ACCOUNTS_URL with the Kony Fabric-URL
For example httpsltkonyfabric-ipgtltportgt
Note The JasperServer URL is required to be configured inMobileFarbic Console
For more details refer to the image at the end of this section
l Configure the value for the ltproperty namegt 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
copy 2017 by Kony Inc All rights reserved 54 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
ltproperty name=singleTenant value=ltenter the value -for
example true or falsegt gt
3 From your Jasper install location open thejsconfigproperties file
For example ltjasperinstall-dirgtapache-
tomcatwebappsjasperserver-proWEB-
INFjsconfigproperties
4 In thejsconfigproperties file replace SERVER_URL with the JasperServer
URL
For example httpsltjasperipgtltportgtjasperserver-pro
copy 2017 by Kony Inc All rights reserved 55 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56
7 How to Configure Kony Fabric in the
JasperReports Server
Kony Analytics and Reporting
Installation GuideVersion10
Note Enter credentials for jasperadmin For Jasper Reports Server 6062 the default
credentials for jasper admin are
username = jasperadmin7Cltorganization_namegt For example
jasperadmin7Corganization _1
In general the URLs encoding encodes the pipe symbol (|) to7C
password = jasperadmin
Note Enter credentials for jasperadmin For Jasper Reports Server V71 the default
credentials for jasper admin are
username = jasperadmin|ltorganization_namegt For example
jasperadmin|organization _1
password = jasperadmin
Note Youmust provide the credentials only in the above specified format in order to
configure the reports properly in the Fabric console This ismandatory
copy 2017 by Kony Inc All rights reserved 56 of 56