1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/docs/sessions-servers.html Sat Apr 30 20:31:51 2005 +0000
1.3 @@ -0,0 +1,64 @@
1.4 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
1.5 +<html xmlns="http://www.w3.org/1999/xhtml">
1.6 +<head>
1.7 + <meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type" />
1.8 + <title>Server Environment Support for Sessions</title>
1.9 + <meta name="generator"
1.10 + content="amaya 8.1a, see http://www.w3.org/Amaya/" />
1.11 + <link href="styles.css" rel="stylesheet" type="text/css" />
1.12 +</head>
1.13 +<body>
1.14 +<h1>Server Environment Support for Sessions</h1>
1.15 +<p>Various server environments or frameworks do not support sessions
1.16 +directly. In order to provide primitive support for sessions within
1.17 +WebStack upon such frameworks, the <code>WebStack.Helpers.Session</code>
1.18 +module is used to provide a simple file-based session store. Before
1.19 +deploying an application on one of these frameworks, it is necessary to
1.20 +create a directory called <code>WebStack-sessions</code> in a
1.21 +particular location so that the storage of session information will
1.22 +work.</p>
1.23 +<p>The location of the <code>WebStack-sessions</code> directory
1.24 +depends on the framework as summarised below:</p>
1.25 +<table style="text-align: left; width: 80%;" align="center" border="1"
1.26 + cellpadding="5" cellspacing="0" width="80%">
1.27 + <tbody>
1.28 + <tr>
1.29 + <th style="text-align: center;">Server Environment</th>
1.30 + <th style="text-align: center;">Directory Location</th>
1.31 + </tr>
1.32 + <tr>
1.33 + <td align="undefined" valign="undefined">BaseHTTPRequestHandler</td>
1.34 + <td align="undefined" valign="undefined">The directory where the
1.35 +server is run.</td>
1.36 + </tr>
1.37 + <tr>
1.38 + <td align="undefined" valign="undefined">CGI</td>
1.39 + <td align="undefined" valign="undefined">The directory where the
1.40 +handler resides.</td>
1.41 + </tr>
1.42 + <tr>
1.43 + <td align="undefined" valign="undefined">mod_python</td>
1.44 + <td align="undefined" valign="undefined">The server root (such
1.45 +as <code>/usr/local/apache2</code>).</td>
1.46 + </tr>
1.47 + <tr>
1.48 + <td align="undefined" valign="undefined">Twisted</td>
1.49 + <td align="undefined" valign="undefined">The directory where the
1.50 +server is run.</td>
1.51 + </tr>
1.52 + </tbody>
1.53 +</table>
1.54 +<p>Note that the <code>WebStack-sessions</code> directory must
1.55 +have the appropriate ownership and privileges necessary for the server
1.56 +or framework to write session information into it.<br />
1.57 +</p>
1.58 +<h2>Unsupported Environments and Framework Issues</h2>
1.59 +<ul>
1.60 + <li>Webware 0.8.1 has problems creating sessions and is therefore not
1.61 +supported.</li>
1.62 + <li>Webware releases later than 0.8.1 (at least until the 2004-02-06
1.63 +CVS snapshot used for testing) do not support session detection or
1.64 +expiry correctly.</li>
1.65 +</ul>
1.66 +</body>
1.67 +</html>