Previous Topic  Next Topic

Upgrading Report Server

This topic describes how you can upgrade Server in both standalone and integration environments. Upgrading a standalone Server and an integrated Server involves different processes while sharing some common steps. Both updated Servers require converting the report resources in the old version in order to comply with the new server version.

Before upgrading, back up your system database and shut down your Server. If you want to use the old report files in <install_root>\history, install the new Server to the same directory with a new license key, replacing the existing program files.

This topic contains the following sections:

• Upgrading Server in a Standalone Environment
• Upgrading Server in an Integration Environment

Upgrading Server in a Standalone Environment

Server provides two migration tools in the <install_root>\bin folder, to convert the resources on the previous version of Server before version 6.0. Resources that the migration tools cover include the security information (realm, user, group, protection, and ACL), report resources (catalog and reports), scheduled tables, completed tables, versions, and version tables, and other relevant information (such as fonts, NLS, and style groups). If you are upgrading from a release later than v6.0, you do not need these tools.

When installing Server into the same directory as an old version, Server maintains the report-level resources in the old version and does not replace them with the current version report resources. For example, if you install Server v24.1 to C:\Serverv13, Server maintains the backup files of v13 in C:\Serverv13\bak\previous_version, the removed patches and jar files in C:\Serverv13\bak\xxx\lib, and the whole bin folder in C:\Serverv13\bak\xxx\bin.

The following sections show how to upgrade Server from a specific old version to v24.1.

Upgrading from v13 and later to v24.1

This section describes how to upgrade Server v13 to v24.1. Assume that the old server is in C:\Serverv13.

1. Install Server v24.1 to C:\Serverv13.
2. In the Choose Installation Set screen, choose Typical Installation for Standalone Server and select Next.
3. Server displays the Installation Warning message window. Choose Upgrading.
4. The installation turns to the Lists screen which shows the details of the upgrading, including the removed patches, the modified configuration files, and the backup files.
5. Select Install in the Installation Summary screen.
6. After the installation is complete, start Server to check the upgraded version.

Upgrading from v6.0 and later to v24.1

This section describes how to upgrade Server v11.1 to v24.1. Assume that the old server is in C:\Serverv11.1.

1. Check the property values in dbconfig.xml in C:\Serverv11.1\bin or back up the file first.
2. Install Server v24.1 to C:\Serverv11.1.
3. In the Choose Installation Set screen, choose Typical Installation for Standalone Server and select Next.
4. Server displays the Installation Warning message window. Choose Yes.
5. In the System Database screen, input the property values according to the backup dbconfig.xml file. Or selectTrial Database and replace dbconfig.xml file with the one you backed up.
6. In the Lists screen you can see the details of the upgrading, including the removed patches, the modified configuration files, and the backup files.
7. Select Install in the Installation Summary screen.
8. After the installation is complete, start Server to check the upgraded version.

Upgrading a version between v5.2 Build 590 and v6 (excluded) to v24.1

You can make the upgrade using the migration tool MigrationV52.bat (MigrationV52.sh for UNIX) in the <install_root>\bin folder. You use this tool to convert the resources of the versions between v5.2 Build 590 and v6 (excluded) to the resources of Server v24.1. If you install the new version to the same folder as the old one, you can omit the orgReporthome parameter.

• Usage
  MigrationV52 [orgReportHome]
• Parameter
  • orgReporthome
    The report home of the original Server. If you do not provide this parameter, Server uses the report home of Server v24.1 as its value.
• Case 1: Installing Server v24.1 to a new folder (recommended)
  1. Assuming the old Server is in C:\Serverv595, install Server v24.1 to a new folder C:\Serverv24.1. DO NOT start the newly installed Server.
  2. In the DOS window, switch to <install_root>\bin and run MigrationV52 C:\Serverv595.
• Case 2: Installing Server v24.1 to the folder where the old version resides
  1. Assuming the old Server is in C:\Serverv595, install Server v24.1 to the same location. DO NOT start the newly installed Server.
  2. In the DOS window, switch to <install_root>\bin and run MigrationV52.bat.

Upgrading a version earlier than v5.2 Build 590 to v24.1

You can do the upgrade using the migration tool MigrationBV52.bat (MigrationBV52.sh for UNIX) in the <install_root>\bin folder. You use this tool to convert the resources of versions lower than v5.2 Build 590 to the resources of Server v24.1. If you install the new version to the same folder as the old one, you can omit the orgReporthome parameter.

• Usage
  MigrationBV52 [orgReportHome]
• Parameter
  • orgReporthome 
    The report home of the original Server. If you do not provide the parameter, Server uses the report home of Server v24.1 as its value.
• Case 1: Installing Server v24.1 to a new folder (recommended)
  1. Assuming the old Server is in C:\Serverv580, install Server v24.1 to a new folder C:\Serverv24.1. DO NOT start the newly installed Server.
  2. In the DOS window, switch to <install_root>\bin and run MigrationBV52 C:\Serverv580.
• Case 2: Installing Server v24.1 to the folder where the old version resides
  1. Assuming the old Server is in C:\Serverv580, install Server v24.1 to the same location. DO NOT start the newly installed Server.
  2. In the DOS window, switch to <install_root>\bin and run MigrationBV52.bat.

Back to top

Upgrading Server in an Integration Environment

1. Upgrade your standalone Server. In this step you need not convert the old version reports.
2. Back up the dbconfig.xml file in %REPORTHOME%\bin and in <UpgradedServer_install_root>\bin.
3. Copy the dbconfig.xml file in %REPORTHOME%\bin to replace the one in <UpgradedServer_install_root>\bin.
4. Create a self-contained WAR/EAR file jreport.war based on the upgraded Server. Make sure that the report home of the new jreport.war is the same as that of the previous jreport.war. Use -Dreporthome to specify the report home, for example:

   makewar.bat buildWar -Dreporthome=C:\LogiReport

   By default, the report home location is <user.home>/.jreport/default. If you changed it when creating the previous war, you can find it in jreport.war/WEB-INF/web.xml by jreport.rpthome:

   

5. Use your application server Administrative Console to undeploy the previous jreport.war and redeploy the new jreport.war.
6. Clear the temporary files or cached files on the Java application server. Take Tomcat as an example, remove the temp and work folders in D:\Tomcat.

If you want to change property values in server.properties in an integration environment after you upgrade Report Server to v18.2 or later, do as follows:

1. Make sure you do not start the upgraded Server after the upgrade.
2. Create a Report Server WAR, for example, jreport.war.
3. Create a file named install.server.properties.
4. Add the key and value pairs of the properties you want to change in install.server.properties.
5. Add install.server.properties in jreport.war\WEB-INF\lib\jrenv.jar\workspace\bin.
6. Deploy Report Server WAR to your application server.
7. Start your application server. Report Server will load the property values from install.server.properties, replace the values of the same properties in server.properties, and remove the install.server.properties file.

Back to top

Previous Topic  Next Topic