hosting.config file (by default, located in
/usr/local/etc/trafficserver/) allows you to assign cache volumes to
specific origin servers and/or domains so that you can manage cache
space efficiently and restrict disk usage. For step-by-step instructions
on partitioning the cache according to origin servers and/or domains,
refer to Partitioning the Cache.
Before you can assign cache volumes to specific
origin servers and/or domains, you must first partition your cache
according to size and protocol in the
After you modify hosting.config, navigate to the Traffic Server bin
directory and run
traffic_ctl config reload 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.
Each line in the
hosting.config file must have one of the following
hostname=HOST volume=NUMBERS domain=DOMAIN volume=NUMBERS
HOST is the fully-qualified hostname of the origin server
whose content you want to store on a particular volume (for example,
DOMAIN is the domain whose content you
want to store on a particular partition (for example,
NUMBERS 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
Note: 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
hosting.config file cannot contain multiple entries
for the same origin server or domain.
When configuring the
hosting.config file, you must assign a generic
volume to use for content that does not belong to any of the origin
servers or domains listed. If all volumes for a particular origin
server become corrupt, Traffic Server will also use the generic
volume to store content for that origin server.
The generic volume must have the following format:
NUMBERS is a comma-separated list of generic
The following example configures Traffic Server to store content from
mydomain.com in volume 1 and content from
www.myhost.com in volume 2. Traffic Server stores content from
all other origin servers in volumes 3 and 4.
domain=mydomain.com volume=1 hostname=www.myhost.com volume=2 hostname=* volume=3,4