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 2011/06/07 12:05:59 UTC
svn commit: r790556 - in
/websites/staging/trafficserver/trunk/content/docs/trunk/admin:
configuration-files/ configuring-cache/
Author: buildbot
Date: Tue Jun 7 10:05:58 2011
New Revision: 790556
Log:
Staging update by buildbot
Added:
websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/volume.config.en.html
Modified:
websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/hosting.config.en.html
websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/index.en.html
websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/order.txt
websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuring-cache/index.en.html
Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/hosting.config.en.html
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/hosting.config.en.html (original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/hosting.config.en.html Tue Jun 7 10:05:58 2011
@@ -47,15 +47,15 @@ partitioning the cache according to orig
to <a href="../configuring-cache#PartitoningCache">Partitioning the Cache</a> According to Origin Server or Domain.
Before you can assign cache partitions to specific origin servers and/or
domains, you must first partition your cache according to size and
-protocol in the <a href="partition.config">partition.config</a> file.
+protocol in the <a href="volume.config">volume.config</a> file.
For step-by-step instructions about partitioning your cache, refer to
<a href="../configuring-cache#PartitioningCache">Partitioning the Cache</a>. For a description of the
-<code>partition.config</code> file, refer to <a href="partition.config">partition.config</a>.</p>
+<code>volume.config</code> file, refer to <a href="volume.config">volume.config</a>.</p>
<p>After you modify hosting.config, navigate to the Traffic Server bin
directory and run the <code>traffic_line -x</code> command to apply your changes. When
you apply the changes to a node in a cluster, Traffic Server automatically
applies the changes to all other nodes in the cluster.</p>
-<p><strong>IMPORTANT:</strong> The partition configuration must be the same on all nodes in a
+<p><strong>IMPORTANT:</strong> The volume.configuration must be the same on all nodes in a
cluster.</p>
<h2 id="Format">Format</h2>
<p>Each line in the <code>hosting.config</code> file must have one of the following
@@ -72,7 +72,7 @@ on a particular partition(for example, <
<code>partition_numbers</code> is a comma-separated list of the partitions on which you
want to store the content that belongs to the origin server or domain
listed. The partition numbers must be valid numbers listed in the
-<a href="partition.config">partition.config</a> file.</p>
+<a href="volume.config">volume.config</a> file.</p>
<p><strong>Note:</strong> To allocate more than one partition to an origin server or domain,
you must enter the partitions in a comma-separated list on one line, as
shown in the example below. The <a href="hosting.config">hosting.config</a> file
Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/index.en.html
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/index.en.html (original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/index.en.html Tue Jun 7 10:05:58 2011
@@ -51,7 +51,7 @@
<li><a href="log_hosts.config">log_hosts.config</a></li>
<li><a href="logs_xml.config">logs_xml.config</a></li>
<li><a href="parent.config">parent.config</a></li>
-<li><a href="partition.config">partition.config</a></li>
+<li><a href="volume.config">volume.config</a></li>
<li><a href="records.config">records.config</a></li>
<li><a href="remap.config">remap.config</a></li>
<li><a href="splitdns.config">splitdns.config</a></li>
Modified: websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/order.txt
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/order.txt (original)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/order.txt Tue Jun 7 10:05:58 2011
@@ -7,7 +7,7 @@ ip_allow.config
log_hosts.config
logs_xml.config
parent.config
-partition.config
+volume.config
records.config
remap.config
splitdns.config
Added: websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/volume.config.en.html
==============================================================================
--- websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/volume.config.en.html (added)
+++ websites/staging/trafficserver/trunk/content/docs/trunk/admin/configuration-files/volume.config.en.html Tue Jun 7 10:05:58 2011
@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml"
+ xml:lang="en" lang="en">
+ <head>
+
+ <link rel="stylesheet" href="/styles/pygments_style.css" />
+ <link rel="stylesheet" href="/styles/ts.css" />
+
+
+ <title>Configuration Files - volume.config</title>
+ <!-- Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at . http://www.apache.org/licenses/LICENSE-2.0 . Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. -->
+ </head>
+
+ <body>
+ <div id="header" class="header">
+ <table><tr>
+ <td><a href="http://trafficserver.apache.org/"><img class="logo" alt="Apache Traffic Server" src="/images/trans_logo_350x69.png" /></a></td>
+ <td>
+
+ <span class="doc-title">Adminstrator's Guide</span><br />
+
+ <span class="title">Configuration Files - volume.config</span>
+ </td>
+ </tr></table>
+ </div><!-- header -->
+
+ <div class="nav">
+
+ <span class="nav"><a href="./index.en.html">Next</a></span>
+
+ <span class="nav"><a href="../event-logging-formats/index.en.html">Back</a></span>
+
+ <span class="nav"><a href="../index.en.html">Top</a></span>
+
+ </div>
+
+
+ <div class="main">
+
+ <div id="content">
+ <div class="toc">
+<ul>
+<li><a href="#parition.config">volume.config</a></li>
+<li><a href="#Format">Format</a></li>
+<li><a href="#Examples">Examples</a></li>
+</ul>
+</div>
+<h1 id="parition.config">volume.config</h1>
+<p>The <code>volume.config</code> file enables you to manage your cache space
+more efficiently and restrict disk usage by creating cache
+volumes of different sizes for specific protocols. You can
+further configure these volumes to store data from certain
+origin servers and/or domains in
+the <a href="hosting.config">hosting.config</a> file.</p>
+<p><strong>IMPORTANT:</strong> The volume configuration must be the same on all
+nodes in a cluster. You must stop Traffic Server before you change
+the cache volume size and protocol assignment. For step-by-step
+instructions about partitioning the cache, refer to
+<a href="../configuring-cache#PartitioningCache">Partitioning the Cache</a>.</p>
+<h1 id="Format">Format</h1>
+<p>For each volume you want to create, enter a line with the
+following format:</p>
+<div class="codehilite"><pre>volume=volume_number scheme=protocol_type size=volume_size
+</pre></div>
+
+
+<p>where <em><code>volume_number</code></em> is a number between 1 and 255 (the
+maximum number of volumes is 255) and <em><code>protocol_type</code></em> is
+<code>http</code>. Traffic Server supports <code>http</code> for HTTP volume types;
+<em><code>volume_size</code></em> is the amount of cache space allocated to
+the volume. This value can be either a percentage of the total
+cache space or an absolute value. The absolute value must be a
+multiple of 128 MB, where 128 MB is the smallest value. If you
+specify a percentage, then the size is rounded down to the closest
+multiple of 128 MB.</p>
+<p>Each volume is striped across several disks to achieve parallel
+I/O. For example: if there are four disks, then a 1-GB volume
+will have 256 MB on each disk (assuming each disk has enough free
+space available). If you do not allocate all the disk space in the
+cache, then the extra disk space is not used. You can use the extra
+space later to create new volumes without deleting and clearing
+the existing volumes.</p>
+<h1 id="Examples">Examples</h1>
+<p>The following example partitions the cache evenly between HTTP and
+HTTPS requests:</p>
+<div class="codehilite"><pre>volume=1 scheme=http size=50%
+volume=2 scheme=https size=50%
+</pre></div>
+ </div>
+ </div><!-- main -->
+
+ <div id="footer">
+ Copyright © 2010
+ <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.
+ <span id="apache_logo">
+ <a href="http://www.apache.org/"><img alt="The Apache Software Foundation" src="http://www.apache.org/images/feather-small.gif" /></a>
+ </span>
+ </div>
+
+ </body>
+</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 Tue Jun 7 10:05:58 2011
@@ -43,19 +43,34 @@
<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
headers.</p>
-<p>This chapter discusses the following topics: </p>
+<div class="toc">
<ul>
+<li><a href="#ConfiguringCache">Configuring the 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>
-<li><a href="#PartitioningCache">Partitioning the Cache</a></li>
+<li><a href="#ChangingSizeofRAMCache">Changing the Size of the RAM Cache</a></li>
+<li><a href="#ChangingCacheCapacity">Changing Cache Capacity</a><ul>
+<li><a href="#IncreasingCacheCapacity">Increasing Cache Capacity</a></li>
+<li><a href="#ReducingCacheCapacity">Reducing Cache Capacity</a></li>
+</ul>
+</li>
+<li><a href="#PartitioningCache">Partitioning the Cache</a><ul>
+<li><a href="#CreatingCachePartitionsforSpecificProtocols">Creating Cache Partitions for Specific Protocols</a></li>
+<li><a href="#MakingChangesPartitionSizesProtocols">Making Changes to Partition Sizes and Protocols</a></li>
+<li><a href="#PartitioningCacheAccordingOriginServerDomain">Partitioning the Cache According to Origin Server or Domain</a></li>
+</ul>
+</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>
+<li><a href="#RemovinganObjectFromCache">Removing an Object From the Cache</a></li>
+<li><a href="#InspectingCache">Inspecting the Cache</a><ul>
+<li><a href="#AccessingCacheInspectorUtility">Accessing the Cache Inspector Utility</a></li>
+<li><a href="#UsingCachePage">Using the Cache Page</a></li>
</ul>
-<h2 id="TSCache">The Traffic Server Cache</h2>
+</li>
+</ul>
+</div>
+<h1 id="TSCache">The Traffic Server Cache</h1>
<p>The Traffic Server cache consists of a high-speed object database called the
<strong>object store</strong>. The object store indexes objects according to URLs and associated
headers. This enables Traffic Server to store, retrieve, and serve not only
@@ -77,13 +92,13 @@ Server goes into proxy-only mode. </p>
<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>
+<h1 id="RAMCache">The RAM Cache</h1>
<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="ChangingSizeofRAMCache">Changing the Size of the RAM Cache</h2>
+<h1 id="ChangingSizeofRAMCache">Changing the Size of the RAM Cache</h1>
<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
@@ -94,95 +109,89 @@ if you increase the size of the RAM cach
(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 id="changeRAMcachesize">To change the RAM cache size:</h5>
-<ol>
-<li>Stop Traffic Server. </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>To change the RAM cache size
+1. Stop Traffic Server.
+3. 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.
+6. 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>).</p>
+<h1 id="ChangingCacheCapacity">Changing Cache Capacity</h1>
<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 id="IncreasingCacheCapacity">Increasing Cache Capacity</h3>
+<h2 id="IncreasingCacheCapacity">Increasing Cache Capacity</h2>
<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="../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>Edit the Traffic Server <a href="../configuration-files/storage.config"><code>storage.config</code></a> file: increase the
+ amount of disk space allocated to the cache on existing disks or describe the new hardware you are adding.</li>
<li>Restart Traffic Server. </li>
</ol>
-<h3 id="ReducingCacheCapacity">Reducing Cache Capacity</h3>
+<h2 id="ReducingCacheCapacity">Reducing Cache Capacity</h2>
<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="../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>Edit the Traffic Server <a href="../configuration-files/storage.config"><code>storage.config</code></a> file: reduce the
+ amount of disk space allocated to the cache on existing disks or delete the reference to the hardware you're removing.</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>
+<h1 id="PartitioningCache">Partitioning the Cache</h1>
<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
+creating cache volumes with different sizes for specific protocols. You
+can further configure these volumes to store data from specific origin servers
+and/or domains. The volume configuration must be the same on all nodes in
a cluster. </p>
-<h3 id="CreatingCachePartitionsforSpecificProtocols">Creating Cache Partitions for Specific Protocols</h3>
-<p>You can create separate partitions for your cache that vary in size to store
+<h2 id="CreatingCachePartitionsforSpecificProtocols">Creating Cache Partitions for Specific Protocols</h2>
+<p>You can create separate volumes 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 <strong>http</strong> partition type for HTTP objects.</p>
-<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="../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>
-<h4 id="MakingChangesPartitionSizesProtocols">Making Changes to Partition Sizes and Protocols</h4>
-<p>After you've configured your cache partitions based on protocol, you can make
+<p>To partition the cache according to protocol
+1. Enter a line in the <a href="../configuration-files/volume.config"><code>volume.config</code></a> file for each volume you want to create
+4. Restart Traffic Server. </p>
+<h2 id="MakingChangesPartitionSizesProtocols">Making Changes to Partition Sizes and Protocols</h2>
+<p>After you've configured your cache volumes 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>
+<li>You must stop Traffic Server before you change the cache volume size and protocol assignment. </li>
+<li>When you increase the size of a volume, the contents of the volume are <em>not</em> deleted. However, when you reduce the size of a volume, the contents of the volume <em>are</em> deleted. </li>
+<li>When you change the volume number, the volume 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, volume sizes specified in percentages will increase proportionately. </li>
+<li>A lot of changes to volume sizes might result in disk fragmentation, which affects performance and hit rate. You should clear the cache before making many changes to cache volume sizes (refer to <a href="#ClearingCache">Clearing the Cache</a>).</li>
</ul>
-<h3 id="PartitioningCacheAccordingOriginServerDomain">Partitioning the Cache According to Origin Server or Domain</h3>
+<h2 id="PartitioningCacheAccordingOriginServerDomain">Partitioning the Cache According to Origin Server or Domain</h2>
<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
+assign the volumes you created to specific origin servers and/or domains.
+You can assign a volumes to a single origin server or to multiple origin
+servers. However, if a volumes is assigned to multiple origin servers, then
+there is no guarantee on the space available in the volumes for each origin
+server. Content is stored in the volumes according to popularity. In addition
+to assigning volumes to specific origin servers and domains, you must assign
+a generic volume to store content from all origin servers and domains that
+are not listed. This generic volume 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
+volume, 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 volumes
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 id="partitioncacheaccordinghostnamedomain">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="../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>
-</ol>
-<h2 id="ConfiguringCacheObjectSizeLimit">Configuring the Cache Object Size Limit</h2>
+<p>To partition the cache according to hostname and domain
+1. Configure the cache volumes according to size and protocol, as described in
+ <a href="#CreatingCachePartitionsSpecificProtocols">Creating Cache Partitions for Specific Protocols</a>.
+2. Create a separate volume 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 volumes do not need to be the same size.
+4. Enter a line in the <a href="../configuration-files/hosting.config"><code>hosting.config</code></a> file to allocate the volume(s) used for each origin server and/or domain
+5. Assign a generic volume to use for content that does not belong to any of the origin servers or domains listed in the file.
+ If all volumes for a particular origin server become corrupt, then Traffic Server will also use the generic volume to store content
+ for that origin server as per <a href="../configuration-files/hosting.config">hosting.config</a>.
+8. Run the command <code>traffic_line -x</code> to apply the configuration changes. </p>
+<h1 id="ConfiguringCacheObjectSizeLimit">Configuring the Cache Object Size Limit</h1>
<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>
@@ -191,20 +200,23 @@ via the steps below:</p>
<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>
+<h1 id="ClearingCache">Clearing the Cache</h1>
<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 id="clearcache">To clear the cache:</h5>
+<p>To clear the cache
+1. Stop Traffic Server (refer to <a href="../getting-started#StoppingTS">Stopping Traffic Server</a>).
+2. Enter the following command to clear the cache:</p>
+<div class="codehilite"><pre> <span class="n">traffic_server</span> <span class="o">-</span><span class="n">Cclear</span>
+<span class="n">The</span> <span class="sb">`clear`</span> <span class="n">command</span> <span class="n">deletes</span> <span class="n">all</span> <span class="n">data</span> <span class="n">in</span> <span class="n">the</span> <span class="n">object</span> <span class="n">store</span> <span class="ow">and</span> <span class="n">the</span> <span class="n">host</span> <span class="n">database</span><span class="o">.</span> <span class="n">Traffic</span> <span class="n">Server</span> <span class="n">does</span> <span class="ow">not</span> <span class="n">prompt</span> <span class="n">you</span> <span class="n">to</span> <span class="n">confirm</span> <span class="n">the</span> <span class="n">deletion</span><span class="o">.</span>
+</pre></div>
+
+
<ol>
-<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="../getting-started#StoppingTS">Starting Traffic Server</a>).</li>
</ol>
-<h2 id="RemovinganObjectFromCache">Removing an Object From the Cache</h2>
+<h1 id="RemovinganObjectFromCache">Removing an Object From the Cache</h1>
<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,
@@ -212,7 +224,7 @@ a <code>404 File Not Found</code> messag
<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>
<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">"http://example.com/remove_me.jpg"</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">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>
@@ -233,18 +245,17 @@ the Traffic Server cache).</p>
<p>Note: The procedure above only removes an object from a <em>specific</em> 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>
+<h1 id="InspectingCache">Inspecting the Cache</h1>
<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 <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="../security-options#ControllingHostAccessTrafficManager">Controlling Host Access to Traffic Manager</a>.</p>
-<h3 id="AccessingCacheInspectorUtility">Accessing the Cache Inspector Utility</h3>
+this utility, see <a href="../security-options#ControllingHostAccessTrafficManager">Controlling Host Access to Traffic Manager</a>.</p>
+<h2 id="AccessingCacheInspectorUtility">Accessing the Cache Inspector Utility</h2>
<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: <em><code>CONFIG proxy.config.http_ui_enabled INT 1</code></em></li>
+<li>In the <a href="../configuration-files/records.config"><code>records.config</code></a> file add the following variable:</li>
+<li><a href="../configuration-files/records.config#proxy.config.http_ui_enabled"><em><code>CONFIG proxy.config.http_ui_enabled INT 1</code></em></a></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:
@@ -252,7 +263,7 @@ file, see <a href="../security-options#C
<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>
+<h2 id="UsingCachePage">Using the Cache Page</h2>
<p>The <strong>Cache page</strong> provides several options that enable you to view and delete
the contents of your cache: </p>
<ul>