Deploying to WebLogic 8.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:

• WebLogic 8.1 is installed in the /opt/BEA directory. This is referred to as BEA_HOME in the WebLogic documentation.
• 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 BEA WebLogic 8.1:

1. If you have not already created a WebLogic Domain for JReport Enterprise Server you must create one before starting the integration.
2. Start WebLogic by executing the script /startWebLogic.sh. You will be prompted for the login and password you created such as Username weblogic and Password weblogic. You should see a message that the server started in RUNNING mode and that it is listening on port 7001.
3. Open the Administrative Console in your web browser. Open the URL: http://hostname:7001/console/, where the hostname is host name or IP address, and 7001 is the port number. The 7001 port is the default although it may be different on your installation. The port number was specified when you created your WebLogic domain.

   To login, use a user with the Administrator role. If you didn't change the default for the domain it is Username weblogic and Password weblogic.

4. After successfully logging in, expand the Deployments node, and then select Web Application Modules.
5. Click the Deploy a new Web Application Module link.
6. Select the upload your file(s) link.
7. Click Browse to select your WAR file. Then click the Upload button.
8. Select the checkbox on jreport.war, and then click the Target Module button.
9. The Identity Name is the JReport Servlet Context. By default it is the name of the WAR file. The remaining instructions assume that you do not modify this. Select Deploy to complete the deployment.
10. Once the status says Success you are ready to test your deployment. You can do this simply by selecting the Testing tab.
11. Select the link for jreport, and then a new web browser window will be launched with JReport Enterprise Server.
12. Access JReport Enterprise Server using the following URLs:
    

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

Troubleshooting

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

1. Add -Dlogall=true on the same line as -Dreporthome in the startWebLogic.sh shell script.
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 WebLogic log file may also help to identify the problem. It is /opt/BEA/user_projects/domains/reporting/reporting.log.