You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficcontrol.apache.org by da...@apache.org on 2017/06/07 23:28:23 UTC
[09/51] [abbrv] [partial] incubator-trafficcontrol-website git
commit: copy 1.8.1 docs to latest
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/9c7fc09d/docs/latest/basics/caching_proxies.html
----------------------------------------------------------------------
diff --git a/docs/latest/basics/caching_proxies.html b/docs/latest/basics/caching_proxies.html
index 2e50bca..801c457 100644
--- a/docs/latest/basics/caching_proxies.html
+++ b/docs/latest/basics/caching_proxies.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Caching Proxies — Traffic Control master documentation </title>
+ <title>Caching Proxies — Traffic Control 1.8.1 documentation </title>
@@ -33,7 +33,10 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="index" title="Index"
+ href="../genindex.html"/>
+ <link rel="search" title="Search" href="../search.html"/>
+ <link rel="top" title="Traffic Control 1.8.1 documentation" href="../index.html"/>
<link rel="up" title="CDN Basics" href="index.html"/>
<link rel="next" title="Cache Control Headers and Revalidation" href="cache_revalidation.html"/>
<link rel="prev" title="HTTP 1.1" href="http_11.html"/>
@@ -58,7 +61,7 @@
- <img src="../_static/tc_logo_c_only.png" class="logo" />
+ <img src="../_static/tc_logo.png" class="logo" />
</a>
@@ -82,7 +85,7 @@
<li class="toctree-l1 current"><a class="reference internal" href="index.html">CDN Basics</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="content_delivery_networks.html">Content Delivery Networks</a></li>
<li class="toctree-l2"><a class="reference internal" href="http_11.html">HTTP 1.1</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="">Caching Proxies</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Caching Proxies</a></li>
<li class="toctree-l2"><a class="reference internal" href="cache_revalidation.html">Cache Control Headers and Revalidation</a></li>
</ul>
</li>
@@ -159,14 +162,14 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8.1</a> »</li>
<li><a href="index.html">CDN Basics</a> »</li>
<li>Caching Proxies</li>
<li class="wy-breadcrumbs-aside">
- <a href="../_sources/basics/caching_proxies.txt" rel="nofollow"> View page source</a>
+ <a href="../_sources/basics/caching_proxies.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
@@ -222,16 +225,16 @@ cache is: <code class="docutils literal"><span class="pre">http://www-origin-cac
<p class="first admonition-title">Note</p>
<p class="last">In the previous example minimal headers were shown on both the request and response. In the examples that follow, the origin server response is more realistic.</p>
</div>
-<div class="highlight-python"><div class="highlight"><pre>HTTP/1.1 200 OK
-Date: Sun, 14 Dec 2014 23:22:44 GMT
-Server: Apache/2.2.15 (Red Hat)
-Last-Modified: Sun, 14 Dec 2014 23:18:51 GMT
-ETag: "1aa008f-2d-50a3559482cc0"
-Content-Length: 45
-Connection: close
-Content-Type: text/html; charset=UTF-8
-
-<html><body>This is a fun file</body></html>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span> <span class="mi">200</span> <span class="n">OK</span>
+<span class="n">Date</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">22</span><span class="p">:</span><span class="mi">44</span> <span class="n">GMT</span>
+<span class="n">Server</span><span class="p">:</span> <span class="n">Apache</span><span class="o">/</span><span class="mf">2.2</span><span class="o">.</span><span class="mi">15</span> <span class="p">(</span><span class="n">Red</span> <span class="n">Hat</span><span class="p">)</span>
+<span class="n">Last</span><span class="o">-</span><span class="n">Modified</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">18</span><span class="p">:</span><span class="mi">51</span> <span class="n">GMT</span>
+<span class="n">ETag</span><span class="p">:</span> <span class="s2">"1aa008f-2d-50a3559482cc0"</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Length</span><span class="p">:</span> <span class="mi">45</span>
+<span class="n">Connection</span><span class="p">:</span> <span class="n">close</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Type</span><span class="p">:</span> <span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">;</span> <span class="n">charset</span><span class="o">=</span><span class="n">UTF</span><span class="o">-</span><span class="mi">8</span>
+
+<span class="o"><</span><span class="n">html</span><span class="o">><</span><span class="n">body</span><span class="o">></span><span class="n">This</span> <span class="ow">is</span> <span class="n">a</span> <span class="n">fun</span> <span class="n">file</span><span class="o"></</span><span class="n">body</span><span class="o">></</span><span class="n">html</span><span class="o">></span>
</pre></div>
</div>
<p>The client is given the URL <code class="docutils literal"><span class="pre">http://www-origin-cache.cdn.com/foo/bar/fun.html</span></code> (note the different hostname) and when attempting to obtain that URL, the following occurs:</p>
@@ -241,8 +244,8 @@ Content-Type: text/html; charset=UTF-8
<li><p class="first">Similar to the previous case, the LDNS server resolves the name <code class="docutils literal"><span class="pre">www-origin-cache.cdn.com</span></code> to an IPv4 address, in this example, this address is 55.44.33.22.</p>
</li>
<li><p class="first">The client opens a TCP connection from a random port locally, to port 80 (the HTTP default) on 55.44.33.22, and sends the following:</p>
-<div class="highlight-python"><div class="highlight"><pre>GET /foo/bar/fun.html HTTP/1.1
-Host: www-origin-cache.cdn.com
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">GET</span> <span class="o">/</span><span class="n">foo</span><span class="o">/</span><span class="n">bar</span><span class="o">/</span><span class="n">fun</span><span class="o">.</span><span class="n">html</span> <span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span>
+<span class="n">Host</span><span class="p">:</span> <span class="n">www</span><span class="o">-</span><span class="n">origin</span><span class="o">-</span><span class="n">cache</span><span class="o">.</span><span class="n">cdn</span><span class="o">.</span><span class="n">com</span>
</pre></div>
</div>
</li>
@@ -255,38 +258,38 @@ Host: www-origin-cache.cdn.com
<blockquote>
<div><ol class="arabic">
<li><p class="first">The proxy uses DNS to get the IPv4 address for <code class="docutils literal"><span class="pre">www.origin.com</span></code>, connect to it on port 80, and sends:</p>
-<div class="highlight-python"><div class="highlight"><pre>GET /foo/bar/fun.html HTTP/1.1
-Host: www.origin.com
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">GET</span> <span class="o">/</span><span class="n">foo</span><span class="o">/</span><span class="n">bar</span><span class="o">/</span><span class="n">fun</span><span class="o">.</span><span class="n">html</span> <span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span>
+<span class="n">Host</span><span class="p">:</span> <span class="n">www</span><span class="o">.</span><span class="n">origin</span><span class="o">.</span><span class="n">com</span>
</pre></div>
</div>
</li>
<li><p class="first">The origin server responds with the headers and content as shown:</p>
-<div class="highlight-python"><div class="highlight"><pre>HTTP/1.1 200 OK
-Date: Sun, 14 Dec 2014 23:22:44 GMT
-Server: Apache/2.2.15 (Red Hat)
-Last-Modified: Sun, 14 Dec 2014 23:18:51 GMT
-ETag: "1aa008f-2d-50a3559482cc0"
-Content-Length: 45
-Connection: close
-Content-Type: text/html; charset=UTF-8
-
-<html><body>This is a fun file</body></html>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span> <span class="mi">200</span> <span class="n">OK</span>
+<span class="n">Date</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">22</span><span class="p">:</span><span class="mi">44</span> <span class="n">GMT</span>
+<span class="n">Server</span><span class="p">:</span> <span class="n">Apache</span><span class="o">/</span><span class="mf">2.2</span><span class="o">.</span><span class="mi">15</span> <span class="p">(</span><span class="n">Red</span> <span class="n">Hat</span><span class="p">)</span>
+<span class="n">Last</span><span class="o">-</span><span class="n">Modified</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">18</span><span class="p">:</span><span class="mi">51</span> <span class="n">GMT</span>
+<span class="n">ETag</span><span class="p">:</span> <span class="s2">"1aa008f-2d-50a3559482cc0"</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Length</span><span class="p">:</span> <span class="mi">45</span>
+<span class="n">Connection</span><span class="p">:</span> <span class="n">close</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Type</span><span class="p">:</span> <span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">;</span> <span class="n">charset</span><span class="o">=</span><span class="n">UTF</span><span class="o">-</span><span class="mi">8</span>
+
+<span class="o"><</span><span class="n">html</span><span class="o">><</span><span class="n">body</span><span class="o">></span><span class="n">This</span> <span class="ow">is</span> <span class="n">a</span> <span class="n">fun</span> <span class="n">file</span><span class="o"></</span><span class="n">body</span><span class="o">></</span><span class="n">html</span><span class="o">></span>
</pre></div>
</div>
</li>
<li><p class="first">The proxy sends the origin response on to the client adding a <code class="docutils literal"><span class="pre">Via:</span></code> header (and maybe others):</p>
-<div class="highlight-python"><div class="highlight"><pre>HTTP/1.1 200 OK
-Date: Sun, 14 Dec 2014 23:22:44 GMT
-Last-Modified: Sun, 14 Dec 2014 23:18:51 GMT
-ETag: "1aa008f-2d-50a3559482cc0"
-Content-Length: 45
-Connection: close
-Content-Type: text/html; charset=UTF-8
-Age: 0
-Via: http/1.1 cache01.cdn.kabletown.net (ApacheTrafficServer/4.2.1 [uScSsSfUpSeN:t cCSi p sS])
-Server: ATS/4.2.1
-
- <html><body>This is a fun file</body></html>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span> <span class="mi">200</span> <span class="n">OK</span>
+<span class="n">Date</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">22</span><span class="p">:</span><span class="mi">44</span> <span class="n">GMT</span>
+<span class="n">Last</span><span class="o">-</span><span class="n">Modified</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">18</span><span class="p">:</span><span class="mi">51</span> <span class="n">GMT</span>
+<span class="n">ETag</span><span class="p">:</span> <span class="s2">"1aa008f-2d-50a3559482cc0"</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Length</span><span class="p">:</span> <span class="mi">45</span>
+<span class="n">Connection</span><span class="p">:</span> <span class="n">close</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Type</span><span class="p">:</span> <span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">;</span> <span class="n">charset</span><span class="o">=</span><span class="n">UTF</span><span class="o">-</span><span class="mi">8</span>
+<span class="n">Age</span><span class="p">:</span> <span class="mi">0</span>
+<span class="n">Via</span><span class="p">:</span> <span class="n">http</span><span class="o">/</span><span class="mf">1.1</span> <span class="n">cache01</span><span class="o">.</span><span class="n">cdn</span><span class="o">.</span><span class="n">kabletown</span><span class="o">.</span><span class="n">net</span> <span class="p">(</span><span class="n">ApacheTrafficServer</span><span class="o">/</span><span class="mf">4.2</span><span class="o">.</span><span class="mi">1</span> <span class="p">[</span><span class="n">uScSsSfUpSeN</span><span class="p">:</span><span class="n">t</span> <span class="n">cCSi</span> <span class="n">p</span> <span class="n">sS</span><span class="p">])</span>
+<span class="n">Server</span><span class="p">:</span> <span class="n">ATS</span><span class="o">/</span><span class="mf">4.2</span><span class="o">.</span><span class="mi">1</span>
+
+ <span class="o"><</span><span class="n">html</span><span class="o">><</span><span class="n">body</span><span class="o">></span><span class="n">This</span> <span class="ow">is</span> <span class="n">a</span> <span class="n">fun</span> <span class="n">file</span><span class="o"></</span><span class="n">body</span><span class="o">></</span><span class="n">html</span><span class="o">></span>
</pre></div>
</div>
</li>
@@ -295,18 +298,18 @@ Server: ATS/4.2.1
<p>6b. If it <em>is</em> in the cache:</p>
<blockquote>
<div><p>The proxy responds to the client with the previously retrieved result:</p>
-<div class="highlight-python"><div class="highlight"><pre>HTTP/1.1 200 OK
-Date: Sun, 14 Dec 2014 23:22:44 GMT
-Last-Modified: Sun, 14 Dec 2014 23:18:51 GMT
-ETag: "1aa008f-2d-50a3559482cc0"
-Content-Length: 45
-Connection: close
-Content-Type: text/html; charset=UTF-8
-Age: 39711
-Via: http/1.1 cache01.cdn.kabletown.net (ApacheTrafficServer/4.2.1 [uScSsSfUpSeN:t cCSi p sS])
-Server: ATS/4.2.1
-
-<html><body>This is a fun file</body></html>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span> <span class="mi">200</span> <span class="n">OK</span>
+<span class="n">Date</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">22</span><span class="p">:</span><span class="mi">44</span> <span class="n">GMT</span>
+<span class="n">Last</span><span class="o">-</span><span class="n">Modified</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">18</span><span class="p">:</span><span class="mi">51</span> <span class="n">GMT</span>
+<span class="n">ETag</span><span class="p">:</span> <span class="s2">"1aa008f-2d-50a3559482cc0"</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Length</span><span class="p">:</span> <span class="mi">45</span>
+<span class="n">Connection</span><span class="p">:</span> <span class="n">close</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Type</span><span class="p">:</span> <span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">;</span> <span class="n">charset</span><span class="o">=</span><span class="n">UTF</span><span class="o">-</span><span class="mi">8</span>
+<span class="n">Age</span><span class="p">:</span> <span class="mi">39711</span>
+<span class="n">Via</span><span class="p">:</span> <span class="n">http</span><span class="o">/</span><span class="mf">1.1</span> <span class="n">cache01</span><span class="o">.</span><span class="n">cdn</span><span class="o">.</span><span class="n">kabletown</span><span class="o">.</span><span class="n">net</span> <span class="p">(</span><span class="n">ApacheTrafficServer</span><span class="o">/</span><span class="mf">4.2</span><span class="o">.</span><span class="mi">1</span> <span class="p">[</span><span class="n">uScSsSfUpSeN</span><span class="p">:</span><span class="n">t</span> <span class="n">cCSi</span> <span class="n">p</span> <span class="n">sS</span><span class="p">])</span>
+<span class="n">Server</span><span class="p">:</span> <span class="n">ATS</span><span class="o">/</span><span class="mf">4.2</span><span class="o">.</span><span class="mi">1</span>
+
+<span class="o"><</span><span class="n">html</span><span class="o">><</span><span class="n">body</span><span class="o">></span><span class="n">This</span> <span class="ow">is</span> <span class="n">a</span> <span class="n">fun</span> <span class="n">file</span><span class="o"></</span><span class="n">body</span><span class="o">></</span><span class="n">html</span><span class="o">></span>
</pre></div>
</div>
</div></blockquote>
@@ -331,7 +334,7 @@ client obtains, and is unaware of the proxy in the middle.</div></blockquote>
<li>To retrieve <code class="docutils literal"><span class="pre">http://www.origin.com/foo/bar/fun.html</span></code> URL, the client connects to 99.88.77.66 on port 8080 and sends:</li>
</ol>
<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>GET http://www.origin.com/foo/bar/fun.html HTTP/1.1
+<div><div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">GET</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="n">www</span><span class="o">.</span><span class="n">origin</span><span class="o">.</span><span class="n">com</span><span class="o">/</span><span class="n">foo</span><span class="o">/</span><span class="n">bar</span><span class="o">/</span><span class="n">fun</span><span class="o">.</span><span class="n">html</span> <span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span>
</pre></div>
</div>
<div class="admonition note">
@@ -346,38 +349,38 @@ client obtains, and is unaware of the proxy in the middle.</div></blockquote>
<blockquote>
<div><ol class="arabic">
<li><p class="first">The proxy uses DNS to obtain the IPv4 address for <code class="docutils literal"><span class="pre">www.origin.com</span></code>, connects to it on port 80, and sends:</p>
-<div class="highlight-python"><div class="highlight"><pre>GET /foo/bar/fun.html HTTP/1.1
-Host: www.origin.com
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">GET</span> <span class="o">/</span><span class="n">foo</span><span class="o">/</span><span class="n">bar</span><span class="o">/</span><span class="n">fun</span><span class="o">.</span><span class="n">html</span> <span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span>
+<span class="n">Host</span><span class="p">:</span> <span class="n">www</span><span class="o">.</span><span class="n">origin</span><span class="o">.</span><span class="n">com</span>
</pre></div>
</div>
</li>
<li><p class="first">The origin server responds with the headers and content as shown below:</p>
-<div class="highlight-python"><div class="highlight"><pre>HTTP/1.1 200 OK
-Date: Sun, 14 Dec 2014 23:22:44 GMT
-Server: Apache/2.2.15 (Red Hat)
-Last-Modified: Sun, 14 Dec 2014 23:18:51 GMT
-ETag: "1aa008f-2d-50a3559482cc0"
-Content-Length: 45
-Connection: close
-Content-Type: text/html; charset=UTF-8
-
-<html><body>This is a fun file</body></html>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span> <span class="mi">200</span> <span class="n">OK</span>
+<span class="n">Date</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">22</span><span class="p">:</span><span class="mi">44</span> <span class="n">GMT</span>
+<span class="n">Server</span><span class="p">:</span> <span class="n">Apache</span><span class="o">/</span><span class="mf">2.2</span><span class="o">.</span><span class="mi">15</span> <span class="p">(</span><span class="n">Red</span> <span class="n">Hat</span><span class="p">)</span>
+<span class="n">Last</span><span class="o">-</span><span class="n">Modified</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">18</span><span class="p">:</span><span class="mi">51</span> <span class="n">GMT</span>
+<span class="n">ETag</span><span class="p">:</span> <span class="s2">"1aa008f-2d-50a3559482cc0"</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Length</span><span class="p">:</span> <span class="mi">45</span>
+<span class="n">Connection</span><span class="p">:</span> <span class="n">close</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Type</span><span class="p">:</span> <span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">;</span> <span class="n">charset</span><span class="o">=</span><span class="n">UTF</span><span class="o">-</span><span class="mi">8</span>
+
+<span class="o"><</span><span class="n">html</span><span class="o">><</span><span class="n">body</span><span class="o">></span><span class="n">This</span> <span class="ow">is</span> <span class="n">a</span> <span class="n">fun</span> <span class="n">file</span><span class="o"></</span><span class="n">body</span><span class="o">></</span><span class="n">html</span><span class="o">></span>
</pre></div>
</div>
</li>
<li><p class="first">The proxy sends this on to the client adding a <code class="docutils literal"><span class="pre">Via:</span></code> header (and maybe others):</p>
-<div class="highlight-python"><div class="highlight"><pre>HTTP/1.1 200 OK
-Date: Sun, 14 Dec 2014 23:22:44 GMT
-Last-Modified: Sun, 14 Dec 2014 23:18:51 GMT
-ETag: "1aa008f-2d-50a3559482cc0"
-Content-Length: 45
-Connection: close
-Content-Type: text/html; charset=UTF-8
-Age: 0
-Via: http/1.1 cache01.cdn.kabletown.net (ApacheTrafficServer/4.2.1 [uScSsSfUpSeN:t cCSi p sS])
-Server: ATS/4.2.1
-
-<html><body>This is a fun file</body></html>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span> <span class="mi">200</span> <span class="n">OK</span>
+<span class="n">Date</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">22</span><span class="p">:</span><span class="mi">44</span> <span class="n">GMT</span>
+<span class="n">Last</span><span class="o">-</span><span class="n">Modified</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">18</span><span class="p">:</span><span class="mi">51</span> <span class="n">GMT</span>
+<span class="n">ETag</span><span class="p">:</span> <span class="s2">"1aa008f-2d-50a3559482cc0"</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Length</span><span class="p">:</span> <span class="mi">45</span>
+<span class="n">Connection</span><span class="p">:</span> <span class="n">close</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Type</span><span class="p">:</span> <span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">;</span> <span class="n">charset</span><span class="o">=</span><span class="n">UTF</span><span class="o">-</span><span class="mi">8</span>
+<span class="n">Age</span><span class="p">:</span> <span class="mi">0</span>
+<span class="n">Via</span><span class="p">:</span> <span class="n">http</span><span class="o">/</span><span class="mf">1.1</span> <span class="n">cache01</span><span class="o">.</span><span class="n">cdn</span><span class="o">.</span><span class="n">kabletown</span><span class="o">.</span><span class="n">net</span> <span class="p">(</span><span class="n">ApacheTrafficServer</span><span class="o">/</span><span class="mf">4.2</span><span class="o">.</span><span class="mi">1</span> <span class="p">[</span><span class="n">uScSsSfUpSeN</span><span class="p">:</span><span class="n">t</span> <span class="n">cCSi</span> <span class="n">p</span> <span class="n">sS</span><span class="p">])</span>
+<span class="n">Server</span><span class="p">:</span> <span class="n">ATS</span><span class="o">/</span><span class="mf">4.2</span><span class="o">.</span><span class="mi">1</span>
+
+<span class="o"><</span><span class="n">html</span><span class="o">><</span><span class="n">body</span><span class="o">></span><span class="n">This</span> <span class="ow">is</span> <span class="n">a</span> <span class="n">fun</span> <span class="n">file</span><span class="o"></</span><span class="n">body</span><span class="o">></</span><span class="n">html</span><span class="o">></span>
</pre></div>
</div>
</li>
@@ -386,18 +389,18 @@ Server: ATS/4.2.1
<p>4b. If it <em>is</em> in the cache:</p>
<blockquote>
<div><p>The proxy responds to the client with the previously retrieved result:</p>
-<div class="highlight-python"><div class="highlight"><pre>HTTP/1.1 200 OK
-Date: Sun, 14 Dec 2014 23:22:44 GMT
-Last-Modified: Sun, 14 Dec 2014 23:18:51 GMT
-ETag: "1aa008f-2d-50a3559482cc0"
-Content-Length: 45
-Connection: close
-Content-Type: text/html; charset=UTF-8
-Age: 99711
-Via: http/1.1 cache01.cdn.kabletown.net (ApacheTrafficServer/4.2.1 [uScSsSfUpSeN:t cCSi p sS])
-Server: ATS/4.2.1
-
-<html><body>This is a fun file</body></html>
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span> <span class="mi">200</span> <span class="n">OK</span>
+<span class="n">Date</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">22</span><span class="p">:</span><span class="mi">44</span> <span class="n">GMT</span>
+<span class="n">Last</span><span class="o">-</span><span class="n">Modified</span><span class="p">:</span> <span class="n">Sun</span><span class="p">,</span> <span class="mi">14</span> <span class="n">Dec</span> <span class="mi">2014</span> <span class="mi">23</span><span class="p">:</span><span class="mi">18</span><span class="p">:</span><span class="mi">51</span> <span class="n">GMT</span>
+<span class="n">ETag</span><span class="p">:</span> <span class="s2">"1aa008f-2d-50a3559482cc0"</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Length</span><span class="p">:</span> <span class="mi">45</span>
+<span class="n">Connection</span><span class="p">:</span> <span class="n">close</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Type</span><span class="p">:</span> <span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">;</span> <span class="n">charset</span><span class="o">=</span><span class="n">UTF</span><span class="o">-</span><span class="mi">8</span>
+<span class="n">Age</span><span class="p">:</span> <span class="mi">99711</span>
+<span class="n">Via</span><span class="p">:</span> <span class="n">http</span><span class="o">/</span><span class="mf">1.1</span> <span class="n">cache01</span><span class="o">.</span><span class="n">cdn</span><span class="o">.</span><span class="n">kabletown</span><span class="o">.</span><span class="n">net</span> <span class="p">(</span><span class="n">ApacheTrafficServer</span><span class="o">/</span><span class="mf">4.2</span><span class="o">.</span><span class="mi">1</span> <span class="p">[</span><span class="n">uScSsSfUpSeN</span><span class="p">:</span><span class="n">t</span> <span class="n">cCSi</span> <span class="n">p</span> <span class="n">sS</span><span class="p">])</span>
+<span class="n">Server</span><span class="p">:</span> <span class="n">ATS</span><span class="o">/</span><span class="mf">4.2</span><span class="o">.</span><span class="mi">1</span>
+
+<span class="o"><</span><span class="n">html</span><span class="o">><</span><span class="n">body</span><span class="o">></span><span class="n">This</span> <span class="ow">is</span> <span class="n">a</span> <span class="n">fun</span> <span class="n">file</span><span class="o"></</span><span class="n">body</span><span class="o">></</span><span class="n">html</span><span class="o">></span>
</pre></div>
</div>
</div></blockquote>
@@ -447,7 +450,7 @@ Server: ATS/4.2.1
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8.1',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/9c7fc09d/docs/latest/basics/content_delivery_networks.html
----------------------------------------------------------------------
diff --git a/docs/latest/basics/content_delivery_networks.html b/docs/latest/basics/content_delivery_networks.html
index 85685f8..85a644e 100644
--- a/docs/latest/basics/content_delivery_networks.html
+++ b/docs/latest/basics/content_delivery_networks.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Content Delivery Networks — Traffic Control master documentation </title>
+ <title>Content Delivery Networks — Traffic Control 1.8.1 documentation </title>
@@ -33,7 +33,10 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="index" title="Index"
+ href="../genindex.html"/>
+ <link rel="search" title="Search" href="../search.html"/>
+ <link rel="top" title="Traffic Control 1.8.1 documentation" href="../index.html"/>
<link rel="up" title="CDN Basics" href="index.html"/>
<link rel="next" title="HTTP 1.1" href="http_11.html"/>
<link rel="prev" title="CDN Basics" href="index.html"/>
@@ -58,7 +61,7 @@
- <img src="../_static/tc_logo_c_only.png" class="logo" />
+ <img src="../_static/tc_logo.png" class="logo" />
</a>
@@ -80,7 +83,7 @@
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal" href="index.html">CDN Basics</a><ul class="current">
-<li class="toctree-l2 current"><a class="current reference internal" href="">Content Delivery Networks</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Content Delivery Networks</a></li>
<li class="toctree-l2"><a class="reference internal" href="http_11.html">HTTP 1.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="caching_proxies.html">Caching Proxies</a></li>
<li class="toctree-l2"><a class="reference internal" href="cache_revalidation.html">Cache Control Headers and Revalidation</a></li>
@@ -159,14 +162,14 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8.1</a> »</li>
<li><a href="index.html">CDN Basics</a> »</li>
<li>Content Delivery Networks</li>
<li class="wy-breadcrumbs-aside">
- <a href="../_sources/basics/content_delivery_networks.txt" rel="nofollow"> View page source</a>
+ <a href="../_sources/basics/content_delivery_networks.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
@@ -187,35 +190,30 @@
<div class="section" id="content-delivery-networks">
<span id="index-0"></span><h1>Content Delivery Networks<a class="headerlink" href="#content-delivery-networks" title="Permalink to this headline">¶</a></h1>
<p>The vast majority of today’s Internet traffic is media files (often video or audio) being sent from a single source (the <em>Content Provider</em>) to many thousands or even millions of destinations (the <em>Content Consumers</em>). Content Delivery Networks are the technology that make that one-to-many distribution possible in an economical way. A Content Delivery Network (CDN) is a distributed system of servers for delivering content over HTTP. These servers are deployed in multiple locations with the goal of optimizing the delivery of content to the end users, while minimizing the traffic on the network. A CDN typically consists of the following:</p>
-<ul>
+<ul class="simple">
<li><dl class="first docutils">
<dt><strong>Caching Proxies</strong></dt>
-<dd><p class="first last">The proxy (cache or caching proxy) is a server that both proxies the requests and caches the results for reusing.</p>
-</dd>
+<dd>The proxy (cache or caching proxy) is a server that both proxies the requests and caches the results for reusing.</dd>
</dl>
</li>
<li><dl class="first docutils">
<dt><strong>Content Router</strong></dt>
-<dd><p class="first last">The Content Router ensures that the end user is connected to the optimal cache for the location of the end user and content availability.</p>
-</dd>
+<dd>The Content Router ensures that the end user is connected to the optimal cache for the location of the end user and content availability.</dd>
</dl>
</li>
<li><dl class="first docutils">
<dt><strong>Health Protocol</strong></dt>
-<dd><p class="first last">The Health Protocol monitors the usage of the caches and tenants in the CDN.</p>
-</dd>
+<dd>The Health Protocol monitors the usage of the caches and tenants in the CDN.</dd>
</dl>
</li>
<li><dl class="first docutils">
<dt><strong>Configuration Management System</strong></dt>
-<dd><p class="first last">In many cases a CDN encompasses hundreds of servers across a large geographic area. The Configuration Management System allows an operator to manage these servers.</p>
-</dd>
+<dd>In many cases a CDN encompasses hundreds of servers across a large geographic area. The Configuration Management System allows an operator to manage these servers.</dd>
</dl>
</li>
<li><dl class="first docutils">
<dt><strong>Log File Analysis System</strong></dt>
-<dd><p class="first last">Every transaction in the CDN gets logged. The Log File Analysis System aggregates all of the log entries from all of the servers to a central location for analysis and troubleshooting.</p>
-</dd>
+<dd>Every transaction in the CDN gets logged. The Log File Analysis System aggregates all of the log entries from all of the servers to a central location for analysis and troubleshooting.</dd>
</dl>
</li>
</ul>
@@ -259,7 +257,7 @@
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8.1',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/9c7fc09d/docs/latest/basics/http_11.html
----------------------------------------------------------------------
diff --git a/docs/latest/basics/http_11.html b/docs/latest/basics/http_11.html
index 36b3776..9d1fb0f 100644
--- a/docs/latest/basics/http_11.html
+++ b/docs/latest/basics/http_11.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>HTTP 1.1 — Traffic Control master documentation </title>
+ <title>HTTP 1.1 — Traffic Control 1.8.1 documentation </title>
@@ -33,7 +33,10 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="index" title="Index"
+ href="../genindex.html"/>
+ <link rel="search" title="Search" href="../search.html"/>
+ <link rel="top" title="Traffic Control 1.8.1 documentation" href="../index.html"/>
<link rel="up" title="CDN Basics" href="index.html"/>
<link rel="next" title="Caching Proxies" href="caching_proxies.html"/>
<link rel="prev" title="Content Delivery Networks" href="content_delivery_networks.html"/>
@@ -58,7 +61,7 @@
- <img src="../_static/tc_logo_c_only.png" class="logo" />
+ <img src="../_static/tc_logo.png" class="logo" />
</a>
@@ -81,7 +84,7 @@
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal" href="index.html">CDN Basics</a><ul class="current">
<li class="toctree-l2"><a class="reference internal" href="content_delivery_networks.html">Content Delivery Networks</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="">HTTP 1.1</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">HTTP 1.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="caching_proxies.html">Caching Proxies</a></li>
<li class="toctree-l2"><a class="reference internal" href="cache_revalidation.html">Cache Control Headers and Revalidation</a></li>
</ul>
@@ -159,14 +162,14 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8.1</a> »</li>
<li><a href="index.html">CDN Basics</a> »</li>
<li>HTTP 1.1</li>
<li class="wy-breadcrumbs-aside">
- <a href="../_sources/basics/http_11.txt" rel="nofollow"> View page source</a>
+ <a href="../_sources/basics/http_11.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
@@ -201,17 +204,17 @@
</div></blockquote>
<ol class="arabic" start="3">
<li><p class="first">The client opens a TCP connection from a random port locally to port 80 (the HTTP default) on 44.33.22.11, and sends this (showing the minimum HTTP 1.1 request, typically there are additional headers):</p>
-<div class="highlight-python"><div class="highlight"><pre>GET /foo/bar/fun.html HTTP/1.1
-Host: www.origin.com
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">GET</span> <span class="o">/</span><span class="n">foo</span><span class="o">/</span><span class="n">bar</span><span class="o">/</span><span class="n">fun</span><span class="o">.</span><span class="n">html</span> <span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span>
+<span class="n">Host</span><span class="p">:</span> <span class="n">www</span><span class="o">.</span><span class="n">origin</span><span class="o">.</span><span class="n">com</span>
</pre></div>
</div>
</li>
<li><p class="first">The server at <code class="docutils literal"><span class="pre">www.origin.com</span></code> looks up the Host: header to match that to a configuration section, usually referred to as a virtual host section. If the Host: header and configuration section match, the search continues for the content of the path <code class="docutils literal"><span class="pre">/foo/bar/fun.html</span></code>, in the example, this is a file that contains <code class="docutils literal"><span class="pre"><html><body>This</span> <span class="pre">is</span> <span class="pre">a</span> <span class="pre">fun</span> <span class="pre">file</body></html></span></code>, so the server responds with the following:</p>
-<div class="highlight-python"><div class="highlight"><pre>HTTP/1.1 200 OK
-Content-Type: text/html; charset=UTF-8
-Content-Length: 45
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">HTTP</span><span class="o">/</span><span class="mf">1.1</span> <span class="mi">200</span> <span class="n">OK</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Type</span><span class="p">:</span> <span class="n">text</span><span class="o">/</span><span class="n">html</span><span class="p">;</span> <span class="n">charset</span><span class="o">=</span><span class="n">UTF</span><span class="o">-</span><span class="mi">8</span>
+<span class="n">Content</span><span class="o">-</span><span class="n">Length</span><span class="p">:</span> <span class="mi">45</span>
-<html><body>This is a fun file</body></html>
+<span class="o"><</span><span class="n">html</span><span class="o">><</span><span class="n">body</span><span class="o">></span><span class="n">This</span> <span class="ow">is</span> <span class="n">a</span> <span class="n">fun</span> <span class="n">file</span><span class="o"></</span><span class="n">body</span><span class="o">></</span><span class="n">html</span><span class="o">></span>
</pre></div>
</div>
</li>
@@ -258,7 +261,7 @@ Content-Length: 45
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8.1',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/9c7fc09d/docs/latest/basics/index.html
----------------------------------------------------------------------
diff --git a/docs/latest/basics/index.html b/docs/latest/basics/index.html
index d7bb2fc..d3427a1 100644
--- a/docs/latest/basics/index.html
+++ b/docs/latest/basics/index.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>CDN Basics — Traffic Control master documentation </title>
+ <title>CDN Basics — Traffic Control 1.8.1 documentation </title>
@@ -33,7 +33,10 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="index" title="Index"
+ href="../genindex.html"/>
+ <link rel="search" title="Search" href="../search.html"/>
+ <link rel="top" title="Traffic Control 1.8.1 documentation" href="../index.html"/>
<link rel="next" title="Content Delivery Networks" href="content_delivery_networks.html"/>
<link rel="prev" title="Traffic Control" href="../index.html"/>
@@ -57,7 +60,7 @@
- <img src="../_static/tc_logo_c_only.png" class="logo" />
+ <img src="../_static/tc_logo.png" class="logo" />
</a>
@@ -78,7 +81,7 @@
<ul class="current">
-<li class="toctree-l1 current"><a class="current reference internal" href="">CDN Basics</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">CDN Basics</a><ul>
<li class="toctree-l2"><a class="reference internal" href="content_delivery_networks.html">Content Delivery Networks</a></li>
<li class="toctree-l2"><a class="reference internal" href="http_11.html">HTTP 1.1</a></li>
<li class="toctree-l2"><a class="reference internal" href="caching_proxies.html">Caching Proxies</a></li>
@@ -158,12 +161,12 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8.1</a> »</li>
<li>CDN Basics</li>
<li class="wy-breadcrumbs-aside">
- <a href="../_sources/basics/index.txt" rel="nofollow"> View page source</a>
+ <a href="../_sources/basics/index.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
@@ -237,7 +240,7 @@
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8.1',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/9c7fc09d/docs/latest/development/index.html
----------------------------------------------------------------------
diff --git a/docs/latest/development/index.html b/docs/latest/development/index.html
index 3de6b99..0c9164b 100644
--- a/docs/latest/development/index.html
+++ b/docs/latest/development/index.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Developer’s Guide — Traffic Control master documentation </title>
+ <title>Developer’s Guide — Traffic Control 1.8.1 documentation </title>
@@ -33,7 +33,10 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="index" title="Index"
+ href="../genindex.html"/>
+ <link rel="search" title="Search" href="../search.html"/>
+ <link rel="top" title="Traffic Control 1.8.1 documentation" href="../index.html"/>
<link rel="next" title="Traffic Ops" href="traffic_ops.html"/>
<link rel="prev" title="Configure Delivery Service Steering" href="../admin/quick_howto/steering.html"/>
@@ -57,7 +60,7 @@
- <img src="../_static/tc_logo_c_only.png" class="logo" />
+ <img src="../_static/tc_logo.png" class="logo" />
</a>
@@ -116,7 +119,7 @@
</li>
</ul>
<ul class="current">
-<li class="toctree-l1 current"><a class="current reference internal" href="">Developer’s Guide</a><ul>
+<li class="toctree-l1 current"><a class="current reference internal" href="#">Developer’s Guide</a><ul>
<li class="toctree-l2"><a class="reference internal" href="traffic_ops.html">Traffic Ops</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_portal.html">Traffic Portal</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_router.html">Traffic Router</a></li>
@@ -158,12 +161,12 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8.1</a> »</li>
<li>Developer’s Guide</li>
<li class="wy-breadcrumbs-aside">
- <a href="../_sources/development/index.txt" rel="nofollow"> View page source</a>
+ <a href="../_sources/development/index.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
@@ -279,7 +282,7 @@
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8.1',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/9c7fc09d/docs/latest/development/traffic_monitor.html
----------------------------------------------------------------------
diff --git a/docs/latest/development/traffic_monitor.html b/docs/latest/development/traffic_monitor.html
index e3439a5..91356e2 100644
--- a/docs/latest/development/traffic_monitor.html
+++ b/docs/latest/development/traffic_monitor.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Traffic Monitor — Traffic Control master documentation </title>
+ <title>Traffic Monitor — Traffic Control 1.8.1 documentation </title>
@@ -33,7 +33,10 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="index" title="Index"
+ href="../genindex.html"/>
+ <link rel="search" title="Search" href="../search.html"/>
+ <link rel="top" title="Traffic Control 1.8.1 documentation" href="../index.html"/>
<link rel="up" title="Developer’s Guide" href="index.html"/>
<link rel="next" title="Traffic Monitor APIs" href="traffic_monitor/traffic_monitor_api.html"/>
<link rel="prev" title="Traffic Router API" href="traffic_router/traffic_router_api.html"/>
@@ -58,7 +61,7 @@
- <img src="../_static/tc_logo_c_only.png" class="logo" />
+ <img src="../_static/tc_logo.png" class="logo" />
</a>
@@ -121,7 +124,7 @@
<li class="toctree-l2"><a class="reference internal" href="traffic_ops.html">Traffic Ops</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_portal.html">Traffic Portal</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_router.html">Traffic Router</a></li>
-<li class="toctree-l2 current"><a class="current reference internal" href="">Traffic Monitor</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Traffic Monitor</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_stats.html">Traffic Stats</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_server.html">Traffic Server</a></li>
</ul>
@@ -159,14 +162,14 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8.1</a> »</li>
<li><a href="index.html">Developer’s Guide</a> »</li>
<li>Traffic Monitor</li>
<li class="wy-breadcrumbs-aside">
- <a href="../_sources/development/traffic_monitor.txt" rel="nofollow"> View page source</a>
+ <a href="../_sources/development/traffic_monitor.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
@@ -247,8 +250,7 @@
<li>Change directories into <code class="docutils literal"><span class="pre">traffic_control/traffic_monitor</span></code>.</li>
<li>Edit the following parameters in src/test/resources/conf/traffic_monitor_config.js:</li>
</ol>
-<blockquote>
-<div><table border="1" class="docutils">
+<table border="1" class="docutils">
<colgroup>
<col width="22%" />
<col width="78%" />
@@ -273,8 +275,6 @@
</tr>
</tbody>
</table>
-<p>Note: any change done later in the configuration file requires a mvn build in order to be applied.</p>
-</div></blockquote>
<ol class="arabic" start="4">
<li><p class="first">Import the existing git repo into Eclipse:</p>
<blockquote>
@@ -321,7 +321,7 @@
</div>
<div class="section" id="api">
<h2>API<a class="headerlink" href="#api" title="Permalink to this headline">¶</a></h2>
-<p><a class="reference internal" href="traffic_monitor/traffic_monitor_api.html#reference-tm-api"><em>Traffic Monitor APIs</em></a></p>
+<p><a class="reference internal" href="traffic_monitor/traffic_monitor_api.html#reference-tm-api"><span class="std std-ref">Traffic Monitor APIs</span></a></p>
<div class="toctree-wrapper compound">
</div>
</div>
@@ -365,7 +365,7 @@
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8.1',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/9c7fc09d/docs/latest/development/traffic_monitor/traffic_monitor_api.html
----------------------------------------------------------------------
diff --git a/docs/latest/development/traffic_monitor/traffic_monitor_api.html b/docs/latest/development/traffic_monitor/traffic_monitor_api.html
index ae165ff..7d9392c 100644
--- a/docs/latest/development/traffic_monitor/traffic_monitor_api.html
+++ b/docs/latest/development/traffic_monitor/traffic_monitor_api.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Traffic Monitor APIs — Traffic Control master documentation </title>
+ <title>Traffic Monitor APIs — Traffic Control 1.8.1 documentation </title>
@@ -33,7 +33,10 @@
- <link rel="top" title="Traffic Control master documentation" href="../../index.html"/>
+ <link rel="index" title="Index"
+ href="../../genindex.html"/>
+ <link rel="search" title="Search" href="../../search.html"/>
+ <link rel="top" title="Traffic Control 1.8.1 documentation" href="../../index.html"/>
<link rel="up" title="Traffic Monitor" href="../traffic_monitor.html"/>
<link rel="next" title="Traffic Stats" href="../traffic_stats.html"/>
<link rel="prev" title="Traffic Monitor" href="../traffic_monitor.html"/>
@@ -58,7 +61,7 @@
- <img src="../../_static/tc_logo_c_only.png" class="logo" />
+ <img src="../../_static/tc_logo.png" class="logo" />
</a>
@@ -159,7 +162,7 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../../index.html">Traffic Control master</a> »</li>
+ <li><a href="../../index.html">Traffic Control 1.8.1</a> »</li>
<li><a href="../index.html">Developer’s Guide</a> »</li>
@@ -168,7 +171,7 @@
<li>Traffic Monitor APIs</li>
<li class="wy-breadcrumbs-aside">
- <a href="../../_sources/development/traffic_monitor/traffic_monitor_api.txt" rel="nofollow"> View page source</a>
+ <a href="../../_sources/development/traffic_monitor/traffic_monitor_api.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
@@ -475,7 +478,7 @@ treated as partial strings.</td>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../../',
- VERSION:'master',
+ VERSION:'1.8.1',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true
http://git-wip-us.apache.org/repos/asf/incubator-trafficcontrol-website/blob/9c7fc09d/docs/latest/development/traffic_ops.html
----------------------------------------------------------------------
diff --git a/docs/latest/development/traffic_ops.html b/docs/latest/development/traffic_ops.html
index b99bd75..d23644a 100644
--- a/docs/latest/development/traffic_ops.html
+++ b/docs/latest/development/traffic_ops.html
@@ -7,7 +7,7 @@
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
- <title>Traffic Ops — Traffic Control master documentation </title>
+ <title>Traffic Ops — Traffic Control 1.8.1 documentation </title>
@@ -33,7 +33,10 @@
- <link rel="top" title="Traffic Control master documentation" href="../index.html"/>
+ <link rel="index" title="Index"
+ href="../genindex.html"/>
+ <link rel="search" title="Search" href="../search.html"/>
+ <link rel="top" title="Traffic Control 1.8.1 documentation" href="../index.html"/>
<link rel="up" title="Developer’s Guide" href="index.html"/>
<link rel="next" title="API Routes" href="traffic_ops_api/routes.html"/>
<link rel="prev" title="Developer’s Guide" href="index.html"/>
@@ -58,7 +61,7 @@
- <img src="../_static/tc_logo_c_only.png" class="logo" />
+ <img src="../_static/tc_logo.png" class="logo" />
</a>
@@ -118,7 +121,7 @@
</ul>
<ul class="current">
<li class="toctree-l1 current"><a class="reference internal" href="index.html">Developer’s Guide</a><ul class="current">
-<li class="toctree-l2 current"><a class="current reference internal" href="">Traffic Ops</a></li>
+<li class="toctree-l2 current"><a class="current reference internal" href="#">Traffic Ops</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_portal.html">Traffic Portal</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_router.html">Traffic Router</a></li>
<li class="toctree-l2"><a class="reference internal" href="traffic_monitor.html">Traffic Monitor</a></li>
@@ -159,14 +162,14 @@
<div class="rst-content">
<div role="navigation" aria-label="breadcrumbs navigation">
<ul class="wy-breadcrumbs">
- <li><a href="../index.html">Traffic Control master</a> »</li>
+ <li><a href="../index.html">Traffic Control 1.8.1</a> »</li>
<li><a href="index.html">Developer’s Guide</a> »</li>
<li>Traffic Ops</li>
<li class="wy-breadcrumbs-aside">
- <a href="../_sources/development/traffic_ops.txt" rel="nofollow"> View page source</a>
+ <a href="../_sources/development/traffic_ops.rst.txt" rel="nofollow"> View page source</a>
</li>
</ul>
@@ -205,11 +208,6 @@
<li>MySQL 5.1.52</li>
<li><a class="reference external" href="https://bitbucket.org/liamstask/goose/">Goose</a></li>
</ul>
-<p>Addionally, the installation of the following RPMs (or equivalent) is required:</p>
-<ul class="simple">
-<li>All RPMs listed in <a class="reference internal" href="../admin/traffic_ops_install.html#rl-ps"><em>Installing Traffic Ops</em></a></li>
-<li>mysql-test</li>
-</ul>
</div>
<div class="section" id="traffic-ops-project-tree-overview">
<h2>Traffic Ops Project Tree Overview<a class="headerlink" href="#traffic-ops-project-tree-overview" title="Permalink to this headline">¶</a></h2>
@@ -269,7 +267,7 @@
<div class="section" id="perl-formatting-conventions">
<h2>Perl Formatting Conventions<a class="headerlink" href="#perl-formatting-conventions" title="Permalink to this headline">¶</a></h2>
<p>Perl tidy is for use in code formatting. See the following config file for formatting conventions.</p>
-<div class="highlight-python"><div class="highlight"><pre>edit a file called $HOME/.perltidyrc
+<div class="highlight-default"><div class="highlight"><pre><span></span>edit a file called $HOME/.perltidyrc
-l=156
-et=4
@@ -355,7 +353,7 @@ environment.</td>
<li>Install the local dependencies using Carton (cpanfile).</li>
</ol>
<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>$ cd traffic_ops/app
+<div><div class="highlight-default"><div class="highlight"><pre><span></span>$ cd traffic_ops/app
$ carton
</pre></div>
</div>
@@ -365,7 +363,7 @@ $ carton
</ol>
<blockquote>
<div><p>Example:</p>
-<div class="highlight-python"><div class="highlight"><pre>master $ mysql
+<div class="highlight-default"><div class="highlight"><pre><span></span>master $ mysql
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 305
Server version: 5.6.19 Homebrew
@@ -396,7 +394,7 @@ mysql> grant all on to_integration.* to 'to_user'@'localhost'
<div class="line"><br /></div>
</div>
<p>Running the the admin.pl script in setup mode should look like this:</p>
-<div class="highlight-python"><div class="highlight"><pre>master $ db/admin.pl --env=development setup
+<div class="highlight-default"><div class="highlight"><pre><span></span>master $ db/admin.pl --env=development setup
Using database.conf: conf/development/database.conf
Using database.conf: conf/development/database.conf
Using database.conf: conf/development/database.conf
@@ -429,9 +427,9 @@ Warning: Using a password on the command line interface can be insecure.
</li>
</ol>
<blockquote>
-<div><div class="highlight-python"><div class="highlight"><pre>[2015-02-24 10:44:34,991] [INFO] Listening at "http://*:3000".
+<div><div class="highlight-default"><div class="highlight"><pre><span></span><span class="p">[</span><span class="mi">2015</span><span class="o">-</span><span class="mi">02</span><span class="o">-</span><span class="mi">24</span> <span class="mi">10</span><span class="p">:</span><span class="mi">44</span><span class="p">:</span><span class="mi">34</span><span class="p">,</span><span class="mi">991</span><span class="p">]</span> <span class="p">[</span><span class="n">INFO</span><span class="p">]</span> <span class="n">Listening</span> <span class="n">at</span> <span class="s2">"http://*:3000"</span><span class="o">.</span>
-Server available at http://127.0.0.1:3000.
+<span class="n">Server</span> <span class="n">available</span> <span class="n">at</span> <span class="n">http</span><span class="p">:</span><span class="o">//</span><span class="mf">127.0</span><span class="o">.</span><span class="mf">0.1</span><span class="p">:</span><span class="mf">3000.</span>
</pre></div>
</div>
</div></blockquote>
@@ -453,7 +451,7 @@ Server available at http://127.0.0.1:3000.
<h2>Test Cases<a class="headerlink" href="#test-cases" title="Permalink to this headline">¶</a></h2>
<p>Use prove to execute test cases. Execute after a carton install:</p>
<ul class="simple">
-<li>To run the Unit Tests: <code class="docutils literal"><span class="pre">$</span> <span class="pre">local/bin/prove</span> <span class="pre">-qrp</span> <span class="pre">t/</span></code></li>
+<li>To run the Unit Tests: <code class="docutils literal"><span class="pre">$</span> <span class="pre">local/bin/prove</span> <span class="pre">-qrp</span>  <span class="pre">t/</span></code></li>
<li>To run the Integration Tests: <code class="docutils literal"><span class="pre">$</span> <span class="pre">local/bin/prove</span> <span class="pre">-qrp</span> <span class="pre">t_integration/</span></code></li>
</ul>
<div class="section" id="the-kabletown-cdn-example">
@@ -491,14 +489,14 @@ Server available at http://127.0.0.1:3000.
</ol>
<blockquote>
<div>These allow you to add statistic sources for the graph views and APIs.</div></blockquote>
-<p>Extensions are managed using the $TO_HOME/bin/extensions command line script. For more information see <a class="reference internal" href="../admin/traffic_ops_extensions.html#admin-to-ext-script"><em>Managing Traffic Ops Extensions</em></a>.</p>
+<p>Extensions are managed using the $TO_HOME/bin/extensions command line script. For more information see <a class="reference internal" href="../admin/traffic_ops_extensions.html#admin-to-ext-script"><span class="std std-ref">Managing Traffic Ops Extensions</span></a>.</p>
<div class="section" id="check-extensions">
<h3>Check Extensions<a class="headerlink" href="#check-extensions" title="Permalink to this headline">¶</a></h3>
<p>In other words, check extensions are scripts that, after registering with Traffic Ops, have a column reserved in the “Health->Server Checks” view and that usually run periodically out of cron.</p>
<p>It is the responsibility of the check extension script to iterate over the servers it wants to check and post the results.</p>
<p>An example script might proceed by logging into the Traffic Ops server using the HTTPS base_url provided on the command line. The script is hardcoded with an auth token that is also provisioned in the Traffic Ops User database. This token allows the script to obtain a cookie used in later communications with the Traffic Ops API. The script then obtains a list of all caches to be polled by accessing Traffic Ops’ <code class="docutils literal"><span class="pre">/api/1.1/servers.json</span></code> REST target. This list is walked, running a command to gather the stats from that cache. For some extensions, an HTTP GET request might be made to the ATS astats plugin, while for others the cache might be pinged, or a command run over SSH. The results are then compiled into a numeric or boolean result and the script POSTs tha result back to the Traffic Ops <code class="docutils literal"><span class="pre">/api/1.1/servercheck/</span></code> target.</p>
<p>A check extension can have a column of <img alt="checkmark" src="../_images/good1.png" />‘s and <img alt="X" src="../_images/bad1.png" />‘s (CHECK_EXTENSION_BOOL) or a column that shows a number (CHECK_EXTENSION_NUM).A simple example of a check extension of type CHECK_EXTENSION_NUM that will show 99.33 for all servers of type EDGE is shown below:</p>
-<div class="highlight-python"><div class="highlight"><pre>Script here.
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">Script</span> <span class="n">here</span><span class="o">.</span>
</pre></div>
</div>
<p>Check Extension scripts are located in the $TO_HOME/bin/checks directory.</p>
@@ -513,7 +511,7 @@ Server available at http://127.0.0.1:3000.
<dt><strong>Maximum Transmission Check - MTU</strong></dt>
<dd>Checks if the Traffic Ops host (if that is the one running the check) can send and receive 8192 size packets to the <code class="docutils literal"><span class="pre">ip_address</span></code> of the server in the server table.</dd>
<dt><strong>Operational Readiness Check - ORT</strong></dt>
-<dd>See <a class="reference internal" href="../admin/traffic_server.html#reference-traffic-ops-ort"><em>Configuring Traffic Server</em></a> for more information on the ort script. The ORT column shows how many changes the traffic_ops_ort.pl script would apply if it was run. The number in this column should be 0.</dd>
+<dd>See <a class="reference internal" href="../admin/traffic_server.html#reference-traffic-ops-ort"><span class="std std-ref">Configuring Traffic Server</span></a> for more information on the ort script. The ORT column shows how many changes the traffic_ops_ort.pl script would apply if it was run. The number in this column should be 0.</dd>
<dt><strong>Ping Check - 10G, ILO, 10G6, FQDN</strong></dt>
<dd><p class="first">The bin/checks/ToPingCheck.pl is to check basic IP connectivity, and in the default setup it checks IP connectivity to the following:</p>
<dl class="last docutils">
@@ -546,7 +544,7 @@ Server available at http://127.0.0.1:3000.
<div class="section" id="extension-directories">
<h3>Extension Directories<a class="headerlink" href="#extension-directories" title="Permalink to this headline">¶</a></h3>
<p>PERL5LIB Example Configuration:</p>
-<div class="highlight-python"><div class="highlight"><pre>export PERL5LIB=/opt/traffic_ops_extensions/private/lib/Extensions:/opt/traffic_ops/app/lib/Extensions/TrafficStats
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">export</span> <span class="n">PERL5LIB</span><span class="o">=/</span><span class="n">opt</span><span class="o">/</span><span class="n">traffic_ops_extensions</span><span class="o">/</span><span class="n">private</span><span class="o">/</span><span class="n">lib</span><span class="o">/</span><span class="n">Extensions</span><span class="p">:</span><span class="o">/</span><span class="n">opt</span><span class="o">/</span><span class="n">traffic_ops</span><span class="o">/</span><span class="n">app</span><span class="o">/</span><span class="n">lib</span><span class="o">/</span><span class="n">Extensions</span><span class="o">/</span><span class="n">TrafficStats</span>
</pre></div>
</div>
</div>
@@ -573,9 +571,9 @@ Extensions::YourCustomExtension</p>
<div class="section" id="response-structure">
<h3>Response Structure<a class="headerlink" href="#response-structure" title="Permalink to this headline">¶</a></h3>
<p>All successful responses have the following structure:</p>
-<div class="highlight-python"><div class="highlight"><pre>{
- "response": <JSON object with main response>,
-}
+<div class="highlight-default"><div class="highlight"><pre><span></span><span class="p">{</span>
+ <span class="s2">"response"</span><span class="p">:</span> <span class="o"><</span><span class="n">JSON</span> <span class="nb">object</span> <span class="k">with</span> <span class="n">main</span> <span class="n">response</span><span class="o">></span><span class="p">,</span>
+<span class="p">}</span>
</pre></div>
</div>
<p>To make the documentation easier to read, only the <code class="docutils literal"><span class="pre"><JSON</span> <span class="pre">object</span> <span class="pre">with</span> <span class="pre">main</span> <span class="pre">response></span></code> is documented, even though the response and version fields are always present.</p>
@@ -588,7 +586,7 @@ Extensions::YourCustomExtension</p>
<li>Pass the mojolicious cookie value, along with any subsequent calls to an authenticated API endpoint.</li>
</ol>
<p>Example:</p>
-<div class="highlight-python"><div class="highlight"><pre>[jvd@laika ~]$ curl -H "Accept: application/json" http://localhost:3000/api/1.1/usage/asns.json
+<div class="highlight-default"><div class="highlight"><pre><span></span>[jvd@laika ~]$ curl -H "Accept: application/json" http://localhost:3000/api/1.1/usage/asns.json
{"alerts":[{"level":"error","text":"Unauthorized, please log in."}]}
[jvd@laika ~]$
[jvd@laika ~]$ curl -v -H "Accept: application/json" -v -X POST --data '{ "u":"admin", "p":"secret_passwd" }' http://localhost:3000/api/1.1/user/login
@@ -663,7 +661,7 @@ Extensions::YourCustomExtension</p>
<dl class="docutils">
<dt>401 Unauthorized</dt>
<dd><p class="first">When you don’t supply the right cookie, this is the response.</p>
-<div class="last highlight-python"><div class="highlight"><pre>[jvd@laika ~]$ curl -v -H "Accept: application/json" http://localhost:3000/api/1.1/usage/asns.json
+<div class="last highlight-default"><div class="highlight"><pre><span></span>[jvd@laika ~]$ curl -v -H "Accept: application/json" http://localhost:3000/api/1.1/usage/asns.json
* Hostname was NOT found in DNS cache
* Trying ::1...
* connect to ::1 port 3000 failed: Connection refused
@@ -695,7 +693,7 @@ Extensions::YourCustomExtension</p>
</dd>
<dt>404 Not Found</dt>
<dd><p class="first">When the resource (path) is non existent Traffic Ops returns a 404:</p>
-<div class="last highlight-python"><div class="highlight"><pre>[jvd@laika ~]$ curl -v -H'Cookie: mojolicious=eyJleHBpcmVzIjoxNDI5NDAyMjAxLCJhdXRoX2RhdGEiOiJhZG1pbiJ9--f990d03b7180b1ece97c3bb5ca69803cd6a79862;' -H "Accept: application/json" http://localhost:3000/api/1.1/asnsjj.json
+<div class="last highlight-default"><div class="highlight"><pre><span></span>[jvd@laika ~]$ curl -v -H'Cookie: mojolicious=eyJleHBpcmVzIjoxNDI5NDAyMjAxLCJhdXRoX2RhdGEiOiJhZG1pbiJ9--f990d03b7180b1ece97c3bb5ca69803cd6a79862;' -H "Accept: application/json" http://localhost:3000/api/1.1/asnsjj.json
* Hostname was NOT found in DNS cache
* Trying ::1...
* connect to ::1 port 3000 failed: Connection refused
@@ -729,7 +727,7 @@ Extensions::YourCustomExtension</p>
</dd>
<dt>500 Internal Server Error</dt>
<dd><p class="first">When you are asking for a correct path, but the database doesn’t match, it returns a 500:</p>
-<div class="highlight-python"><div class="highlight"><pre>[jvd@laika ~]$ curl -v -H'Cookie: mojolicious=eyJleHBpcmVzIjoxNDI5NDAyMjAxLCJhdXRoX2RhdGEiOiJhZG1pbiJ9--f990d03b7180b1ece97c3bb5ca69803cd6a79862;' -H "Accept: application/json" http://localhost:3000/api/1.1/servers/hostname/jj/details.json
+<div class="highlight-default"><div class="highlight"><pre><span></span>[jvd@laika ~]$ curl -v -H'Cookie: mojolicious=eyJleHBpcmVzIjoxNDI5NDAyMjAxLCJhdXRoX2RhdGEiOiJhZG1pbiJ9--f990d03b7180b1ece97c3bb5ca69803cd6a79862;' -H "Accept: application/json" http://localhost:3000/api/1.1/servers/hostname/jj/details.json
* Hostname was NOT found in DNS cache
* Trying ::1...
* connect to ::1 port 3000 failed: Connection refused
@@ -870,7 +868,7 @@ Extensions::YourCustomExtension</p>
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT:'../',
- VERSION:'master',
+ VERSION:'1.8.1',
COLLAPSE_INDEX:false,
FILE_SUFFIX:'.html',
HAS_SOURCE: true