Deploying to IBM WebSphere 9.0.0.4
This topic introduces how to deploy Logi JReport Server Guide v15 Server to IBM WebSphere 9.0.0.4. 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:\Logi JReport\Server
instead of /opt/Logi JReport/Server
.
It is assumed that:
- WebSphere 9.0.0.4 is installed in the
/opt/IBM/WebSphere9.0.0.4/AppServer
directory. - The Logi JReport Server WAR file Logi JReport.war is located in the
/opt/Logi 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: Before creating the WAR, you need to modify the LogConfig.properties file in
/opt/Logi JReport/Server/bin
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.
- Change all the Logger levels from ERROR to trace.
- Remove the code
To deploy Logi JReport Server to IBM WebSphere:
- Copy Derby jars in
/opt/Logi JReport/Server/derby
to the/opt/IBM/WebSphere9.0.0.4/AppServer/lib
directory. - Start IBM WebSphere. Use the shell script
/opt/IBM/WebSphere9.0.0.4/AppServer/bin/startServer.sh <servername>
to start the server. The default server name is server1. - Access the WebSphere Administrative Console by using the URL:
http://hostname:9060/ibm/console
, where the hostname is host name or IP address, and 9060 is the port number. - The login requires user name and password.
- After successfully log in, expand the Applications node, select Application Types and then Websphere enterprise applications.
- Select Install.
- Select Browse to select the Logi JReport.war file, and then select Next.
- Keep selecting Next until you see the requirement for specifying context root.
- In the Context Root field, type a context path such as /Logi JReport/, then select Next.
- Select Finish on the Summary page. The installing process may take several minutes, wait until the process is completed.
- Select Save.
- Select Logi JReport.war and then select Start to start Logi JReport Server.
- Access Logi JReport Server using the following URL:
http://<hostname>:9080/Logi JReport/jrserver
http://<hostname>:9080/Logi JReport/admin/index.jsp
http://<hostname>:9080/Logi JReport/jinfonet/index.jsp
Troubleshooting
If you run into problems when using Logi JReport Server in IBM WebSphere, send the log files of Logi JReport Server to support@jinfonet.com. The following procedure illustrates how to generate the log files:
- Type -Dlogall=true in the Generic JVM arguments field. Go to Application servers > server1 > Process Definition > Java Virtual Machine to access this field.
- Restart the application server, and 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/WebSphere9.0.0.4/AppServer/profiles/AppSrv01/logs/server1/SystemErr.log.
Note: For WebSphere Application Server Liberty Profile V17.0.0.2, you need to do the following:
- Configure JNDI so as for the reporthome to be generated successfully. Add the following lines in server.xml located in
${WebSphere_home}/usr/servers/defaultServer
:<featureManager>
<feature>jndi-1.0</feature>
</featureManager> - Extract Logi JReport.war to
${wlphome}/usr/servers/defaultServer/dropins
and then start WebSphere Application Server Liberty Profile V17.0.0.1. In this way the sample reports will be able to run well.