#Here is a numbered list of what you need to do to deploy you Turbogears2 or Pylons application. Follow 1 through 6. 

#1. Create production.ini configuration file if its not there already. Example: 

cp development.ini production.ini

#Edit production.ini and delete the port settings or make sure its set to 80.

#2. Change or check the apache settings file.

#Edit /usr/local/turbogears/vigiboard/apache/vigiboard and make sure it has the necessary apache configurations you need.

#Copy {vigiboard} apache config file to apache folder. Example:

cp /usr/local/turbogears/vigiboard/apache/vigiboard /etc/apache2/sites-available/vigiboard

#3.Check if permissions are the same as other apache sites usually (root:root)

ls -l /etc/apache2/sites-available/

#You shoud see

#total 16

#-rw-r--r-- 1 root root  950 2008-08-08 13:06 default

#-rw-r--r-- 1 root root 7366 2008-08-08 13:06 default-ssl

#-rw-r--r-- 1 root root 1077 2008-11-08 12:38 vigiboard

#4.Enable your site.

a2ensite vigiboard

#5. Check if your project has proper permissions, usually apache user. (Example: www-data:www-data on Debian).

ls -l /usr/local/turbogears/vigiboard/apache/

#total 16

#-rw-r--r-- 1 www-data www-data 1077 2008-11-26 22:35 vigiboard

#-rw-r--r-- 1 www-data www-data 2319 2008-11-26 23:25 vigiboard.wsgi

#-rw-r--r-- 1 www-data www-data  594 2008-11-26 22:35 README.txt

#-rw-r--r-- 1 www-data www-data  538 2008-11-26 22:35 test.wsgi

#6.Reload apache

/etc/init.d/apache2 reload

#You are done. Your application should be working. Check the access.log, warn.log, and error.log in /var/log/apache to see if there are any errors. 

#Test modwsgi.

#Hello world test application to make sure modwsgi runs. Link from you apache file to here to test.

def application(environ, start_response):

    status = '200 OK'

    output = 'Hello World!'

    #print >> sys.stderr, "sys.stderr"

    #print >> environ["wsgi.errors"], "wsgi.errors" 

    response_headers = [('Content-type', 'text/plain'),

                        ('Content-Length', str(len(output)))]

    start_response(status, response_headers)

    return [output]

#Apache configuration File

#Read README.txt

#1. This file should be added to your apache config folder; On Debian copy to /etc/apache2/sites-available/

#Default location for tg2 project is /usr/local/turbogears/vigiboard. That is where you should put your project. This folder should be outside of apache location. Your package should not be installed into python site-package.

#2. Alias/Allow apache to serve static content.

Alias /vigiboard/images /usr/local/turbogears/vigiboard/vigiboard/public/images

Alias /vigiboard/css /usr/local/turbogears/vigiboard/vigiboard/public/css

Alias /vigiboard/javascript /usr/local/turbogears/vigiboard/vigiboard/public/javascript

#Embeded mode (http://example.com/vigiboard).For big websites with a lot of memory and visitors.

WSGIScriptAlias /vigiboard /usr/local/turbogears/vigiboard/apache/vigiboard.wsgi

#3. Test if modwsgi is working. Uncomment below line, and go to http://localhost/test:

#WSGIScriptAlias /test /usr/local/turbogears/vigiboard/apache/test.wsgi

#4. [Optional] Sitewide (http://example.com/)

#Alias /images /usr/local/turbogears/vigiboard/vigiboard/public/images

#Alias /css /usr/local/turbogears/vigiboard/vigiboard/public/css

#Alias /javascript /usr/local/turbogears/vigiboard/vigiboard/public/javascript

#WSGIScriptAlias / /usr/local/turbogears/apache/vigiboard.wsgi

#5. [Optional] Deamon mode with 10 threads and 3 processes. For small to medium website.

#WSGIDaemonProcess vigiboard threads=10 processes=3

#WSGIProcessGroup vigiboard

#WSGIScriptAlias / /usr/local/turbogears/vigiboard/apache/vigiboard.wsgi

#6. Directory Permission.

<Directory /usr/local/turbogears/vigiboard/apache>

Order deny,allow

Allow from all

</Directory>

#7. [Optional] If you want to use Virtualhost apache settings. 

#Sample Virtual Host configuration would look like this:

<Directory /usr/local/turbogears/vigiboard/vigiboard/public>

    Order allow,deny

    Allow from all

</Directory>

#NameVirtualHost *:81

#<VirtualHost *:81>

#    WSGIScriptAlias / /usr/local/turbogears/vigiboard/apache/vigiboard.wsgi

#</VirtualHost>

#modwsgi script for vigiboard

#1.Point to this script in you apache config file.

#Default location for all apps is:

#Debian:  /usr/local/turbogears/vigiboard

#2. Make sure apache user own the folder.

#Debian: chown -R www-data:www-data /usr/local/turbogears/vigiboard

import sys

sys.stdout = sys.stderr

#3. start of virtualenv (enabled by default).

#Please comment out until 4 if you don't use virtualenv. 

#Make sure root owns the virtualenv folder. Example:(root:root)

#Create virtualenv if you didn't create it yet:

#mkdir /usr/local/pythonenv

#virtualenv --no-site-packages /usr/local/pythonenv/BASELINE

prev_sys_path = list(sys.path)

import site 

site.addsitedir('/usr/lib/python2.5/site-packages')

#Move just added item to the front of the python system path. 

#Not needed if modwsgi>=3.0. Uncomment next 6 lines.

new_sys_path = []

for item in list(sys.path):

    if item not in prev_sys_path:

        new_sys_path.append(item)

        sys.path.remove(item)

sys.path[:0] = new_sys_path 

#End of virtualenv

#4. Your website file location.

import os, sys

sys.path.append('/usr/local/turbogears/vigiboard')

#5. Set the environment variable PYTHON_EGG_CACHE to an appropriate directory where the Apache user has write permission and into which it can unpack egg files.

os.environ['PYTHON_EGG_CACHE'] = '/usr/local/turbogears/vigiboard/python-eggs'

#6.[Optional]If you want to enable logging you need to initialize logging. You also need to setup logger handlers in you production.ini. When done uncomment next two lines.

#from paste.script.util.logging_config import fileConfig

#fileConfig('/usr/local/turbogears/vigiboard/production.ini')

#7. Load you application production.ini file.

from paste.deploy import loadapp

application = loadapp('config:/usr/local/turbogears/vigiboard/production.ini')

#8.[Optional] If you want to test modwsgi only, uncomment section 3 in you /usr/local/turbogears/vigiboard/apache/vigiboard

import paste.fixture

app = paste.fixture.TestApp(application)

app.get("/")