Deploying to Tomcat 7.0.27

The example directory paths listed below are based on Solaris or Linux (referred to as Unix). The instructions are applicable to both Unix and Windows installations; however, the format of the paths for Windows would use the Windows format, i.e. C:\JReport\Server instead of /opt/JReport/Server.

It is assumed that:

• Tomcat 7.0.27 is installed in the /opt/apache-tomcat-7.0.27 directory.
• The JReport Server WAR file jreport.war is located in the /opt/JReport/Server/bin/distribute directory. To create the WAR file refer to the instructions in Building a WAR/EAR file to include a self-contained JReport Server.

To deploy JReport Server to Tomcat 7.0.27:

1. Ensure that Tomcat is shut down.
2. Copy the Web Application Archive jreport.war to /opt/apache-tomcat-7.0.27/webapps.
3. Start Tomcat by running the startup.sh script.
4. Access JReport Server using the following URLs:

   http://hostname:8080/jreport/jrserver
http://hostname:8080/jreport/admin/index.jsp
http://hostname:8080/jreport/jinfonet/index.jsp

Troubleshooting

If you run into problems when using JReport Server in Tomcat, send the log files of JReport Server to support@jinfonet.com. The following procedure illustrates how to generate the log files:

1. Modify the catalina.sh file in /opt/apache-tomcat-7.0.27/bin.

   In the file catalina.sh, add -Dlogall=true after the reporthome definition:

   JAVA_OPTS="-Dreporthome=/opt/JReport/Server -Dlogall=true" Cygwin=false

   Or if no reporthome is specified, add as follows:

   JAVA_OPTS=-Dlogall=true Cygwin=false

2. After editing catalina.sh, start Tomcat.
3. To get the information about the JReport Server environment, you can access http://hostname:8080/jreport/admin/info.jsp?cmd=info.
4. Save the output to a file.
5. After reproducing the problem, send support@jinfonet.com the log files in reporthome/logs.

   The Tomcat log files may also help to identify the problem. The most useful one is /opt/apache-tomcat-7.0.27/logs/catalina.out.