Webware for Python

Update of /cvsroot/webware/Webware/WebKit/Docs
In directory usw-pr-cvs1:/tmp/cvs-serv16537/WebKit/Docs

Modified Files:
	Application.configlist RelNotes-0.7.html UsersGuide.html 
Log Message:
added setting SessionPrefix which can be set to 'hostname' to cause all session IDs to be prefixed with the hostname, or you can put in any other string.  This can be used along with mod_rewrite to do simple load balancing with session affinity.

Index: Application.configlist
===================================================================
RCS file: /cvsroot/webware/Webware/WebKit/Docs/Application.configlist,v
retrieving revision 1.10
retrieving revision 1.11
diff -C2 -d -r1.10 -r1.11
*** Application.configlist	1 Feb 2002 08:54:06 -0000	1.10
--- Application.configlist	2 Mar 2002 16:31:25 -0000	1.11
***************
*** 48,51 ****
--- 48,53 ----
  ('DynamicSessionTimeout', '15', 'The number of minutes of inactivity after which a session is pushed out to disk. This setting can be used to help control memory requirements, especially for busy sites. This is used only if the SessionStore is set to Dynamic.'),
  
+ ('SessionPrefix', 'None', '''This setting can be used to prefix the session IDs with a string.  Possible values are None (don't use a prefix), "hostname" (use the hostname as the prefix), or any other string (use that string as the prefix).  Why would you want to use this?  It can be used along with some mod_rewrite magic to do simple load balancing with session affinity.'''),
+ 
  ('ExtraPathInfo', '0', '''When enabled, this setting allows a servlet to be followed by additional path components which are accessible via HTTPRequest's extraURLPath(). For subclassers of Page, this would be self.request().extraURLPath(). This may degrade performance when turned on.'''),
  

Index: RelNotes-0.7.html
===================================================================
RCS file: /cvsroot/webware/Webware/WebKit/Docs/RelNotes-0.7.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** RelNotes-0.7.html	13 Feb 2002 07:28:12 -0000	1.3
--- RelNotes-0.7.html	2 Mar 2002 16:31:25 -0000	1.4
***************
*** 40,43 ****
--- 40,45 ----
  	<li> A new PickleRPCServlet serves as a more convenient and efficient alternative to XMLRPCServlet. Also, a new RPCServlet base class is used by both classes and provides a starting point for other RPC protocols. The old setting 'IncludeTracebackInXMLRPCFault' is now called 'RPCExceptionReturn' and takes different values.
  
+ 	<li> New Application.config setting SessionPrefix can be used to prefix the session ID's with a string.  Possible values are None (don't use a prefix), "hostname" (use the hostname as the prefix), or any other string (use that string as the prefix).  Why would you want to use this?  It can be used along with some mod_rewrite magic to do simple load balancing with session affinity.
+ 
  </ul>
  

Index: UsersGuide.html
===================================================================
RCS file: /cvsroot/webware/Webware/WebKit/Docs/UsersGuide.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -C2 -d -r1.16 -r1.17
*** UsersGuide.html	21 Dec 2001 21:04:37 -0000	1.16
--- UsersGuide.html	2 Mar 2002 16:31:25 -0000	1.17
***************
*** 328,332 ****
  &nbsp; <code> = 1</code></dt>
  <dd class=config>
! If false, then an error message will be returned to the user if the user's session has timed out or doesn't exist.  If true, then servlets will be processed with no session data <!-- and can take action if session.isNew(). -->. 
  </dd>
  </dl></p>
--- 328,332 ----
  &nbsp; <code> = 1</code></dt>
  <dd class=config>
! If false, then an error message will be returned to the user if the user's session has timed out or doesn't exist.  If true, then servlets will be processed with no session data <!-- and can take action if session.isNew(). -->.
  </dd>
  </dl></p>
***************
*** 336,340 ****
  &nbsp; <code> = 0</code></dt>
  <dd class=config>
! If true, then the app server will include the session ID in the URL by inserting a component of the form _SID_=8098302983 into the URL, and will parse the URL to determine the session ID.  This is useful for situations where you want to use sessions, but it has to work even if the users can't use cookies. 
  </dd>
  </dl></p>
--- 336,340 ----
  &nbsp; <code> = 0</code></dt>
  <dd class=config>
! If true, then the app server will include the session ID in the URL by inserting a component of the form _SID_=8098302983 into the URL, and will parse the URL to determine the session ID.  This is useful for situations where you want to use sessions, but it has to work even if the users can't use cookies.
  </dd>
  </dl></p>
***************
*** 357,360 ****
--- 357,368 ----
  
  <p><dl class=config>
+ <dt class=config><span class=setting>SessionPrefix</span>
+ &nbsp; <code> = None</code></dt>
+ <dd class=config>
+ This setting can be used to prefix the session IDs with a string.  Possible values are None (don't use a prefix), "hostname" (use the hostname as the prefix), or any other string (use that string as the prefix).  Why would you want to use this?  It can be used along with some mod_rewrite magic to do simple load balancing with session affinity.
+ </dd>
+ </dl></p>
+ 
+ <p><dl class=config>
  <dt class=config><span class=setting>ExtraPathInfo</span>
  &nbsp; <code> = 0</code></dt>
***************
*** 495,507 ****
  	<br><br> If your site has a large amount of static files being served via WebKit, you should consider changing 'CacheContent' to 0. If you are confident that your static files do not get updated while the app server is live, then you might consider changing 'CheckDate' to 0 for better performance.
  
! 	<br><br> The 'Technique' setting can be switch to 'redirectSansAdapter', but this is an experimental setting with some known problems. 
  </dd>
  </dl></p>
  
  <p><dl class=config>
! <dt class=config><span class=setting>IncludeTracebackInXMLRPCFault</span>
! &nbsp; <code> = 1</code></dt>
  <dd class=config>
! If true, then the full traceback for uncaught exceptions in XML-RPC Servlets will be returned to the client in an XML-RPC Fault.  If false, then a generic 'unhandled exception' message will be returned in the Fault.
  </dd>
  </dl></p>
--- 503,515 ----
  	<br><br> If your site has a large amount of static files being served via WebKit, you should consider changing 'CacheContent' to 0. If you are confident that your static files do not get updated while the app server is live, then you might consider changing 'CheckDate' to 0 for better performance.
  
! 	<br><br> The 'Technique' setting can be switch to 'redirectSansAdapter', but this is an experimental setting with some known problems.
  </dd>
  </dl></p>
  
  <p><dl class=config>
! <dt class=config><span class=setting>RPCExceptionReturn</span>
! &nbsp; <code> = 'traceback'</code></dt>
  <dd class=config>
! Determines how much detail an RPC servlet will return when an exception occurs on the server side. Can take the values, in order of increasing detail, 'occurred', 'exception' and 'traceback'. The first reports the string 'unhandled exception', which the second prints the actual exception and finally the third prints both the exception and accompanying traceback. All returns are always strings.
  </dd>
  </dl></p>