Running with WebLogic (v8.1) on Win XP
The steps to integrate JReport Enterprise Server with WebLogic V8.1 on Windows NT or Unix are very similar. Here we take integrating with WebLogic 8.1 on NT as an example.
Assuming that,
* WebLogic 8.1 has been installed to E:\bea\weblogic81.
* JReport Enterprise Server has been installed to E:\JREntServer.
Please take the following steps to integrate JREntServer into Weblogic8.1:
Creating User Projects
1. Click Start --> Programs --> BEA Weblogic Platform8.1(BEAHOME1) --> Configuration Wizard (you can also run the cmd file E:\bea\weblogic81\common\bin\config.cmd).
2. On the dialog, choose "Create a new Weblogic configuration", click Next.
3. Select "Basic Weblogic Server Domain", using the default path for the template location, click Next.
4. Make sure the "Express" option is selected, click Next.
5. Enter the User Name and Password. If the user is the default administrator, the password should be more than 8 characters. Click Next.
6. Choose "Development Mode" and a Java SDK (Sun SDK is recommended), click Next.
7. Use the default path and name of "Configuration Location and Domain Name", click Create to create a User Project.
8. Click Done to complete the process of User Projects¡¯ creation.
Now we can administrate the weblogic server by access
http://localhost:7001/console
if the weblogic server is running.
Creating a War File
1. Create a new directory in your local disk. e.g. D:\servlet.
2. Create a sub directory "WEB-INF" under it: D:\servlet\WEB-INF.
3. Generate a web.xml as follows and put it under D:\servlet\WEB-INF.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN"
"http://java.sun.com/j2ee/dtds/web-app_2_2.dtd">
<web-app>
<servlet>
<servlet-name>jrserver</servlet-name>
<servlet-class>jet.server.servlets.JRServlet</servlet-class>
<init-param>
<param-name>reporthome</param-name>
<param-value>E:\JREntServer</param-value>
</init-param>
</servlet>
<servlet>
<servlet-name>sendfile</servlet-name>
<servlet-class>jet.server.servlets.SendFileServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>jrserver</servlet-name>
<url-pattern>/jrserver/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>sendfile</servlet-name>
<url-pattern>/sendfile/*</url-pattern>
</servlet-mapping>
Notes:
* If you are scheduling to export a report to DHTML format, please add the following lines into the file above:
<servlet>
<servlet-name>dhtml</servlet-name>
<servlet-class>jet.web.dhtml.DHTMLlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>dhtml</servlet-name>
<url-pattern>/dhtml/*</url-pattern>
</servlet-mapping>
<servlet>
<servlet-name>help</servlet-name>
<servlet-class>jet.web.dhtml.JHelplet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>help</servlet-name>
<url-pattern>/help/*</url-pattern>
</servlet-mapping>
<servlet>
<servlet-name>jrdhtml</servlet-name>
<servlet-class>jet.web.dhtml.DHTMLRunReportlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>jrdhtml</servlet-name>
<url-pattern>/jrdhtml/*</url-pattern>
</servlet-mapping>
* If you want to support start/stop/restart report server in integration environment, please add the following lines to the XML code above. (Note : This feature is based on Servlet2.3 specification. The <listener> part should be ahead to the <servlet> part.)
<listener>
<listener-class>
jet.server.servlets.JRServerContextListener
</listener-class>
</listener>
4. Create a directory lib under D:\servlet\WEB-INF.
5. Copy the class file JREngine.jar, hsqldb.jar, tar.jar, JRESServlets.jar, log4j-1.2.8.jar, xerces.jar and JRWebDesign.jar from E:\JREntServer\lib to D:\servlet\WEB-INF\lib.
Notes:
* If you are scheduling a report to export to the following formats, you should copy the corresponding class package or jar under E:\JREntServer\lib to D:\servlet\WEB-INF\lib:
1. To Mail or use the "Mail Notification" function: activation.jar and mail.jar.
2. To PDF & DHTML: Itext.jar.
3. To Excel: poiHSSF_151.jar.
4. To XML: xerces.jar.
5. To DHTML: JRWebDesign.jar.
* If you are using DHTML tag libraries, please also add the following jar to D:\servlet\WEB-INF\lib: taglib.jar.
6. Copy the folders jinfonet, admin, and dhtmljsp (with their sub-folders) from E:\JREntServer\public_html to D:\servlet.
7. Using the following command to create a WAR file and name it as "servlet.war":
jar -cvf servlet.war jinfonet admin dhtmljsp WEB-INF
Uploading and Deploying War file to Weblogic Server
Please take the following steps:
1. Access
http://localhost:7001/console using the user name and password that we just created.
2. Click "Web Application Modules" under "Domain Configurations" "Your Deployed Resources".
3. Then in next webpage, click "Deploy a new Web Application Module..." .
4. Click "Upload your file(s)" to upload the servlet.war file, the uploaded servler.war file will be saved in E:\bea\user_projects\domains\mydomain\myserver\upl oad (if you don¡¯t change the default settings during the process of User Projects creation.)
5. After uploading the war file, click myserver --> upload, then pick the servlet.war file, click "Target Module", then click "Deploy" to deploy the servlet.war file to server.
Modifying the server.properties and redirect.properties
Open the file server.properties under E:\JREntServer\bin, and modify the properties to:
jsp.webapp.sendfile=/servlet/sendfile
web.design_servlet_path=/servlet/webreporting
web.dhtml_servlet_path=/servlet/dhtml
web.jreport_servlet_path=/servlet/jrserver
web.dhtml_servlet_entry_path=/servlet/jrdhtml
web.dhtml_jsp_path=/servlet/dhtmljsp
Note: If you want to view report in DHTML format, please modify the property
web.newwindow.same_name= true
Modify the property in redirect.properties under E:\JREntServer\bin, it is:
jsp_path=/servlet/jinfonet/
Set JREntServer's reporthome
Modify the command script: E:\bea\user_projects\domains\mydomain\startWebLogi c.cmd
"%JAVA_HOME%\bin\java" %JAVA_VM% %MEM_ARGS% %JAVA_OPTIONS% -Dweblogic.Name=%SERVER_NAME% -Dweblogic.management.username=%WLS_USER% -Dweblogic.management.password=%WLS_PW% -Dweblogic.ProductionModeEnabled=%PRODUCTION_MODE% -Djava.security.policy="%WL_HOME%\server\lib\weblog ic.policy" -Dreporthome=E:\JREntServer weblogic.Server
Now, we can access JReport Enterprise Server from web browser (The default port of WebLogic is 7001) using:
http://localhost:7001/servlet/jrserver
Access JSPs using:
http://localhost:7001/servlet/jinfonet/index.jsp
http://localhost:7001/servlet/admin/index.jsp