== Branch Demo Setup Guidelines ==

e.g. for [wiki:GSOC2010ProjectIdeas GSoC] students

Install Sahana locally according to InstallationGuidelinesDeveloper

You should register your code branch on Launchpad:
 * https://code.launchpad.net/sahana-eden

You can make a live demo of your code available publically (e.g. to share with your mentors) by using the space set aside for you on demo.eden.sahanafoundation.org:
 * r0bby: http://survey.sahanafoundation.org (port 8001)
 * shikhar: http://importer.eden.sahanafoundation.org (port 8002)
 * amer: http://sync.eden.sahanafoundation.org (port 8003)

Login to the server via SSH using your assigned user names and passwords.

Install Web2Py & your Sahana branch (using InstallationGuidelinesDeveloper as a guide)

Suggest symlinking your app to make it the default:
{{{
ln -s web2py/applications/eden web2py/applications/init
}}}

=== New (WSGI) ===

An Apache virtual server has been created which points your sites at /home/<username>/web2py/applications/eden

If you need to restart Apache (in order to see changes to a Module - either in Web2Py or Eden) then you have sudo rights to do this:
{{{
sudo /etc/init.d/apache2 force-reload
}}}

If you need to access Tickets through Web UI, then configure the Ticket Viewer:
 * http://eden.sahanafoundation.org/wiki/ConfigurationGuidelines#Errorpages
=== Old (Proxy) ===

After logging in you will need to spawn web2py according to the ports assigned to you:
{{{
python web2py.py -p 800x
}}}

For running the web2py instance in the background you can execute:
{{{
screen python web2py.py -p 800x
}}}

To detach from the screen:
{{{
ctrl+a d
}}}

To reconnect to the screen to kill the instance (e.g. to restart after editing a module):
{{{
screen -r 
ctrl+c
}}}

To connect to the admin panel of the web2py using an ssh tunnel refer to: 
 * Linux: http://web2py.com/AlterEgo/default/show/68
 * Windows: http://web2py.com/AlterEgo/default/show/143
NB Replace '8000' with the port assigned to you.