Running the application

Requirements

PC Linux or Windows system Java Platform Standard Edition 5.0 (J2SE)

Installation

The ADL2N v0.8 is available at:
http://www-sop.inria.fr/oasis/Vercors/software2/adl2n-v0.8.zip

Unzip the package adl2n-0.8.zip into the desired directory. A root folder called adl2n will be created containing the following components:

examples/	(Some examples)
lib/	(Some additional Java libraries needed for ADL2N)
adl2n.jar	(The ADL2N Java archive)
ADL2N.bat	(A Windows script for running ADL2N)
ADL2N.sh	(A Linux script for running ADL2N)

Setting up the examples

1. Preparing the examples: Remember that to run the application you need the ADL (.fractal file) and the compiled interfaces from which the method names will be extracted. The distribution comes with 3 examples: pots, newpots and BufferComponents. Both pots and newpots are provided only as sources, therefore you must compile the Java interfaces before using them. We provide a script called compile.sh (or compile.bat in case of Windows) for that:
   

   For example, at examples/pots directory, compile pots with (repeat for the other examples):

   ./compile.sh pots	(to compile the pots example in Linux)
   compile.bat pots	(to compile the pots example in Windows)

2. Once compiled, they are ready to be used. Run the ADL2N script from the installation directory, giving as argument the name of the directory containing the example files; for example, from the root directory run:

   ./ADL2N.sh pots	(for Linux users)
   ADL2N.bat pots	(for Windows users)

   
   The BufferComponent is different, we only provide the ADL and interfaces already compiled (.class files) within the folder Components/bin. To test it with ADL2N, it must be run as following:

   ./ADL2N.sh BufferComponents/bin	(for Linux users)
   ADL2N.bat BufferComponents\bin	(for Windows users)

Note 1:

if there is a problem with the classloader, please check the path described in the classpath. It is recommended to leave all sources (.class, .fractal) in the same folder.

Note 2:

Linux users can get a "permission denied" error when running the script. Please check the permissions of the file, change it (chmod 755 ADL2N.sh), and try again.

Common usage scenario

• Select a Fractal source file by choosing FILE/OPEN from the main menu
• in the structure panel on the left, select the root component
• in the Description view, select the parameters you want to observe in the model
• repeat the first two steps for the other components
• generate the fc2 parameterized file(s) using the "FC2 Param" menu
• in the Instantiation view, specify the domains of the parameters
• save the FC2 files using the "FC2 Param" menu

The model is ready, the program has created pair of files <comp>.fc2 and <comp>Inst.fc2 for each component involved.

Tips:

For preparing and editing ADL files, you can use the Fractal/Proactive GUI, provided by the ProActive distribution:

• Run as: $PROACTIVE/script/unix/ic2d.sh
• Activate the Components/Start the component GUI button
• Within the GUI, set the storage directory form the file menu before opening an existing or creating a new ADL (.fractal) file.