You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@trafficserver.apache.org by bu...@apache.org on 2013/12/24 19:32:22 UTC
svn commit: r891679 [3/24] - in /websites/staging/trafficserver/trunk:
cgi-bin/ content/ content/docs/ content/docs/trunk/
content/docs/trunk/admin/ content/docs/trunk/admin/cluster-howto/
content/docs/trunk/admin/configuration-files/ content/docs/trun...
Added: websites/staging/trafficserver/trunk/content/docs/v2/admin/cache.htm
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/v2/admin/cache.htm (added)
+++ websites/staging/trafficserver/trunk/content/docs/v2/admin/cache.htm Tue Dec 24 18:32:14 2013
@@ -0,0 +1,188 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Traffic Edge Administrator's Guide</title>
+
+<link href="http://trafficserver.apache.org/docs/trunk/admin/configuring-cache/index.en.html" rel="canonical" />
+<!--#include file="top.html" -->
+
+<h1>Configuring the Cache</h1>
+<p>The Traffic Server cache consists of a high-speed object database called the <b>object store </b>that indexes objects according to URLs and their associated headers.</p>
+<p>This chapter discusses the following topics: </p>
+<ul>
+<li><a href="#TrafficEdgeCache">The Traffic Server Cache</a></li>
+<li><a href="#RAMCache">The RAM Cache</a></li>
+<li><a href="#ChangingSizeRAMCache">Changing the Size of the RAM Cache</a></li>
+<li><a href="#ChangingCacheCapacity">Changing Cache Capacity</a></li>
+<li><a href="#PartitioningCache">Partitioning the Cache</a></li>
+<li><a href="#ConfiguringCacheObjectSizeLimit">Configuring the Cache Object Size Limit</a></li>
+<li><a href="#ClearingCache">Clearing the Cache</a></li>
+<li><a href="#RemoveObjectFromCache">Removing an Object From the Cache</a></li>
+<li><a href="#InspectingCache">Inspecting the Cache</a></li>
+</ul>
+<h2 id="TrafficEdgeCache">The Traffic Server Cache</h2>
+<p>The Traffic Server cache consists of a high-speed object database called the <b>object store</b>. The object store indexes objects according to URLs and associated headers. This enables Traffic Server to store, retrieve, and serve not only web pages, but also parts of web pages - which provides optimum bandwidth savings. Using sophisticated object management, the object store can cache alternate versions of the same object (versions may differ because of dissimilar language or encoding types). It can also efficiently store very small and very large documents, thereby minimizing wasted space. When the cache is full, Traffic Server removes stale data to ensure the most requested objects are kept readily available and fresh. </p>
+<p>Traffic Server is designed to tolerate total disk failures on any of the cache disks. If the disk fails completely, then Traffic Server marks the entire disk as corrupt and continues using the remaining disks. An alarm is then created to indicate which disk failed. If all of the cache disks fail, then Traffic Server goes into proxy-only mode. </p>
+<p>You can perform the following cache configuration tasks: </p>
+<ul>
+ <li>Change the total amount of disk space allocated to the cache: refer to <a href="#ChangingCacheCapacity">Changing Cache Capacity</a>. </li>
+ <li>Partition the cache by reserving cache disk space for specific protocols and origin servers/domains: refer to <a href="#PartitioningCache">Partitioning the Cache</a>. </li>
+ <li>Delete all data in the cache: refer to <a href="#ClearingCache">Clearing the Cache</a>.</li>
+</ul>
+<h2 id="RAMCache">The RAM Cache</h2>
+<p>Traffic Server maintains a small RAM cache of extremely popular objects. This RAM cache serves the most popular objects as quickly as possible and reduces load on disks, especially during temporary traffic peaks. You can configure the RAM cache size to suit your needs, as described in <a href="#ChangingSizeRAMCache">Changing the Size of the RAM Cache</a> below. </p>
+<h2 id="ChangingSizeRAMCache">Changing the Size of the RAM Cache</h2>
+<p>Traffic Server provides a dedicated RAM cache for fast retrieval of popular small objects. The default RAM cache size is automatically calculated based on the number and size of the cache partitions you have configured. If you've partitioned your cache according to protocol and/or hosts, then the size of the RAM cache for each partition is proportional to the size of that partition. </p>
+<p>You can increase the RAM cache size for better cache hit performance. However, if you increase the size of the RAM cache and observe a decrease in performance (such as increased latencies), then it's possible that the operating system requires more memory for network resources. In such instances, you should return the RAM cache size to its previous value.</p>
+<h5>To change the RAM cache size: </h5>
+<ol>
+ <li>Stop Traffic Server. </li>
+ <li>In a text editor, open the <code>records.config</code> file located in the Traffic Server <code>config</code> directory. </li>
+ <li>Edit the following variable:</li>
+
+
+<table width="1232" border="1">
+ <tr>
+ <th width="322" scope="col">Variable</th>
+ <th width="894" scope="col">Description</th>
+ </tr>
+ <tr>
+ <td><i><code>proxy.config.cache.ram_cache.size</code></i></td>
+ <td>Set this variable to specify the size of the RAM cache.<br />
+ The default value of -1 means that the RAM cache is automatically sized at approximately 1MB per gigabyte of disk.</td>
+ </tr>
+</table>
+
+
+ <li>Save and close the <code>records.config</code> file. </li>
+ <li>Restart Traffic Server. If you increase the RAM cache to a size or 1GB or more, then restart with the <code>start_traffic_server</code> command (refer to <a href="getstart.htm#StartingTrafficEdge">Starting Traffic Server</a>). </li>
+</ol>
+<p> </p>
+<h2 id="ChangingCacheCapacity">Changing Cache Capacity</h2>
+<p>You can increase or reduce the total amount of disk space allocated to the cache without clearing the content. To check the size of the cache (in bytes), enter the command <code>traffic_line -r proxy.process.cache.bytes_total</code>. </p>
+<h3>Increasing Cache Capacity </h3>
+<p>To increase the total amount of disk space allocated to the cache on existing disks or to add new disks to a Traffic Server node, follow the steps below:</p>
+<ol>
+ <li>Stop Traffic Server. </li>
+ <li>Add hardware, if necessary. </li>
+ <li>Edit the Traffic Server <code>storage.config</code> file: increase the amount of disk space allocated to the cache on existing disks or describe the new hardware you are adding (refer to <a href="files.htm#storage.config">storage.config</a>).</li>
+ <li>If you add a new disk, then you must edit the <code>/etc/rc.d/init.d/traffic_server</code> file to add a raw disk binding. Instructions for adding a raw disk binding are located in the Traffic Server <code>storage.config</code> file. </li>
+ <li>Restart Traffic Server. </li>
+</ol>
+<h3>Reducing Cache Capacity </h3>
+<p>To reduce the total amount of disk space allocated to the cache on an existing disk or to remove disks from a Traffic Server node, follow the steps below:</p>
+<ol>
+ <li>Stop Traffic Server. </li>
+ <li>Remove hardware, if necessary. </li>
+ <li>Edit the Traffic Server <code>storage.config</code> file: reduce the amount of disk space allocated to the cache on existing disks or delete the reference to the hardware you're removing (refer to <a href="files.htm#storage.config">storage.config</a>). </li>
+ <li>If you remove a disk, then you must edit the <code>/etc/rc.d/init.d/traffic_server</code> file to remove the raw disk binding for the disk. </li>
+ <li>Restart Traffic Server. </li>
+</ol>
+<p><strong>IMPORTANT:</strong> In the <code>storage.config</code> file, a formatted or raw disk must be at least 128 MB. </p>
+<h2 id="PartitioningCache">Partitioning the Cache</h2>
+<p>You can manage your cache space more efficiently and restrict disk usage by creating cache partitions with different sizes for specific protocols. You can further configure these partitions to store data from specific origin servers and/or domains. The partition configuration must be the same on all nodes in a cluster. </p>
+<h3 id="CreatingCachePartitionsSpecificProtocols">Creating Cache Partitions for Specific Protocols</h3>
+<p>You can create separate partitions for your cache that vary in size to store content according to protocol. This ensures that a certain amount of disk space is always available for a particular protocol. Traffic Server currently supports the <b>http</b> partition type for HTTP objects.</p>
+<h5>To partition the cache according to protocol: </h5>
+<ol>
+ <li>In a text editor, open the <code>partition.config</code> file located in the Traffic Server <code>config</code> directory. </li>
+ <li>Enter a line in the file for each partition you want to create (refer to <a href="files.htm#partition.config">partition.config</a>). </li>
+ <li>Save and close the <code>partition.config</code> file. </li>
+ <li>Restart Traffic Server. </li>
+</ol>
+<h4>Making Changes to Partition Sizes and Protocols </h4>
+<p>After you've configured your cache partitions based on protocol, you can make changes to the configuration at any time. Before making changes, note the following: </p>
+<ul>
+ <li>You must stop Traffic Server before you change the cache partition size and protocol assignment. </li>
+ <li>When you increase the size of a partition, the contents of the partition are <em>not</em> deleted However, when you reduce the size of a partition, the contents of the partition <em>are</em> deleted. </li>
+ <li>When you change the partition number, the partition is deleted and then recreated, even if the size and protocol type remain the same. </li>
+ <li>When you add new disks to your Traffic Server node, partition sizes specified in percentages will increase proportionately. </li>
+ <li>A lot of changes to partition sizes might result in disk fragmentation, which affects performance and hit rate. You should clear the cache before making many changes to cache partition sizes (refer to <a href="#ClearingCache">Clearing the Cache</a>).</li>
+</ul>
+<h3>Partitioning the Cache According to Origin Server or Domain</h3>
+<p>After you have partitioned the cache according to size and protocol, you can assign the partitions you created to specific origin servers and/or domains. You can assign a partition to a single origin server or to multiple origin servers. However, if a partition is assigned to multiple origin servers, then there is no guarantee on the space available in the partition for each origin server. Content is stored in the partition according to popularity. In addition to assigning partitions to specific origin servers and domains, you must assign a generic partition to store content from all origin servers and domains that are not listed. This generic partition is also used if the partitions for a particular origin server or domain become corrupt. If you do not assign a generic partition, then Traffic Server will run in proxy-only mode. </p>
+<p><strong>Note: </strong>You do <em>not</em> need to stop Traffic Server before you assign partitions to particular hosts or domains. However, this type of configuration is time-consuming and can cause a spike in memory usage. Therefore, it's best to configure partition assignment during periods of low traffic. </p>
+<h5>To partition the cache according to hostname and domain: </h5>
+<ol>
+ <li>Configure the cache partitions according to size and protocol, as described in <a href="#CreatingCachePartitionsSpecificProtocols">Creating Cache Partitions for Specific Protocols</a>. </li>
+ <li>Create a separate partition based on protocol for each host and domain, as well as an additional generic partition to use for content that does not belong to these origin servers or domains. The partitions do not need to be the same size. </li>
+ <li>In a text editor, open the <code>hosting.config</code> file located in the Traffic Server <code>config</code> directory. </li>
+ <li>Enter a line in the file to allocate the partition(s) used for each origin server and/or domain (refer to <a href="files.htm#hosting.config">hosting.config</a>). </li>
+ <li>Assign a generic partition to use for content that does not belong to any of the origin servers or domains listed in the file. If all partitions for a particular origin server become corrupt, then Traffic Server will also use the generic partition to store content for that origin server (see <a href="files.htm#hosting.config">hosting.config</a>). </li>
+ <li>Save and close the <code>hosting.config</code> file. </li>
+ <li>Navigate to the Traffic Server <code>bin</code> directory. </li>
+ <li>Run the command <code>traffic_line -x</code> to apply the configuration changes. </li>
+</ol>
+<h2 id="ConfiguringCacheObjectSizeLimit">Configuring the Cache Object Size Limit</h2>
+<p>By default, Traffic Server allows objects of any size to be cached. You can change the default behavior and specify a size limit for objects in the cache via the steps below:</p>
+<ol>
+ <li>In a text editor, open the <code>records.config</code> file located in the Traffic Server <code>config</code> directory. </li>
+ <li>Edit the following variable:<br />
+ <table width="1232" border="1">
+ <tr>
+ <th width="322" scope="col">Variable</th>
+ <th width="894" scope="col">Description</th>
+ </tr>
+ <tr>
+ <td><code><i>proxy.config.cache.max_doc_size</i></code></td>
+ <td>Set this variable to specify the maximum size allowed for objects in the cache in bytes.<br /> Enter <code>0</code> (zero) if you do not want a size limit.</td>
+ </tr>
+ </table>
+ </li>
+ <li>Save and close the <code>records.config</code> file. </li>
+ <li>Navigate to the Traffic Server <code>bin</code> directory. </li>
+ <li>Run the command <code>traffic_line -x</code> to apply the configuration changes. </li>
+</ol>
+<h2 id="ClearingCache">Clearing the Cache</h2>
+
+<p>When you clear the cache, you remove all data from the entire cache - including data in the host database. You should clear the cache before performing certain cache configuration tasks, such as partitioning. You cannot clear the cache when Traffic Server is running. </p>
+<h5>To clear the cache: </h5>
+<ol>
+ <li>Stop Traffic Server (refer to <a href="getstart.htm#StoppingTrafficEdge">Stopping Traffic Server</a>). </li>
+ <li>Enter the following command to clear the cache:<br /><code>traffic_server -Cclear</code><br />The <code>clear</code> command deletes all data in the object store and the host database. Traffic Server does not prompt you to confirm the deletion. </li>
+ <li>Restart Traffic Server (refer to <a href="getstart.htm#StartingTrafficEdge">Starting Traffic Server</a>).</li>
+</ol>
+
+<h2 id="RemoveObjectFromCache">Removing an Object From the Cache</h2>
+<p>Traffic Server accepts the custom HTTP request method <code>PURGE</code> when removing a specific object from cache. If the object is found in the cache and is successfully removed, then Traffic Server responds with a <code>200 OK </code> HTTP message; otherwise, a <code>404 File Not Found</code> message is returned. </p>
+<p>In the following example, Traffic Server is running on the domain <u><code>example.com</code></u> and you want to remove the image <code>remove_me.jpg</code> from cache:</p>
+<p><code>$ curl -X PURGE -v "http://example.com/remove_me.jpg"</code></p>
+<p><code>* About to connect() to example.com port 80 (#0) <br />
+ * Trying 192.0.32.11... connected <br />
+ * Connected to example.com (192.0.32.11) port 80 (#0)</code></p>
+<p><code> > PURGE /remove_me.jpg HTTP/1.1 <br /> > User-Agent: curl/7.19.7 <br />
+ > Host: example.com <br /> > Accept: */* <br /> > <br /> < HTTP/1.1 200 Ok <br />
+ < Date: Thu, 08 Jan 2010 20:32:07 GMT <br /> < Connection: keep-alive</code></p>
+<p>The next time Traffic Server receives a request for the removed object, it will contact the origin server to retrieve it (i.e., it has been purged from the Traffic Server cache).</p>
+<p>Note: The procedure above only removes an object from a <i>specific</i> Traffic Server cache. Users may still see the old (removed) content if it was cached by intermediary caches or by the end-users' web browser.</p>
+<h2 id="InspectingCache">Inspecting the Cache</h2>
+<p>Traffic Server provides a Cache Inspector utility that enables you to view, delete, and invalidate URLs in the cache (HTTP only). The Cache Inspector utility is a powerful tool that's capable of deleting <i>all</i> the objects in your cache; therefore, make sure that only authorized administrators are allowed to access this utility. To control which hosts have access via the <code>mgmt_allow.config</code> file, see <a href="secure.htm#ControllingHostAccessTrafficManager">Controlling Host Access to Traffic Manager</a>. </p>
+<h3>Accessing the Cache Inspector Utility </h3>
+<p>To access the Cache Inspector utility, follow the steps below:</p>
+<ol>
+ <li>In a text editor, open the <code>records.config</code> file located in the Traffic Server <code>config</code> directory. </li>
+ <li>Add the following variable at the end of the file:<br /><code><i>CONFIG proxy.config.http_ui_enabled INT 1</i></code></li>
+ <li>To access the cache inspector in reverse proxy mode, you must add a remap rule to <code>remap.config</code> to expose the URL. <br />
+ For example: <br />
+ <code>map http://yourhost.com/myCI http://{cache} @action=allow @src_ip=corp_internal_address</code></li>
+ <li>From the Traffic Server <code>bin</code> directory, enter the following command to re-read the configuration file:<br />
+ <code>traffic_line -x</code></li>
+ <li>Open your web browser and configure it to use your Traffic Server as a proxy server. Type the following URL:
+<br /><code>http://{cache}</code></li>
+ <li>The Cache page opens (see <a href="#UsingCachePage">Using the Cache Page</a> below).</li>
+</ol>
+<h3 id="UsingCachePage">Using the Cache Page </h3>
+<p>The <b>Cache page</b> provides several options that enable you to view and delete the contents of your cache: </p>
+<ul>
+ <li>Click <strong>Lookup url</strong> to search for a particular URL in the cache. When Traffic Server finds the URL in the cache, it displays details about the object that corresponds to the URL (such as the header length and the number of alternates). From the display page, you can delete the URL from the cache. </li>
+ <li>Click <strong>Delete url</strong> to delete a particular URL or list of URLs from the cache. Traffic Server indicates if a delete is successful. </li>
+ <li>Click <strong>Regex lookup</strong> to search for URLs that match one or more regular expressions. From the display page, you can delete the URLs listed.<br />
+ For example, enter the following to search for all URLs that end in html and are prefixed with <code>http://www.dianes.com: <br />
+ http://www.dianes.com/.*\.html$</code></li>
+ <li>Click <strong>Regex delete</strong> to delete all URLs that match a specified regular expression.<br /> For example, enter the following to delete all HTTP URLs that end in <code>html</code>: <br /><code>http://.*\.html$</code> </li>
+ <li>Click <strong>Regex invalidate</strong> to invalidate URLs that match a specified regular expression. When you invalidate a URL, Traffic Server marks the object that corresponds to the URL as stale in the cache. Traffic Server then contacts the origin server to check if the object is still fresh (revalidates) before serving it from the cache. </li>
+</ul>
+<p><strong>Note:</strong> Only one administrator should delete and invalidate cache entries from the Cache page at any point in time. Changes made by multiple administrators at the same time can lead to unpredictable results.</p>
+
+
+<!--#include file="bottom.html" -->
Propchange: websites/staging/trafficserver/trunk/content/docs/v2/admin/cache.htm
------------------------------------------------------------------------------
svn:executable = *
Added: websites/staging/trafficserver/trunk/content/docs/v2/admin/cli.htm
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/v2/admin/cli.htm (added)
+++ websites/staging/trafficserver/trunk/content/docs/v2/admin/cli.htm Tue Dec 24 18:32:14 2013
@@ -0,0 +1,410 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Traffic Line Commands</title>
+
+<link href="http://trafficserver.apache.org/docs/trunk/admin/traffic-line-commands/index.en.html" rel="canonical" />
+<!--#include file="top.html" -->
+
+ <h1><a name="1053643">Appendix C - Traffic Line Commands</a>
+
+ </h1>
+ <p> This appendix contains the following sections: </p>
+
+<ul>
+<li><a href="#1053987">Traffic Line Commands</a></li>
+<li><a href="#1025718">Traffic Line Variables</a></li>
+</ul>
+<h2>
+ <a name="1053987">Traffic Line Commands</a> </h2>
+ <p> Use Traffic Line to execute individual Traffic Server commands and to script multiple commands in a shell. Execute Traffic Line commands from the Traffic Server <code>bin</code> directory. If the Traffic Server <code>bin</code> directory is not in your path, then prepend the Traffic Line command with <code>./</code> (for example: <code>./traffic_line -p</code>). </p>
+ <p> The following table describes all the commands available in Traffic Line. </p>
+ <table border="1">
+ <tr>
+ <th> <p> Command</p></th>
+ <th> <p> Description</p></th>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -b</code> </p></td>
+ <td><p> Bounces Traffic Server on the local node. Bouncing Traffic Server shuts down and immediately restarts the Traffic Server node.</p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -c</code> </p></td>
+ <td><p> Clears accumulated statistics on the local node.</p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -h</code> </p></td>
+ <td><p> Displays a list of Traffic Line commands.</p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -p <em>socket_path</em></code> </p></td>
+ <td><p> Specifies location (directory and path) of the socket used for Traffic Line communication.<br />
+ The default path is: <code><em>install_dir</em> /config/cli</code> </p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -q</code> </p></td>
+ <td><p> Displays a list of the origin servers that are currently congested. </p>
+ <p> <b>Note:</b> To use this command, you must set the variable <code> <i>proxy.config.raf.enabled</i></code> to 1 and set the variable <code> <i>proxy.config.raf.port</i></code> to a different port <em CLASS="Emphasis"> only</em> if there is a conflict with the default port 9000.</p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -r <em>variable</em></code> </p></td>
+ <td><p> Displays specific performance statistics or a current configuration setting. For a list of the variables you can specify, see <a href="cli.htm#1025718">Traffic Line Variables</a>.</p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -s <em>variable</em> -v <em>value</em></code> </p></td>
+ <td><p> Sets configuration variables, where <code><i>variable</i></code> is the configuration variable you want to change and <code> <i>value</i></code> is the value you want to set. Refer to <a href="files.htm#records.config">records.config</a> for a list of the configuration variables you can specify.</p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -x</code> </p></td>
+ <td><p> Initiates a Traffic Server configuration file reread. Use this command after every configuration file modification.</p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -B</code> </p></td>
+ <td><p> Bounces all Traffic Server nodes in the cluster. Bouncing Traffic Server shuts down and immediately restarts Traffic Server, node-by-node.</p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -C</code> </p></td>
+ <td><p> Clears accumulated statistics on all nodes in the cluster.</p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -L</code> </p></td>
+ <td><p> Restarts the <code> traffic_manager</code> and <code> traffic_server</code> processes on the local node.</p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -M</code> </p></td>
+ <td><p> Restarts the <code> traffic_manager</code> process and the <code> traffic_server</code> process on all the nodes in a cluster.</p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -S</code> </p></td>
+ <td><p> Shuts down Traffic Server on the local node.</p></td>
+ </tr>
+ <tr>
+ <td><p> <code> traffic_line -U</code> </p></td>
+ <td><p> Starts Traffic Server on the local node.</p></td>
+ </tr>
+ </table>
+<p>
+ <strong><a name="1025718">Traffic Line Variables</a></strong>
+ </p>
+ <p> You can view statistics and change configuration options in Traffic Line by using specific variables. The variables used for gathering statistics are described below. The variables used for viewing and changing configuration options are described in <a href="files.htm#records.config">records.config</a>. For procedures about specifying the variables, refer to <a href="monitor.htm">Viewing Statistics from Traffic Line</a> and <a href="configure.htm">Configuring Traffic Server Using Traffic Line</a>. </p>
+<p> The variables used for viewing individual statistics are described in the following table. To view a statistic in Traffic Line, enter the command <code>traffic_line -r <em>variable</em> </code>at the prompt. </p>
+ <table border="1">
+ <tr>
+ <td><p><strong> Statistic</strong></p></td>
+ <td><p><strong> Variable</strong></p></td>
+ </tr>
+ <tr>
+ <td rowspan="1" colspan="2"><p><strong> Summary</strong></p></td>
+ </tr>
+ <tr>
+ <td><p> Node name</p></td>
+ <td><p> <i><code> proxy.node.hostname </code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Objects served</p></td>
+ <td><p> <i><code> proxy.node.user_agents_total_documents_served</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Transactions per second</p></td>
+ <td><p> <i><code> proxy.node.user_agent_xacts_per_second</code> </i></p></td>
+ </tr>
+ <tr>
+ <td rowspan="1" colspan="2"><p><strong> Node</strong></p></td>
+ </tr>
+ <tr>
+ <td><p> Document hit rate </p></td>
+ <td><p> <i><code> proxy.node.cache_hit_ratio_avg_10s</code> </i></p>
+ <p> <i><code> proxy.cluster.cache_hit_ratio_avg_10s</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Bandwidth savings </p></td>
+ <td><p> <i><code> proxy.node.bandwidth_hit_ratio_avg_10s</code> </i></p>
+ <p> <i><code> proxy.cluster.bandwidth_hit_ratio_avg_10s </code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Cache percent free</p></td>
+ <td><p> <i><code> proxy.node.cache.percent_free</code> </i></p>
+ <p> <i><code> proxy.cluster.cache.percent_free</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Open origin server connections</p></td>
+ <td><p> <i><code> proxy.node.current_server_connections</code> </i></p>
+ <p> <i><code> proxy.cluster.current_server_connections </code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Open client connections </p></td>
+ <td><p> <i><code> proxy.node.current_client_connections</code> </i></p>
+ <p> <i><code> proxy.cluster.current_client_connections </code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Cache transfers in progress </p></td>
+ <td><p> <i><code> proxy.node.current_cache_connections</code> </i></p>
+ <p> <i><code> proxy.cluster.current_cache_connections </code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Client throughput (Mbits/sec)</p></td>
+ <td><p> <i><code> proxy.node.client_throughput_out</code> </i></p>
+ <p> <i><code> proxy.cluster.client_throughput_out</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Transactions per second </p></td>
+ <td><p> <i><code> proxy.node.user_agent_xacts_per_second </code> </i></p>
+ <p> <i><code> proxy.cluster.user_agent_xacts_per_second</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> DNS lookups per second </p></td>
+ <td><p> <i><code> proxy.node.dns.lookups_per_second </code> </i></p>
+ <p> <i><code> proxy.cluster.dns.lookups_per_second </code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Host database hit rate </p></td>
+ <td><p> <i><code> proxy.node.hostdb.hit_ratio_avg_10s</code> </i></p>
+ <p> <i><code> proxy.cluster.hostdb.hit_ratio_avg_10s </code> </i></p></td>
+ </tr>
+ <tr>
+ <td rowspan="1" colspan="2"><p><strong> HTTP</strong></p></td>
+ </tr>
+ <tr>
+ <td><p> Total document bytes from client</p></td>
+ <td><p> <i><code> proxy.process.http.user_agent_response_document_total_size</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Total header bytes from client</p></td>
+ <td><p> <i><code> proxy.process.http.user_agent_response_header_total_size</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Total connections to client</p></td>
+ <td><p> <i><code> proxy.process.http.total_client_connections</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Client transactions in progress</p></td>
+ <td><p> <i><code> proxy.process.http.current_client_transactions</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Total document bytes from origin server</p></td>
+ <td><p> <i><code> proxy.process.http.origin_server_response_document_total_size</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Total header bytes from origin server</p></td>
+ <td><p> <i><code> proxy.process.http.origin_server_response_header_total_size</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Total connections to origin server</p></td>
+ <td><p> <i><code> proxy.process.http.total_server_connections</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Origin server transactions in progress </p></td>
+ <td><p> <i><code> proxy.process.http.current_server_transactions</code> </i></p></td>
+ </tr>
+ <tr>
+ <td rowspan="1" colspan="2"><p><strong> ICP</strong></p></td>
+ </tr>
+ <tr>
+ <td><p> ICP query requests originating from this node</p></td>
+ <td><p> <i><code> proxy.process.icp.icp_query_requests</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> ICP query messages sent from this node</p></td>
+ <td><p> <i><code> proxy.process.icp.total_udp_send_queries</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> ICP peer hit messages received from this node</p></td>
+ <td><p> <i><code> proxy.process.icp.icp_query_hits</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> ICP peer miss messages received from this node </p></td>
+ <td><p> <i><code> proxy.process.icp.icp_query_misses</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Total ICP responses received from this node</p></td>
+ <td><p> <i><code> proxy.process.icp.icp_remote_responses</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Average ICP message response time (ms) from this node</p></td>
+ <td><p> <i><code> proxy.process.icp.total_icp_response_time</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Average ICP request time (ms) from this node</p></td>
+ <td><p> <i><code> proxy.process.icp.total_icp_request_time</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Query messages received from ICP peers</p></td>
+ <td><p> <i><code> proxy.process.icp.icp_remote_query_requests</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Remote query hits from ICP peers</p></td>
+ <td><p> <i><code> proxy.process.icp.cache_lookup_success</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Remote query misses from ICP peers</p></td>
+ <td><p> <i><code> proxy.process.icp.cache_lookup_fail</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Successful response messages sent to peers</p></td>
+ <td><p> <i><code> proxy.process.icp.query_response_write</code> </i></p></td>
+ </tr>
+ <tr>
+ <td rowspan="1" colspan="2"><p><strong> Cache </strong></p></td>
+ </tr>
+ <tr>
+ <td><p> Bytes used</p></td>
+ <td><p> <i><code> proxy.process.cache.bytes_used</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Cache size</p></td>
+ <td><p> <i><code> proxy.process.cache.bytes_total</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Lookups in progress</p></td>
+ <td><p> <i><code> proxy.process.cache.lookup.active</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Lookups completed</p></td>
+ <td><p> <i><code> proxy.process.cache.lookup.success</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Lookup misses</p></td>
+ <td><p> <i><code> proxy.process.cache.lookup.failure</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Reads in progress</p></td>
+ <td><p> <i><code> proxy.process.cache.read.active</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Reads completed</p></td>
+ <td><p> <i><code> proxy.process.cache.read.success</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Read misses</p></td>
+ <td><p> <i><code> proxy.process.cache.read.failure</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Writes in progress</p></td>
+ <td><p> <i><code> proxy.process.cache.write.active</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Writes completed</p></td>
+ <td><p> <i><code> proxy.process.cache.write.success</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Write failures</p></td>
+ <td><p> <i><code> proxy.process.cache.write.failure</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Updates in progress</p></td>
+ <td><p> <i><code> proxy.process.cache.update.active</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Updates completed</p></td>
+ <td><p> <i><code> proxy.process.cache.update.success</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Update failures</p></td>
+ <td><p> <i><code> proxy.process.cache.update.failure</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Removes in progress</p></td>
+ <td><p> <i><code> proxy.process.cache.remove.active</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Remove successes</p></td>
+ <td><p> <i><code> proxy.process.cache.remove.success</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Remove failures</p></td>
+ <td><p> <i><code> proxy.process.cache.remove.failure</code> </i></p></td>
+ </tr>
+ <tr>
+ <td rowspan="1" colspan="2"><p> <strong> Host Database</strong> </p></td>
+ </tr>
+ <tr>
+ <td><p> Total lookups</p></td>
+ <td><p> <i><code> proxy.process.hostdb.total_lookups</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Total hits</p></td>
+ <td><p> <i><code> proxy.process.hostdb.total_hits</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Time TTL (min)</p></td>
+ <td><p> <i><code> proxy.process.hostdb.ttl</code> </i></p></td>
+ </tr>
+ <tr>
+ <td rowspan="1" colspan="2"><p> <strong> DNS</strong> </p></td>
+ </tr>
+ <tr>
+ <td><p> DNS total lookups</p></td>
+ <td><p> <i><code> proxy.process.dns.total_dns_lookups</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Average lookup time (msec)</p></td>
+ <td><p> <i><code> proxy.process.dns.lookup_avg_time</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> DNS successes</p></td>
+ <td><p> <i><code> proxy.process.dns.lookup_successes</code> </i></p></td>
+ </tr>
+ <tr>
+ <td rowspan="1" colspan="2"><p><strong> Cluster </strong></p></td>
+ </tr>
+ <tr>
+ <td><p> Bytes read</p></td>
+ <td><p> <i><code> proxy.process.cluster.read_bytes</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Bytes written</p></td>
+ <td><p> <i><code> proxy.process.cluster.write_bytes</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Connections open</p></td>
+ <td><p> <i><code> proxy.process.cluster.connections_open</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Total operations</p></td>
+ <td><p> <i><code> proxy.process.cluster.connections_opened</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Network backups</p></td>
+ <td><p> <i><code> proxy.process.cluster.net_backup</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Clustering nodes</p></td>
+ <td><p> <i><code> proxy.process.cluster.nodes</code> </i></p></td>
+ </tr>
+ <tr>
+ <td rowspan="1" colspan="2"><p><strong> Logging </strong></p></td>
+ </tr>
+ <tr>
+ <td><p> Log files currently open</p></td>
+ <td><p> <i><code> proxy.process.log.log_files_open</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Space used for log files</p></td>
+ <td><p> <i><code> proxy.process.log.log_files_space_used</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Number of access events logged</p></td>
+ <td><p> <i><code> proxy.process.log.event_log_access</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Number of access events skipped</p></td>
+ <td><p> <i><code> proxy.process.log.event_log_access_skip</code> </i></p></td>
+ </tr>
+ <tr>
+ <td><p> Number of error events logged</p></td>
+ <td><p> <i><code> proxy.process.log.event_log_error</code> </i></p></td>
+ </tr>
+ <tr>
+ <td rowspan="1" colspan="2"><p><strong> Congestion Control</strong></p></td>
+ </tr>
+ <tr>
+ <td><p> Number of congestions Traffic Server has observed because the maximum number of connections was exceeded.</p></td>
+ <td><p> <i><code>proxy.process.congestion.congested_on_max_connection</code></i></p></td>
+ </tr>
+ <tr>
+ <td><p> Number of congestions Traffic Server has observed because of an OS response or timeout failure.</p></td>
+ <td><p><i><code>proxy.process.congestion.congested_on_conn_failures</code></i></p></td>
+ </tr>
+ </table>
+
+<!--#include file="bottom.html" -->
Propchange: websites/staging/trafficserver/trunk/content/docs/v2/admin/cli.htm
------------------------------------------------------------------------------
svn:executable = *
Added: websites/staging/trafficserver/trunk/content/docs/v2/admin/configure.htm
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/v2/admin/configure.htm (added)
+++ websites/staging/trafficserver/trunk/content/docs/v2/admin/configure.htm Tue Dec 24 18:32:14 2013
@@ -0,0 +1,36 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Traffic Edge Administrator's Guide</title>
+
+<link href="http://trafficserver.apache.org/docs/trunk/admin/configuring-traffic-server/index.en.html" rel="canonical" />
+<!--#include file="top.html" -->
+
+<h1>Configuring Traffic Server</h1>
+<p>Traffic Server provides several options for configuring the system.</p>
+<p>This chapter discusses the following topics: </p>
+<ul>
+<li><a href="#ConfiguringTrafficEdgeUsingTrafficLine">Configure Traffic Server Using Traffic Line</a></li>
+<li><a href="#ConfiguringTrafficEdgeUsingConfigFiles">Configure Traffic Server Using Configuration Files</a></li>
+</ul>
+<h2 id="ConfiguringTrafficEdgeUsingTrafficLine">Configure Traffic Server Using Traffic Line</h2>
+<p>Traffic Line enables you to quickly and easily change your Traffic Server configuration via command-line interface. Alternatively, you can also use <a href="getstart.htm#StartingTrafficShell">Traffic Shell</a> to configure Traffic Server.</p>
+<h5>To view or change configuration options in Traffic Line: </h5>
+<ol>
+ <li>Log on to a Traffic Server node as the Traffic Server administrator and navigate to the Traffic Server <code>bin</code> directory. </li>
+ <li>To view a configuration setting, enter the following command: <br /><code>traffic_line -r <em>var</em></code><br />
+ where <em><code>var</code></em> is the variable associated with the configuration option. For a list of variables, refer to <a href="files.htm#config_var">Configuration Variables</a>.</li>
+ <li>To change the value of a configuration setting, enter the following command:
+ <br /><code>traffic_line -s <em>var</em> -v <em>value</em></code> <br />
+ where <em><code>var</code></em> is the variable associated with the configuration option and <em><code>value</code></em> is the value you want to use. For a list of the variables, see <a href="files.htm#config_var">Configuration Variables</a>.<br /> <br /> If the Traffic Server <code>bin</code> directory is not in your path, then prepend the Traffic Line command with <code>./</code> (for example, <code>./traffic_line -r variable</code>).</li>
+</ol>
+<h2 id="ConfiguringTrafficEdgeUsingConfigFiles">Configure Traffic Server Using Configuration Files</h2>
+<p>As an alternative to using Traffic Line or Traffic Shell, you can change Traffic Server configuration options by manually editing specific variables in the <code>records.config</code> file located in the Traffic Server <code>config</code> directory. To edit the variables, open the file in a text editor (such as <code>vi</code> or <code>emacs</code>) and change variable values. After you modify the <code>records.config</code> file, Traffic Server must reread the configuration files. From the Traffic Server <code>bin</code> directory, enter the Traffic Line command <code>traffic_line -x</code>. You may need to restart Traffic Server to apply the configuration changes. </p>
+<p>The following is a sample portion of the <code>records.config</code> file: </p>
+<p><img src="images/records.jpg" width="812" height="609" /></p>
+<blockquote>
+ <p><em><b>Sample records.config file </b></em></p>
+</blockquote>
+<p>In addition to the <code>records.config</code> file, Traffic Server provides other configuration files that are used to configure specific features. All configuration files you can manually edit are described in <a href="files.htm">Configuration Files</a>. </p>
+
+<!--#include file="bottom.html" -->
Propchange: websites/staging/trafficserver/trunk/content/docs/v2/admin/configure.htm
------------------------------------------------------------------------------
svn:executable = *
Added: websites/staging/trafficserver/trunk/content/docs/v2/admin/doc.css
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/v2/admin/doc.css (added)
+++ websites/staging/trafficserver/trunk/content/docs/v2/admin/doc.css Tue Dec 24 18:32:14 2013
@@ -0,0 +1,28 @@
+body{
+ font-family:Tahoma, Geneva, sans-serif;
+ width:95%;
+}
+h1{
+ font-family:Arial;
+}
+h2{border-style: solid none none; border-color: grey; border-width: 3px 0px 0px;font-family:Arial;}
+h3{font-family:Arial;}
+h5{font-family:Arial; padding: 5px 5px 5px 15px; background:url(http://us.i1.yimg.com/us.yimg.com/i/us/pim/bn/downbr1.gif) no-repeat left center;}
+code{padding:15px 0px;}
+table{border:thin solid;border-collapse:collapse;}
+td{border:thin solid grey; border-top-style:solid;}
+h1.doctitle{
+ position:relative;
+ top:-8px;
+ display:inline;
+ margin-left:10px;
+}
+ul.leftnav{
+ margin-left:0px;
+ padding-left:15px;
+ font-family: Tahoma, Geneva, sans-serif;
+ width:170px;
+}
+#ft #incu_logo{float:right;}
+#cse-search-box{display:inline; float:right;margin:15px 5px 0 5px;}
+img{border:0;}
\ No newline at end of file
Propchange: websites/staging/trafficserver/trunk/content/docs/v2/admin/doc.css
------------------------------------------------------------------------------
svn:executable = *
Added: websites/staging/trafficserver/trunk/content/docs/v2/admin/errors.htm
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/v2/admin/errors.htm (added)
+++ websites/staging/trafficserver/trunk/content/docs/v2/admin/errors.htm Tue Dec 24 18:32:14 2013
@@ -0,0 +1,410 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Traffic Server Error Messages</title>
+
+<link href="http://trafficserver.apache.org/docs/trunk/admin/traffic-server-error-messages/index.en.html" rel="canonical" />
+<!--#include file="top.html" -->
+
+ <h1><a name="48024">Appendix F - Traffic Server Error Messages</a>
+ </h1>
+<p> This appendix contains the following sections:</p>
+<ul>
+<li><a href="#57301">Traffic Server Error Messages</a>: describes the warning messages Traffic Server sends to the system log file.</li>
+<li><a href="#65686">Traffic Server Alarm Messages</a>: describes the alarm messages that may appear on Traffic Manager Monitor pages.</li>
+<li><a href="#55499">HTML Messages Sent to Clients</a>: describes the HTML error messages Traffic Server sends to browser clients.</li>
+<li><a href="#55388">Standard HTTP Response Messages</a>: describes the standard HTTP response codes origin servers send to browser clients.</li>
+</ul>
+
+ <h2>
+ <a name="57301">Traffic Server Error Messages</a> </h2>
+<p>The following table lists messages that can appear in system log files. This list is not exhaustive; it simply describes common warning messages that can occur and which might require your attention. </p>
+ <h3>
+ <a name="57388">Traffic Server Process Fatal</a> </h3>
+ <table border="1">
+ <tr>
+ <th> <p> Message</p></th>
+ <th> <p> Description</p></th>
+ </tr>
+ <tr>
+ <td><p> <code>Accept port is not between 1 and 65535. Please check configuration</code></p></td>
+ <td><p> The port specified in the <code> records.config</code> file that accepts incoming HTTP requests is not valid. </p></td>
+ </tr>
+ <tr>
+ <td><p> <code>Self loop is detected in parent proxy configuration</code></p></td>
+ <td><p> The name and port of the parent proxy match that of Traffic Server. This creates a loop when Traffic Server attempts to send the request to the parent proxy. </p></td>
+ </tr>
+ </table>
+ <h3>
+ <a name="65683">Traffic Server Warnings</a> </h3>
+ <table border="1">
+ <tr>
+ <th> <p> Message</p></th>
+ <th> <p> Description</p></th>
+ </tr>
+ <tr>
+ <td><p> <code><em> Logfile</em> error: <em> error_number</em> </code></p></td>
+ <td><p> Generic logging error.</p></td>
+ </tr>
+ <tr>
+ <td><p><code> Bad cluster major version range <em> version1</em> -<em> version2</em> for node <em> IP address</em> connect failed</code></p></td>
+ <td><p> Incompatible software versions causing a problem.</p></td>
+ </tr>
+ <tr>
+ <td><p><code> Can't open config file <em> filename</em> for reading custom formats</code></p></td>
+ <td><p> Custom logging is enabled, but Traffic Server cannot find the <code> logs.config</code> file. </p></td>
+ </tr>
+ <tr>
+ <td><p><code> Connect by disallowed client <em> IP address</em>, closing</code></p></td>
+ <td><p> The specified client is not allowed to connect to Traffic Server; the client IP address is not listed in the <code> ip_allow.config</code> file. </p></td>
+ </tr>
+ <tr>
+ <td><p> Could not rename log<em> <code>filename</code></em> to <em> <code>rolled filename</code></em> </p></td>
+ <td><p> System error when renaming log file during roll. </p></td>
+ </tr>
+ <tr>
+ <td><p><code> Did <em> this_amount</em> of backup; still to do <em> remaining_amount</em> </code></p></td>
+ <td><p> Congestion is approaching.</p></td>
+ </tr>
+ <tr>
+ <td><p><code> Different clustering minor versions <em> version1</em> , <em> version2</em> for node <em> IP address</em> continuing</code></p></td>
+ <td><p> Incompatible software versions are causing a problem. </p></td>
+ </tr>
+ <tr>
+ <td><p><code> Log format symbol <em> symbol_name</em> not found</code></p></td>
+ <td><p> Custom log format references a field symbol that does not exist. Refer to <a href="logfmts.htm">Event Logging Formats</a>.</p></td>
+ </tr>
+ <tr>
+ <td><p><code> Missing field for field marker</code></p></td>
+ <td><p> Error reading a log buffer.</p></td>
+ </tr>
+ <tr>
+ <td><p><code> Unable to open log file<em> filename</em>, errno=<em> error_number</em> </code></p></td>
+ <td><p> Cannot open the log file.</p></td>
+ </tr>
+ <tr>
+ <td><p><code> Error accessing disk <em> disk_name</em> </code></p></td>
+ <td><p> Traffic Server might have a cache read problem. You might need to replace the disk.</p></td>
+ </tr>
+ <tr>
+ <td><p><code> Too many errors accessing disk <em> disk_name</em> : declaring disk bad</code></p></td>
+ <td><p> Traffic Server is not using the cache disk because it encountered too many errors. The disk might be corrupt and might have to be replaced.</p></td>
+ </tr>
+ <tr>
+ <td><p><code> No cache disks specified in storage.config file: cache disabled</code></p></td>
+ <td><p> The Traffic Server <code> storage.config</code> file does not list any cache disks; Traffic Server is running in proxy-only mode. You must add the disks you want to use for the cache to the <a href="files.htm#storage.config">storage.config</a> file.</p></td>
+ </tr>
+ </table>
+ <h2>
+<a name="65686">Traffic Server Alarm Messages</a></h2>
+ <p> </p>
+ <table border="1">
+ <tr>
+ <th> <p> Message</p></th>
+ <th> <p> Description</p></th>
+ </tr>
+ <tr>
+ <td><p><code> [Rollback::Rollback] Config file is read-only:<em> filename</em></code></p></td>
+ <td><p> Go to the Traffic Server <code> config</code> directory and check the indicated file permissions; change if necessary. </p></td>
+ </tr>
+ <tr>
+ <td><p><code> [Rollback::Rollback] Unable to read or write config file<em> filename</em></code></p></td>
+ <td><p> Go to the Traffic Server <code> config</code> directory and make sure the indicated file exists. Check permissions and modify if necessary. </p></td>
+ </tr>
+ <tr>
+ <td><p><code> [Traffic Manager] Configuration File Update Failed: <em> error_number</em> </code></p></td>
+ <td><p> Go to the Traffic Server <code> config</code> directory and check the indicated file permissions; change if necessary. </p></td>
+ </tr>
+ <tr>
+ <td><p><code> [Traffic Manager] Mgmt <==>Proxy conn. closed</code></p></td>
+ <td><p> An informational message to inform you that the <code> traffic_server</code> process is down. </p></td>
+ </tr>
+ <tr>
+ <td><p><code> Access logging suspended - configured space allocation exhausted. </code></p></td>
+ <td><p> The space allocated to the event log files is full; you must either increase the space or delete some log files so that access logging to continue. To prevent this error, consider rolling log files more frequently and enabling the autodelete feature. </p></td>
+ </tr>
+ <tr>
+ <td><p><code> Access logging suspended - no more space on the logging partition.</code></p></td>
+ <td><p> The entire partition containing the event logs is full; you must delete or move some log files to enable access logging to continue. To prevent this error, consider rolling log files more frequently and enabling the autodelete feature. </p></td>
+ </tr>
+ <tr>
+ <td><p><code> Created zero length place holder for config file<em> filename</em> </code></p></td>
+ <td><p> Go to the Traffic Server <code> config</code> directory and check the indicated file. If it is indeed zero in length, then use a backup copy of the configuration file. </p></td>
+ </tr>
+ <tr>
+ <td><p><code> Traffic Server can't open<em> filename </em>for reading custom formats</code></p></td>
+ <td><p> Make sure the <code> <i>proxy.config.log.config_file</i></code> variable in the <code> records.config</code> file contains the correct path to the custom log configuration file (the default is<code> logging/logs.config</code> ). </p></td>
+ </tr>
+ <tr>
+ <td><p><code> Traffic Server could not open logfile <em> filename</em> </code></p></td>
+ <td><p> Check permissions for the indicated file and the logging directory. </p></td>
+ </tr>
+ <tr>
+ <td><p><code> Traffic Server failed to parse line <em> line_number</em> of the logging config file<em> filename</em></code></p></td>
+ <td><p> Check your custom log configuration file; there could be syntax errors. Refer to <a href="logfmts.htm#66912"> Custom Logging Fields</a> for correct custom log format fields. </p></td>
+ </tr>
+ <tr>
+ <td><p> <code>vip_config binary is not setuid root, manager will be unable to enable virtual ip addresses</code></p></td>
+ <td><p> The <code> traffic_manager</code> process is not able to set virtual IP addresses. You must <code>setuid root </code>for the <code> vip_config</code> file in the Traffic Server <code> bin</code> directory. </p></td>
+ </tr>
+ </table>
+ <h2>
+ <a name="55499">HTML Messages Sent to Clients</a> </h2>
+<p>Traffic Server returns detailed error messages to browser clients when there are problems with the HTTP transactions requested by the browser. These Traffic Server response messages correspond to standard HTTP response codes, but provide more information. A list of the more frequently-encountered HTTP response codes is provided in <a href="#55388">Standard HTTP Response Messages</a>. You can customize the Traffic Server response messages, if desired.</p>
+<p>The following table lists the hard-coded Traffic Server HTTP messages, with corresponding HTTP response codes and customizable files. </p>
+ <table border="1">
+ <tr>
+ <th> <p> Title </p></th>
+ <th> <p> HTTP Code</p></th>
+ <th> <p> Description</p></th>
+ <th> <p> Customizable Filename</p></th>
+ </tr>
+ <tr>
+ <td><p><code> Access Denied</code></p></td>
+ <td><p><code> 403</code></p></td>
+ <td><p> You are not allowed to access the document at location <code><em> URL</em></code> . </p></td>
+ <td><p><code> access#denied</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Cache Read Error</code></p></td>
+ <td><p><code> 500</code></p></td>
+ <td><p> Error reading from cache; please retry request.</p></td>
+ <td><p><code> cache#read_error</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Connection Timed Out</code></p></td>
+ <td><p><code> 504</code></p></td>
+ <td><p> Too much time has elapsed since the server has sent data. </p></td>
+ <td><p><code> timeout#inactivity</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Content Length Required</code></p></td>
+ <td><p><code> 400</code></p></td>
+ <td><p> Could not process this request because <code>Content-Length</code> was not specified.</p></td>
+ <td><p><code> request#no_content_length</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Cycle Detected</code></p></td>
+ <td><p><code> 400</code></p></td>
+ <td><p> Your request is prohibited because it would cause an HTTP proxy cycle. </p></td>
+ <td><p><code> request#cycle_detected</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Forbidden</code></p></td>
+ <td><p><code> 403</code></p></td>
+ <td><p> <code><em> port_number</em></code> is not an allowed port for SSL connections (you have made a request for a secure SSL connection to a forbidden port number).</p></td>
+ <td><p><code> access#ssl_forbidden</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Host Header Required</code></p></td>
+ <td><p><code> 400</code></p></td>
+ <td><p> An attempt was made to transparently proxy your request, but this attempt failed because your browser did not send an HTTP <code> Host</code> header. Manually configure your browser to use <code> http://</code> <code><em> proxy_name</em></code> :<code><em> proxy_port</em></code> as the HTTP proxy. Alternatively, end users can upgrade to a browser that supports the HTTP <code> Host</code> header field.</p></td>
+ <td><p><code> interception#no_host</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Host Header Required</code></p></td>
+ <td><p><code> 400</code></p></td>
+ <td><p> Because your browser did not send a <code>Host</code> HTTP header field, the virtual host being requested could not be determined. To access the website correctly, you must upgrade to a browser that supports the HTTP <code>Host</code> header field.</p></td>
+ <td><p><code> request#no_host</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> HTTP Version Not Supported</code></p></td>
+ <td><p><code> 505</code></p></td>
+ <td><p> The origin server <em><code> server_name</code></em> is using an unsupported version of the HTTP protocol.</p></td>
+ <td><p><code> response#bad_version</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Invalid HTTP Request</code></p></td>
+ <td><p><code> 400</code></p></td>
+ <td><p> Could not process this <code><em> client_request</em></code> HTTP method request for <em><code> URL</code></em> .</p></td>
+ <td><p><code> request#syntax_error</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Invalid HTTP Response</code></p></td>
+ <td><p><code> 502</code></p></td>
+ <td><p> The host <code><em> server_name</em></code> did not return the document <code><em> URL</em></code> correctly.</p></td>
+ <td><p><code> response#bad_response</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Malformed Server Response</code></p></td>
+ <td><p><code> 502</code></p></td>
+ <td><p> The host <code><em> server_name</em></code> did not return the document <code><em> URL</em></code> correctly.</p></td>
+ <td><p><code> response#bad_response</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Malformed Server Response Status</code></p></td>
+ <td><p><code> 502</code></p></td>
+ <td><p> The host <code><em> server_name </em></code> did not return the document <code><em> URL </em></code> correctly.</p></td>
+ <td><p><code> response#bad_response</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Maximum Transaction Time exceeded</code></p></td>
+ <td><p><code> 504</code></p></td>
+ <td><p> Too much time has elapased while transmitting document <code><em> URL</em></code> .</p></td>
+ <td><p><code> timeout#activity</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> No Response Header From Server</code></p></td>
+ <td><p><code> 502</code></p></td>
+ <td><p align="left"> The host <code><em> server_name </em></code> did not return the document <code><em> URL</em></code> correctly.</p></td>
+ <td><p><code> response#bad_response</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Not Cached</code></p></td>
+ <td><p><code> 504</code></p></td>
+ <td><p> This document was not available in the cache, and you (the client) only accept cached copies.</p></td>
+ <td><p><code> cache#not_in_cache</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Not Found on Accelerator</code></p></td>
+ <td><p><code> 404</code></p></td>
+ <td><p> The request for <code><em> URL</em></code> on host <code><em> server_name </em></code> was not found. Check the location and try again.</p></td>
+ <td><p><code> urlrouting#no_mapping</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> NULL</code></p></td>
+ <td><p><code> 502</code></p></td>
+ <td><p> The host <code><em> hostname</em></code> did not return the document <code><em> URL</em></code> correctly.</p></td>
+ <td><p><code> response#bad_response</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Proxy Authentication Required</code></p></td>
+ <td><p><code> 407</code></p></td>
+ <td><p> Please log in with username and password.</p></td>
+ <td><p><code> access#proxy_auth_required</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Server Hangup</code></p></td>
+ <td><p><code> 502</code></p></td>
+ <td><p> The server <code><em> hostname</em></code> closed the connection before the transaction was completed.</p></td>
+ <td><p><code> connect#hangup</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Temporarily Moved</code></p></td>
+ <td><p><code> 302</code></p></td>
+ <td><p> The document you requested,<code><em> URL</em></code> , has moved to a new location. The new location is <code><em> new_URL</em></code> .</p></td>
+ <td><p><code> redirect#moved_temporarily</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Transcoding Not Available</code></p></td>
+ <td><p><code> 406</code></p></td>
+ <td><p> Unable to provide the document <code><em> URL</em></code> in the format requested by your browser.</p></td>
+ <td><p><code> transcoding#unsupported</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Tunnel Connection Failed</code></p></td>
+ <td><p><code> 502</code></p></td>
+ <td><p> Could not connect to the server <code><em> hostname</em></code> .</p></td>
+ <td><p><code> connect#failed_connect</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Unknown Error</code></p></td>
+ <td><p><code> 502</code></p></td>
+ <td><p> The host <code><em> hostname</em></code> did not return the document <code><em> URL</em></code> correctly.</p></td>
+ <td><p><code> response#bad_response</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Unknown Host</code></p></td>
+ <td><p><code> 500</code></p></td>
+ <td><p> Unable to locate the server named <code><em> hostname</em></code>; the server does not have a DNS entry. Perhaps there is a misspelling in the server name or the server no longer exists; double-check the name and try again. </p></td>
+ <td><p><code> connect#dns_failed</code></p></td>
+ </tr>
+ <tr>
+ <td><p><code> Unsupported URL Scheme</code></p></td>
+ <td><p><code> 400</code></p></td>
+ <td><p> Cannot perform your request for the document <code><em> URL</em></code> because the protocol scheme is unknown.</p></td>
+ <td><p><code> request#scheme_unsupported</code></p></td>
+ </tr>
+ </table>
+ <h3>
+ <a name="55388">Standard HTTP Response Messages </a> </h3>
+<p>The following standard HTTP response messages are provided for your information. </p>
+
+ <table border="1">
+ <tr>
+ <th> <p> Message</p></th>
+ <th> <p> Description</p></th>
+ </tr>
+ <tr>
+ <td><p><strong><code> 200</code></strong></p></td>
+ <td><p> OK</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 202</code></strong></p></td>
+ <td><p> Accepted</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 204</code></strong></p></td>
+ <td><p> No Content</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 206</code></strong></p></td>
+ <td><p> Partial Content</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 300 </code></strong></p></td>
+ <td><p> Multiple Choices</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 301</code></strong></p></td>
+ <td><p> Moved Permanently</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 302</code></strong></p></td>
+ <td><p> Found</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 303</code></strong></p></td>
+ <td><p> See Other</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 304</code></strong></p></td>
+ <td><p> Not Modified</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 400</code></strong></p></td>
+ <td><p> Bad Request</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 401</code></strong></p></td>
+ <td><p> Unauthorized; retry</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 403</code></strong></p></td>
+ <td><p> Forbidden</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 404</code></strong></p></td>
+ <td><p> Not Found</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 405</code></strong></p></td>
+ <td><p> Method Not Allowed</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 406</code></strong></p></td>
+ <td><p> Not acceptable</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 408</code></strong></p></td>
+ <td><p> Request Timeout</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 500</code></strong></p></td>
+ <td><p> Internal server error</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 501 </code></strong></p></td>
+ <td><p> Not Implemented</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 502</code></strong></p></td>
+ <td><p> Bad Gateway</p></td>
+ </tr>
+ <tr>
+ <td><p><strong><code> 504</code></strong></p></td>
+ <td><p> Gateway Timeout</p></td>
+ </tr>
+ </table>
+
+<!--#include file="bottom.html" -->
Propchange: websites/staging/trafficserver/trunk/content/docs/v2/admin/errors.htm
------------------------------------------------------------------------------
svn:executable = *
Added: websites/staging/trafficserver/trunk/content/docs/v2/admin/explicit.htm
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/v2/admin/explicit.htm (added)
+++ websites/staging/trafficserver/trunk/content/docs/v2/admin/explicit.htm Tue Dec 24 18:32:14 2013
@@ -0,0 +1,58 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Traffic Edge Administrator's Guide</title>
+
+<link href="http://trafficserver.apache.org/docs/trunk/admin/explicit-proxy-caching/index.en.html" rel="canonical" />
+<!--#include file="top.html" -->
+
+<h1>Explicit Proxy Caching</h1>
+<p>If you want to use Traffic Server as an explicit proxy cache, you must configure client software (i.e., browsers) to send requests directly to Traffic Server.</p>
+<h2 id="ExplicitProxyCachingHTTP">Explicit Proxy Caching for HTTP</h2>
+<p> If you do not configure Traffic Server to use the transparency option (with which client requests are intercepted en route to origin servers by a switch/router and rerouted to the Traffic Server machine), then clients must configure their web browsers to send HTTP requests to the Traffic Server proxy cache by configuring their browsers to download proxy configuration instructions from a <a href="#UsingPACFile">PAC file</a> (Proxy Auto-Configuration file).</p>
+<h3 id="ConfiguringBrowsersManually">Configuring Browsers Manually </h3>
+<p>To manually configure a browser to send HTTP requests to Traffic Server, clients must provide the following information: </p>
+<ul>
+ <li>The fully-qualified hostname or IP address of the Traffic Server node</li>
+ <li>The Traffic Server proxy server port (port 8080)</li>
+</ul>
+<p>In addition, clients can specify <i>not</i> to use Traffic Server for certain sites - in such cases, requests to the listed sites go directly to the origin server. The procedures for manual configuration vary among browser versions; refer to specific browser documentation for complete proxy configuration instructions. You do not need to set any special configuration options on Traffic Server if you want to accept requests from manually-configured browsers. </p>
+<h3 id="UsingPACFile">Using a PAC File </h3>
+<p>A <b>PAC file</b> is a specialized JavaScript function definition that a browser calls to determine how requests are handled. Clients must specify (in their browser settings) the URL from which the PAC file is loaded. You can store a PAC file on Traffic Server (or on any server in your network) and then provide the URL for this file to your clients. </p>
+<p>If you want to store a PAC file on the Traffic Server system, then you must perform the following configuration: </p>
+<ul>
+ <li>Either copy an existing PAC file into the Traffic Server <code>config</code> directory or enter a script that defines the proxy server configuration settings in the <code>proxy.pac</code> file provided (the file is empty by default). </li>
+ <li>Specify the port Traffic Server uses to serve the PAC file. The default port is 8083.</li>
+</ul>
+<h5>Configure Traffic Server to provide a PAC file manually: </h5>
+<ol>
+ <li>If you have an existing PAC file, then replace the <code>proxy.pac</code> file located in the Traffic Server <code>config</code> directory with the existing file. </li>
+ <li>In a text editor, open the <code>records.config</code> file located in the Traffic Server <code>config</code> directory. </li>
+ <li>Edit the following variable:</li>
+ <table width="1232" border="1">
+ <tr>
+ <th width="322" scope="col">Variable</th>
+ <th width="894" scope="col">Description</th>
+ </tr>
+ <tr>
+ <td><code><i>proxy.config.admin.autoconf_port</i></code></td>
+ <td><p>Set this variable to specify the port Traffic Server uses to serve the PAC file. The default port is 8083.</p> </td>
+ </tr>
+</table>
+ <li>Save and close the <code>records.config</code> file. </li>
+ <li>In a text editor, open the <code>proxy.pac</code> file located in the Traffic Server <code>config</code> directory. </li>
+ <ul>
+ <li>If you copied an existing PAC file into the Traffic Server config directory, then the <code>proxy.pac</code> file contains your proxy configuration settings. Check the settings and make changes if necessary. </li>
+ <li>If you did not copy an existing PAC file into the Traffic Server <code>config</code> directory, then the <code>proxy.pac</code> file is empty. Enter a script that will provide the proxy server configuration settings. A sample script is provided in <a href="#SamplePACFile">Sample PAC File</a>. </li>
+</ul>
+<li>Save and close the <code>proxy.pac</code> file. </li>
+ <li>Restart Traffic Server. </li>
+ <li>Inform your users to set their browsers to point to this PAC file; <a href="#SetBrowsersPointPACFile">click here for browser settings</a>. </li>
+</ol>
+<h4 id="SamplePACFile">Sample PAC File </h4>
+<p>The following sample PAC file instructs browsers to connect directly to all hosts without a fully-qualified domain name and to all hosts in the local domain. All other requests go to the Traffic Server named <code>myproxy.company.com</code>.</p>
+<pre>function FindProxyForURL(url, host) <br />{<br /> if (isPlainHostName(host)) ||<br /> (localHostOrDomainIs(host, ".company.com")) {<br /> return "DIRECT";<br /> }<br /> else<br /> return "PROXY myproxy.company.com:8080;" +<br /> "DIRECT"; <br />} </pre>
+<h3 id="UsingWPAD"> </h3>
+<p> </p>
+
+<!--#include file="bottom.html" -->
Propchange: websites/staging/trafficserver/trunk/content/docs/v2/admin/explicit.htm
------------------------------------------------------------------------------
svn:executable = *