Installing the BIRT Report Designer to work with web reports

Before you can modify or create reports using the BIRT Report Designer, you must perform the following high-level steps:

1. Download version 4.8.0 of the BIRT Report Designer.
2. Copy three BMC Remedy AR System plug-ins into their proper location.
3. Specify the BIRT library and template location in the BIRT Report Designer.

To download and open the BIRT Report Designer

1. Download the RCP Designer version of the BIRT Report Designer..
2. Extract the BIRT Report Designer zip file to a destination directory (BIRTInstallDir).
   For example, if you extract the zip file to c:\birtdesigner48 folder, the BIRTInstallDir is c:\birtdesigner\birt.
3. To open the BIRT Report Designer application, click the BIRT.exe file.

To copy BMC Remedy AR System plug-ins for use with BIRT

1. Go to the BIRTInstallDir/plugins folder.

2. Copy and paste the following plug-ins from your mid-tier plugins directory (MidTierInstallDir/WEB-INF/platform/plugins) to BIRTInstallDir/plugins:

   com.bmc.arsys.oda.designtime_versionNumber.buildNumber.jar
   com.bmc.arsys.oda.runtime_versionNumber.buildNumber.jar
   com.bmc.arsys.studio.api_versionNumber.buildNumber.jar

3. Modify the BIRTInstallDir/configuration/config.ini file, and then add the following bundles in osgi.bundles property at the end:
   
   com.bmc.arsys.oda.designtime_versionNumber.buildNumber.jar
   com.bmc.arsys.oda.runtime_versionNumber.buildNumber.jar
   com.bmc.arsys.studio.api_versionNumber.buildNumber.jar
   
   For example, after adding these bundles the osgi.bundles property looks as follows:
   osgi.bundles=reference….

   osgi.bundles=reference\:file\:org.eclipse.equinox.simpleconfigurator_1.3.0.v20180502-1828.jar@1\:start,com.bmc.arsys.oda.designtime_9.1.10.build009.jar@start,com.bmc.arsys.oda.runtime_9.1.10.build009.jar@start,
   com.bmc.arsys.studio.api_9.1.10.build009.jar@start
4. In the BIRTInstallDir directory, launch the BIRT.exe file.
   The BIRT Report Designer application opens.

If the datasource is not displayed after configuring BIRT Designer, see the knowledge article BIRT Designer - Remedy AR System Server BMC datasource is not appearing in BIRT after following directions.

Where to go from here

Enabling-BIRT-to-access-your-AR-System-data-by-setting-BIRT-preferences

Creating-a-new-web-report-with-the-BIRT-Report-Designer