Deploying to IBM WebSphere 5.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:

• WebSphere 5.1 is installed in the /opt/IBM/WebSphere/AppServer directory.
• The JReport Enterprise 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 Enterprise Server.

To deploy JReport Enterprise Server to IBM WebSphere 5.1:

1. Start IBM WebSphere 5. Use the shell script /opt/IBM/WebSphere/AppServer/bin/startServer.sh <servername> to start the server. The default server name is server1.
2. Open the Administrative Console in your web browser. Open the URL: http://hostname:9090/admin/, where the hostname is host name or IP address, and 9090 is the port number. The 9090 port is the default for UNIX installations although it may be different on your installation.
3. To login, create a User ID that contains only letters and numbers. It can be any ID that you want use to identify your changes such as admin.
4. After successfully logging in, expand the Applications node, and then click Install New Application.
5. Click Browse to select your WAR file. Then in the Context Root field, type a context path such as /jreport/. Then click Next.
6. Do not check any option on this page. Click Next.
7. Do not be concerned about the security options warning. Click Continue.
8. Type JREntServer in the Application Name field. Leave the Pre-compile JSP option unchecked. Then click Next.
9. Do not make any changes to the next two pages.
10. In the Summary page, click Finish to complete the wizard. The installing process may take several minutes. Wait until the process has completed.
11. After the installation process has successfully completed, in the pop-up dialog, click the Save to Master Configuration link.
12. Click Save.
13. Access JReport Enterprise Server using the following URLs:

    http://<hostname>:9080/jreport/jrserver
http://<hostname>:9080/jreport/admin/index.jsp
http://<hostname>:9080/jreport/jinfonet/index.jsp

Troubleshooting

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

1. Type -Dlogall=true in the Generic JVM arguments field. Go to Application servers > server1 > Process Definition > Java Virtual Machine to access this field.
2. Restart the application server, and then try to reproduce the problem. After reproducing the problem, send support@jinfonet.com the log files in reporthome/logs.

   The WebSphere log files may also help to identify the problem. The most useful one is in /opt/IBM/WebSphere/AppServer/logs/server1/SystemErr.log.