Upgrading Issues

Upgrading from previous versions to Version 7.1

When upgrading from previous version to V7.1, make sure that you have specified log4j-1.2.8.jar in your classpath running Report. This new jar is used for JReport logging systems to have a better formatted debug information. You can always get this jar file under the product's lib directory or the archive file.

Specifically,

For the products JReport Designer (jrpsetup.exe/jrpsetup.sh), JReport Enterprise Server (EntSvrSetup.exe/EntSvrSetup.sh), and JReport Viewer for JReport Enterprise Server (EntViewSetup.exe/EntViewSetup.sh), after installation, the extracted batch/script files for these three products have been updated already. The log4j-1.2.8.jar is under the %InstallRoot%\lib directory.

For the products Designer API (designAPISetup.exe), Server Designer API (svrdsgAPISetup.exe), Client API (EntViewSetup.exe/EntViewSetup.sh), and Server API (EntSvrSetup.exe/EntSvrSetup.sh), after installation, you can find log4j-1.2.8.jar under the %InstallRoot%\lib directory. Please add this jar to the classpath of your application calling the above products.

For the product JReport Client Viewer Bean, you can find log4j-1.2.8.jar in the following archive file: JREntVBean.zip, JREntVBeanSwing10.zip, JREntVBeanSwing11.zip. Please add this jar to the classpath of your application calling the Viewer Bean.

Upgrading to JReport Enterprise Server 7.0

If you choose to install JReport Enterprise Server 7.0 to the folder where the earlier version of JREntServer resides, or, you choose to install a fresh copy of JReport Enterprise Server 7.0, but still want to use the resources and reports on the previous version of JREntServer, these upgrading notes would guide you through the upgrading process.

The Migration Tool

There is a migration tool that comes with JReport Enterprise Server 7.0 under %JREntServerHome%\bin folder, which can help you to convert all the resources on the previouse version before version 6.0 of JREntServer.

File Name Description

MigrationBV52.bat The tool that converts all the resources on JREntServer whose version is lower than v5.2 build 590 to the resources of JREntServer V7. Provide the home path of the existing old version of JREntServer as the parameter. If you install the new version to the same folder and the old one, this parameter can be omitted.

Notes

You should not start JREntServer v7 after it is installed before resource conversion, otherwise resource conflicts may occur.
If the old version and the new version of JREntServer contains the same folder, such as AccessDemo, oojdbcDemo, and SybaseDemo (newly installed products contains only these three demo folders), after the conversion, only the content in the old version folder is available on JREntServer v7, say, the old folders override the new ones.
The resources the migration tool covers include the security information (realm, user, group, protection, and ACL), report resources (catalog, reports, and so on), scheduled tables, completed tables, version and version tables, and other relevant information (such as fonts nls, and style groups).

MigrationV52.bat The tool that converts all the resources on JREntServer whose version is between v5.2 build 590 (include 590) and v6 (not include) to the resources of JREntServer V7. The usage of this tool is the same as that of MigrationBV52.bat.

File Name	Description
MigrationBV52.bat	The tool that converts all the resources on JREntServer whose version is lower than v5.2 build 590 to the resources of JREntServer V7. Provide the home path of the existing old version of JREntServer as the parameter. If you install the new version to the same folder and the old one, this parameter can be omitted. Notes You should not start JREntServer v7 after it is installed before resource conversion, otherwise resource conflicts may occur. If the old version and the new version of JREntServer contains the same folder, such as AccessDemo, oojdbcDemo, and SybaseDemo (newly installed products contains only these three demo folders), after the conversion, only the content in the old version folder is available on JREntServer v7, say, the old folders override the new ones. The resources the migration tool covers include the security information (realm, user, group, protection, and ACL), report resources (catalog, reports, and so on), scheduled tables, completed tables, version and version tables, and other relevant information (such as fonts nls, and style groups).
MigrationV52.bat	The tool that converts all the resources on JREntServer whose version is between v5.2 build 590 (include 590) and v6 (not include) to the resources of JREntServer V7. The usage of this tool is the same as that of MigrationBV52.bat.

Upgrading the Resources Using the Migration Tool

As the way you install JReport Enterprise Server 7.0 may vary, the way you upgrade the resources might also be slightly different. Please follow the proper instructions according to your own case.

Case 1: I want to install JREntServer 7.0 to a new folder (Recommended)

If you want to install JREntServer 7.0 to a new folder, take the following steps:

Install JREntServer 7.0, DO NOT start the newly installed JREntServer.
In the DOS window, switch to %JREntServerHome%\bin, do one of the following:

If the old version is lower than v5.2 b590, run MigrationBV52.bat, using the home path of the existing old version of JREntServer as the parameter, for example,

