Defines the initial configuration of the Cache Manager
Description
The CacheInfo file specifies the initial configuration of the Cache Manager on a client machine. The Cache Manager checks the file at initialization to
determine certain cache configuration information. It uses the file regardless of the type of caching, disk or memory, in use on the machine.
The CacheInfo file is manually created during DFS client installation. (See Part 1 of the OSF DCE DFS Administration Guide and Reference for details on creating the file.) It must reside in the directory named dcelocal/etc.
The file is a one-line ASCII file consisting of the following three fields separated by colons:
· The first field names a directory on the local disk where the Cache Manager mounts the DCE global namespace. The default entry is the global namespace designation (/...). If /... is not specified, symbolic links to the global namespace fail.
The value of this field can be overridden with the dfsd command and the -mountdir option.
· The second field names a directory on the local disk to serve as the cache directory for a disk cache. This is the directory in which the Cache Manager stores the Vn, CacheItems, and FilesetItems files that it creates. The default entry is dcelocal/var/adm/dfs/cache. You can change this to a directory on another partition if more space is available elsewhere. Although the indicated directory is not used with a memory cache, an entry must appear in this field even if memory caching is employed on the machine.
The value of this field can be overridden with the dfsd command and the -cachedir option.
· The third field specifies the cache size in 1024-byte (1-kilobyte) blocks. The amount of disk space or machine memory used for caching depends on several factors. The size of the partition housing the cache directory or the amount of memory available on the machine places an absolute limit on the cache size. However, do not use more than 90% of the cache directory's partition for a disk cache, and do not use more than 20 to 25% of available memory for a memory cache.
The value of this field can be overridden with the dfsd command and the -blocks option. It can also be overridden with the cm setcachesize command. The cm getcachesize command can be used to view the current size of the cache and the amount in use.
Because it is an ASCII file, the CacheInfo file can be directly modified with a text editor. To modify the file, log in as root on the machine.
Cautions
The size of the partition housing the cache directory or the amount of memory available on the machine places an absolute limit on the cache size. However, do not use
more than 90% of the cache directory's partition for a disk cache, and do not use more than 20 to 25% of available memory for a memory cache.
Be precise when editing the CacheInfo file; use colons to separate the fields in the file, and do not include any spaces in the file. Improper formatting of this file can cause the kernel to panic.
Examples
An example of a typical CacheInfo file follows. It lists the DCE global namespace mounted at the global namespace designation (/...),
dcelocal/var/adm/dfs/cache used for the cache directory, and a defined cache size of 50,000 1-kilobyte blocks.
/...:dcelocal/var/adm/dfs/cache:50000
Related Information
Commands: cm getcachesize(8dfs)
Files: CacheItems(4dfs)