trafficserver-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r788046 - /websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuring-cache/index.en.html
Date Wed, 06 Apr 2011 15:11:12 GMT
Author: buildbot
Date: Wed Apr  6 15:11:12 2011
New Revision: 788046

Log:
Staging update by buildbot

Modified:
    websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuring-cache/index.en.html

Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuring-cache/index.en.html
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuring-cache/index.en.html
(original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuring-cache/index.en.html
Wed Apr  6 15:11:12 2011
@@ -41,11 +41,11 @@
     <div id="content">
       <h1 id="ConfiguringCache">Configuring the Cache</h1>
 <p>The Traffic Server cache consists of a high-speed object database called the 
-<strong>object store </strong>that indexes objects according to URLs and their
associated 
+<strong>object store</strong> 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="#TSCache">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>
@@ -97,20 +97,9 @@ the RAM cache size to its previous value
 <h5 id="changeRAMcachesize">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>
-<li>
-<dl>
-<dt><strong>Variable</strong> <strong>Description</strong></dt>
-<dt><em><code>proxy.config.cache.ram_cache.size</code></em></dt>
-<dd>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.</dd>
-</dl>
-</li>
-<li>
-<p>Save and close the <code>records.config</code> file. </p>
-</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>
+<li>Set the variable <a href="../configuration-files/records.config#proxy.config.cache.ram_cache.size"><em><code>proxy.config.cache.ram_cache.size</code></em></a>
to specify the size of the RAM cache.
+ The default value of -1 means that the RAM cache is automatically sized at approximately
1MB per gigabyte of disk.</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="../getting-started#StartingTS">Starting Traffic Server</a>).</li>
 </ol>
 <h2 id="ChangingCacheCapacity">Changing Cache Capacity</h2>
 <p>You can increase or reduce the total amount of disk space allocated to the 
@@ -122,7 +111,7 @@ disks or to add new disks to a Traffic S
 <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>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="../configuration-files/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>
@@ -132,7 +121,7 @@ disk or to remove disks from a Traffic S
 <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>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="../configuration-files/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>
@@ -152,7 +141,7 @@ the <strong>http</strong> partition type
 <h5 id="partitioncacheaccordingprotocol">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>Enter a line in the file for each partition you want to create (refer to <a
href="../configuration-files/partition.config">partition.config</a>). </li>
 <li>Save and close the <code>partition.config</code> file. </li>
 <li>Restart Traffic Server. </li>
 </ol>
@@ -178,7 +167,7 @@ a generic partition to store content fro
 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 
+<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>
@@ -187,8 +176,8 @@ assignment during periods of low traffic
 <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>Enter a line in the file to allocate the partition(s) used for each origin server