MigrationBV52 C:\JREntServer580
If the old version is between v5.2 b590 (include b590) and v6.0 (not include), run MigrationV52.bat, using the home path of the existing old version of JREntServer as the parameter, for example,

MigrationV52 C:\JREntServer595

Case 2: I want to install JREntServer 7.0 to the folder where the old JREntServer resides

If you want to install JREntServer 7.0 to a folder that already contains an earlier version of JREntServer, take the following steps:

Install JREntServer 7.0, DO NOT start the newly installed JREntServer.
In the DOS window, switch to %JREntServerHome%\bin, do one of the following:

If the old version is lower than v5.2 b590, run MigrationBV52.bat.
If the old version is between v5.2 b590 (include b590) and v6.0 (not include), run MigrationV52.bat

Upgrading from previous versions to Version 6.0

If you choose to install JReport Enterprise Server 6.0 to the folder where the earlier version of JREntServer resides, or, you choose to install a fresh copy of JReport Enterprise Server 6.0, but still want to use the resources and reports on the previous version of JREntServer, these upgrading notes would guide you through the upgrading process.

There is a migration tool that comes with JReport Enterprise Server 6.0 under %JREntServerHome%\bin folder, which can help you to convert all the resources on the previouse version of JREntServer.

File Name Description

MigrationBV52toV6.bat The tool that converts all the resources on JREntServer whose version is lower than v5.2 build 590 to the resources of JREntServer V6. Provide the home path of the existing old version of JREntServer as the parameter. If you install the new version to the same folder and the old one, this parameter can be omitted.

Notes

You should not start JREntServer v6 after it is installed before resource conversion, otherwise resource conflicts may occur.

If the old version and the new version of JREntServer contains the same folder, such as AccessDemo, oojdbcDemo, and SybaseDemo (newly installed products contains only these three demo folders), after the conversion, only the content in the old version folder is available on JREntServer v6, say, the old folders override the new ones.

The resources the migration tool covers include the security information (realm, user, group, protection, and ACL), report resources (catalog, reports, and so on), scheduled tables, completed tables, version and version tables, and other relevant information (such as fonts nls, and style groups).

MigrationV52toV6.bat The tool that converts all the resources on JREntServer whose version is between v5.2 build 590 (include 590) and v6 to the resources of JREntServer V6. The usage of this tool is the same as that of MigrationBV52toV6.bat.

File Name	Description
MigrationBV52toV6.bat	The tool that converts all the resources on JREntServer whose version is lower than v5.2 build 590 to the resources of JREntServer V6. Provide the home path of the existing old version of JREntServer as the parameter. If you install the new version to the same folder and the old one, this parameter can be omitted. Notes You should not start JREntServer v6 after it is installed before resource conversion, otherwise resource conflicts may occur. If the old version and the new version of JREntServer contains the same folder, such as AccessDemo, oojdbcDemo, and SybaseDemo (newly installed products contains only these three demo folders), after the conversion, only the content in the old version folder is available on JREntServer v6, say, the old folders override the new ones. The resources the migration tool covers include the security information (realm, user, group, protection, and ACL), report resources (catalog, reports, and so on), scheduled tables, completed tables, version and version tables, and other relevant information (such as fonts nls, and style groups).
MigrationV52toV6.bat	The tool that converts all the resources on JREntServer whose version is between v5.2 build 590 (include 590) and v6 to the resources of JREntServer V6. The usage of this tool is the same as that of MigrationBV52toV6.bat.

Upgrading the Resources Using the Migration Tool

As the way you install JReport Enterprise Server 6.0 may vary, the way you upgrade the resources might also be slightly different. Please follow the proper instructions according to your own case.

Case 1: I want to install JREntServer 6.0 to a new folder (Recommended)

If you want to install JREntServer 6.0 to a new folder, take the following steps:

Install JREntServer 6.0, DO NOT start the newly installed JREntServer.

In the DOS window, switch to %JREntServerHome%\bin, do one of the following:

If the old version is lower than v5.2 b590, run MigrationBV52toV6.bat, using the home path of the existing old version of JREntServer as the parameter, for example,

MigrationBV52toV6 C:\JREntServer580

If the old version is between v5.2 b590 (include b590) and v6.0, run MigrationV52toV6.bat, using the home path of the existing old version of JREntServer as the parameter, for example,

MigrationV52toV6 C:\JREntServer595

Case 2: I want to install JREntServer 6.0 to the folder where the old JREntServer resides

If you want to install JREntServer 6.0 to a folder that already contains an earlier version of JREntServer, take the following steps:

Install JREntServer 6.0, DO NOT start the newly installed JREntServer.

In the DOS window, switch to %JREntServerHome%\bin, do one of the following:

If the old version is lower than v5.2 b590, run MigrationBV52toV6.bat.

If the old version is between v5.2 b590 (include b590) and v6.0, run MigrationV52toV6.bat