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