The Event and Statistics cache can get corrupted at time due to various incidents such as an abrupt shut down of the PATROL Agent. You can fix the corrupted cache in two ways:
This topic provides information about repairing the corrupted Event and Statistics cache using
fix_cacheutility. The files are located at:
fix_cache utility requires shutting down the PATROL agent for the entire duration of running the fix_cache utility. The length of the down time is directly related to the size of the cache. If these files are very large or any down time for the agent is undesirable, consider automatic recovery instead of running the
Ensure that adequate disk space is available on the system. A minimum of ten times the size of the cache will be required. During the cache repair, if the system runs out of disk space, all PATROL files will become inaccessible and other applications might also stop running.
Stop the PATROL Agent.
fix_cacheutility and monitor the output.
Issue the following command to get the return code of the process:
See Return values for fix_cache utility section below for more information about return values.
fix_cache utility exits with one of the following values:
fix_cache utility has the following format:
The following table lists and defines the options recognized by the
Options recognized by the
This option specifies which PATROL Agent's cache is used. If -host option is not specified, then the name of the host, where the
|-queue_size||This option specifies the queue size used by the utility. Queue size indicates the number of elements in the queue. If no value is specified or the value is invalid, then value 100 is set as default.|
|-rebuild_cache||This option rebuilds the cache from the buffer. No value is needed for this option.|
This option specifies which PATROL Agent's cache is used. Combined with the -host option, -port specifies a unique PATROL Agent. The value of this option must be the port number to which the specified PATROL Agent is listening. The default value is 3181.
This option displays version information.
The following examples illustrate how to use the
This command fixes the cache and creates a backup of the cache file at port 5000.
This command fixes the cache and rebuilds it.
This command fixes the cache for host host123 at port 3181.