From 9da182cf4e6af46164d7e60574dcdd07bc11de3e Mon Sep 17 00:00:00 2001
From: Jan Zeleny <jzeleny@redhat.com>
Date: Aug 01 2012 14:19:41 +0000
Subject: Primary server support: man page, failover section


---

diff --git a/src/man/include/failover.xml b/src/man/include/failover.xml
index efe3ee4..dbf9d54 100644
--- a/src/man/include/failover.xml
+++ b/src/man/include/failover.xml
@@ -2,7 +2,7 @@
     <title>FAILOVER</title>
     <para>
         The failover feature allows back ends to automatically switch to
-        a different server if the primary server fails.
+        a different server if the current server fails.
     </para>
     <refsect2 id='failover_syntax'>
         <title>Failover Syntax</title>
@@ -12,6 +12,16 @@
             listed in order of preference. The list can contain any number
             of servers.
         </para>
+        <para>
+            For each failover-enabled config option, two variants exist:
+            <emphasis>primary</emphasis> and <emphasis>backup</emphasis>.
+            The idea is that servers in the primary list are preferred and
+            backup servers are only searched if no primary servers can be
+            reached. If a backup server is selected, a timeout of 30 seconds
+            is set. After this timeout SSSD will periodically try to reconnect
+            to one of the primary servers. If it succeeds, it will replace
+            the current active (backup) server.
+        </para>
     </refsect2>
     <refsect2 id='failover_mechanism'>
         <title>The Failover Mechanism</title>