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 <[email protected]> Authored: Fri Feb 6 17:29:46 2015 +0000 Committer: David Carlin <[email protected]> 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:
