Previous Page Next Page

Deploying to Tomcat 8.5.23

The example directory paths listed below are based on 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.5.23 is installed in the /opt/apache-tomcat-8.5.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.

  Note: When unpackWARs="false" is set in server.xml in the conf folder of Tomcat, you need to do the following:

  1. Modify the LogConfig.properties file in /opt/JReport/Server/bin before creating the WAR as follows:
     • Remove the code packages = com.jinfonet.util.
     • Change JRRollingFileAppender to RollingFile all over the file.
     • Change JRPatternLayout to PatternLayout all over the file.
  2. Add the parameter -Djbossas7=true when launching makewar.bat/.sh to build the WAR, for example:

     makewar.bat -Djbossas7=true

  3. Move log4j-api-2.7.jar and log4j-core-2.7.jar from jreport.war > WEB-INF > lib to the lib folder of Tomcat.

To deploy JReport Server to Tomcat 8.5.23:

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

Previous Page Next Page