Oracle iPlanet Web Proxy Server 4.0.14 Configuration File Reference

Cache Elements

Cache elements are as follows:

FILECACHE

Configures the in-memory cache.

Subelements

The following table describes subelements for the FILECACHE element.

Table 2–22 FILECACHE subelements

Element  

Required  

Description  

DESCRIPTION

Zero or one 

Contains a text description of this element 

Attributes

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 transmitfile, the server caches open file descriptors for files in the file cache, rather than caching the file contents. PR_transmitfile is used to send the file contents to a client. When transmitfile 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

Initial number of hash buckets.  

CACHE

Configures the disk cache.

Subelements

The following table describes subelements for the CACHE element.

Table 2–24 CACHE subelements

Element  

Required  

Description  

DESCRIPTION

Zero or one 

Contains a text description of this element. 

PARTITION

One or more 

The cache partition is a reserved part of disk or memory that is set aside for caching purposes. 

GC

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. 

Attributes

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. 

PARTITION

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.

Subelements

The following table describes subelements for the PARTITION element.

Table 2–26 PARTITION subelements

Element  

Required  

Description  

DESCRIPTION

Zero or one 

Contains a text description of this element. 

Attributes

The following table describes attributes for the PARTITION element.

Table 2–27 PARTITION 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 

(Optional) Number for the maximum size to which you want to allow the cache partition to grow, listed in megabytes. 

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.

GC

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.

Subelements

The following table describes subelements for the GC element.

Table 2–28 CACHE subelements

Element  

Required  

Description  

DESCRIPTION

Zero or one 

Contains a text description of this element. 

Attributes

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