and/or domain (refer to <a href="../configuration-files/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="../configuration-files/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>
@@ -198,20 +187,8 @@ assignment during periods of low traffic
 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>
-<dl>
-<dt>Edit the following variable:</dt>
-<dt><strong>Variable</strong> <strong>Description</strong></dt>
-<dt><code>_proxy.config.cache.max_doc_size_</code></dt>
-<dd>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.</dd>
-</dl>
-</li>
-<li>
-<p>Save and close the <code>records.config</code> file. </p>
-</li>
-<li>Navigate to the Traffic Server <code>bin</code> directory. </li>
+<li>Set <a href="../configuration-files/records.config#proxy.config.cache.max_doc_size"><em><code>proxy.config.cache.max_doc_size</code></em></a>
to specify the maximum size allowed for objects in the cache in bytes.
+   <code>0</code> (zero) if you do not want a size limit.</li>
 <li>Run the command <code>traffic_line -x</code> to apply the configuration
changes. </li>
 </ol>
 <h2 id="ClearingCache">Clearing the Cache</h2>
@@ -221,11 +198,11 @@ cache configuration tasks, such as parti
 when Traffic Server is running. </p>
 <h5 id="clearcache">To clear the cache:</h5>
 <ol>
-<li>Stop Traffic Server (refer to <a href="getstart.htm#StoppingTrafficEdge">Stopping
Traffic Server</a>). </li>
+<li>Stop Traffic Server (refer to <a href="../getting-started#StoppingTS">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>
+<li>Restart Traffic Server (refer to <a href="../getting-started#StoppingTS">Starting
Traffic Server</a>).</li>
 </ol>
 <h2 id="RemovinganObjectFromCache">Removing an Object From the Cache</h2>
 <p>Traffic Server accepts the custom HTTP request method <code>PURGE</code>
when removing 
@@ -234,14 +211,19 @@ removed, then Traffic Server responds wi
 a <code>404 File Not Found</code> message is returned. </p>
 <p>In the following example, Traffic Server is running on the domain <em><code>example.com</code></em>

 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>
-<div class="codehilite"><pre><span class="o">*</span> <span class="n">About</span>
<span class="n">to</span> <span class="nb">connect</span><span
class="p">()</span> <span class="n">to</span> <span class="n">example</span><span
class="o">.</span><span class="n">com</span> <span class="n">port</span>
<span class="mi">80</span> <span class="p">(</span><span class="c1">#0)
 </span>
-  <span class="o">*</span> <span class="n">Trying</span> <span
class="mf">192.0.32.11</span><span class="o">...</span> <span class="n">connected</span>

-  <span class="o">*</span> <span class="n">Connected</span> <span
class="n">to</span> <span class="n">example</span><span class="o">.</span><span
class="n">com</span> <span class="p">(</span><span class="mf">192.0.32.11</span><span
class="p">)</span> <span class="n">port</span> <span class="mi">80</span>
<span class="p">(</span><span class="c1">#0)</span>
+<div class="codehilite"><pre>  <span class="nv">$</span> <span
class="nv">curl</span> <span class="o">-</span><span class="n">X</span>
<span class="n">PURGE</span> <span class="o">-</span><span class="n">v</span>
<span class="s">&quot;http://example.com/remove_me.jpg&quot;</span>
+ <span class="o">*</span> <span class="n">About</span> <span class="n">to</span>
<span class="nb">connect</span><span class="p">()</span> <span
class="n">to</span> <span class="n">example</span><span class="o">.</span><span
class="n">com</span> <span class="n">port</span> <span class="mi">80</span>
<span class="p">(</span><span class="c1">#0)  </span>
+ <span class="o">*</span> <span class="n">Trying</span> <span
class="mf">192.0.32.11</span><span class="o">...</span> <span class="n">connected</span>

+ <span class="o">*</span> <span class="n">Connected</span> <span
class="n">to</span> <span class="n">example</span><span class="o">.</span><span
class="n">com</span> <span class="p">(</span><span class="mf">192.0.32.11</span><span
class="p">)</span> <span class="n">port</span> <span class="mi">80</span>
<span class="p">(</span><span class="c1">#0)</span>
 
- <span class="o">&gt;</span> <span class="n">PURGE</span> <span
class="sr">/remove_me.jpg HTTP/</span><span class="mf">1.1</span>   
<span class="o">&gt;</span> <span class="n">User</span><span
class="o">-</span><span class="n">Agent:</span> <span class="n">curl</span><span
class="o">/</span><span class="mf">7.19.7</span>    
-  <span class="o">&gt;</span> <span class="n">Host:</span> <span
class="n">example</span><span class="o">.</span><span class="n">com</span>
   <span class="o">&gt;</span> <span class="n">Accept:</span>
<span class="o">*</span><span class="sr">/*    &gt;   &lt; HTTP/</span><span
class="mf">1.1</span> <span class="mi">200</span> <span class="n">Ok</span>
  
-  <span class="o">&lt;</span> <span class="n">Date:</span> <span
class="n">Thu</span><span class="p">,</span> <span class="mi">08</span>
<span class="n">Jan</span> <span class="mi">2010</span> <span class="mi">20</span><span
class="p">:</span><span class="mi">32</span><span class="p">:</span><span
class="mo">07</span> <span class="n">GMT</span>   <span class="o">&lt;</span>
<span class="n">Connection:</span> <span class="n">keep</span><span
class="o">-</span><span class="n">alive</span>
+ <span class="o">&gt;</span> <span class="n">PURGE</span> <span
class="sr">/remove_me.jpg HTTP/</span><span class="mf">1.1</span>
+ <span class="o">&gt;</span> <span class="n">User</span><span
class="o">-</span><span class="n">Agent:</span> <span class="n">curl</span><span
class="o">/</span><span class="mf">7.19.7</span>    
+ <span class="o">&gt;</span> <span class="n">Host:</span> <span
class="n">example</span><span class="o">.</span><span class="n">com</span>
+ <span class="o">&gt;</span> <span class="n">Accept:</span> <span
class="o">*/*</span>
+ <span class="o">&gt;</span>    
+ <span class="o">&lt;</span> <span class="n">HTTP</span><span
class="o">/</span><span class="mf">1.1</span> <span class="mi">200</span>
<span class="n">Ok</span>   
+ <span class="o">&lt;</span> <span class="n">Date:</span> <span
class="n">Thu</span><span class="p">,</span> <span class="mi">08</span>
<span class="n">Jan</span> <span class="mi">2010</span> <span class="mi">20</span><span
class="p">:</span><span class="mi">32</span><span class="p">:</span><span
class="mo">07</span> <span class="n">GMT</span>
+ <span class="o">&lt;</span> <span class="n">Connection:</span>
<span class="n">keep</span><span class="o">-</span><span class="n">alive</span>
 </pre></div>
 
 
@@ -257,20 +239,17 @@ delete, and invalidate URLs in the cache
 is a powerful tool that's capable of deleting <em>all</em> 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>
+file, see <a href="../security-options#ControllingHostAccessTrafficManager">Controlling
Host Access to Traffic Manager</a>.</p>
 <h3 id="AccessingCacheInspectorUtility">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>_CONFIG proxy.config.http_ui_enabled INT 1_</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>Add the following variable at the end of the file: <em><code>CONFIG
proxy.config.http_ui_enabled INT 1</code></em></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
+   For example: <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:
+   <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: <code>http://yourhost/myCI</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>
@@ -279,40 +258,17 @@ 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     http://www.dianes.com: 
-          http://www.dianes.com/.*.html$</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>
+<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.
+  For example, enter the following to search for all URLs that end in html and are prefixed
with http://www.dianes.com:  <code>http://www.dianes.com/.*\.html$</code></li>
+<li>Click <strong>Regex delete</strong> to delete all URLs that match a
specified regular expression.
+  For example, enter the following to delete all HTTP URLs that end in <code>html</code>:
  <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>
-<ul>
-<li><a href="intro.htm">Overview</a></li>
-<li><a href="getstart.htm">Getting Started</a></li>
-<li><a href="http.htm">HTTP Proxy Caching </a></li>
-<li><a href="explicit.htm">Explicit Proxy Caching</a></li>
-<li><a href="reverse.htm">Reverse Proxy and HTTP Redirects</a></li>
-<li><a href="hier.htm">Hierarchical Caching</a></li>
-<li><a href="cache.htm">Configuring the Cache</a></li>
-<li><a href="monitor.htm">Monitoring Traffic</a></li>
-<li><a href="configure.htm">Configuring Traffic Server</a></li>
-<li><a href="secure.htm">Security Options</a></li>
-<li><a href="log.htm">Working with Log Files</a></li>
-<li><a href="cli.htm">Traffic Line Commands</a></li>
-<li><a href="logfmts.htm">Event Logging Formats</a></li>
-<li><a href="files.htm">Configuration Files</a> </li>
-<li><a href="errors.htm">Traffic Server Error Messages</a></li>
-<li><a href="trouble.htm">FAQ and Troubleshooting Tips</a></li>
-<li><a href="ts_admin_chinese.pdf">Traffic Server 管理员指南</a>
(PDF)</li>
-</ul>
-<p>Copyright © 2011 <a href="http://www.apache.org/">The Apache Software Foundation</a>.

-Licensed under the <a href="http://www.apache.org/licenses/">Apache License</a>,
Version 
-2.0. Apache Traffic Server, Apache, the Apache Traffic Server logo, and the 
-Apache feather logo are trademarks of The Apache Software Foundation.</p>
     </div>
   </div><!-- main -->
 



Mime
View raw message