EraseCache(1)

Name

EraseCache - delete files maintained by the Vesta-2 cache server

Synopsis

EraseCache [ -f ] [ -v ]

Description

EraseCache deletes files maintained by the Vesta-2 cache server. In particular, it deletes the cache server's log files, stable cache files (i.e., all of the so-called MultiPKFiles), and stable variable files. It also deletes any stable files written by the Vesta-2 weeder, VestaWeed(1).

By default, the files containing the stable cache entries are not listed when they are deleted, since there are likely to be so many of them. If you specify the -v switch, all of the stable cache files are listed as they are deleted.

Since erasing a cache server's cache is a serious operation, by default EraseCache displays the directory of the cache that will be erased, and then asks for confirmation:

  Are you sure you want to erase this cache (y/n)?

The cache will only be erased if your response begins with the letter "y". The -f switch forces the cache to be erased without a request for confirmation.

When you erase the cache files created by some cache server, you must run EraseCache as the same user that ran the cache server that created those files. In particular, to erase the centralized cache, you must run EraseCache as vestasrv.

When you run EraseCache, cache entries are only deleted from the disk, not from the memory of a running cache server VCache(1). To run the cache server on an empty cache, you must kill any running instance of the cache server, run EraseCache, and then restart the server.

Warning! You should never erase a stable cache that is in use by some cache server. Doing so will most likely cause the cache server to crash. Be sure there is no cache server running on the stable cache in question before using this program.

Configuration Variables

EraseCache deletes files contained in a part of the filesystem pointed to by the current Vesta configuration file. In particular, it reads the following values from the CacheServer section of the configuration file:

[CacheServer]
MetaDataRoot     - root of Vesta-2 meta-data
  MetaDataDir    - root of cache server meta-data sub-tree
    SCacheDir    - root of stable cache entries sub-tree
    SVarsDir     - root of stable variables sub-tree
    WeededLogDir - directory containing log of weeded MPKFiles
    CacheLogDir  - directory containing the cache log
    GraphLogDir  - directory containing the graph log
    CILogDir     - directory containing the used cache index log

It also reads the following value from the Weeder section of the configuration file:

[Weeder]
  MetaDataDir    - root of weeder meta-data files

Nesting indicates how the directory tree corresponding to these names is structured. If the MetaDataRoot value is the empty string, then the current directory is used.

See Also

CleanCache(1), CreateCacheDirs(1), PrintMPKFile(1), ShowCache(1), VCache(1), VestaWeed(1), WhichCache(1).

Author

Allan Heydon (caheydon@yahoo.com)

Last modified on Thu Nov  8 12:48:54 EST 2001 by ken@xorian.net
     modified on Sun Oct  4 19:22:45 PDT 1998 by heydon