Upgrading from 6.3.x or Earlier
If you're running JasperReports Server version 6.3.x or earlier, your upgrade requires multiple steps.
If you're running JasperReports Server 3.7 through 4.2:
|1.||Upgrade to the latest version of 6.3.x.|
|2.||Upgrade 6.3.x to the latest version 6.4.x.|
|3.||Upgrade 6.4.x to version 7.5.|
If you're running JasperReports Server 4.5 through 6.3.x:
|1.||Upgrade to the latest version of 6.4.x.|
|2.||Upgrade from 6.4.x to version 7.5.|
The steps for the upgrade to 6.3.x or 6.4.x are documented in the JasperServer Installation Guide for that release. Download the JasperReports Server WAR file distribution zip package for the release you want to get the relevant files and documentation. The Installation Guide is in the docs folder.
You can download the JasperReports Server WAR file distribution zip package from
If you're running a JasperServer version earlier than 3.7, first upgrade to 3.7.0, then to 6.3.x, then to 7.5.
Best Practices for Upgrading on Windows
The two methods for installing JasperReports Server are:
|1.||Installing with the Binary Installer and Bundled Components|
The binary installer is an executable that puts all the components in place to run JasperReports Server. For example, if you take the default installation choices, you'll get the Apache Tomcat application server, the PostgreSQL database and Java execution environment.
But keep in mind that these components are specially configured to run a specific version of JasperReports Server. This applies to the Windows Start Menu items created to start and stop JasperReports Server.
|2.||Installing to Pre-existing Components|
When installing a “Production” instance of JasperReports Server, you may want to install the main components before you install JasperReports Server. This way you have more control over updating and upgrading components like the application server, database, and Java.
Once you put these components in place, you have two options for installing JasperReports Server:
|a.||Use the War File ZIP distribution (file name: TIB_js-jrs_7.5.0_bin.zip)|
You'll install JasperReports Server to the existing components using the js-install.bat scripts. You'll create a default_master.properties file that specifies the location of the application server and database components.
|b.||Use the Binary Installer, TIB_js-jrs_7.5.0__installer-windows-x64.exe|
The installer will prompt you for the location of the application server and database components.
If you intend to upgrade your Windows installation with future releases of JasperReports Server, we recommend installing to pre-existing components. This will reduce any post-upgrade confusion caused by the Windows Start Menu showing the older version of JasperReports Server.