To Configure the File Cache

1. From the Server Manager, click the Caching tab.

2. Click the Configure File Cache link.

   The Configure File Cache page is displayed.

3. Select Enable File Cache, if not already selected.

4. Choose whether to transmit files.

   When you enable Transmit File, the server caches open file descriptors for files in the file cache rather than the file contents. 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. By default, Transmit File is enabled on Windows and disabled on UNIX. On UNIX, you should only enable Transmit File for platforms that have native OS support for PR_TransmitFile, which currently includes HP-UX. Use on UNIX/Linux platforms is not recommended.

5. Type a size for the hash table.

   The default size is twice the maximum number of files plus 1. For example, if your maximum number of files is set to 1024, the default hash table size is 2049.

6. Type a maximum age in seconds for a valid cache entry.

   The default setting is 30. This setting controls how long cached information will continue to be used once a file has been 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. Set the maximum age based on whether the content is updated on a regular schedule. For example, if content is updated four times a day at regular intervals, you could set the maximum age to 21600 seconds (6 hours). Otherwise, consider setting the maximum age to the longest time you are willing to serve the previous version of a content file after the file has been modified.

7. Type the Maximum Number of Files to be cached.

   The default setting is 1024.

8. Type medium and small file size limits in bytes.

   The Medium File Size Limit is set by default to 537600. The Small File Size Limit is set by default to 2048.

   The cache treats small, medium, and large files differently. The contents of medium files are cached by mapping the file into virtual memory only on UNIX/Linux platforms. The contents of small files are cached by allocating heap space and reading the file into it. Information about large files is cached but the file contents are not cached. The advantage of distinguishing between small files and medium files is to avoid wasting part of many pages of virtual memory when there are lots of small files. So the Small File Size Limit is typically a slightly lower value than the VM page size.

9. Set the medium and small file space.

   The medium file space is the size in bytes of the virtual memory used to map all medium sized files. The size is set by default to 10485760. The small file space is the size of heap space in bytes used for the cache, including heap space used to cache small files. The size is set by default to 1048576 for UNIX/Linux.

10. Click OK.

11. Click Restart Required.

    The Apply Changes page is displayed.

12. Click the Restart Proxy Server button to apply the changes.