FastCGIWSGI

[[PageOutline]]

= FastCGI WSGI =

This is a HOWTO. See BehindApache for a higher-level discussion.

A very simple setup lets your cherry run with FastCGI (on apache in my setup). You need just a running apache server with mod_fastcgi and [http://www.saddi.com/software/flup/ flup].

== CherryPy code ==

hello.py:

{{{
#!python
#!/usr/bin/python

import cherrypy

class HelloWorld:
    """ Sample request handler class. """
    def index(self):
        return "Hello world!"
    index.exposed = True

cherrypy.tree.mount(HelloWorld())
# CherryPy autoreload must be disabled for the flup server to work
cherrypy.config.update({'engine.autoreload_on':False})
}}}

Then run the shiny new cherryd with the '-f' arg:

{{{
cherryd -c <myconfig> -d -f -i hello.py
}}}

== Apache config ==

At the top level in httpd.conf:

{{{
    FastCgiIpcDir /tmp
    FastCgiServer /path/to/cherry.fcgi -idle-timeout 120 -processes 4
}}}

And inside the relevant !VirtualHost section:

{{{
    # FastCGI config  
    AddHandler fastcgi-script .fcgi
    ScriptAliasMatch (.*$) /path/to/cherry.fcgi$1
}}}

== Lighttpd config ==

For [http://www.lighttpd.net/ Lighttpd] you can follow these instructions. Within `lighttpd.conf` make sure `"mod_fastcgi"` is active within `server.modules`. Then, within your `$HTTP["host"]` directive, configure your fastcgi script like the following:

{{{
$HTTP["url"] =~ "" {
  fastcgi.server = (
    "/" => (
      "script.fcgi" => (
        "bin-path" => "/path/to/your/script.fcgi",
        "socket"          => "/tmp/script.sock",
        "check-local"     => "disable",
        "disable-time"    => 1,
        "min-procs"       => 1,
        "max-procs"       => 1, # adjust as needed
      ),
    ),
  )
} # end of $HTTP["url"] =~ "^/"       
}}}

Please see [http://trac.lighttpd.net/trac/wiki/Docs:ModFastCGI] for an explanation of the possible configuration options.


{{{
#!html
<h2 class='compatibility'>Older versions</h2>
}}}

Use autoreload.on = False instead of engine.autoreload_on = False.

== 3.0 ==

{{{
#!python
#!/usr/bin/python

import cherrypy
from flup.server.fcgi import WSGIServer


class HelloWorld:
    """ Sample request handler class. """
    def index(self):
        return "Hello world!"
    index.exposed = True


app = cherrypy.tree.mount(HelloWorld())
cherrypy.engine.start(blocking=False)
try:
    WSGIServer(app).run()
finally:
    # This ensures that any left-over threads are stopped as well.
    cherrypy.engine.stop()
}}}

== 2.2 ==

{{{
#!python
#!/usr/bin/python

import cherrypy

class HelloWorld:
    """ Sample request handler class. """
    def index(self):
        return "Hello world!"
    index.exposed = True

cherrypy.tree.mount(HelloWorld())
cherrypy.server.start(initOnly=True, serverClass=None)

# use flup to start wsgi server
from cherrypy._cpwsgi import wsgiApp
from flup.server.fcgi import WSGIServer
WSGIServer(wsgiApp).run()
}}}


== 2.0 ==

{{{
#!python
#!/usr/bin/python

from cherrypy import cpg

class HelloWorld:
    """ Sample request handler class. """
    def index(self):
        return "Hello world!"
    index.exposed = True

cpg.root = HelloWorld()
cpg.server.start(initOnly=True, serverClass=None)

# use flup to start wsgi server
from cherrypy._cpwsgi import wsgiApp
from flup.server.fcgi import WSGIServer
WSGIServer(wsgiApp).run()
}}}