[portal-commits] JBoss Portal SVN: r9056 - docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules.

[portal-commits at lists.jboss.org]

Author: bdaw
Date: 2007-11-21 05:12:05 -0500 (Wed, 21 Nov 2007)
New Revision: 9056

Modified:
   docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/ldap.xml
Log:
LDAP configuration update

Modified: docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/ldap.xml
===================================================================
--- docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/ldap.xml	2007-11-21 09:54:32 UTC (rev 9055)
+++ docs/branches/JBoss_Portal_Branch_2_6/referenceGuide/en/modules/ldap.xml	2007-11-21 10:12:05 UTC (rev 9056)
@@ -101,6 +101,65 @@
    <sect1>
       <title>Configuration of LDAP connection</title>
       <sect2>
+         <title>Connection Pooling</title>
+         <para>Portal uses connection pooling provided by <ulink url="http://java.sun.com/products/jndi/tutorial/ldap/connect/pool.html">JNDI</ulink>.
+         It is enabled by default. You can configure connection pooling settings using following options:</para>
+         <programlisting><![CDATA[
+<datasource>
+   <name>LDAP</name>
+   <config>
+      ...
+      <!-- com.sun.jndi.ldap.connect.pool -->
+      <option>
+         <name>pooling</name>
+         <value>true</value>
+      </option>
+
+      <!-- com.sun.jndi.ldap.connect.pool.protocol -->
+      <option>
+         <name>poolingProtocol</name>
+         <value>plain ssl</value>
+      </option>
+
+      <!-- com.sun.jndi.ldap.connect.pool.timeout -->
+      <option>
+         <name>poolingTimeout</name>
+         <value>300000</value>
+      </option>
+
+      <!-- com.sun.jndi.ldap.connect.pool.debug -->
+      <option>
+         <name>pooling</name>
+         <value> ... </value>
+      </option>
+
+      <!-- com.sun.jndi.ldap.connect.pool.initsize -->
+      <option>
+         <name>poolingInitsize</name>
+         <value> ... </value>
+      </option>
+
+      <!-- com.sun.jndi.ldap.connect.pool.maxsize -->
+      <option>
+         <name>poolingMaxsize</name>
+         <value> ... </value>
+      </option>
+
+      <!-- com.sun.jndi.ldap.connect.pool.prefsize -->
+      <option>
+         <name>poolingPrefsize</name>
+         <value> ... </value>
+      </option>
+
+      ...
+   </config>
+</datasource>]]></programlisting>
+         <para>
+            Please refer to the <ulink url="http://java.sun.com/products/jndi/tutorial/ldap/connect/config.html">JNDI Documentation</ulink> to learn about option values.
+         </para>
+
+      </sect2>
+      <sect2>
          <title>SSL</title>
          <para>The setup is very similar to the one described in LdapLoginModule <ulink url="http://www.jboss.org/wiki/Wiki.jsp?page=LdapLoginModule">wiki page</ulink></para>
          <para>You need to modify your identity configuration file and add "protocol"</para>