logo

Manual Pages


Table of Contents

NAME

flexcache - commands for administering FlexCache volumes

SYNOPSIS

flexcache help [subcommand]

flexcache fstat path

flexcache eject path [-f]

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

DESCRIPTION

The flexcache command is used to administer FlexCache volumes. FlexCache volumes are housed on the caching filer, and are cached copies of separate volumes, which are on a different filer (henceforth referred to as the origin filer). Clients access the FlexCache volume as they would access any other volume exported over NFS. FlexCache must be licensed on the caching filer, and is not required for the origin filer. The current version of FlexCache only supports client access via NFSv2 and NFSv3.

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

USAGE

flexcache help [subcommand]

Displays help on the specified flexcache subcommand.

flexcache fstat 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 1K 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.

flexcache eject 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 -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 filer 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 filer 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