~ubuntu-branches/ubuntu/saucy/sssd/saucy

« back to all changes in this revision

Viewing changes to src/man/gu/include/failover.xml

  • Committer: Stéphane Graber
  • Date: 2011-06-15 16:23:14 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: stgraber@ubuntu.com-20110615162314-rbhoppnpaxfqo5q7
Merge 1.5.8

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<refsect1 id='failover'>
 
2
    <title>FAILOVER</title>
 
3
    <para>
 
4
        The failover feature allows back ends to automatically switch to a different
 
5
server if the primary server fails.
 
6
    </para>
 
7
    <refsect2 id='failover_syntax'>
 
8
        <title>Failover Syntax</title>
 
9
        <para>
 
10
            The list of servers is given as a comma-separated list; any number of spaces
 
11
is allowed around the comma. The servers are listed in order of
 
12
preference. The list can contain any number of servers.
 
13
        </para>
 
14
    </refsect2>
 
15
    <refsect2 id='failover_mechanism'>
 
16
        <title>The Failover Mechanism</title>
 
17
        <para>
 
18
            The failover mechanism distinguishes between a machine and a service. The
 
19
back end first tries to resolve the hostname of a given machine; if this
 
20
resolution attempt fails, the machine is considered offline. No further
 
21
attempts are made to connect to this machine for any other service. If the
 
22
resolution attempt succeeds, the back end tries to connect to a service on
 
23
this machine. If the service connection attempt fails, then only this
 
24
particular service is considered offline and the back end automatically
 
25
switches over to the next service.  The machine is still considered online
 
26
and might still be tried for another service.
 
27
        </para>
 
28
        <para>
 
29
            Further connection attempts are made to machines or services marked as
 
30
offline after a specified period of time; this is currently hard coded to 30
 
31
seconds.
 
32
        </para>
 
33
        <para>
 
34
            If there are no more machines to try, the back end as a whole switches to
 
35
offline mode, and then attempts to reconnect every 30 seconds.
 
36
        </para>
 
37
    </refsect2>
 
38
</refsect1>