### Deploying to Tomcat 8.0.23

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, that is, `C:\JReport\Server` instead of `/opt/JReport/Server`.

It is assumed that:

- Tomcat 8.0.23 is installed in the `/opt/apache-tomcat-8.0.23` 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 8.0.23:

1. Ensure that Tomcat is shut down.
2. Copy the Web Application Archive jreport.war to `/opt/apache-tomcat-8.0.23/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-8.0.23/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-8.0.23/logs/catalina.out.`