svn commit: r958747 - /httpd/httpd/trunk/docs/manual/mod/mod_authn_dbd.xml

[ni...@apache.org]

Author: niq
Date: Mon Jun 28 21:23:19 2010
New Revision: 958747

URL: http://svn.apache.org/viewvc?rev=958747&view=rev
Log:
Add cacheing to authn_dbd docs

Modified:
    httpd/httpd/trunk/docs/manual/mod/mod_authn_dbd.xml

Modified: httpd/httpd/trunk/docs/manual/mod/mod_authn_dbd.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_authn_dbd.xml?rev=958747&r1=958746&r2=958747&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_authn_dbd.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_authn_dbd.xml Mon Jun 28 21:23:19 2010
@@ -57,12 +57,23 @@
 <seealso><directive module="mod_dbd">DBDriver</directive></seealso>
 <seealso><directive module="mod_dbd">DBDParams</directive></seealso>
 
+<section id="socache">
+<title>Performance and Cacheing</title>
+<p>Some users of DBD authentication in HTTPD 2.2 have reported that it
+imposes a problematic load on the database.  This is most likely where
+an HTML page contains hundreds of objects (e.g. images, scripts, etc)
+each of which requires authentication.  Users affected (or concerned)
+by this kind of problem should use <module>mod_authn_socache</module>
+to cache credentials and take most of the load off the database.</p>
+</section>
+
 <section id="example">
 <title>Configuration Example</title>
 <p>This simple example shows use of this module in the context of
 the Authentication and DBD frameworks.</p>
 <example><pre>
 # mod_dbd configuration
+# UPDATED to include authentication cacheing
 DBDriver pgsql
 DBDParams "dbname=apacheauth user=apache password=xxxxxx"
 
@@ -76,7 +87,13 @@ DBDExptime 300
   # for mod_authn_dbd
   AuthType Basic
   AuthName "My Server"
-  AuthBasicProvider dbd
+
+  # To cache credentials, put socache ahead of dbd here
+  AuthBasicProvider socache dbd
+
+  # Also required for caching: tell the cache to cache dbd lookups!
+  AuthnCacheProvider dbd
+  AuthnCacheContext my-server
 
   # mod_authz_core configuration
   Require valid-user