RepoMirrors/haproxy
1
0
Fork 0
mirror of http://git.haproxy.org/git/haproxy.git/ synced 2025-04-01 22:48:25 +00:00
Code Issues Packages Projects Releases Wiki Activity

DOC: config: clarify the fact that "retries" is not just for connections

Browse Source 
In issue #412 it was rightfully reported that the wording in "retries"
still exclusively speaks about connection attempts, while since L7
retries with "retry-on" it's no longer a limitation. Let's update the
text.
This commit is contained in:
Willy Tarreau 2022-11-25 11:06:20 +01:00
parent 4f4fea417b
commit 0b4a622b49
1 changed files with 12 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
doc/configuration.txt
View File

@ -10631,24 +10631,26 @@ redirect scheme <sch> [code <code>] <option> [{if | unless} <condition>]
retries <value> retries <value>
Set the number of retries to perform on a server after a connection failure Set the number of retries to perform on a server after a failure
May be used in sections: defaults | frontend | listen | backend May be used in sections: defaults | frontend | listen | backend
yes | no | yes | yes yes | no | yes | yes
Arguments : Arguments :
<value> is the number of times a connection attempt should be retried on <value> is the number of times a request or connection attempt should be
a server when a connection either is refused or times out. The retried on a server after a failure.
default value is 3.
It is important to understand that this value applies to the number of By default, retries apply only to new connection attempts. However, when
connection attempts, not full requests. When a connection has effectively the "retry-on" directive is used, other conditions might trigger a retry
been established to a server, there will be no more retry. (e.g. empty response, undesired status code), and each of them will count
one attempt, and when the total number attempts reaches the value here, an
error will be returned.
In order to avoid immediate reconnections to a server which is restarting, In order to avoid immediate reconnections to a server which is restarting,
a turn-around timer of min("timeout connect", one second) is applied before a turn-around timer of min("timeout connect", one second) is applied before
a retry occurs. a retry occurs on the same server.
When "option redispatch" is set, the last retry may be performed on another When "option redispatch" is set, some retries may be performed on another
server even if a cookie references a different server. server even if a cookie references a different server. By default this will
only be the last retry unless an argument is passed to "option redispatch".
See also : "option redispatch" See also : "option redispatch"