Introduction - Developer Installation Guide


In order to participate in the development of this project, you will have to make some adjustments to your system.

This document explains the necessary adjustments to your development environment and how to implement them.

Description of the project:
AgilPro is a cooperation project between the eMundo GmbH and the working group Programming of Distributed Systems of the University of Augsburg, Germany. The goal of this project is the development of a tool which enables the modeling of business processes.

With the AgilPro LiMo (Light Modeller) you can represent your specific business processes. Apart from modeling process flows and user roles you can associate applications with each action (depending on the available adapters, e.g. for the Internet Explorer). The created process model file (file extension.agilpro) can then be started with the AgilPro Simulator and the process flow can be simulated with "real" applications.

If you have further questions or want to report an error you can contact us by email at support@agilpro.de.






Table of Contents





1. Installation Requirements

1.1. Quick Start

If you are in a hurry and want to get the program up and running right away, here is a short description of the required configuration:

  • Eclipse 3.2 Calisto WTP
  • Eclipse Plugins:
       EMF v.2.2.0 or newer
       GEF v.3.2.1 or newer
       Subclipse v.1.0.3 or newer
       ANTLR Delta Pac
  • Java Sun JDK 1.5.0_09
  • Subversion: https://svn.sourceforge.net/svnroot/agilpro
  • Projects:
       agil-mod
  • Optional Projects:
       agil-mod-installer
       agil-sim
       agil-sim-installer
  • Extract
The necessary adjustments are described in the following chapters.

Back to the Table of Contents


1.2. Development Environment

The Web-Tools-Platform Eclipse Calisto (ver. 3.2) was used for the development of the AgilPro-LiMo and the corresponding installation packing tool.
The Eclipse development environment can be obtained for free at http://www.eclipse.org/webtools. The WTP-All-In-One package already includes the two important plugins (EMF /GEF) and should be labeled according to the following pattern: ‘wtp-all-in-one-sdk-R-1.5.x-date-your-os.extension’ (about 215 MB).

If you are already using Eclipse, you need to additionally install the following plugins. Please download them from the web sites stated below and extract the files to your Eclipse directory:

Both plugins are installed by extracting them into your Eclipse installation directory.

Additionally to your existing Eclipse or Eclipse Calisto (WTP) installation you will definitely need the following plugins: The installation of the additional plugins can be achieved with the Eclipse Update Manager: ‘Eclipse Menu → Help → Software Updates → Find and Install → Search for new Features’ → ‘New Remote Site...’

Back to the Table of Contents


1.3. Java Runtime Environment

The AgilPro LiMo requires the Java Runtime Environment (JDK) ver. 5.0. The precondition is the JDK Version 5.0 Update 9 which can be obtained for free at http://java.sun.com/javase/downloads/index.jsp.
The AgilPro LiMo does not work properly with other versions of JRE 5.0.

Back to the Table of Contents


1.4. Apache ANT

All scripts for the creation of the installer are written in the ANT-format. ANT is already included in Eclipse and no further adjustments are necessary.

Back to the Table of Contents


1.5. IzPack

IzPack 3.8.1 (which is distributed under the ‘Apache License Version 2.0’) was used for the creation of the installation program for the AgilPro-LiMo. This program can be obtained at the address www.izforge.com.
The installation of this tool is NOT necessary, since the required library is included in the project.

If you want to replace the installed version by a newer / older one, copy the file ‘IzPack\lib\standalone-compiler.jar’ in the library - directory of the project (e.g. ‘agil-mod-installer\lib’).

Back to the Table of Contents



2. Configuration

2.1. Eclipse

2.1.1. Java JDK

By default Eclipse uses the Java Runtime Environment (JRE) instead of the Java Development Kit (JDK). Even if only one JDK was installed, it is important to choose the right Java runtime environment (JDK) so that Eclipse can use it for compiling.
‘Eclipse Menu → Window → Preferences → Java → Installed JREs’ ⇒ ‘Add...’ ⇒ Click on the button ‘Browse...’ and choose the installation directory of your Java Development Kit. The installation path could look like this: ‘C:\Program Files\Java\jdk1.5.0_09’.

Back to the Table of Contents


2.1.2. Java Compiler Level

The source code must be compiled with the Java 5.0 (1.5.0_09) Compiler. The following adjustments are required:
‘Eclipse Menu → Window → Preferences → Java → Compiler’ ⇒ ‘Compiler compliance level: 5.0’

Back to the Table of Contents


2.1.3. Apache ANT

To be able to run JUnit-tests which may be present in the project in ANT, JUnit must be registered with ANT. ‘Eclipse Menu → Window → Preferences → Ant → Runtime’ ⇒ please choose ‘Classpath → Global Entries → Add External JARs...’ ⇒ and add the JUnit-JAR in your Eclipsehome-Plugin-folder: ‘Eclipsehome\plugins\org.junit_3.8.1’

