Previous Topic

Book Contents

Book Index

Next Topic
Configure the Birt Report Server

The web.xml file can be found in '...\webapps\vmweb\WEB-INF\' in the Tomcat folder.

The comment signs for the following BIRT Parametes must be removed or the parameters must be set in the vmconfig.ini file.

  • BIRT_HOME
  • BIRT_REPORTING_URL
  • BIRT_REPORTING_ABSOLUTE_PATH
  • BIRT_RESOURCE_FOLDER
  • BIRT_EXTERNAL_PRINT_SERVER
Parameter BIRT_HOME

This parameter is mandatory if you want to use the Birt Report Engine.

The parameter must point to the directory of the Birt runtime's 'ReportEngine' directory. This directory contains the 'lib' directory where the dependent jars of the Birt runtime are located. These jars are loaded during initializing of the birt report engine.

Windows:

<init-param>
    <param-name>BIRT_HOME</param-name>
    <param-value>C:\birt-runtime-2_6_2\ReportEngine</param-value>
</init-param>

Linux:

<init-param>
    <param-name>BIRT_HOME</param-name>
    <param-value>/usr/local/birt-runtime-2_6_2/ReportEngine</param-value>
</init-param>

Parameter BIRT_REPORTING_URL

The parameter defines which url is used to display the reports. It can be a relative directory in the $VMWEB_HOME or you can set a complete URL if it is used as print server.

<init-param>
    <param-name>BIRT_REPORTING_URL</param-name>
    <param-value>http://192.168.1.105:8080/vmweb/reporting/</param-value>
</init-param>

Parameter BIRT_REPORTING_ABSOLUTE_PATH

This parameter should point to the absolute path where the parameter BIRT_REPORTING_URL points to.

<!-- ABSOLUTE PATH -->
<!-- Should point to the BIRT_REPORTING_URL -->
<init-param>
    <param-name>BIRT_REPORTING_ABSOLUTE_PATH</param-name>
    <param-value>$VMWEB_HOME/reporting/</param-value>
</init-param>

Parameter BIRT_EXTERNAL_PRINT_SERVER

This parameter is optional. You can define if the Valuemation Web Server is used as an external print server. For a Birt Report Server the parameter has to be true.

<init-param>
    <param-name>BIRT_EXTERNAL_PRINT_SERVER</param-name>
    <param-value>true</param-value>
</init-param>

Parameter BIRT_RESOURCE_FOLDER

<!-- Point to resource folder in translation cache -->
<init-param>
<param-name>BIRT_RESOURCE_FOLDER</param-name>
<param-value>crystalreports</param-value>
</init-param>

Possible settings of the web.xml parameter BIRT_RESOURCE_FOLDER:

  • parameter not used (in comments) >> resource path folder is botranslations (default)
  • parameter defined with empty String >> resource path folder is the translation cache directory
  • parameter defined with folder name, e.g. crystalreports>>the resource files are in this subfolder of the translation cache directory