About the content of this folder please read the README.TXT file.

HOW TO INSTALL, set up and run the Simulator application.

1) Extract bin.zip and data.zip into "H:\project\" folder.
  
  a) Yes, that is right, the software needs precisely this drive and precisely 
  this folder, otherwise the sample FieldStar Open Office database will not
  run properly (it was designed so). We recommend to map a network drive for this folder.

  b) Otherwise you will need to open Fieldstar.mdb file and correct 
  the pathes to the data files in the following attributes:
	JobPlanData: JPDFile,
	Field: FiBoundaryRef1,
	ExlusionZone: EZFile,
	JobPlanData: JPDFile,

2) Set up the "FIELDSTAR OPEN OFFICE" database ODBC data source:

  a) Windows 2000: go to Start -> Settings -> Control Panel -> 
                   Administrative tools -> Data Sources (ODBC)

     Older Windows: go to Start -> Settings -> Control Panel -> ODBC32

  b) choose User DSN

  c) press "Add..." button.

  d) Choose "Driver for Microsoft Access (*.mdb)" and press "Finish"

  e) Write down the "Data Source Name": "FIELDSTAR OPEN OFFICE"

  f) Select a database "h:\project\data\Fieldstar.mdb" and press "OK"

  g) Press "OK" in "ODBC Data Source Administrator" window.

3) Start up the CORBA name server service: h:\project\nameserv.bat

4) Start up the Simulator Server application: h:\project\server.bat

5) Start up one of the simulator client applications:
 
  a) the last used algorithm: h:\project\simulator.bat

  b) the Grid-line-moving algorithm: h:\project\GridSimulator.bat

  c) the Insertion algorithm: h:\project\InsertionSimulator.bat

  d) the Genetic algorithm: h:\project\GeneticSimulator.bat

  e) the Brute-force algorithm (this one will calculate route almost forever): 
     h:\project\BruteForceSimulator.bat


REQUIREMENTS for the Simulator server:

1) Microsoft Access 2000 or compatible.

2) Microsoft Windows operating system or compatible 
   (this is needed to run Microsoft Access database and access it through jdbc:ODBC).

3) Sun Java SDK 1.3.1_01 or compatible java platform installed and properly configured.


REQUIREMENTS for the Simulator client:

1) Sun Java SDK 1.3.1_01 or compatible java platform installed and properly configured.


CUSTOMIZATIONS:

It is possible to run the server and the client on separate different machines and/or 
different ports if you do not have permissions for port 900 (the standard property 
of CORBA).

For these kind of customizations you need to alter these files:
   dbserver.properties
   station.properties

To change the route planning algorithm you need to alter and recompile
auc.algo.RouteAlgorithmFactory class source file.


If you have any technical problems or have found a bug in the Simulator or in this manual 
please feel free to contact us or our supervisor Anders P. Ravn apr@cs.auc.dk.


Marius Mikucionis    marius@cs.auc.dk     http://www.cs.auc.dk/~marius/