Contents Apache Tomcat 4.0 Sample DISCLAIMER... 3 RELEASE NOTES... 4 SAMPLE FEATURES... 4 RELATED TOPICS... 4 Load Balancing... 4 Data Source Setup Guide... 4 File Return... 4 Java API... 4 OUTPUT TYPES... 4 PDF and SVG Output... 4 Excel and Word Output... 4 INSTALLATION INSTRUCTIONS... 5 APACHE TOMCAT 4.0... 5 Installation prerequisites... 5 RUN THE SAMPLE... 5 REPORT CONCATENATION... 6 LOAD BALANCING... 6 UNINSTALL THE SAMPLE... 6-2 -
Disclaimer Apache Tomcat 4.0 Sample 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. - 3 -
Release Notes Apache Tomcat 4.0 Sample 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 Related Topics Load Balancing http://www.dynalivery.com/products/harmoni/harmonidoc.html Data Source Setup Guide http://www.dynalivery.com/products/harmoni/harmonidoc.html File Return http://www.dynalivery.com/customersupport/faq/filereturn.html Java API http://www.dynalivery.com/products/parallelcrystal/parallelcrystaldoc.html#2.7.2_3.7.2 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 Microsoft Word and Excel are needed to view.doc and.xls output types. - 4 -
Apache Tomcat 4.0 Sample 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. 4. Replace localhost in the value for outputurl with your machine's full DNS name. - 5 -
Apache Tomcat 4.0 Sample 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. http://www.dynalivery.com/products/harmoni/harmonidoc.html 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. Uninstall the Sample To uninstall the sample, stop the server and delete the TomcatSample directory. - 6 -