NAME¶
cache-clean - Administration tool for the A-REX cache.
SYNOPSIS¶
cache-clean [-h] [-s] [-m NN -M NN] [-E N] [-D debug_level]
[ -c <arex_config_file> | <dir1> [<dir2> [...]] ]
DESCRIPTION¶
cache-clean is a tool for administrators of ARC server installations to
safely remove A-REX cache data and to provide an overview of the contents of
the cache. It is used by the A-REX to automatically manage cache contents.
There are two modes of operation - printing statistics and deleting files. If
-s is used, then statistics are printed on each cache. If
-m and
-M are used then files in each cache are deleted if the free space on
the file system is less than that given by
-m, in the order of least
recently accessed, until the free space is equal to what is specified by
-M. If
-E is used, then all files accessed less recently than
the given time are deleted.
-E can be used in combination with
-m and
-M but deleting files using
-E is carried out
first. If after this the cache free space is still less than that given by
-m then cleaning according to those options is performed. Cache
directories are given by
dir1, dir2.. or taken from the config file
specified by
-c or the ARC_CONFIG environment variable.
-h - print short help
-s - print cache statistics, without deleting anything. The output
displays for each cache the number of deletable (and locked) files, the total
size of these files, the percentage usage of the file system in which the
cache is stored, and a histogram of access times of the files in the cache.
-m - the minimum free space (as % of the file system) at which to start
cleaning
-M - the minimum free space (as % of the file system) at which to stop
cleaning
-E - files accessed less recently than the given time period will be
deleted. Example values of this option are 1800, 90s, 24h, 30d. The default
when no suffix is given is seconds.
-D - debug level. Possible values are FATAL, ERROR, WARNING, INFO,
VERBOSE or DEBUG. Default level is INFO.
-c - path to an A-REX config file, xml or ini format
This tool is run periodically by the A-REX to keep the size of each cache within
the limits specified in the configuration file. Therefore cleaning should not
be performed manually, unless the cache size needs to be reduced temporarily.
For performance reasons it may however be desirable to run cache-clean
independently on the machine hosting the cache file system, if this is
different from the A-REX host. The most useful function for administrators is
to give an overview of the contents of the cache, using the
-s option.
Within each cache directory specified in the configuration file, there is a
subdirectory for data (data/) and one for per-job hard links (joblinks/). See
the A-REX Administration Guide for more details.
cache-clean should
only operate on the data subdirectory, therefore when giving
dir
arguments they should be the top level cache directory.
cache-clean
will then automatically only look at files within the data directory.
EXAMPLE¶
cache-clean -m20 -M30 -E30d -D VERBOSE -c /etc/arc.conf
Cache directories are taken from the configuration file
/etc/arc.conf and
all cache files accessed more than 30 days ago are deleted. Then if the free
space in a cache is below 20%, data is deleted until the free space reaches
30%. Verbose debug output is enabled so information is output on each file
that is deleted.
COPYRIGHT¶
APACHE LICENSE Version 2.0
AUTHOR¶
ARC software is developed by the NorduGrid Collaboration
(
http://www.nordugrid.org), please consult the AUTHORS file distributed with
ARC. Please report bugs and feature requests to
http://bugzilla.nordugrid.org