How to Set Up the Jasper Reports Server
How to Install JasperReports Server V 7.9.2
This section explains how to install JasperReports Server V 7.9 in your local, and apply the hotfix for 7.9.2:
Important: Ensure that you have the required hardware and access to the supporting software as provided in the Prerequisites section.
-
Download the required version 'TIBCO JasperReports Server - Professional Edition' from this link TIBCO JasperReports Server - Professional Edition.
-
Install the JasperReports Server using one of the following:
Windows:
. TIB_js-jrs_7.9.0_win_x86_64.exe
Ubuntu Linux:
. TIB_js-jrs_7.9.0_linux_x86_64.run
-
Replace the JasperReports Server License provided by TIBCO. For example, <js-install-location>jasperserver.license.
-
Download the hotfix_JRSPro7.9.2_cumulative_20221213_0819 (https://support.tibco.com/s/article/TIBCO-JasperReports-Server-v7-9-2-cumulative-hotfix-20221213-0819-is-now-available) from TIBCO Support.
-
Apply the hotfix_JRSPro7.9.2_cumulative_20221213_0819 hotfix. Follow the readme.txt file under the hotfix_JRSPro7.9.2_cumulative_20221213_0819 and apply the hotfix.
-
Start and Log into JasperReports Server 7.9.2.
a. Start your application server (Tomcat server).
b. Clear your browsing cache.
c. Log in to the JasperReports Server. You can view the JasperReports Server version upgraded to V7.9.2.
To check the upgraded version of the Jasper Reports Server, click the link specified in the footer immediately after the upgrade. The About TIBCO JasperReports Server dialog appears with upgraded details, shown below:
]()
-
Perform the Post-Installation tasks as specified in the Post-Installation Tasks.
-
Clear the application server's Work and Temp folder.
a. Go to <tomcat>/work folder and delete all the files and folders in that directory.
b. Go to <tomcat>/temp folder and delete all the files and folders in that directory.
-
Clear the Repository Cache Database table.
a. Run the following commands in the JasperServer's PostgreSQL DB with postgres user.
i. update JIRepositoryCache set item_reference = null;
ii. delete from JIRepositoryCache;
Now your JasperReports Server is upgraded to V 7.9.2, and all the analytics information from the previous version is available in the upgraded version.
-
Configure the JasperReports Server. Refer to How to Configure the JasperReports Server.
How to Configure 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.
To configure the JasperReports Server, follow these steps:
-
Once the JasperReports Server is installed, the Install Complete window appears with the confirmation message. Select the Launch check box to launch the JasperReports Server.
The Welcome to Jaspersoft page appears.
-
Provide your default log-in credentials (username as superuser and password as superuser), and then click Login.
The Getting Started page appears.
-
On the Manage menu, click Users.
Note: You need to edit superuser attributes only if reports are going to be run outside of the Foundry Console's context for users of Foundry 9.X and above.
For most users of Foundry 9.X and above, reports can be directly accessed from Foundry Console after following the setup steps as mentioned in the Post-Installation Tasks and How to Configure Foundry in the JasperReports Server sections to finish the post-installation tasks and configuring Foundry Console to communicate with JasperReports Server -
From the Users list, click superuser, and then click Edit to continue.
-
In the Attributes tab, click the Add button to add a row for the attribute.
-
Add the following details:
Attribute Name Attribute Value
kaid - VoltMX Account ID. This value needs to match the Account Id generated by VoltMX Foundry Installer.
The value of Account ID field generated for VoltMX Foundry Server can be viewed from the Settings page in Appservices. The Settings URL format is as follows:
http://<mfconsoleIP:Port>/admin/console/config/configuration.htmlExample: 100000002
Note: VoltMX Foundry 9.x, the default kaid value is always 100000002.
tz_display_name - The timezone display name attribute appears on all reports as a footer indicating the timezone in which a report was generated. It is generally set to the Country/City Example: America/New_York
tz_offset - The timezone offset attribute indicates the offset in minutes from UTC time. Date calculations are adjusted according to this attribute while running reports to ensure that time is based on a user's timezone.
The offset contains sign (+ or -) with minutes to indicate if it is behind or ahead of UTC. For example: UTC - 5:00 for New York City would be set as -300 minutes varies for Japan which is at UTC + 9:00 would be set as 540 minutes.Example: +300 -
Click Save to save the new attributes.
Note: To change the default password of a user, you can change the password from the edit section of the user as well (optional).
-
Re-login to JasperReports Server portal with the user to test the reports.
-
To modify the attributes of a user, repeat Step 1 through Step 7 in this procedure, after modifying attributes, re-login to JasperReports portal.