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