Upgrading JasperServer 3.5 or Earlier

Upgrading from 4.2.1 or Earlier

If you're running JasperServer version 4.2.1, your upgrade requires two steps:

1. Upgrade from version 4.2.1 to version 6.3.
2. Upgrade from version 6.3 to version 6.4.

The steps for this upgrade are documented in the JasperServer Installation Guide for the 6.3 release. Download the JasperServer 6.3 WAR file distribution zip package to get the relevant files and documentation. The Installation Guide is in the docs folder.

If you're running a JasperServer version earlier than 3.7, first upgrade to 3.7, then to 6.3, then to 6.4.

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_cp_6.4.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_cp_6.4.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.