The instructions below describe how to deploy a PEERNET Reports project to the PEERNET Reports Server. Note that, if you are using the PEERNET Reports Embedded Engine directly, your deployment method will be similar, but it will be based on how you have embedded the product into your application.

 

PEERNET Reports Server is a Web Application, and should be installed using the default name PEERNETReportsServer3. In the webapps folder you will see a PEERNETReportsServer3 folder, and it will feature the following structure:

 

PEERNETReportsServer3

 \applet

 \images

 \META-INF

 \WEB-INF

         \classes

         \lib

         \projects

                 \examples

                         \labels

                         \Northwind

                 \fonts

 

In the base PEERNET Reports for J2EE installation an evaluation environment has been provided for PEERNET Reports Server using the Java Application Server tomcat. The webapps folder will be at <installdir>\PEERNETReports3.0\jakarta-tomcat-3.3.1\webapps on a Windows platform, or at <installdir>/PEERNETReports3.0/jakarta-tomcat-3.3.1/webapps on the other supported platforms.

There are two key folders in the WEB-INF folder: projects and fonts. To deploy a PEERNET Reports project, you must copy the project (PNJ) file to the projects folder.  You might also need to copy any TrueType font files referenced by your reports or labels to the fonts folder. On a Windows platform, this is not a requirement if PEERNETOS2Extension.dll has been added to the PATH variable during the startup of the Java Application Server. Note that, in the base installation, we do not add the PEERNETOS2Extension; this is to demonstrate the requirement that fonts must be copied to the fonts folder.

 

From the PEERNET Reports Server Web Application home page (which is located at the address of http://<webserver>:<port>/PEERNETReportsServer3/index.htm), you can retrieve a list of the deployed projects, and also retrieve a list of the fonts available for use by any deployed project.   For the base installation, once you have started the J2EE Server, you can access the home page at http://localhost:8080/PEERNETReportsServer3/index.htm or http://127.0.0.1:8080/index.htm (use this link if the localhost link fails). Instructions for starting the J2EE Server can be found below.

 

Note: Starting the J2EE Server will cause a new window to be opened in which the server will run; do not close this window or you will shut down the server.