Cache elements are as follows:
Configures the in-memory cache.
The following table describes subelements for the FILECACHE element.
Table 2–22 FILECACHE subelements
Element |
Required |
Description |
---|---|---|
Zero or one |
Contains a text description of this element |
The following table describes attributes for the FILEACHE element.
Table 2–23 FILECACHE attributes
Attribute |
Default |
Description |
---|---|---|
enabled |
true |
Select this option, if not already selected. |
transmitfile |
false |
When you enable Transmit File, the server caches open file descriptors for files in the file cache, rather than the file contents and PR_TransmitFile is used to send the file contents to a client. When Transmit File is enabled, the distinction normally made by the file cache between small, medium, and large files no longer applies, because only the open file descriptor is being cached. |
contentcache |
true |
Enables caching file content. |
tempdir |
Specifies the directory to store temporary files. |
|
maxage |
30 |
The maximum age in seconds of a valid cache entry. This setting controls how long cached information will continue to be used once the file is cached. An entry older than maxage is replaced by a new entry for the same file, if the same file is referenced through the cache. |
mediumfilesizelimit |
537600 |
Size in bytes of the largest (non-small) file that is considered to be medium size. The contents of medium files are cached by mapping the file into virtual memory (currently only on UNIX platforms). The contents of "large" files (larger than "medium") are not cached, although information about large files is cached. |
mediumfilespace |
10485760 |
Specifies how much virtual memory will be used to map all medium-sized files. |
smallfilesizelimit |
2048 |
Size in bytes of the largest file that is considered to be "small". The contents of small files are cached by allocating heap space and reading the file into that space. |
smallfilespace |
1048576 |
Specifies how much heap space will be used for the cache, including heap space used to cache small files. |
maxfiles |
1024 |
The maximum number of files that may be in the cache at once. |
hashinitsize |
0 |
Configures the disk cache.
The following table describes subelements for the CACHE element.
Table 2–24 CACHE subelements
Element |
Required |
Description |
---|---|---|
Zero or one |
Contains a text description of this element. |
|
One or more |
The cache partition is a reserved part of disk or memory that is set aside for caching purposes. |
|
Zero or one |
The cache garbage collector is used to delete files from the cache. Garbage collection can be done in either the automatic mode or the explicit mode. |
The following table describes attributes for the CACHE element.
Table 2–25 CACHE attributes
Attribute |
Default |
Description |
---|---|---|
enabled |
true |
Select this option, if not already selected. |
cachedir |
install-root/instance-directory/cache |
Specifies the directory for caching. |
cachecapacity |
2000 Mbytes |
The cache capacity should be set equal to or greater than the cache size. Setting the capacity larger than the cache size can be helpful if you know that you plan to increase the cache size later, such as by adding an external disk. |
Configures the storage area on a disk that you set aside for caching. If you want to have your cache span several disks, you need to configure at least one cache partition for each disk. Each partition can be independently administered, so you can enable, disable, and configure a partition independently of all other partitions.
The following table describes subelements for the PARTITION element.
Table 2–26 CACHE subelements
Element |
Required |
Description |
---|---|---|
Zero or one |
Contains a text description of this element. |
The following table describes attributes for the PARTITION element.
Table 2–27 CACHE attributes
Attribute |
Default |
Description |
---|---|---|
enabled |
true |
Select this option, if not already selected. |
partitiondir |
install-root/instance-directory/cache |
Specify the directory where the partition is to be created. |
partitionname |
part1 |
Specify a name for the partition. |
maxsize |
1600 Mbytes |
The optional number for the maximum size, in megabytes, to allow for the cache partition to grow. |
minspace |
5 Mbytes |
The minimum amount of available space, in megabytes, on the physical partition. This partition is the actual disk on which the cache partition resides. If less space is available, the proxy stops caching to that cache partition, even if the cache has not reached the maximum size (maxsize). The proxy server continues to write to other partitions that are not full. |
Configures the cache garbage collector that deletes files from the cache. Garbage collection can be done in either the automatic mode or the explicit mode.
The following table describes subelements for the GC element.
Table 2–28 CACHE subelements
Element |
Required |
Description |
---|---|---|
Zero or one |
Contains a text description of this element. |
The following table describes attributes for the GC element.
Table 2–29 CACHE attributes
Attribute |
Default |
Description |
---|---|---|
enabled |
true |
Select this option, if not already selected |
gchimargin |
80 |
Controls the percentage of the maximum cache size that, when reached, triggers garbage collection |
gclomargin |
70 |
Controls the percentage of the maximum cache size that the garbage collector targets |
gcleavefsfull |
60 |
Determines the percentage of the cache partition size below which garbage collection will not go |
gcextramargin |
30 |
Sets the percentage of the cache to be removed by the garbage collector |