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

It is assumed that:

• JBoss 5.0.1 is installed in the /opt/jboss 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 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.