Previous Topic  Next Topic

Deploying to Tomcat 9.0.24

This topic introduces how to deploy Logi JReport Server to Tomcat. 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 9.0.24 is installed in the /opt/apache-tomcat-9.0.24 directory.
• The Logi 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 Logi 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.9.1.jar and log4j-core-2.9.1.jar from jreport.war > WEB-INF > lib to the lib folder of Tomcat

To deploy Logi JReport Server to Tomcat 9.0.24:

1. Ensure that Tomcat is shut down.
2. Copy the Web Application Archive jreport.war to /opt/apache-tomcat-9.0.24/webapps.
3. When running on Java 9 you will need to additionally add the arguments that are listed in java.option located in $REPORTHOME/bin to Catalina.sh in $CATALINA_HOME/bin.
4. Start Tomcat by running the script file startup.sh.
5. Access Logi JReport Server using the following URLs:

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

Troubleshooting

If you run into problems when using Logi JReport Server in Tomcat, send the log files of Logi 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-9.0.24/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 Logi 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-9.0.24/logs/catalina.out.

Previous Topic  Next Topic