Birt WAS CE

BIRT WebSphere Community Edition (Apache Geronimo) Deployment

This entry explains how to deploy the WebViewerExample contained in the BIRT 2.1.1 runtime as a war file using WAS CE, Version 1.1.

---

Modify the birt.war file from the BIRT 2.1.1 runtime

• Download the BIRT 2.1.1 runtime
• Unzip the birt-runtime-2_1_1.zip file.
  • The birt.war file will appear in the directory you just unzipped the zip file to.
• Expand the birt.war file, for example, jar -xvf birt.war.
• cd to the WEB-INF directory and create a geronimo-web.xml file, a sample geronimo-web.xml file is shown below.
• Edit the web.xml file with a different schema, by changing the web-app element to the one shown below.
• Now the birt.war file is ready to be remade again. Go to the directory where you unzipped the birt-runtime zip file and issue this command to recreate the birt.war file;
  • jar -cvf WebViewerExample.war index.jsp test.rptdesign test1.rptdesign webcontent/* WEB-INF/*

---

Deploying the war file to WAS CE

• Once you start up the server go to the console: http://<server_name>:8080/console/
• Select the Applications >> Deploy New link in the left frame
  • Now Browse to the WebViewerExample.war file using the Browse button next to the Archive text field, and click the Install button.
• Go to this URL in another browser to test it: http://<server_name>:8080/WebViewerExample/

---

Example geronimo-web.xml for WAS 6.0.1

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://geronimo.apache.org/xml/ns/j2ee/web-1.1">
<dep:environment xmlns:dep="http://geronimo.apache.org/xml/ns/deployment-1.1">
<dep:moduleId>
<dep:groupId>geronimo</dep:groupId>
<dep:artifactId>WebViewerExample</dep:artifactId>
<dep:version>1.1</dep:version>
<dep:type>war</dep:type>
</dep:moduleId>
</dep:environment>
<context-root>/WebViewerExample</context-root>
</web-app> 

---

Modification to web.xml

<?xml version="1.0" encoding="UTF-8"?> 
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"> 
...