paulb@360 | 1 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
paulb@360 | 2 | <html xmlns="http://www.w3.org/1999/xhtml"> |
paulb@360 | 3 | <head> |
paulb@360 | 4 | <meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type" /> |
paulb@360 | 5 | <title>Server Environment Support for Sessions</title> |
paulb@360 | 6 | <meta name="generator" |
paulb@360 | 7 | content="amaya 8.1a, see http://www.w3.org/Amaya/" /> |
paulb@360 | 8 | <link href="styles.css" rel="stylesheet" type="text/css" /> |
paulb@360 | 9 | </head> |
paulb@360 | 10 | <body> |
paulb@360 | 11 | <h1>Server Environment Support for Sessions</h1> |
paulb@360 | 12 | <p>Various server environments or frameworks do not support sessions |
paulb@360 | 13 | directly. In order to provide primitive support for sessions within |
paulb@360 | 14 | WebStack upon such frameworks, the <code>WebStack.Helpers.Session</code> |
paulb@360 | 15 | module is used to provide a simple file-based session store. Before |
paulb@360 | 16 | deploying an application on one of these frameworks, it is necessary to |
paulb@360 | 17 | create a directory called <code>WebStack-sessions</code> in a |
paulb@360 | 18 | particular location so that the storage of session information will |
paulb@360 | 19 | work.</p> |
paulb@360 | 20 | <p>The location of the <code>WebStack-sessions</code> directory |
paulb@360 | 21 | depends on the framework as summarised below:</p> |
paulb@360 | 22 | <table style="text-align: left; width: 80%;" align="center" border="1" |
paulb@360 | 23 | cellpadding="5" cellspacing="0" width="80%"> |
paulb@360 | 24 | <tbody> |
paulb@360 | 25 | <tr> |
paulb@360 | 26 | <th style="text-align: center;">Server Environment</th> |
paulb@360 | 27 | <th style="text-align: center;">Directory Location</th> |
paulb@360 | 28 | </tr> |
paulb@360 | 29 | <tr> |
paulb@360 | 30 | <td align="undefined" valign="undefined">BaseHTTPRequestHandler</td> |
paulb@360 | 31 | <td align="undefined" valign="undefined">The directory where the |
paulb@360 | 32 | server is run.</td> |
paulb@360 | 33 | </tr> |
paulb@360 | 34 | <tr> |
paulb@360 | 35 | <td align="undefined" valign="undefined">CGI</td> |
paulb@360 | 36 | <td align="undefined" valign="undefined">The directory where the |
paulb@360 | 37 | handler resides.</td> |
paulb@360 | 38 | </tr> |
paulb@360 | 39 | <tr> |
paulb@360 | 40 | <td align="undefined" valign="undefined">mod_python</td> |
paulb@360 | 41 | <td align="undefined" valign="undefined">The server root (such |
paulb@360 | 42 | as <code>/usr/local/apache2</code>).</td> |
paulb@360 | 43 | </tr> |
paulb@360 | 44 | <tr> |
paulb@360 | 45 | <td align="undefined" valign="undefined">Twisted</td> |
paulb@360 | 46 | <td align="undefined" valign="undefined">The directory where the |
paulb@360 | 47 | server is run.</td> |
paulb@360 | 48 | </tr> |
paulb@360 | 49 | </tbody> |
paulb@360 | 50 | </table> |
paulb@360 | 51 | <p>Note that the <code>WebStack-sessions</code> directory must |
paulb@360 | 52 | have the appropriate ownership and privileges necessary for the server |
paulb@360 | 53 | or framework to write session information into it.<br /> |
paulb@360 | 54 | </p> |
paulb@360 | 55 | <h2>Unsupported Environments and Framework Issues</h2> |
paulb@360 | 56 | <ul> |
paulb@360 | 57 | <li>Webware 0.8.1 has problems creating sessions and is therefore not |
paulb@360 | 58 | supported.</li> |
paulb@360 | 59 | <li>Webware releases later than 0.8.1 (at least until the 2004-02-06 |
paulb@360 | 60 | CVS snapshot used for testing) do not support session detection or |
paulb@360 | 61 | expiry correctly.</li> |
paulb@360 | 62 | </ul> |
paulb@360 | 63 | </body> |
paulb@360 | 64 | </html> |