Manual Pages


Table of Contents

NAME

flexcache - commands for administering FlexCache volumes

SYNOPSIS

flexcache help [subcommand]

flexcache fstat [-i] path

flexcache eject [-i] path [-f]

flexcache stats [ -C [volname]] [ -S [volname] [-c [clientname]]] [-z]

DESCRIPTION

The flexcache command is used to administer FlexCache volumes. FlexCache volumes are cached copies of another volume (called the origin volume) located on a different system. The system that contains the FlexCache volumes is called the caching system, and the system that contains the origin volume is called the origin system. The FlexCache volume might contain only part of the contents of the origin volume.

Clients access the FlexCache volume the same way they access other volumes exported over NFS, except that only NFSv2 and NFSv3 are supported on FlexCache volumes. FlexCache must be licensed on the caching system, but no license is required on the origin system.

For more information on volumes, see na_vol(1).

USAGE

flexcache help [subcommand]

Displays help on the specified flexcache subcommand.

flexcache fstat [-i] path

Display statistics about the object cached at path. path must be given as a canonical pathname. That is, to display information on the file bar, residing on cache volume foo, one would use the path /vol/foo/bar. fstat avoids fetching attribute information for files that aren't already present in the cache. Note however that all directories given in path will be fetched in order to perform the required lookups. In addition to the traditional UNIX stat information, specific information used by the caching algorithms is displayed. In particular, the number of 4K blocks the file is consuming on the caching volume, and the last time the file was updated on the cache. fstat can be used on any path on the appliance. The -i option enables you to specify the inode rather than the file name (for example, flexcache fstat -i /vol/foo/inode:24529). The -i option can be useful if the file name is unknown or the path to the file name cannot be resolved.

flexcache eject [-i] path [-f]

Eject the given file from the cache. The path must be specified in the same manner as in the flexcache fstat command. The -i option enables you to specify the inode rather than the file name (for example, flexcache eject -i /vol/foo/inode:24529). The -i option can be useful if the file name is unknown or the path to the file name cannot be resolved. The -f option ejects the file without prompting the user for confirmation.

flexcache stats [ -C [volname]] [ -S [volname] [-c [clientname]]] [-z]

The -C option on the caching node displays client side bandwidth savings and hit/miss statistics for volname, or for all mapped FlexCache volumes if volname is unspecified. The -S option on the origin node displays server side statistics for volname if one is supplied or for all origin volumes otherwise. If -c is also supplied, statistics for each caching client are also displayed. If clientname is specified then information for that client only is displayed. The -c option is only valid with the -S option and the global option flexcache.per_client_stats must be set to on. The -z option zeroes all the statistics for all FlexCache volumes.

SEE ALSO

na_vol(1)


Table of Contents