| 1 |
Cherokee's SCGI Python implementation |
|---|
| 2 |
===================================== |
|---|
| 3 |
|
|---|
| 4 |
I have written this package because the original SCGI python module |
|---|
| 5 |
(written by Neil Schemenauer) didn't fit for my needs. The problem is |
|---|
| 6 |
that it depends on a C source file that needs to be compiled in order |
|---|
| 7 |
to make the module work, and even if Python provides tools for the |
|---|
| 8 |
task, it still makes the distribution a bit more difficult under some |
|---|
| 9 |
circumstances. |
|---|
| 10 |
|
|---|
| 11 |
This implementation of the SCGI protocol has been completely written |
|---|
| 12 |
in Python to easy as much as possible the deploy for SCGI based apps. |
|---|
| 13 |
|
|---|
| 14 |
This module is BSD licensed. Read the LICENSE file or the notice at |
|---|
| 15 |
the beginning of the source code files for more information. |
|---|
| 16 |
|
|---|
| 17 |
|
|---|
| 18 |
Tests |
|---|
| 19 |
===== |
|---|
| 20 |
There are a few tests programs for checking the module. Each one of |
|---|
| 21 |
them test an specific feature of the module. |
|---|
| 22 |
|
|---|
| 23 |
|
|---|
| 24 |
Configuration |
|---|
| 25 |
============= |
|---|
| 26 |
This module is suitable for all the web servers that support SCGI: |
|---|
| 27 |
Cherokee, Apache or any one else. |
|---|
| 28 |
|
|---|
| 29 |
However, here is an configuration example for Cherokee 0.6 (actually, |
|---|
| 30 |
this is what I've used to test it out): |
|---|
| 31 |
|
|---|
| 32 |
vserver!default!directory!/!handler = scgi |
|---|
| 33 |
vserver!default!directory!/!handler!balancer = round_robin |
|---|
| 34 |
vserver!default!directory!/!handler!balancer!type = interpreter |
|---|
| 35 |
vserver!default!directory!/!handler!balancer!local1!host = localhost:4000 |
|---|
| 36 |
vserver!default!directory!/!priority = 99999 |
|---|
| 37 |
|
|---|
| 38 |
Just write that on a file, lets suppose /var/tmp/test_scgi.conf, and |
|---|
| 39 |
execute Cherokee with the -C parameter to point to the configuration |
|---|
| 40 |
file: |
|---|
| 41 |
|
|---|
| 42 |
# cherokee -C /var/tmp/test_scgi.conf |
|---|
| 43 |
|
|---|
| 44 |
Then, launch one of the test programs provided with this package. It |
|---|
| 45 |
will start a new SCGI server instance that will be used to execute the |
|---|
| 46 |
web server requests. Finally, go to your browser and try to browser |
|---|
| 47 |
and type http://localhost. |
|---|
| 48 |
|
|---|
| 49 |
|
|---|
| 50 |
References |
|---|
| 51 |
========== |
|---|
| 52 |
SCGI: http://www.mems-exchange.org/software/scgi/ |
|---|
| 53 |
Cherokee: http://www.cherokee-project.com/ |
|---|
| 54 |
|
|---|
| 55 |
|
|---|
| 56 |
-- |
|---|
| 57 |
Alvaro Lopez Ortega |
|---|
| 58 |
<alvaro@alobbs.com> |
|---|