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