You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficserver.apache.org by bu...@apache.org on 2013/10/16 23:46:14 UTC
svn commit: r882888 - in /websites/staging/trafficserver/trunk: cgi-bin/
content/ content/docs/trunk/admin/http-proxy-caching/index.en.html
Author: buildbot
Date: Wed Oct 16 21:46:13 2013
New Revision: 882888
Log:
Staging update by buildbot for trafficserver
Modified:
websites/staging/trafficserver/trunk/cgi-bin/ (props changed)
websites/staging/trafficserver/trunk/content/ (props changed)
websites/staging/trafficserver/trunk/content/docs/trunk/admin/http-proxy-caching/index.en.html
Propchange: websites/staging/trafficserver/trunk/cgi-bin/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Oct 16 21:46:13 2013
@@ -1 +1 @@
-1532173
+1532919
Propchange: websites/staging/trafficserver/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Oct 16 21:46:13 2013
@@ -1 +1 @@
-1532173
+1532919
Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/http-proxy-caching/index.en.html
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/http-proxy-caching/index.en.html (original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/http-proxy-caching/index.en.html Wed Oct 16 21:46:13 2013
@@ -706,10 +706,10 @@ resources. There are several features in
<h2 id="ReadWhileWriter">Read While Writer</h2>
<p>When Traffic Server goes to fetch something from origin, and upon receiving the response, any number of clients can be allowed to start serving the partially filled cache object once <code>background_fill_completed_threshold</code> % of the object has been received. The difference is that Squid allows this as soon as it goes to origin, whereas ATS can not do it until we get the complete response header. The reason for this is that we make no distinction between cache refresh, and cold cache, so we have no way to know if a response is going to be cacheable, and therefore allow read-while-writer functionality.</p>
<p>The configurations necessary to enable this are in <a href="../configuration-files/records.config"><code>records.config</code></a>:</p>
-<div class="codehilite"><pre><span class="n">CONFIG</span> <span class="p">[</span><span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">enable_read_while_writer</span><span class="p">](.</span><span class="o">./</span><span class="n">configuration</span><span class="o">-</span><span class="n">files</span><span class="o">/</span><span class="n">records</span><span class="p">.</span><span class="n">config</span>#<span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">enable_read_while_writer</span><span class="p">)</span> <span class="n">INT</span> 1
-<span class="n">CONFIG</span> <span class="p">[</span><span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">background_fill_active_timeou</span><span class="p">](.</span><span class="o">./</span><span class="n">configuration</span><span class="o">-</span><span class="n">files</span><span class="o">/</span><span class="n">records</span><span class="p">.</span><span class="n">config</span>#<span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">background_fill_active_timeou</span><span class="p">)</span> <span class="n">INT</span> 0
-<span class="n">CONFIG</span> <span class="p">[</span><span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">background_fill_completed_threshold</span><span class="p">](.</span><span class="o">./</span><span class="n">configuration</span><span class="o">-</span><span class="n">files</span><span class="o">/</span><span class="n">records</span><span class="p">.</span><span class="n">config</span>#<span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">background_fill_completed_threshold</span><span class="p">)</span> <span class="n">FLOAT</span> 0<span class="p">.</span>000000
-<span class="n">CONFIG</span> <span class="p">[</span><span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">max_doc_size</span><span class="p">](.</span><span class="o">./</span><span class="n">configuration</span><span class="o">-</span><span class="n">files</span><span class="o">/</span><span class="n">records</span><span class="p">.</span><span class="n">config</span>#<span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">max_doc_size</span><span class="p">)</span> <span class="n">INT</span> 0
+<div class="codehilite"><pre><span class="n">CONFIG</span> <span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">enable_read_while_writer</span> <span class="n">INT</span> 1
+<span class="n">CONFIG</span> <span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">background_fill_active_timeout</span> <span class="n">INT</span> 0
+<span class="n">CONFIG</span> <span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">background_fill_completed_threshold</span> <span class="n">FLOAT</span> 0<span class="p">.</span>000000
+<span class="n">CONFIG</span> <span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">max_doc_size</span> <span class="n">INT</span> 0
</pre></div>
@@ -722,9 +722,9 @@ resources. There are several features in
<p>Once all this enabled, you have something that is very close, but not quite the same, as Squid's Collapsed Forwarding.</p>
<h2 id="FuzzyRevalidation">Fuzzy Revalidation</h2>
<p>Traffic Server can be set to attempt to revalidate an object before it becomes stale in cache. <a href="../configuration-files/records.config"><code>records.config</code></a> contains the settings:</p>
-<div class="codehilite"><pre><span class="n">CONFIG</span> <span class="p">[</span><span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">fuzz</span><span class="p">.</span><span class="n">time</span><span class="p">](.</span><span class="o">./</span><span class="n">configuration</span><span class="o">-</span><span class="n">files</span><span class="o">/</span><span class="n">records</span><span class="p">.</span><span class="n">config</span>#<span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">fuzz</span><span class="p">.</span><span class="n">time</span><span class="p">)</span> <span class="n">INT</span> 240
-<span class="n">CONFIG</span> <span class="p">[</span><span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">fuzz</span><span class="p">.</span><span class="n">min_time</span><span class="p">](.</span><span class="o">./</span><span class="n">configuration</span><span class="o">-</span><span class="n">files</span><span class="o">/</span><span class="n">records</span><span class="p">.</span><span class="n">config</span>#<span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">fuzz</span><span class="p">.</span><span class="n">min_time</span><span class="p">)</span> <span class="n">INT</span> 0
-<span class="n">CONFIG</span> <span class="p">[</span><span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">fuzz</span><span class="p">.</span><span class="n">probability</span><span class="p">](.</span><span class="o">./</span><span class="n">configuration</span><span class="o">-</span><span class="n">files</span><span class="o">/</span><span class="n">records</span><span class="p">.</span><span class="n">config</span>#<span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">fuzz</span><span class="p">.</span><span class="n">probability</span><span class="p">)</span> <span class="n">FLOAT</span> 0<span class="p">.</span>005
+<div class="codehilite"><pre><span class="n">CONFIG</span> <span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">fuzz</span><span class="p">.</span><span class="n">time</span> <span class="n">INT</span> 240
+<span class="n">CONFIG</span> <span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">fuzz</span><span class="p">.</span><span class="n">min_time</span> <span class="n">INT</span> 0
+<span class="n">CONFIG</span> <span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">fuzz</span><span class="p">.</span><span class="n">probability</span> <span class="n">FLOAT</span> 0<span class="p">.</span>005
</pre></div>
@@ -740,8 +740,8 @@ requests for that object will be proxied
<p>Similarly, this setting should be used in conjunction with Read While Writer for big (those that take longer than (<code>max_open_read_retries</code> x <code>open_read_retry_time</code>) milliseconds to transfer) cacheable objects. Without the read-while-writer settings enabled, while the initial fetch is ongoing, not only would subsequent requests be delayed by the maximum time, but also, those requests would result in another request to the origin server.</p>
<p>Since ATS now supports setting these settings per-request or remap rule, you can configure this to be suitable for your setup much more easily.</p>
<p>The configurations are (with defaults):</p>
-<div class="codehilite"><pre><span class="n">CONFIG</span> <span class="p">[</span><span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">max_open_read_retries</span><span class="p">](.</span><span class="o">./</span><span class="n">configuration</span><span class="o">-</span><span class="n">files</span><span class="o">/</span><span class="n">records</span><span class="p">.</span><span class="n">config</span>#<span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">max_open_read_retries</span><span class="p">)</span> <span class="n">INT</span> <span class="o">-</span>1
-<span class="n">CONFIG</span> <span class="p">[</span><span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">open_read_retry_time</span><span class="p">](.</span><span class="o">./</span><span class="n">configuration</span><span class="o">-</span><span class="n">files</span><span class="o">/</span><span class="n">records</span><span class="p">.</span><span class="n">config</span>#<span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">open_read_retry_time</span><span class="p">)</span> <span class="n">INT</span> 10
+<div class="codehilite"><pre><span class="n">CONFIG</span> <span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">max_open_read_retries</span> <span class="n">INT</span> <span class="o">-</span>1
+<span class="n">CONFIG</span> <span class="n">proxy</span><span class="p">.</span><span class="n">config</span><span class="p">.</span><span class="n">http</span><span class="p">.</span><span class="n">cache</span><span class="p">.</span><span class="n">open_read_retry_time</span> <span class="n">INT</span> 10
</pre></div>