A BRIEF INTRO TO WSPLAN

I. INSTALLING WSPLAN

Prerequisites

Java Development Kit 1.4 or higher
GNU C++ compatible build environment (e.g. Linux, Windows+CYGWIN)
Internet Access

1. Install VHPOP-RP

download VHPOP-RP from sourceforge.net and extract it. We refer to the folder containg VHPOP-RP now as $VHPOP
point your command line interpreter to $VHPOP
execute the following commands to compile the planner (Windows users need to use CYGWIN, available for free from here) :
```
./configure
./make
```
After this process, you should find a VHPOP exutable in your $VHPOP directory ("vhpop" on *nix, "vhpop.exe" on CygWin/Windows)

2. Install WSPlan

extract the WSPLAN package downloaded from sourceforge.net to some directory $WSPLAN.
no compilation necessary; if you want to compile it, just type "ant" (you need to have Apache ANT installed on your system)

3. Configure WSPLAN

Each scenario has its own configuration file, eg. "config-shopping1.xml" for example "shopping1". Among the configuration data stored in those files, the path to the VHPOP startup script is defined in a <planner> element. Edit the definitions in the $WSPLAN/examplex/config-* files to match your configuration:

  <planner name="VHPOP" features="strips, types"  isDefault="true">
    <param name="class" value="org.mcm.sws.planners.VHPOPPlanner"/>
    <!-- change to the VHPOP startup script, for instance to:
      <param name="path" value="/home/jpeer/vhpop-rp/vhpop.sh"/>
    -->
    <param name="path" value="d:\cygwin\home\_jpeer\vhpop-rp\vhpop.bat"/>
    <!-- change to a temp directory on your system -->
    <param name="temp-dir" value="d:\tmp"/>
  </planner>

II. RUNNING WSPLAN

1. Check availability of Web Services

The examples are configured to use the publicly available services deployed at http://sws.mcm.unisg.ch:8080/axis Check if the services are alive

In case you want to run the services locally on your computer/network, then download the WSE (Web Service Examples)-package from the CVS repository and follow the instructions in the package's INSTALL/README files

2. A Test Run

there are currently 3 examples which can be run by invoking:

cd $WSPLAN/examples
shopping-N.bat

(or ./shopping-N.sh on Unix systems!) wait until the GUI is loaded and then hit the "PLAN!" button

Troubleshooting

The current packages have been tested for Windows XP + CygWin and for SUSE Linux. If you experience any problems, please send the problem or bug report to: joachim.peer(at)unisg.ch - Thank you.