Skip to main content

Notice: This Wiki is now read only and edits are no longer possible. Please see: for the plan.

Jump to: navigation, search


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 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="">
<dep:environment xmlns:dep="">

Modification to web.xml

<?xml version="1.0" encoding="UTF-8"?> 
<web-app version="2.4" xmlns=""

Back to the top