Apache Tomcat 4.0 Sample Modified 06/09/04

(1)

(2)

Disclaimer

Dynalivery Corporation provides sample source code, screencam movies, and other documentation only as aids for learning specifically about our Harmoni Server while providing a general overview of Web Reporting.

These materials are subject to change without notice. We provide them on an "as is" basis without warranty.

Please do not treat them as production quality components to use within your own application without your own comprehensive testing.

Dynalivery recommends that its customers establish separate development, test, and production environments and promote applications and report/ document templates step by step as they prove themselves in each environment, under conditions of realistic test data, network load, database load, and report/ document concurrency.

In addition, Dynalivery recommends that Harmoni be evaluated and operated on server computers that match or exceed the hardware specifications in our Installation Guide and with staff that have experience with the Seagate Crystal Reports Designer or Microsoft Word, Microsoft Windows network administration, and SDK level programming in the Web Application Server with which they are using Harmoni.

(4)

Release Notes

Sample Features

To see what Crystal Reports features are in the Dynalivery downloadable samples please go to this link:

http://www.dynalivery.com/customersupport/faq/Sample_Features.html

Output Types

PDF and SVG Output

Adobe Acrobat Reader and SVG Viewer are needed to view .pdf and .svg output types. Acrobat Reader and SVG Viewer are available free at http://www.adobe.com/.

Excel and Word Output

(5)

- 5 -

Harmoni ver 1.0

Installation Instructions

Apache Tomcat 4.0

This sample has been written and tested based on Apache Tomcat 4.0 and J2SDK 1.4. Other versions of Tomcat and/or Java may not work with this sample.

Installation prerequisites

Before installing and running the sample, please review the Data Source Setup Guide and make sure the DSNs have been configured prior to running the sample.

The instructions assume you have unzipped the Apache Tomcat 4.0.zip bundle that is available fromhttp://jakarta.apache.org/tomcat.

1) Set the JAVA_HOME environment variable to refer to the JDK installation directory.

2) Make sure the CATALINA_HOME environment variable points to the Tomcat installation directory. 3) Replace the <Path_to_Tomcat>\common\lib\tools.jar file with the tools.jar file in the

<Path_to_JDK>\lib\tools.jar directory.

4) Copy the TomcatSample folder to <path_to_Tomcat>\webapps directory.

5) Please copy these jar files to the <path_to_Tomcat>\webapps\TomcatSample\WEB-INF\lib folder from the <<path_to_Dynalivery>>\Harmoni\Jars directory:

HarmoniJavaClient_JDK1.4.jar HarmoniJavaClient_JDK1.4Stubs.jar

6) Start the server by running the <path_to_Tomcat>\bin\startup.bat batch file.

Run the Sample

Please review the Data Source Setup Guide and make sure the DSNs have been configured prior to any attempt at running the sample.

The following changes should be made to the sample.config file:

Edit the <path_to_TomcatSample>\config\sample.config file to make the following changes: 1. Replace the server name value with the full DNS name of the Harmoni server machine. 2. Make sure that the value for outputDir correctly matches the path to where you have installed

the Tomcat server.

3. Make sure that the value for imageDir correctly matches the path to where you have installed the Tomcat directory.

(6)

5. Make sure that the value for DORfile.location states the correct path of the <<Path_To_ TomcatSample>>\dor\DORDataFile.dat file.

If you are accessing a password-protected database, modify the user name and password. If your server is running locally, you can click on the following link to run the sample

http://localhost:8080/TomcatSample/web/index.html. Otherwise, modify the URL to reference the server machine. When running this sample, you will be prompted for a config directory. Supply the directory where the sample.config file exists: <path_to_Tomcat>\webapps\TomcatSample\config\sample.config.

Report Concatenation

Multiple reports can now be automatically concatenated and displayed within a single run of Harmoni Engine to generate a single document in Saffron PDF, Html, RTF, SVG, PNG and JPG formats.

Important: Concatenation of reports works only with Saffron PDF, HTML, RTF and SVG output types.

Load Balancing

For detailed information on Load Balancing please review the “Load Balancing Guide to Installation and Configuration.” It can be found at the link below on our website.

To test load balancing, you must modify the

<path_to_Tomcat>\webapps\TomcatSample\Prop\harmoni.properties file

to contain all of the machine names in the load-balancing channel. Add the directory where your harmoni.properties file resides to the Tomcat CLASSPATH. This is specified in

<path_to_Tomcat>\bin\catalina.bat file.

(e.g. set CLASSPATH=%CLASSPATH%;%CATALINA_HOME%\bin\bootstrap.jar; <path_to_Tomcat>\webapps\TomcatSample\Prop\harmoni.properties).

You will need to restart the server after the CLASSPATH is modified.