trafficserver-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mlib...@apache.org
Subject svn commit: r991020 - /trafficserver/site/trunk/docs/v2/admin/trouble.htm
Date Mon, 30 Aug 2010 23:06:08 GMT
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 &quot;data
missing&quot; 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">&quot;Maximum document size exceeded&quot; message
in the system log file</a></li>
-    </ul></td>
-  </tr>
-  <tr>
-  <td>
-    <ul>
-      <li><a href="#0_76993">&quot;DrainIncomingChannel&quot; message
in the system log file</a></li>
-    </ul></td>
-  </tr>
-  <tr>
-  <td>
-    <ul>
-      <li>
-        <a href="#0_73746">&quot;No cop file&quot; 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>&lt;protocol&gt; &lt;proxyname&gt;</em> (_&lt;product/version&gt;
[_&lt;via-codes&gt;_])
+
+<p />
+
+<dl>
+<dt> <em>&lt;protocol&gt;</em> </dt><dd> the scheme
and version of the HTTP request <br>
+</dd>
+<dt> <em>&lt;proxyname&gt;</em> </dt><dd> the configured
name of the proxy server <br>
+</dd>
+
+<dt> <em>&lt;product/version&gt;</em> </dt><dd> the
Inktomi Network Products product name and 
+  version <br>
+
+</dd>
+<dt> <em>&lt;via-codes&gt;</em> </dt><dd> a string
of alphabetic codes presenting status information about the proxy handling of the HTTP request

+</dd>
+</dl>
+<p />
+For example:
+
+&lt;p&gt;<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>&lt;request results&gt;</i>:<i>&lt;proxy

+  op&gt;</i>] where <i>&lt;request results&gt;</i> represents
status information about 
+  the results of the client request and <i>&lt;proxy op&gt;</i> represent
some information 
+  about the proxy operations performed during request processing. The full via-code 
+  status format is 
+
+<p>[u<i>&lt;client-info&gt;</i> c<i>&lt;cache-lookup&gt;</i>
s<i>&lt;server-info&gt;</i>
+
+f<i>&lt;cache-fill&gt;</i> p<i>&lt;proxy-info&gt;</i>
e<i>&lt;error-codes&gt;</i>
+
+: t<i>&lt;tunnel-info&gt;</i>c<i>&lt;cache-type&gt;&lt;cache-lookup-result&gt;</i>
+i<i>&lt;icp-conn-info&gt;</i> p<i>&lt;parent-proxy&gt;</i>
s<i>&lt;server-conn-info&gt;</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>&nbsp;</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>&nbsp; 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 &quot;data missing&quot; message</a></li>
+         <li><a href="#0_45366">Traffic Server does not resolve any websites</a></li>
+         <li><a href="#0_13841">&quot;Maximum document size exceeded&quot;
message in the system log file</a></li>
+         <li><a href="#0_76993">&quot;DrainIncomingChannel&quot; message
in the system log file</a></li>
+         <li><a href="#0_73746">&quot;No cop file&quot; 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>



Mime
View raw message