SimuPlant Server Installation instructions

This server has been developed on Ubuntu Linux 12.04 64bit;
any other reasonably modern Linux distribution should be sufficient.

1. Prerequsites

The server is built using Python 2.7, and the Numpy and Scipy Libraries.
It also uses parts of the OpenAlea simulation environment -
http://openalea.gforge.inria.fr/dokuwiki/doku.php 

To obtain the necessary libraries on Ubuntu 12.04, type

sudo apt-get install python-numpy python-scipy python-matplotlib 
sudo apt-get install python-lxml libxml2


Although the server is written in Python, it requires an additional
package to be built (odesparse) in order to function.

1.1 Building odesparse

odesparse requires a fortran compiler (gfortran), c compiler, and the Python
development library (python-dev). 


Enter the odesparse_1 directory, and follow the instructions in README
(Note that to install the module you may need to be root/use sudo.)

On ubuntu-12.04, these commands will install the server:

sudo apt-get install python-numpy python-scipy gfortran gcc
cd odesparse_1
sudo python setup.py install
cd ..



1.2 Running the server

The main Python program is http_server.py

The server serves requests on port 80; either (a) run the command using sudo
or (b) use authbind to allow a non-root server to access this port

On Ubuntu 12.04

(a) sudo python http_server.py

(b) sudo apt-get install authbind
    sudo touch /etc/authbind/byport/80
    sudo chmod +x /etc/authbind/byport/80

1.3 Configuring the client.

The compiled version of the Java client is setup to access
the server at simuplant.org 
To change this, the SERVER_NAME variable in rootgui.controller.VRootController
must be modified to be "http://localhost"