Setting up and running Decapod 0.5a

Running from Within Windows or Mac OS

To run Decapod within MacOS or Windows, using Virtualbox is an easy way. To do this, follow this guide: Setting up Virtualbox for Decapod.

Installing Decapod 0.5a

(warning) Make sure you are connected to the Internet before proceeding.

In a command prompt, run:

hg clone https://code.google.com/p/decapod -r decapod-0.5a
cd decapod/install-scripts
sudo ./decapod-all.sh

This will download and install all required components for Decapod 0.5a - the process may take a while.

Running Decapod 0.5a

Step 1:

From within the ~/decapod/decapod-server directory, run the following command:

python ./decapod.py

Once the server is loaded, you will see something like this in the console:

[25/Nov/2011:17:25:28] ENGINE Bus STARTING
[25/Nov/2011:17:25:28] ENGINE Started monitor thread '_TimeoutMonitor'.
[25/Nov/2011:17:25:28] ENGINE Started monitor thread 'Autoreloader'.
[25/Nov/2011:17:25:28] ENGINE Serving on 127.0.0.1:8080
[25/Nov/2011:17:25:28] ENGINE Bus STARTED

Keep this console window open.

Step 2:

Launch Firefox and open the following address: http://localhost:8080/
Decapod should load into the web browser.

Stopping Decapod 0.5a

The Decapod server must be stopped manually, closing the web browser is not enough.

1. In the console window that is running the Decapod server, press CTRL+Z to suspend the server.
2. Show all running processes by typing: ps a
3. Take note of the PID number of python ./decapod.py
4. Type: kill -9 PID number
5. Type: ps a to confirm the python ./decapod.py process is gone.

Here is an example:

127.0.0.1 - - [25/Nov/2011:17:32:16] "GET /%selection/ HTTP/1.1" 200 25 "http://localhost:8080/" 
     "Mozilla/5.0 (X11; Linux i686; rv:8.0.1) Gecko/20100101 Firefox/8.0.1"
127.0.0.1 - - [25/Nov/2011:17:32:21] "GET /%selection/ HTTP/1.1" 200 25 "http://localhost:8080/" 
     "Mozilla/5.0 (X11; Linux i686; rv:8.0.1) Gecko/20100101 Firefox/8.0.1"
^Z
[1]+  Stopped                 python ./decapod.py
%> ps a
  PID TTY      STAT   TIME COMMAND
 1091 tty1     Ss+    0:00 /sbin/getty -8 38400 tty1
19177 pts/0    Ss     0:00 bash
19883 pts/0    Tl     0:03 python ./decapod.py
19945 pts/0    R+     0:00 ps a
%> kill -9 19883