NFS Services Administrator's Guide (B.11.31.03) August 2008

Common Problems While Using CacheFS
This section discusses the common problems you may encounter while using CacheFS.
It also describes steps to overcome these problems. The following tables list the error
messages, their cause, and how to resolve these errors.
Table 4-2 Common Error Messages encountered while using the cfsadmin command
ResolutionPossible CausesError Message
1. Delete the cache.
2. Recreate the cache directory
using the cfsadmin
command.
Indicates that you do not have
write permissions to the
filesystem, where the cache
directory is being created.
“cfsadmin: Cannot create lock file
/test/mnt/c/.cfs_lock
1. Enter the fsck command.
2. Try mount operation.
The Cache directory may not
be clean.
“mount failed No space left on device”
(There could be a message in syslog
that states: "WARNING: cacheFS: cache
not clean. Run fsck") .
1. Increase the CacheFS
parameters using the -u
option with the cfsadmin
command.
For more information, see
cfsadmin(1M).
The value of the cache
parameters, used to create the
cache directory, must be
modified.
(There could be a message in syslog
that states: “WARNING: cacheFS: not
enough space to create <fscache
directory name>).
Table 4-3 Common Error Messages encountered while using the fsck command
ResolutionPossible CausesError Message
1. Delete the cache.
2. Recreate the cache directory
using the cfsadmin command.
This error message indicates that
/c is not a cache directory.
fsck -F cachefs Cannot
open lock file /test/c/
.cfs_lock
1. Check if a directory named /c
exists and also if it is a cache
directory.
2. If it is not a cache directory,
delete the directory.
3. If it is a cache directory, run
fsck on the cache directory.
4. If the problem still exists, use a
different cache directory.
This error message indicates that
the cache directory is in use.
However, the actual reason for this
error may be that the cache
directory does not exist, or that/c
is not a cache directory.
“Cache /c is in use and cannot
be modified”.
1. Unmount the filesystem.
2. Run the fsck command on the
cache directory.
This error message indicates that
the filesystem is mounted.
“Cache /c is in use.”
126 Configuring and Administering a Cache Filesystem