Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

vxcached(1m) [hpux man page]

vxcached(1M)															      vxcached(1M)

NAME

       vxcached - resize cache volumes when required

SYNOPSIS

       /etc/vx/bin/vxcached [-v] [mail-address ...]

DESCRIPTION

       The  Veritas Volume Manager cache daemon, vxcached, is invoked by the VxVM kernel to monitor the cache objects that are used by space-opti-
       mized snapshots.  When usage of a cache volume by space-optimized snapshots reaches the high watermark level that  has  been  set  for  the
       cache, vxcached automatically grows the cache volume if this is required and configured.

       The -v option enables the daemon in verbose mode.  If no mail addresses are given as arguments, mail is sent to root.

       If  the autogrow feature has been enabled on a cache object, the values of the highwatermark, autogrowby and maxautogrow attributes for the
       cache object determine the behavior of vxcached:

       o  When cache usage reaches the high watermark value, highwatermark, (default value is 90 percent), and the new required cache  size  would
	  not  exceed  the  value  of  maxautogrow (default value is twice the size of the cache volume in blocks), vxcached grows the size of the
	  cache volume by the value of autogrowby (default value is 20% of the size of the cache volume in blocks).

       o  When cache usage reaches the high watermark value, and the new required cache size would  exceed  the  value	of  maxautogrow,  vxcached
	  deletes the oldest snapshot in the cache.  If there are several snapshots with the same age, the largest of these is deleted.

       If the autogrow feature has been disabled on a cache object:

       o  When	cache  usage  reaches the high watermark value, vxcached deletes the oldest snapshot in the cache.  If there are several snapshots
	  with the same age, the largest of these is deleted.  If there is only a single snapshot, the snapshot is detached and marked as invalid.

       The values of the highwatermark, autogrowby and maxautogrow attributes can be set when a cache object is created using vxmake.	If  neces-
       sary, you can use the vxcache set command to change the values of these attributes for an existing cache.

NOTES

       The  vxcached  daemon is started automatically if a license for the FastResync feature is already present on the system.  If you add such a
       license while VxVM is running, you can either start vxcached manually, or shut down and reboot the system.

       Killing the vxcached process stops it from removing snapshots.  The daemon can be prevented from being started by commenting out its  entry
       in the startup script, /sbin/init.d/vxvm-recover.

       The vxcached daemon does not remove snapshots that are currently open, and it does not remove the last or only snapshot in the cache.

       If  the	cache space becomes exhausted, the snapshot is detached.  If this happens, the snapshot is unrecoverable and must be removed manu-
       ally.  Enabling the autogrow feature on the cache helps to avoid this situation occurring.  However, for very small caches (of the order of
       a  few  megabytes),  it	is  possible  for the cache to become exhausted before the system has time to respond and grow the cache.  In such
       cases, either increase the size of the cache manually, or reduce the value of highwatermark.

       You can use the maxautogrow attribute to limit the maximum size to which a cache can grow.  To estimate this size, consider  how  much  the
       contents of each source volume are likely to change between snapshot refreshes, and allow some additional space for contingency.

SEE ALSO

       vxcache(1M), vxintro(1M), vxmake(1M), vxsnap(1M)

VxVM 5.0.31.1							    24 Mar 2008 						      vxcached(1M)

Check Out this Related Man Page

FS_SETCACHESIZE(1)					       AFS Command Reference						FS_SETCACHESIZE(1)

NAME

       fs_setcachesize - Sets the size of the disk cache

SYNOPSIS

       fs setcachesize [-blocks <size (0 = reset)>>] [-reset] [-help]

       fs setca [-b <size (0 = reset)>>] [-r] [-h]

       fs cachesize [-b <size (0 = reset)>>] [-r] [-h]

       fs ca [-b <size (0 = reset)>>] [-r] [-h]

DESCRIPTION

       The fs setcachesize command changes the number of kilobyte blocks of local disk space available to the Cache Manager for its data cache, on
       machines that use a disk cache. The command is not operative on machines that use a memory cache.

       To return the cache size to the default value specified in the third field of the local /etc/openafs/cacheinfo file, provide a value of 0
       to the -blocks argument.

       To return the cache size to the value set when the machine was last rebooted, use the -reset flag instead of the -blocks argument. This is
       normally the amount specified in the cacheinfo file, unless the -blocks argument was included on the afsd command to override the cacheinfo
       value.

       To display the current cache size and amount of cache in use, for both disk and memory caches, use the fs getcacheparms command.

CAUTIONS

       This command is not operative on machines using a memory cache, and results in an error message. To change memory cache size, edit the
       cacheinfo file and reboot, or reboot and provide the -blocks argument to the afsd command.

       On machines using a disk cache, do not set the cache size to exceed 85% to 90% of the actual disk space available for the cache directory.
       The cache implementation itself requires a small amount of space on the partition.

OPTIONS

       -blocks <size>
	   Specifies the amount of disk space available for the Cache Manager to devote to the cache.  The size should be a positive integer
	   followed by an optional suffix: "K" for kibibytes (1024 bytes, the default), "M" for mebibytes (1024 kibibytes), "G" for gibibytes
	   (1024 mebibytes), and "T" for tebibytes (1024 gibibytes).  Provide a value of 0 to set cache size to the default specified in the
	   cacheinfo file.

       -reset
	   Returns the cache size to the value set when the machine was last booted. This agrees with the value in the cacheinfo file unless the
	   -blocks argument was used on the afsd command.

       -help
	   Prints the online help for this command. All other valid options are ignored.

EXAMPLES

       The following command sets the disk cache size to 25000 kilobyte blocks.

	  % fs setcachesize -blocks 25000

       Both of the following commands reset the disk cache size to the value in the cacheinfo file, assuming that the -blocks argument to the afsd
       command was not used.

	  % fs setcachesize -blocks 0
	  % fs setcachesize -reset

PRIVILEGE REQUIRED

       The issuer must be logged in as the local superuser root.

SEE ALSO

       cacheinfo(5), afsd(8), fs_getcacheparms(1)

COPYRIGHT

       IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

       This documentation is covered by the IBM Public License Version 1.0.  It was converted from HTML to POD by software written by Chas
       Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.

OpenAFS 							    2012-03-26							FS_SETCACHESIZE(1)
Man Page