From 9f51f5e36d7472982adb5fb9ee46016142f8d17e Mon Sep 17 00:00:00 2001
From: Tony Stevenson <pctony@apache.org>
Date: Fri, 13 Jul 2007 21:27:12 +0000
Subject: [PATCH] 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
---
 docs/manual/mod/mod_authnz_ldap.html.en | 5 +++++
 docs/manual/mod/mod_authnz_ldap.xml     | 5 +++++
 2 files changed, 10 insertions(+)

diff --git a/docs/manual/mod/mod_authnz_ldap.html.en b/docs/manual/mod/mod_authnz_ldap.html.en
index 36ab492d72..47abbe7ff5 100644
--- 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 1b63a95ebd..f5bb1dc56b 100644
--- 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>
-- 
2.50.1