Deploying to JBoss 5.0.1

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 JBoss 5.0.1:

  1. Ensure that JBoss is shut down by running the script /opt/jboss/bin/shutdown.sh -S.
  2. Remove the two files xercesImpl.jar and xml-apis.jar from jreport.war since they conflict with JBoss. They are located in jreport.war\WEB-INF\lib.
  3. Unzip jreport.war and name the unzipped folder as jreport.war, then copy the folder to /opt/jboss/server/default/deploy.
  4. Start JBoss by running the run.sh script.
  5. Access JReport Server using the following URLs:

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

Troubleshooting

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

  1. Modify the file run.sh in /opt/jboss/bin.

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

    "$JAVA" $JAVA_OPTS \ 
    -classpath "$JBOSS_CLASSPATH" -Dreporthome=/opt/JReport/Server \ 
    -Dlogall=true  \ 
    org.jboss.Main "$@"
  2. After editing run.sh, start JBoss using the modified file.
  3. After reproducing the problem, send support@jinfonet.com the log files in reporthome/logs.

    The JBoss log files may also help to identify the problem. The most useful one is /opt/jboss/server/default/log/server.log.

Notes: