From 99db87c32ab1676fd318075ad50c5fd379c43aa2 Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Mon, 10 Feb 2014 16:34:23 +0000
Subject: [PATCH] Backport Fix for OPENDJ-1334: Mention that load balancer timeouts should be longer than OpenDJ idle timeouts

---
 opends/src/main/docbkx/admin-guide/chap-resource-limits.xml |   18 ++++++++++++++----
 1 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/opends/src/main/docbkx/admin-guide/chap-resource-limits.xml b/opends/src/main/docbkx/admin-guide/chap-resource-limits.xml
index 058ff15..0e14521 100644
--- a/opends/src/main/docbkx/admin-guide/chap-resource-limits.xml
+++ b/opends/src/main/docbkx/admin-guide/chap-resource-limits.xml
@@ -19,15 +19,14 @@
   !
   ! CCPL HEADER END
   !
-  !      Copyright 2011-2012 ForgeRock AS
+  !      Copyright 2011-2014 ForgeRock AS
   !    
 -->
 <chapter xml:id='chap-resource-limits'
  xmlns='http://docbook.org/ns/docbook' version='5.0' xml:lang='en'
  xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
- xsi:schemaLocation='http://docbook.org/ns/docbook http://docbook.org/xml/5.0/xsd/docbook.xsd'
- xmlns:xlink='http://www.w3.org/1999/xlink'
- xmlns:xinclude='http://www.w3.org/2001/XInclude'>
+ xsi:schemaLocation='http://docbook.org/ns/docbook
+                     http://docbook.org/xml/5.0/xsd/docbook.xsd'>
  <title>Setting Resource Limits</title>
  <indexterm><primary>Resource limits</primary></indexterm>
  
@@ -167,6 +166,17 @@
   global configuration property, <literal>idle-time-limit</literal>. By
   default, no idle time limit is set.</para>
 
+  <para>
+   If your network load balancer is configured to drop connections
+   that have been idle for some time,
+   make sure you set the OpenDJ idle time limit to a lower value
+   than the idle time limit for the load balancer.
+   This helps to ensure that idle connections are shut down in orderly fashion.
+   Setting the OpenDJ limit lower than the load balancer limit is
+   particularly useful with load balancers that drop idle connections
+   without cleanly closing the connection and notifying the client and server.
+  </para>
+
   <note>
    <para>OpenDJ does not enforce idle timeout for persistent searches.</para>
   </note>

--
Gitblit v1.10.0