Upgrading JasperReports Server from version 5.2 to version 6.3.0

Starting with version 11.1.1, the WorldServer distribution archive includes the JasperReports Server (JRS) 6.3.0 installation kit. However, if you still use a previous version of JRS with WorldServer 11.x, you can upgrade to JRS 6.3.0 either directly from version 5.2 or indirectly, by upgrading to version 5.2 first.

Before you begin

Make sure you have installed Microsoft SQL Management Studio (MSSQL DB) or Oracle SQL Developer (Oracle DB) on your local machine. You also need a working version of WorldServer 11.x (with Java Development Kit 8 and Tomcat 8) on the same machine. JRS 6.3.0 works with Java Development Kit (JDK) 8 and Tomcat 8, so you can use the same Tomcat and JDK versions you used when you installed other WorldServer 11.x components (ws-api, ws, ws-legacy).

About this task

The following procedure applies to upgrading the JasperReports Server engine for WorldServer 11.x. Only users with administrator permissions can install and upgrade JasperReports Server. You can find the JasperReports Server installation kit on the WorldServer FTP, in <distribution archive>\integrations\JasperSoft_6.3.0.

Procedure

  1. Log in to WorldServer and download all your custom themes from the Report Center.
  2. Go to the buildomatic folder of the path where JRS 5.2 is currently installed.
  3. Open the command prompt (CMD) as an administrator and enter the following command: js-export.bat --everything --output-zip js-52-export.zip
  4. Back up the current JRS database.
  5. Move <tomcat-home>\webapps\jasperserver-pro to a backup location.
  6. Extract the jasperreports-server-6.3.0-bin.zip archive to a path of your choice.
  7. Install JasperReports Server 6.3.0 according to the procedure presented in the "Installing JasperReports Server" topic.
  8. Log in to WorldServer and upload all your custom themes back into the Report Center.

Results

At this point, you should be able to see the reports from Tools > Report Center in WorldServer 11.x using JasperReports Server 6.3.0.