.:Documentation and tutorials
 Project page
Vote for iReport on O'Reilly's OSDir.com

<< Previous   |   Next >>   |   Table of Contents
2 Installing iReport

iReport comes as a zip archive. It contains the main distribution files (classes and source), some templates for wizard, all additional required jars.
2.1 System Requirements

You'll need several things to get started with iReport:
  • Sun JDK 1.4 or greater
  • Ant (required if you want recompile sources, but strongly reccomended to lunch iReport too)
  • JasperReports 0.4.6 (*)
  • SAX 2.0 XML Parser (Apache Xerces 1.3 or later recommended) (*)
  • Jakarta Commons Digester Component (version 1.1 or later) (*)
  • Jakarta Commons BeanUtils Component (version 1.1 or later) (*)
  • Jakarta Commons Collections Component (version 1.0 or later) (*)
  • Jakarta Commons Logging Component (version 1.0 or later) (*)
  • JDBC 2.0 Driver (A MySql driver is already included) (*)
  • iText - Free Java-PDF library by Bruno Lowagie and Paulo Soares (*)
  • Jakarta POI (version 1.5.1 or later) (*)
  • JFreeChart (version 0.9.8 or later) (*)
  • Acrobat Reader 5.0 is not required, but strongly recommended.
  • If you think to use Chinese Simplified, Chinese traditional, Japanese and Korean characters, you must download the Asian font pack from Adobe at: http://www.adobe.com/products/acrobat/acrrasianfontpack.html or use a localized Windows.
  • If you want connect to a database, you must provide a JDBC driver (not shipped with iReport).

(*) a jar of this software is already included in the lib directory of iReport distribution, so you have not to download it.
Note that for now JFreeChart is used to generate charts. This can be change. I'm evaluating JCharts, another OpenSource charting library. It's possible that in future iReport will support both this libraries trought an abstract layer.

2.2 Installation and configuration

If you have already installedon your machine a jdk (not simply a Java Runtime Enviroment, but a Java Development Kit) we are ready to start...

1. Unzip iReport-x.x.x.zip and copy the extracted directory where you want.
2. Look for a file called tools.jar in your jdk and copy it in the lib directory of iReport.

If you have Ant installed on your machine, modify the file iReport.bat or iReport.sh to adjust the ant installation path (default is c:\ant under Win32 and /ant under Linux).
3.Start iReport.bat or iReport.sh.

If you don't have Ant installed (olny for win32 users), go to the directory noAnt and type:

At the first execution, iReport will create a directory (.ireport) in your home directory. Here will be stored all configuration files.
iReport use XML files for configuration.
***This files are not compatible with old 0.1.0 properties files***.
At startup all jars in the iReport lib directory are added to the classpath.
If you want use TTF Font files installed on your system, add to the classpath your fonts directory. iReport comes with an own fonts directory automatically added to the classpath.
Started iReport...

1. go to menu->Tools->Options
2. go to tab external programs
3. set external viewers programs

Fig.2.1: The external programs options tab.

2.3 Final test...

Ok, try if the configuration is ok....
Create a new blank report. Click on the iReport "Run without connection" button
After few seconds will appeare our pdf opened with the program that we have set, as signal that all is OK.

<< Previous   |   Next >>   |   Table of Contents

(c) 2002 by Giulio Toffoli <gt78 at businesslogic.it>