You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficserver.apache.org by ml...@apache.org on 2010/08/31 01:06:08 UTC
svn commit: r991020 - /trafficserver/site/trunk/docs/v2/admin/trouble.htm
Author: mlibbey
Date: Mon Aug 30 23:06:08 2010
New Revision: 991020
URL: http://svn.apache.org/viewvc?rev=991020&view=rev
Log:
Add Via header documentation
Modified:
trafficserver/site/trunk/docs/v2/admin/trouble.htm
Modified: trafficserver/site/trunk/docs/v2/admin/trouble.htm
URL: http://svn.apache.org/viewvc/trafficserver/site/trunk/docs/v2/admin/trouble.htm?rev=991020&r1=991019&r2=991020&view=diff
==============================================================================
--- trafficserver/site/trunk/docs/v2/admin/trouble.htm (original)
+++ trafficserver/site/trunk/docs/v2/admin/trouble.htm Mon Aug 30 23:06:08 2010
@@ -17,91 +17,21 @@ This appendix contains the following sec
<h2>
<a name="0_30488"></a>Frequently Asked Questions</h2>
<p>
-The following table lists the frequently asked questions (FAQs) discussed in this section.</p>
-<table border="1">
-<tr>
-<th width="1024">
-<p>
-FAQs</p></th>
-</tr>
-<tr>
-<td>
- <ul>
- <li>
- <a href="#0_41244">How do you create a raw disk for the cache if all your disks have mounted file systems?</a></li>
- </ul></td>
-</tr>
-<tr>
-<td>
- <ul>
- <li>
- <a href="#0_34163">How do disk I/O errors affect the cache and what does Traffic Server do when a cache disk fails?</a></li>
- </ul></td>
-</tr>
-<tr>
- <td>
- <ul>
- <li>
- <a href="#0_45613">If a client disconnects during the time that Traffic Server is downloading a large object, is any of the object saved in the cache?</a></li>
- </ul></td>
-</tr>
-<tr>
-<td>
- <ul>
- <li>
- <a href="#0_95054">Can Traffic Server cache Java applets, JavaScript programs, or other application files like VBScript?</a></li>
- </ul></td>
-</tr>
-<tr>
- <td>
- <ul>
- <li>
- <a href="#0_37211">How do you apply changes to the <code>logs_xml.config</code> file to all nodes in a cluster?</a></li>
- </ul></td>
-</tr>
-<tr>
-<td>
- <ul>
- <li>
- <a href="#0_21826">In Squid- and Netscape-format log files, what do the cache result codes mean?</a></li>
- </ul></td>
-</tr>
-<tr>
-<td>
- <ul>
- <li>
- <a href="#0_11719">What is recorded by the <code>cqtx</code> field in a custom log file?</a></li>
- </ul></td>
-</tr>
-<tr>
-<td>
- <ul>
- <li>
- <a href="#0_42816">Does Traffic Server refresh entries in its host database after a certain period of time if they haven't been used?</a></li>
- </ul></td>
-</tr>
-<tr>
-<td>
+FAQs</p>
<ul>
- <li>
- <a href="#0_12274">Can you improve the look of your custom response pages by using images, animated .gifs, and Java applets?</a></li>
- </ul></td>
-</tr>
-<tr>
-<td>
- <ul>
- <li>
- <a href="#0_84580">Can Traffic Server run in both forward proxy and reverse proxy mode at the same time?</a></li>
- </ul></td>
-</tr>
-<tr>
-<td>
- <ul>
- <li>
- <a href="#enable_forward_proxy">How do I enable forward proxy mode?</a></li>
- </ul></td>
-</tr>
-</table>
+ <li><a href="#0_41244">How do you create a raw disk for the cache if all your disks have mounted file systems?</a></li>
+ <li><a href="#0_34163">How do disk I/O errors affect the cache and what does Traffic Server do when a cache disk fails?</a></li>
+ <li><a href="#0_45613">If a client disconnects during the time that Traffic Server is downloading a large object, is any of the object saved in the cache?</a></li>
+ <li><a href="#0_95054">Can Traffic Server cache Java applets, JavaScript programs, or other application files like VBScript?</a></li>
+ <li><a href="#0_37211">How do you apply changes to the <code>logs_xml.config</code> file to all nodes in a cluster?</a></li>
+ <li><a href="#0_21826">In Squid- and Netscape-format log files, what do the cache result codes mean?</a></li>
+ <li><a href="#0_11719">What is recorded by the <code>cqtx</code> field in a custom log file?</a></li>
+ <li><a href="#0_42816">Does Traffic Server refresh entries in its host database after a certain period of time if they haven't been used?</a></li>
+ <li><a href="#0_12274">Can you improve the look of your custom response pages by using images, animated .gifs, and Java applets?</a></li>
+ <li><a href="#0_84580">Can Traffic Server run in both forward proxy and reverse proxy mode at the same time?</a></li>
+ <li><a href="#enable_forward_proxy">How do I enable forward proxy mode?</a></li>
+ <li><a href="#interpret_via_header">How do I interpret the Via: header code?</a></li>
+ </ul>
<h3>
<a name="0_41244"></a><em>How do you create a raw disk for the cache if all your disks have mounted file systems?</em></h3>
<h4>
@@ -438,125 +368,243 @@ file. </p>
CONFIG proxy.config.url_remap.remap_required INT 0<br>
</code>
</p>
-<h2>
-
-<em><a name="0_96161"></a></em>Troubleshooting Tips</h2>
-<p>
-The following table lists the troubleshooting tips discussed in this section.</p>
-<em>
-<table border="1">
- <tr>
- <th width="1076">
- <p>
- Troubleshooting Tip</p></th>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_22364">The throughput statistic is inaccurate </a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_48340">You are unable to execute Traffic Line commands</a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_42829">You observe inconsistent behavior when one node obtains an object from another node in the cluster</a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_29076">Web browsers display an error document with a "data missing" message</a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_45366">Traffic Server does not resolve any websites</a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_13841">"Maximum document size exceeded" message in the system log file</a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li><a href="#0_76993">"DrainIncomingChannel" message in the system log file</a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_73746">"No cop file" message in the system log file</a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_67754">Warning in system log file when manually editing <code>vaddrs.config</code></a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_57248">Nontransparent requests fail after enabling <code>always_query_destination</code></a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_47006">Traffic Server is running but no log files are created</a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_82182">Traffic Server shows an error indicating too many network connections</a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_93012">Low memory symptoms</a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_56862">Connection timeouts with the origin server</a></li>
- </ul></td>
- </tr>
- <tr>
- <td>
- <ul>
- <li>
- <a href="#0_13091">IBM Web servers do not work with Traffic Server</a></li>
- </ul></td>
- </tr>
+<h3><em><a name="interpret_via_header">How do I interpret the Via: header code?</a></em></h3>
+<p>The Via header is an optional HTTP header added by Traffic Server and other
+ HTTP proxies. If a request goes through multiple proxies, each one appends its
+ Via header content to the end of the existing Via header. Via header content
+ is for general information and diagnostic use only and should not be used as
+ a programmatic interface to Traffic Server.
+<p />
+The form of the Via header is
+<p />
+Via: <em><protocol> <proxyname></em> (_<product/version> [_<via-codes>_])
+
+<p />
+
+<dl>
+<dt> <em><protocol></em> </dt><dd> the scheme and version of the HTTP request <br>
+</dd>
+<dt> <em><proxyname></em> </dt><dd> the configured name of the proxy server <br>
+</dd>
+
+<dt> <em><product/version></em> </dt><dd> the Inktomi Network Products product name and
+ version <br>
+
+</dd>
+<dt> <em><via-codes></em> </dt><dd> a string of alphabetic codes presenting status information about the proxy handling of the HTTP request
+</dd>
+</dl>
+<p />
+For example:
+
+<p><pre>
+Via: HTTP/1.0 storm (Traffic-Server/4.0.0 [cMs f ])
+ [u lH o f pS eN] cache hit
+ [u lM oS fF pS eN] cache miss
+ [uN l oS f pS eN] no-cache origin server fetch
+</pre>
+The short status code shows the cache-lookup, server-info and cache-fill information
+ as listed in the full status code description below. The long status code list
+ provided in older, commercial versions of Traffic Server can be restored by setting the verbose_via_str config variable.
+<p />
+The character strings in the via-code show [<i><request results></i>:<i><proxy
+ op></i>] where <i><request results></i> represents status information about
+ the results of the client request and <i><proxy op></i> represent some information
+ about the proxy operations performed during request processing. The full via-code
+ status format is
+
+<p>[u<i><client-info></i> c<i><cache-lookup></i> s<i><server-info></i>
+
+f<i><cache-fill></i> p<i><proxy-info></i> e<i><error-codes></i>
+
+: t<i><tunnel-info></i>c<i><cache-type><cache-lookup-result></i>
+i<i><icp-conn-info></i> p<i><parent-proxy></i> s<i><server-conn-info></i>]
+
+<dl>
+<dt> <strong>u</strong> <em>client-info</em> </dt><dd> Request headers received from client. Value is one of:
+
+</dd>
+</dl>
+<table border="1" cellspacing="0" cellpadding="1"> <tr><td> C </td><td> cookie </td></tr>
+<tr><td> E </td><td> error in request </td></tr>
+
+<tr><td> I </td><td> If Modified Since (IMS) </td></tr>
+
+<tr><td> N </td><td> no-cache </td></tr>
+<tr><td> S </td><td> simple request (not conditional) </td></tr>
</table>
-<h3> </h3>
-</em>
+<p />
+
+<dl>
+<dt> <strong>c</strong> <em>cache-lookup</em> </dt><dd> Result of Traffic Server cache lookup for URL. Value is one of:
+
+</dd>
+</dl>
+<table border="1" cellspacing="0" cellpadding="1"> <tr><td> A </td><td> in cache, not acceptable (a cache "MISS") </td></tr>
+<tr><td> H </td><td> in cache, fresh (a cache "HIT") </td></tr>
+
+<tr><td> M </td><td> miss (a cache "MISS") </td></tr>
+
+<tr><td> S </td><td> in cache, stale (a cache "MISS") </td></tr>
+<tr><td> blank </td><td> no cache lookup performed </td></tr>
+</table>
+<p />
+
+<dl>
+<dt> <strong>s</strong> <em>server-info</em> </dt><dd> Response information received from origin server. Value is one of:
+
+</dd>
+</dl>
+<table border="1" cellspacing="0" cellpadding="1"> <tr><td> E </td><td> error in response </td></tr>
+<tr><td> N </td><td> not-modified </td></tr>
+
+<tr><td> S </td><td> served </td></tr>
+
+<tr><td> blank </td><td> no server connection needed </td></tr>
+</table>
+<p />
+<dl>
+<dt> <strong>f</strong> <em>cache-fill</em> </dt><dd> Result of document write to cache. Value is one of:
+
+</dd>
+</dl>
+
+<table border="1" cellspacing="0" cellpadding="1"> <tr><td> D </td><td> cached copy deleted </td></tr>
+<tr><td> U </td><td> updated old cache copy </td></tr>
+<tr><td> W </td><td> written into cache (new copy) </td></tr>
+
+<tr><td> blank </td><td> no cache write performed </td></tr>
+</table>
+<p />
+<dl>
+<dt> <strong>p</strong> <em>proxy-info</em> </dt><dd> Proxy operation result. Value is one of:
+</dd>
+</dl>
+
+<table border="1" cellspacing="0" cellpadding="1"> <tr><td> N </td><td> not-modified </td></tr>
+<tr><td> R </td><td> origin server revalidated </td></tr>
+<tr><td> S </td><td> served </td></tr>
+
+</table>
+
+<p />
+<dl>
+<dt> <strong>e</strong> <em>error-codes</em> </dt><dd> Value is one of:
+</dd>
+</dl>
+<table border="1" cellspacing="0" cellpadding="1"> <tr><td> A </td><td> authorization failure </td></tr>
+
+<tr><td> C </td><td> connection to server failed </td></tr>
+<tr><td> D </td><td> dns failure </td></tr>
+<tr><td> F </td><td> request forbidden </td></tr>
+<tr><td> H </td><td> header syntax unacceptable </td></tr>
+
+<tr><td> N </td><td> no error </td></tr>
+<tr><td> S </td><td> server related error </td></tr>
+<tr><td> T </td><td> connection timed out </td></tr>
+</table>
+
+<p />
+
+<b>:</b> = Separates proxy request result information from operation detail
+codes
+<p />
+<dl>
+<dt> <strong>t</strong> <em>tunnel-info</em> </dt><dd> Proxy-only service operation. Value is one of:
+</dd>
+</dl>
+<table border="1" cellspacing="0" cellpadding="1"> <tr><td> F </td><td> tunneling due to a header field (such as presence of If-Range header) </td></tr>
+
+<tr><td> M </td><td> tunneling due to a method (e.g. CONNECT) </td></tr>
+<tr><td> O </td><td> tunneling because cache is turned off </td></tr>
+<tr><td> U </td><td> tunneling because of url (url suggests dynamic content) </td></tr>
+<tr><td> blank </td><td> no tunneling </td></tr>
+
+</table>
+<p />
+<dl>
+<dt> <strong>c</strong> <em>cache-type</em> and <em>cache-lookup</em> </dt><dd> cache result values (2 characters)
+</dd>
+</dl>
+<br> cache-type character value is one of
+
+
+<table border="1" cellspacing="0" cellpadding="1"> <tr><td> C </td><td> cache </td></tr>
+<tr><td> I </td><td> icp </td></tr>
+<tr><td> blank </td><td> cache miss or no cache lookup </td></tr>
+</table>
+
+<p />
+ cache-lookup-result character value is one of:
+<table border="1" cellspacing="0" cellpadding="1"> <tr><td> C </td><td> cache hit, but config forces revalidate </td></tr>
+<tr><td> D </td><td> cache hit, but method forces revalidated (e.g. ftp, not anonymous) </td></tr>
+<tr><td> H </td><td> cache hit </td></tr>
+
+<tr><td> I </td><td> conditional miss (client sent conditional, fresh in cache, returned 412) </td></tr>
+<tr><td> M </td><td> cache miss (url not in cache) </td></tr>
+<tr><td> N </td><td> conditional hit (client sent conditional, doc fresh in cache, returned 304) </td></tr>
+<tr><td> S </td><td> cache hit, but expired </td></tr>
+
+<tr><td> U </td><td> cache hit, but client forces revalidate (e.g. Pragma: no-cache) </td></tr>
+<tr><td> blank </td><td> no cache lookup </td></tr>
+</table>
+<p />
+<dl>
+<dt> <strong>i</strong> <em>icp-conn-info</em> </dt><dd> ICP status
+
+
+</dd>
+</dl>
+<table border="1" cellspacing="0" cellpadding="1"> <tr><td> F </td><td> connection open failed </td></tr>
+<tr><td> S </td><td> connection opened successfully </td></tr>
+<tr><td> blank </td><td> no icp </td></tr>
+
+</table>
+<p />
+<dl>
+<dt> <strong>p</strong> <em>parent-proxy</em> </dt><dd> parent proxy connection status
+</dd>
+</dl>
+<table border="1" cellspacing="0" cellpadding="1"> <tr><td> F </td><td> connection open failed </td></tr>
+
+<tr><td> S </td><td> connection opened successfully </td></tr>
+<tr><td> blank </td><td> no parent proxy </td></tr>
+</table>
+<p />
+<dl>
+<dt> <strong>s</strong> <em>server-conn-info</em> </dt><dd> origin server connection status
+
+
+</dd>
+</dl>
+<table border="1" cellspacing="0" cellpadding="1"> <tr><td> F </td><td> connection open failed </td></tr>
+<tr><td> S </td><td> connection opened successfully </td></tr>
+<tr><td> blank </td><td> no server connection </td></tr>
+
+</table>
+
+
+
+</p>
+<h2><a name="0_96161"></a>Troubleshooting Tips</h2>
+<p> Troubleshooting Tip</p>
+ <ul>
+ <li><a href="#0_22364">The throughput statistic is inaccurate </a></li>
+ <li><a href="#0_48340">You are unable to execute Traffic Line commands</a></li>
+ <li><a href="#0_42829">You observe inconsistent behavior when one node obtains an object from another node in the cluster</a></li>
+ <li><a href="#0_29076">Web browsers display an error document with a "data missing" message</a></li>
+ <li><a href="#0_45366">Traffic Server does not resolve any websites</a></li>
+ <li><a href="#0_13841">"Maximum document size exceeded" message in the system log file</a></li>
+ <li><a href="#0_76993">"DrainIncomingChannel" message in the system log file</a></li>
+ <li><a href="#0_73746">"No cop file" message in the system log file</a></li>
+ <li><a href="#0_67754">Warning in system log file when manually editing <code>vaddrs.config</code></a></li>
+ <li><a href="#0_57248">Nontransparent requests fail after enabling <code>always_query_destination</code></a></li>
+ <li><a href="#0_47006">Traffic Server is running but no log files are created</a></li>
+ <li><a href="#0_82182">Traffic Server shows an error indicating too many network connections</a></li>
+ <li><a href="#0_93012">Low memory symptoms</a></li>
+ <li><a href="#0_56862">Connection timeouts with the origin server</a></li>
+ <li><a href="#0_13091">IBM Web servers do not work with Traffic Server</a></li>
+ </ul>
<em>
<h3>
<a name="0_22364"></a>The throughput statistic is inaccurate</h3>