kony analytics and reporting installation guide

56
Kony Fabric Reporting and Analytics Installation Guide On-Premises Release V8 SP4 Document Relevance and Accuracy This document is considered relevant to the Release stated on this title page and the document version stated on the Revision History page. Remember to always view and download the latest document version relevant to the software release you are using. © 2017 by Kony, Inc. All rights reserved 1 of 56

Upload: others

Post on 11-Sep-2021

14 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Kony Analytics and Reporting Installation Guide

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

  • 1 Revision History
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 2: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 3: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 4: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 5: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 6: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 7: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 8: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 9: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 10: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 11: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 12: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 13: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 14: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 15: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 16: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 17: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 18: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 19: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 20: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 21: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 22: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 23: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 24: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 25: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 26: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 27: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 28: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 29: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 30: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 31: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 32: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 33: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 34: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 35: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 36: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 37: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 38: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 39: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 40: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 41: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 42: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 43: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 44: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 45: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 46: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 47: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 48: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 49: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 50: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 51: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 52: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 53: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 54: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 55: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server
Page 56: Kony Analytics and Reporting Installation Guide

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
  • 2 Prerequisites
    • 21 Software Requirements
    • 22 Supported Databases and Drivers
    • 23 Hardware Requirements
    • 24 Reports Database
      • 3 How to Set Up the JasperReports Server
      • 4 How to Install the JasperReports Server WAR file using js-install Scripts
      • 5 How to Upgrade Jasper Reports Server
      • 6 Post-Installation Tasks
        • 61 How to Download and Import a Package into the JasperReports Server
        • 62 How to Set Up JNDI Data Sources
        • 63 How to Configure PhantomJS and RequireJS in to the JasperReports Server
        • 64 How to Start or Stop JasperReports Server
        • 65 How to Run Reports
          • 7 How to Configure Kony Fabric in the JasperReports Server