Setting up the JiST/SWANS environment is not very difficult, however it requires some carefulness. This page describes package structure, general installation instructions and a step by step instruction procedure for using it with Eclipse.

Projects Structure

Our whole distribution consists of logical components, which we call "projects". Currently, we have four of them:

• JiST/SWANS core - the original distribution with some bugfixes and small updates
• JiST/SWANS extensions - helper classes and various generic extensions
• VANS - a project comprising the geographic routing and STRAW
• DUCKS - the simulation execution framework

All of them have an own directory in the root directory.
Directory Structure

Regarding the dependencies: the projects of course all depend on the core of JiST/SWANS. Moreover, VANS and DUCKS both depend on JS-EXT, which itself has no further dependencies.

Note that the original JiST/SWANS is not included in our package, though it is of course the integral part. Please download it from the original site and extract it into the main directory, just like if it was another project besides DUCKS, VANS and JS-EXT (see Figure how the final directory structure should look like).

Java Version

Java 1.5 or higher installed (preferable JDK)

General installation

1. Download the all-in-one package and extract it
2. Download original JiST/SWANS (can be found here) and extract it into the directory of the js-uulm package
3. Apply patch file (js-uulm-patch.diff) to original JiST/SWANS.
4. Download latest latest BCEL library, and replace the one in the original distribution of JiST/SWANS (under jist-swans-1.0.6/libs/) with it.
5. Done.

Patching under Linux

After extracting our package and the original JiST/SWANS package apply the patch by:

  cd jist-swans-1.0.6
  patch -p1 -i ../js-uulm-patch.diff

Installation Guide for Eclipse

A detailed guide how to set up our package as project in Eclipse is provided here.