.\" Man page generated from reStructuredText.
.
.
.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
..
.TH "VOLUME.CONFIG" "5" "Nov 02, 2023" "9.2" "Apache Traffic Server"
.SH NAME
volume.config \- Traffic Server cache volume configuration file
.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. By distributing the cache across multiple volumes,
you can help decrease single\-lock pressure when there are not many hard drives
present. You can further configure these volumes to store data from certain
origin servers and/or domains in the \fI\%hosting.config\fP file.
.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.
.sp
\fBIMPORTANT:\fP
.INDENT 0.0
.INDENT 3.5
Changing this file to add, remove or modify volumes effectively invalidates
the cache.
.UNINDENT
.UNINDENT
.SS Optional ramcache setting
.sp
You can also add an option \fBramcache=true/false\fP to the volume configuration
line.  True is the default setting and so not needed unless you want to explicitly
set it.  Setting \fBramcache=false\fP will disable the ramcache that normally
sits in front of a volume.  This may be desirable if you are using something like
ramdisks, to avoid wasting RAM and cpu time on double caching objects.
.SH EXCLUSIVE SPANS AND VOLUME SIZES
.sp
In the following sample configuration 2 spans \fI/dev/disk1\fP and \fI/dev/disk2\fP are defined
in \fI\%storage.config\fP, where span \fI/dev/disk2\fP is assigned to \fIvolume 3\fP exclusively
(\fIvolume 3\fP is forced to an \(dqexclusive\(dq span \fI/dev/disk2\fP).
In \fI\%volume.config\fP there are 3 volumes defined, where \fIvolume 1\fP and \fIvolume 2\fP
occupy span \fI/dev/disk1\fP taking each 50% of its space and \fIvolume 3\fP takes 100% of span
\fI/dev/disk2\fP exclusively.
.sp
storage.config:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
/dev/disk1
/dev/disk2 volume=3 # <\- exclusive span
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
volume.config:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
volume=1 scheme=http size=50%
volume=2 scheme=http size=50%
volume=3 scheme=http size=512 # <\- volume forced to a specific exclusive span
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
It is important to note that when percentages are used to specify volume sizes
and \(dqexclusive\(dq spans are assigned (forced) to a particular volume (in this case \fIvolume 3\fP),
the \(dqexclusive\(dq spans (in this case \fI/dev/disk2\fP) are excluded from the total cache
space when the \(dqnon\-forced\(dq volumes sizes are calculated (in this case \fIvolume 1\fP and \fIvolume 2\fP).
.SH EXAMPLES
.sp
The following example partitions the cache across 5 volumes to decreasing
single\-lock pressure for a machine with few drives. The last volume being
an example of one that might be composed of purely ramdisks so that the
ramcache has been disabled.:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
volume=1 scheme=http size=20%
volume=2 scheme=http size=20%
volume=3 scheme=http size=20%
volume=4 scheme=http size=20%
volume=5 scheme=http size=20% ramcache=false
.ft P
.fi
.UNINDENT
.UNINDENT
.SH COPYRIGHT
2023, dev@trafficserver.apache.org
.\" Generated by docutils manpage writer.
.