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