blob: c83bfcec64b08585ae1d9057d7d1e36f22b0148a [file] [log] [blame]
.. 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.
==============
hosting.config
==============
.. configfile:: hosting.config
The :file:`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 :ref:`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 :file:`volume.config`
file.
After you modify hosting.config, navigate to the Traffic Server bin
directory and run :option:`traffic_ctl config reload` to apply your changes.
Format
======
Each line in the :file:`hosting.config` file must have one of the following
formats::
hostname=HOST volume=NUMBERS
domain=DOMAIN volume=NUMBERS
where ``HOST`` is the fully-qualified hostname of the origin server
whose content you want to store on a particular volume (for example,
``www.myhost.com``); ``DOMAIN`` is the domain whose content you
want to store on a particular partition (for example, ``mydomain.com``);
and ``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
:file:`volume.config`.
**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
:file:`hosting.config` file cannot contain multiple entries
for the same origin server or domain.
Generic Partition
=================
When configuring the :file:`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::
hostname=* volume=NUMBERS
where ``NUMBERS`` is a comma-separated list of generic
volumes.
Examples
========
The following example configures Traffic Server to store content from
the domain ``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