Upgrading JReport Server

Upgrading a standalone JReport Server and an integrated JReport Server involves different processes while sharing some common steps. Both updated JReport Servers require converting the report resources in the old version in order to comply with the new server version.

Before upgrading, the old version JReport Server should be shut down.

Upgrading in a standalone environment

JReport Server 13 provides two migration tools in <install_root>\bin folder, which can help you to convert all the resources on the previous version of JReport Server before version 6.0. Resources the migration tools cover include the security information (realm, user, group, protection, and ACL), report resources (catalog and reports), scheduled tables, completed tables, version and version tables, and other relevant information (such as fonts, NLS, and style groups).

Upgrading a version later than V6.0 (included) to V13

To upgrade a version later than V6.0 (included) to V13, take the steps below. Here is a case showing you how to upgrade V11.1 to V13, provided that the old JReport Server is located in C:\JReport\Server11.1.

1. Backup the file dbconfig.xml in C:\JReport\Server11.1\bin folder.
2. Check the value of property derby.drda.portNumber in C:\JReport\Server11.1\derby\derby.properties if derby is in use and remember it.
3. Install JReport Server 13 to C:\JReport\Server11.1. In the Choose Installation Set screen, choose Typical Installation for Standalone Server. In the System Database screen, check the Trial Database radio button, and set the port number same as the port number mentioned in step 2.
4. After the installation is complete, restore the file dbconfig.xml we backed up in step 1. Then start JReport Server to check the upgraded version.

Upgrading a version between V5.2 Build 590 (included) and V6 (excluded) to V13

You can make the upgrade using the migration tool MigrationV52.bat (MigrationV52.sh for Unix) that is available in the <install_root>\bin folder. This tool is used to convert all the resources of the versions between V5.2 Build 590 (included) and V6 (excluded) to the resources of JReport Server 13. If you install the new version to the same folder as the old one, the parameter can be omitted.

• Usage
  MigrationV52 [orgReportHome]
• Options
  • orgReporthome
    The reporthome of the original JReport Server. If this parameter is not provided, the reporthome of JReport Server 13 will be used as its value.

Case 1: Installing JReport Server 13 to a new folder (recommended)

1. Provided that the old JReport Server is located in C:\JREntServer595. Install JReport Server 13 to a new folder C:\JReport\ServerV13. DO NOT start the newly installed JReport Server.
2. In the DOS window, switch to <install_root>\bin, and run MigrationV52 C:\JREntServer595.

Case 2: Installing JReport Server 13 to the folder where the old version resides

1. Provided that the old JReport Server is located in C:\JREntServer595. Install JReport Server 13 to the same location. DO NOT start the newly installed JReport Server.
2. In the DOS window, switch to <install_root>\bin, and run MigrationV52.bat.

Upgrading a version earlier than V5.2 Build 590 (excluded) to V13

You can do the upgrade using the migration tool MigrationBV52.bat (MigrationBV52.sh for Unix) that is available in the <install_root>\bin folder. This tool is used to convert all the resources of versions lower than V5.2 Build 590 to the resources of JReport Server 13. If you install the new version to the same folder as the old one, the parameter can be omitted.

• Usage
  MigrationBV52 [orgReportHome]
• Options
  • orgReporthome
    The reporthome of the original JReport Server. If the parameter is not provided, the reporthome of JReport Server 13 will be used as its value.

Case 1: Installing JReport Server 13 to a new folder (recommended)

1. Provided that the old JReport Server is located in C:\JREntServer580. Install JReport Server 13 to a new folder C:\JReport\ServerV13. DO NOT start the newly installed JReport Server.
2. In the DOS window, switch to <install_root>\bin, and run MigrationBV52 C:\JREntServer580.

Case 2: Installing JReport Server 13 to the folder where the old version resides

1. Provided that the old JReport Server is located in C:\JREntServer580. Install JReport Server 13 to the same location. DO NOT start the newly installed JReport Server.
2. In the DOS window, switch to <install_root>\bin, and run MigrationBV52.bat.

Upgrading in an integration environment

1. Suppose that you already have a standalone JReport Server 13, whether it is installed directly or upgraded from a previous version. In this step you need not convert the old version reports.
2. Use the JReport Server 13 to create a self-contained WAR/EAR file. For information on how to create the WAR/EAR, see Building a WAR/EAR file to include a self-contained JReport Server. Remember that when building the jreport.war file in a standalone JReport Server 13, the ReportHome of jreport.war must be the same as that of the jreport.war in the previous version.
3. Use the Java application server that integrates the previous version of JReport Server to deploy the new self-contained WAR/EAR and update the old WAR/EAR with the new one.

   By now, if the previous version of JReport Server is later than V6.0 (included), the integrated JReport Server has already been upgraded to V13. But if the previous version is earlier than V6.0, go to step 4 and you need do further upgrade.

4. For a previous version between V5.2 Build 590 (included) and V6 (excluded): in the DOS window, switch to <reporthome>\bin, and run MigrationV52.bat.

   For a previous version earlier than V5.2 Build 590 (excluded): in the DOS window, switch to <reporthome>\bin, and run MigrationBV52.bat.

5. Clear the temporary files or cached files on the application server. Take Tomcat as an example, remove the temp and work directories in D:\Tomcat.