You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficserver.apache.org by dc...@apache.org on 2015/02/06 18:31:30 UTC

trafficserver git commit: Clarify Origin Server Connect Attempts documentation TS-242: make it clear that proxy.config.http.connect_attempts_timeout is for time to first byte

Repository: trafficserver
Updated Branches:
  refs/heads/master 24f1e55c0 -> d77730387


Clarify Origin Server Connect Attempts documentation
TS-242: make it clear that proxy.config.http.connect_attempts_timeout is
for time to first byte


Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/d7773038
Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/d7773038
Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/d7773038

Branch: refs/heads/master
Commit: d77730387c41359cd3612fd4462865bbfe0ac57d
Parents: 24f1e55
Author: David Carlin <dc...@apache.org>
Authored: Fri Feb 6 17:29:46 2015 +0000
Committer: David Carlin <dc...@apache.org>
Committed: Fri Feb 6 17:29:46 2015 +0000

----------------------------------------------------------------------
 doc/reference/configuration/records.config.en.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/trafficserver/blob/d7773038/doc/reference/configuration/records.config.en.rst
----------------------------------------------------------------------
diff --git a/doc/reference/configuration/records.config.en.rst b/doc/reference/configuration/records.config.en.rst
index aa30d03..e65a03c 100644
--- a/doc/reference/configuration/records.config.en.rst
+++ b/doc/reference/configuration/records.config.en.rst
@@ -924,12 +924,17 @@ Origin Server Connect Attempts
 .. ts:cv:: CONFIG proxy.config.http.connect_attempts_max_retries INT 6
    :reloadable:
 
-   The maximum number of connection retries Traffic Server can make when the origin server is not responding.
+   The maximum number of connection retries Traffic Server can make when the origin server is not responding.  
+   Each retry attempt lasts for `proxy.config.http.connect_attempts_timeout`_ seconds.  Once the maximum number of retries is
+   reached, the origin is marked dead.  After this, the setting  `proxy.config.http.connect_attempts_max_retries_dead_server`_
+   is used to limit the number of retry attempts to the known dead origin.
 
 .. ts:cv:: CONFIG proxy.config.http.connect_attempts_max_retries_dead_server INT 3
    :reloadable:
 
-   The maximum number of connection retries Traffic Server can make when the origin server is unavailable.
+   Maximum number of connection retries Traffic Server can make while an origin is marked dead.  Typically this value is smaller than
+   `proxy.config.http.connect_attempts_max_retries`_ so an error is returned to the client faster and also to reduce the load on the dead origin.
+   The timeout interval `proxy.config.http.connect_attempts_timeout`_ in seconds is used with this setting.
 
 .. ts:cv:: CONFIG proxy.config.http.server_max_connections INT 0
    :reloadable:
@@ -963,7 +968,7 @@ Origin Server Connect Attempts
 .. ts:cv:: CONFIG proxy.config.http.connect_attempts_timeout INT 30
    :reloadable:
 
-   The timeout value (in seconds) for an origin server connection.
+   The timeout value (in seconds) for **time to first byte** for an origin server connection.
 
 .. ts:cv:: CONFIG proxy.config.http.post_connect_attempts_timeout INT 1800
    :reloadable: