Sun Microsystems, Inc.
spacerspacer
spacer www.sun.com docs.sun.com |
spacer
black dot
 
 
40.  Using The CacheFS File System (Tasks) Packing a CacheFS File System Troubleshooting cachefspack Errors  Previous   Contents   Next 
   
 
Cause

The cache is out of disk space.

Action

You need to increase the size of the cache by increasing disk space.

cachefspack: filename - can't unpack file: permission denied
Cause

You might not have the correct permissions to access the file or directory.

Action

Set the correct permissions.

cachefspack: filename - can't unpack file: no such file or directory
Cause

You might not have the correct file or directory.

Action

Check for a possible typo.

cachefspack: filename- can't unpack file: stale NFS file handle
Cause

The file or directory might have been moved or deleted from the server at the time you attempted to access it.

Action

Verify that the file or directory on the server is still accessible.

cachefspack: filename - can't unpack file: interrupted system call
Cause

You might have pressed Control-C inadvertently while issuing the command.

Action

Reissue the command.

cachefspack: filename- can't unpack file I/O error
Cause

You might have a hardware problem.

Action

Check your hardware connections.

cachefspack: only one `d', `i', `p', or `u' option allowed
Cause

You entered more than one of these options in a command session.

Action

Select one option for the command session.

cachefspack: can't find environment variable.
Cause

You forgot to set a corresponding environment variable to match the $ in your configuration file.

Action

Define the environment variable in the proper location.

cachefspack: skipping LIST command - no active base
Cause

A LIST command is present in your configuration file that has no corresponding BASE command.

Action

Define the BASE command.

Collecting CacheFS Statistics (Task Map)

The following task map shows the steps involved in collecting CacheFS statistics. All the procedures in this table are optional.

Task

Description

For Instructions

Set up logging

Set up logging on a CacheFS file system using the cachefslog command.

"How to Set Up CacheFS Logging"

Locate the log file

Locate the log file with the cachefslog command.

"How to Locate the CacheFS Log File"

Stop logging

Stop logging with the cachefslog command.

"How to Stop CacheFS Logging"

View the cache size

View the cache size by using the cachefswssize command.

"How to View the Working Set (Cache) Size"

View the cache statistics

View the statistics by using the cachefsstat command.

"How to View CacheFS Statistics"

Collecting CacheFS Statistics

Collecting CacheFS statistics enable you to do the following:

  • Determine an appropriate cache size

  • Observe the performance of the cache

These statistics will help you determine the trade-off between your cache size and the desired performance of the cache.

The CacheFS statistics commands consist of the following:

Command

Man Page

Description

cachefslog

cachefslog(1M)

Specifies the location of the log file. This command also displays where the statistics are currently being logged, and enables you to stop logging.

cachefswssize

cachefswssize(1M)

Interprets the log file to give a recommended cache size.

cachefsstat

cachefsstat(1M)

Displays statistical information about a specific file system or all CacheFS file systems. The information provided in the output of this command is taken directly from the cache.

 

 

 


Note - You can issue the CacheFS statistics commands from any directory. You must be superuser to issue the cachefswssize command.


The CacheFS statistics begin accumulating when you create the log file. When the work session is over, stop the logging by using the cachefslog -h command, as described in "How to Stop CacheFS Logging".

Before using the CacheFS statistics commands, you must do the following:

  • Set up your cache by using the cfsadmin command.

  • Decide on an appropriate length of time to allow statistical information to collect in the log file you create. The length of time should equal a typical work session; for example, a day, a week, or a month.

  • Select a location or path for the log file. Make sure that there is enough space to allow for the growth of the log file. The longer you intend to allow statistical information to collect in the log file, the more space you need.


Note - The following procedures are presented in a recommended order. The order is not required.


How to Set Up CacheFS Logging

  1. Set up logging.

    $ cachefslog -f log-file-path /mount-point

    -f

    Sets up logging.

    log-file-path

    Specifies the location of the log file. The log file is a standard file you create with an editor, such as vi.

    /mount-point

    Designates the mount point (CacheFS file system) for which statistics are being collected.

  2. Verify that you correctly set up the log file.

    $ cachefslog /mount-point

Example--Setting Up CacheFS Logging

The following example shows how to set up the /var/tmp/samlog log file to collect statistics about the /home/sam directory.

$ cachefslog -f /var/tmp/samlog /home/sam
  /var/tmp/samlog: /home/sam

How to Locate the CacheFS Log File

You can also use the cachefslog command with no options to locate a log file for a particular mount point.

$ cachefslog /mount-point

/mount-point specifies the CacheFS file system for which you want to view the statistics.

The following example shows what you would see if a log file has been set up. The location of the log file is /var/tmp/stufflog.

$ cachefslog /home/stuff
	 /var/tmp/stufflog: /home/stuff

The following example shows that no log file has been set up for the specified file system.

$ cachefslog /home/zap
	not logged: /home/zap 
 
 
 
  Previous   Contents   Next