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:

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.