The storage.config file lists all the files, directories, and/or hard disk partitions that make up the Traffic Server cache. After you modify the storage.config file, you must restart Traffic Server.

Format

The format of the storage.config file is:

pathname size

where pathname is the name of a partition, directory or file, and size is the size of the named partition, directory or file (in bytes). You must specify a size for directories or files; size is optional for raw partitions.

You can use any partition of any size. For best performance:

  • Use raw disk partitions.
  • For each disk, make all partitions the same size.
  • For each node, use the same number of partitions on all disks.

Specify pathnames according to your operating system requirements. See the following examples. In the storage.config file, a formatted or raw disk must be at least 128 MB.

Examples

The following basic example shows 64 MB of cache storage in the /big_dir directory:

/big_dir 67108864

You can use the . symbol for the current directory. Here is an example for 64 MB of cache storage in the current directory:

. 67108864

Solaris Example

The following example is for the Solaris operating system:

/dev/rdsk/c0t0d0s5
/dev/rdsk/c0t0d1s5

Note: Size is optional. If not specified, the entire partition is used.

Linux Example

The following example will use an entire raw disk in the Linux operating system:

/dev/sde
/dev/sdf

In order to make sure traffic_server will have access to this disk you can use udev to persisently set the right permissions. The following rules are targeted for an Ubuntu system, and stored in /etc/udev/rules.d/51-cache-disk.rules:

# Assign /dev/sde and /dev/sdf to the www group
# make the assignment final, no later changes allowed to the group!
SUBSYSTEM=="block", KERNEL=="sd[ef]", GROUP:="www"