In some cases it is required that the Tools.jar from the JDK-directory (e.g. ‘C:\Program Files\Java\jdk1.5.0_09\lib\’) is also integrated here. In this case, please add the following file as described above: ‘JDK-Home\lib\tools.jar’

Back to the Table of Contents



2.2. Subversion (SVN) ⁄ Download Project

The project can either be obtained as a compressed file (zip⁄tar) at http://sourceforge.net/projects/agilpro/files, or be checked out with Subversion from Sourceforge.net.
The data required for the check out is:
  • Host name: svn.sourceforge.net
  • Port: 443
  • Protocol: HTTPS
  • Repository path: /svnroot/agilpro
  • User name : Your SourceForge.net - user name for SVN-write operations, otherwise leave it empty
  • Password: Your SourceForge.net - user password for SVN-write operations, otherwise leave it empty
With some tools it is possible to just enter this path: ‘https://svn.sourceforge.net/svnroot/agilpro’.

The AgilPro-Light Modeller basically only requires the project ‘agil-mod’.
If you want to test your process models you have to include the AgilPro Simulator ‘agil-sim’ in your project. To be able to start from the development environment, the AgilPro Simulator requires a project dependence to the project ‘agil-mod’

If you intend to use AgilPro LiMo or the AgilPro Simulator outside Eclipse, you have to check out the projects ‘agil-mod-installer’ and ‘agil-sim-installer’.

Back to the Table of Contents


3. Execution of the Build-Script

3.1. AgilLiMo-Start in the Development Environment

In the development environment the Light Modeller can be started by first opening the file ‘/agil-mod/agilpro.product’ and selecting the option ‘Synchronize’.
Afterwards you can start the program with ‘Launch the product’.

The example process ‘StandardPalette.agilpro’ which is included in the already packed installation file, can only be found in the project ‘agil-mod-installer/prozesse’.

Back to the Table of Contents



3.2. Generating the stand-alone Installation Program

Several steps are necessary to create a JAR-File for the installation of the AgilPro-LiMo on another computer. The creation can be simplified by the use of ANT-scripts.

Please open the ‘build.xml’ file and start the target ‘cleanup-tempfolder’. This is a required preparation for the next step and should be executed every time the following function is executed:
In the project root of the AgilPro-LiMo you will find the file ‘agilpro.product’. Please open this file and choose ‘Eclipse Product export wizard’. The following information has to be entered in the next form:
  • Configuration:
       ‘/agil-mod/agilpro.product’
  • Root directory:
       ‘LiMo’
  • Synchronize before exporting:
       ‘Yes’
  • Directory:
       ‘/EclipseWorkspace/agil-mod-installer/temp/’
  • Include source code:
       ‘No’
  • Export for multiple platforms:
       ‘Yes’
Choose ‘Next’ and select the platforms which you intend to use.
At this time the exports which are supported by ‘build.xml’ are as follows:
  • Windows:
       ‘win32.win32.x86’
  • Linux:
       ‘linux.gtk.x86’
       ‘linux.gtk.ppc’
  • Macintosh:
       ‘macosx.carbon.x86’
       ‘macosx.carbon.ppc’

Close the dialog windows with ‘Finish’ and wait until the export is done. When the export has finished, you can find the exported files in the folder ‘/agil-mod-installer/temp’.

With this step, the preparation is complete.

Now you can start the export for your desired operation system in the ‘build.xml’.
The corresponding commands are ‘create.installer.your-destination-os’. After the successful completion the file ‘AgilProLiMo-Installer-your-destination-os.jar’ can be found in the directory ‘/agil-mod-installer/build/’.

Back to the Table of Contents


3.3. Local Test of the Installation Program

The creation of the installation program (for Windows) can be verified with the ANT-script ‘run.win.installer.’.

Back to the Table of Contents



4. About AgilPro...

AgilPro is a cooperation project between the eMundo GmbH and the working group Programming of Distributed Systems of the University of Augsburg, Germany. The goal of the project is a tool which enables the modeling of business processes. The project is publicly sponsored by the Bavarian State Ministry of Economic Affairs, Infrastructure, Traffic and Technology in the context of the Future Initiative Bavaria.

GPL License - University of Augsburg (Germany), eMundo GmbH
Copyright (c) 2006

The license can be found here .

Back to the Table of Contents



4.1. SourceForge.Net

Information about the current state of the project can be found on the following web site: https://sourceforge.net/projects/agilpro/.

Back to the Table of Contents



4.2. Contact Addresses

University of Augsburg, Germany: http://www.informatik.uni-augsburg.de
eMundo GmbH: http://www.e-mundo.de, http://www.agilpro.de, http://www.agilpro.eu
Email address: support@agilpro.de

Back to the Table of Contents