| 1 | Server Information |
|---|
| 2 | ================== |
|---|
| 3 | |
|---|
| 4 | This folder contains scripts for various deployment types. Depending |
|---|
| 5 | on the kind of Webserver and Webserver interface you should chose one |
|---|
| 6 | of them or create your own. |
|---|
| 7 | |
|---|
| 8 | The following files exist currently: |
|---|
| 9 | |
|---|
| 10 | `zine.cgi` |
|---|
| 11 | This file implements can be used to use Zine over CGI. This |
|---|
| 12 | should *NOT* be used unless you have to. Zine is not designed |
|---|
| 13 | for the run-once nature of CGI and will perform poorly on it. |
|---|
| 14 | |
|---|
| 15 | `zine.fcgi` |
|---|
| 16 | This file serves Zine over FastCGI. It requires the flup |
|---|
| 17 | module for Python. |
|---|
| 18 | |
|---|
| 19 | `zine.wsgi` |
|---|
| 20 | This file can be used to execute Zine over mod_wsgi. |
|---|
| 21 | |
|---|
| 22 | Just take the file of choice, copy it to where you want it to be and |
|---|
| 23 | adjust it. |
|---|
| 24 | |
|---|
| 25 | All this files have some variables you can configure and invoke the |
|---|
| 26 | actual handler code. Variables written in uppercase are there for |
|---|
| 27 | you to change if you want. |
|---|
| 28 | |
|---|
| 29 | Some of these can be set from the process environment as well (for |
|---|
| 30 | example via the apache `SetEnv` directive) if you prefix them with |
|---|
| 31 | ``ZINE_``. This works for the following keys: |
|---|
| 32 | |
|---|
| 33 | `POOL_SIZE` |
|---|
| 34 | The size of the pool to be maintained. This is the largest number |
|---|
| 35 | of connections that will be kept persistently in the pool. Note |
|---|
| 36 | that the pool begins with no connections; once this number of |
|---|
| 37 | connections is requested, that number of connections will remain. |
|---|
| 38 | Defaults to 5. |
|---|
| 39 | If you are deploying Zine in a forking environment you want to set |
|---|
| 40 | this number to 1 or 2. |
|---|
| 41 | |
|---|
| 42 | `POOL_RECYCLE` |
|---|
| 43 | If set to non -1, number of seconds between connection recycling, |
|---|
| 44 | which means upon checkout, if this timeout is surpassed the |
|---|
| 45 | connection will be closed and replaced with a newly opened |
|---|
| 46 | connection. Defaults to -1. |
|---|
| 47 | |
|---|
| 48 | `POOL_TIMEOUT` |
|---|
| 49 | The number of seconds to wait before giving up on returning a |
|---|
| 50 | connection. Defaults to 30. |
|---|
| 51 | |
|---|
| 52 | `BEHIND_PROXY` |
|---|
| 53 | If you are proxying into Zine somehow (caching proxies or external |
|---|
| 54 | fastcgi/http servers) set this value to True to enable proxy support. |
|---|
| 55 | Do not set this to True if you are not using proxies as this would |
|---|
| 56 | be a security risk. |
|---|
| 57 | If you specify this value from the process environment use the values |
|---|
| 58 | ``1`` and ``0`` instead of ``True`` and ``False``. |
|---|