A complete copy of all the source code relating to our project can be downloaded via our SVN repository. To do that, on any MathLAN computer you can type

svn checkout http://grintopia-gorpout.googlecode.com/svn/trunk/ gorpout
GORPOUT=`pwd`/gorpout

This command will create a gorpout folder which will contain all the source code of our project.

The project is live at http://gorpout.appspot.com/ . You need administrative privileges to use the project.

Our project is only accessible by coordinators, so visiting the homepage is all you have to do.

To run the project locally, you will need the Google AppEngine SDK runtime. This is a "toy" server that will run on your local machine. It is required because of the specialized APIs the AppEngine requires (and our project uses). To do that you will first need to get a newer version of Python.

If you'd rather, I have installed Python on my account, and you can use it by typing:

alias python2.6=/home/athanasa/local/bin/python2.6

Alternatively, if you'd like your own version of the Python runtime you can get it with the following commands, but compiling it is time-consuming.

# ========== To get Python 2.6.1
wget http://www.python.org/ftp/python/2.6.1/Python-2.6.1.tgz
tar -zxf Python-2.6.1.tgz
cd Python-2.6.1
./configure
make
alias python2.6=`pwd`/python

Now, to get the AppEngine SDK:

wget http://googleappengine.googlecode.com/files/google_appengine_1.1.7.zip
# Verify the SHA1 signature of the file to be "da57b394f44c940c4fa1d985b8483cfc3776c387"
sha1sum google_appengine_1.1.7.zip
unzip google_appengine_1.1.7.zip
APPENGINE=`pwd`/google_appengine

To run our application:

python2.6 $APPENGINE/dev_appserver.py $GORPOUT/

The development server will run. The first time it might complain about lacking a datastore, but you shouldn't worry--the infrastructure will be created automatically. The last line of the output will be the URL of the development server, most probably http://localhost:8080/ .

It will ask you for a login---this is a mock login and the actual username doesn't matter. However, you must set the Administrator flag ("Log me in as an Administrator").

Running the application on the development server puts it in a special mode that displays two extra links in the menu.

If you run the project on your local computer you will need to put some data to be able to use it. To do that, under "Testing", click on "create_real_equipment" and "random_people". This will insert the standard equipment list and a bunch of random people in the datastore.