.\" Man page generated from reStructuredText.
.
.TH "VOLUME.CONFIG" "5" "Mar 08, 2019" "7.1" "Apache Traffic Server"
.SH NAME
volume.config \- Traffic Server cache volume configuration file
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.sp
The \fI\%volume.config\fP 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
\fBhosting.config\fP file.
.sp
\fBIMPORTANT:\fP
.INDENT 0.0
.INDENT 3.5
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 partitioning\-the\-cache\&.
.UNINDENT
.UNINDENT
.SH FORMAT
.sp
For each volume you want to create, enter a line with the following
format:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
volume=volume_number  scheme=protocol_type  size=volume_size
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
where \fBvolume_number\fP is a number between 1 and 255 (the maximum
number of volumes is 255) and \fBprotocol_type\fP is \fBhttp\fP\&. Traffic
Server supports \fBhttp\fP for HTTP volume types; \fBvolume_size\fP 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.
.sp
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.
.SH EXAMPLES
.sp
The following example partitions the cache evenly between HTTP and HTTPS
requests:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
volume=1 scheme=http size=50%
volume=2 scheme=http size=50%
.ft P
.fi
.UNINDENT
.UNINDENT
.SH COPYRIGHT
2019, dev@trafficserver.apache.org
.\" Generated by docutils manpage writer.
.