Added examples of multiple LDAP servers, and a warning caveat.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@556153 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/mod_authnz_ldap.html.en b/docs/manual/mod/mod_authnz_ldap.html.en
index 36ab492d7238e2ce3502cb11308ba94b3b2d3b6e..47abbe7ff54ff994afe31f8f5dd715296eac9e8f 100644 (file)
--- a/docs/manual/mod/mod_authnz_ldap.html.en
+++ b/docs/manual/mod/mod_authnz_ldap.html.en
@@ -873,6 +873,11 @@ environment variable</td></tr>
     <p>An RFC 2255 URL which specifies the LDAP search parameters
     to use. The syntax of the URL is</p>
 <div class="example"><p><code>ldap://host:port/basedn?attribute?scope?filter</code></p></div>
+    <p>If you want to specify more than one LDAP URL that Apache should try in turn, the syntax for this is:</p>
+<div class="example"><p><code>AuthLDAPUrl "ldap://ldap1.example.com ldap2.example.com"</code></p></div>
+<p><em><strong>Caveat: </strong>If you specify multiple servers, you need to enclose the entire URL string in quotes; 
+otherwise you will get an error: "AuthLDAPURL takes one argument, URL to define LDAP connection.." </em> 
+You can of course use search parameters on each of these.</p>
 
 <dl>
 <dt>ldap</dt>

diff --git a/docs/manual/mod/mod_authnz_ldap.xml b/docs/manual/mod/mod_authnz_ldap.xml
index 1b63a95ebd719d51f30448749895726780c87894..f5bb1dc56ba599fbd44a55c45d1b45868d65d135 100644 (file)
--- a/docs/manual/mod/mod_authnz_ldap.xml
+++ b/docs/manual/mod/mod_authnz_ldap.xml
@@ -872,6 +872,11 @@ environment variable</description>
     <p>An RFC 2255 URL which specifies the LDAP search parameters
     to use. The syntax of the URL is</p>
 <example>ldap://host:port/basedn?attribute?scope?filter</example>
+    <p>If you want to specify more than one LDAP URL that Apache should try in turn, the syntax is:</p>
+<example>AuthLDAPUrl "ldap://ldap1.example.com ldap2.example.com"</example>
+<p><em><strong>Caveat: </strong>If you specify multiple servers, you need to enclose the entire URL string in quotes; 
+otherwise you will get an error: "AuthLDAPURL takes one argument, URL to define LDAP connection.." </em> 
+You can of course use search parameters on each of these.</p>
 
 <dl>
 <dt>ldap</dt>