You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficserver.apache.org by su...@apache.org on 2016/03/05 04:28:14 UTC
[1/2] trafficserver git commit: update docs.
Repository: trafficserver
Updated Branches:
refs/heads/master 95b6f4750 -> 6991aecd9
update docs.
Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/2378e8a9
Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/2378e8a9
Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/2378e8a9
Branch: refs/heads/master
Commit: 2378e8a92eef12144b3a30200d5fe6108e607058
Parents: 95b6f47
Author: Sudheer Vinukonda <su...@yahoo-inc.com>
Authored: Sat Mar 5 03:26:37 2016 +0000
Committer: Sudheer Vinukonda <su...@yahoo-inc.com>
Committed: Sat Mar 5 03:26:37 2016 +0000
----------------------------------------------------------------------
doc/admin-guide/plugins/collapsed_forwarding.en.rst | 16 ++++++++++++----
1 file changed, 12 insertions(+), 4 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/trafficserver/blob/2378e8a9/doc/admin-guide/plugins/collapsed_forwarding.en.rst
----------------------------------------------------------------------
diff --git a/doc/admin-guide/plugins/collapsed_forwarding.en.rst b/doc/admin-guide/plugins/collapsed_forwarding.en.rst
index f6c1607..65bd960 100644
--- a/doc/admin-guide/plugins/collapsed_forwarding.en.rst
+++ b/doc/admin-guide/plugins/collapsed_forwarding.en.rst
@@ -82,6 +82,14 @@ plugin to work::
:ts:cv:`proxy.config.http.background_fill_active_timeout` 0
:ts:cv:`proxy.config.http.background_fill_completed_threshold` 0
+Additionally, given that collapsed forwarding works based on cache write
+lock failure detection, the plugin requires cache to be enabled and ready.
+On a restart, Traffic Server typically takes a few seconds to initialize
+the cache depending on the cache size and number of dirents. While the
+cache is not ready yet, collapsed forwarding can not detect the write lock
+contention and so can not work. The setting :ts:cv:`proxy.config.http.wait_for_cache`
+may be enabled which allows blocking incoming connections from being
+accepted until cache is ready.
Description
-----------
@@ -96,7 +104,7 @@ process intensive file at the Origin layer. This ultimately can cause
stability problems on the origin layer disrupting the overall network
performance.
-ATS supports several kind of connection collapse mechanisms including
+Traffic Server supports several kind of connection collapse mechanisms including
Read-While-Writer (RWW), Stale-While-Revalidate (SWR) etc each very effective
dealing with a majority of the use cases that can result in the
Thundering herd problem.
@@ -157,9 +165,9 @@ from the cache.
However, the Open Read Retry can not help with the concurrent requests
that hit (1.1) above, jumping to (3) directly. Only one such request will
be able to obtain the exclusive write lock and all other requests are
-leaked upstream. This is where, the recently developed ATS feature
-Open Write Fail Action will help. The feature detects the write lock
-failure and can return a stale copy for a Cache Revalidation or a
+leaked upstream. This is where, the recently developed Traffic Server
+feature Open Write Fail Action will help. The feature detects the write
+lock failure and can return a stale copy for a Cache Revalidation or a
5xx status code for a Cache Miss with a special internal header
<@Ats-Internal> that allows a TS plugin to take other special actions
depending on the use-case.
[2/2] trafficserver git commit: update docs.
Posted by su...@apache.org.
update docs.
Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/6991aecd
Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/6991aecd
Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/6991aecd
Branch: refs/heads/master
Commit: 6991aecd9cc0385cf5f76e0e0e444e8eb220f176
Parents: 2378e8a
Author: Sudheer Vinukonda <su...@yahoo-inc.com>
Authored: Sat Mar 5 03:28:03 2016 +0000
Committer: Sudheer Vinukonda <su...@yahoo-inc.com>
Committed: Sat Mar 5 03:28:03 2016 +0000
----------------------------------------------------------------------
plugins/experimental/collapsed_forwarding/README | 8 ++++++++
.../collapsed_forwarding/collapsed_forwarding.cc | 8 ++++++++
2 files changed, 16 insertions(+)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/trafficserver/blob/6991aecd/plugins/experimental/collapsed_forwarding/README
----------------------------------------------------------------------
diff --git a/plugins/experimental/collapsed_forwarding/README b/plugins/experimental/collapsed_forwarding/README
index 4aa2686..6cdd5c5 100644
--- a/plugins/experimental/collapsed_forwarding/README
+++ b/plugins/experimental/collapsed_forwarding/README
@@ -18,6 +18,14 @@
// proxy.config.http.background_fill_active_timeout 0 /////////////////////////
// proxy.config.http.background_fill_completed_threshold 0 /////////////////////////
////////////////////////////////////////////////////////////////////////////////////
+// Additionally, given that collapsed forwarding works based on cache write
+// lock failure detection, the plugin requires cache to be enabled and ready.
+// On a restart, Traffic Server typically takes a few seconds to initialize
+// the cache depending on the cache size and number of dirents. While the
+// cache is not ready yet, collapsed forwarding can not detect the write lock
+// contention and so can not work. The setting proxy.config.http.wait_for_cache
+// may be enabled which allows blocking incoming connections from being
+// accepted until cache is ready.
////////////////////////////////////////////////////////////////////////////////////
// This plugin currently supports only per-remap mode activation.
////////////////////////////////////////////////////////////////////////////////////
http://git-wip-us.apache.org/repos/asf/trafficserver/blob/6991aecd/plugins/experimental/collapsed_forwarding/collapsed_forwarding.cc
----------------------------------------------------------------------
diff --git a/plugins/experimental/collapsed_forwarding/collapsed_forwarding.cc b/plugins/experimental/collapsed_forwarding/collapsed_forwarding.cc
index 18861c7..3a40e4c 100644
--- a/plugins/experimental/collapsed_forwarding/collapsed_forwarding.cc
+++ b/plugins/experimental/collapsed_forwarding/collapsed_forwarding.cc
@@ -39,6 +39,14 @@
// proxy.config.http.background_fill_active_timeout 0 /////////////////////////
// proxy.config.http.background_fill_completed_threshold 0 /////////////////////////
////////////////////////////////////////////////////////////////////////////////////
+// Additionally, given that collapsed forwarding works based on cache write
+// lock failure detection, the plugin requires cache to be enabled and ready.
+// On a restart, Traffic Server typically takes a few seconds to initialize
+// the cache depending on the cache size and number of dirents. While the
+// cache is not ready yet, collapsed forwarding can not detect the write lock
+// contention and so can not work. The setting proxy.config.http.wait_for_cache
+// may be enabled which allows blocking incoming connections from being
+// accepted until cache is ready.
////////////////////////////////////////////////////////////////////////////////////
// This plugin currently supports only per-remap mode activation.
////////////////////////////////////////////////////////////////////////////////////