The persistent data store is a small, fast database used by various components that require short-term data persistence, or fast data access. It is an optional feature used for session management, database caching, and storing system configurations. By default it is not enabled; see the end of this document for instructions on turning this feature on. When on, this application can be used to peek inside the persistent data store, inspect items, and remove items.
Every item in the store can be given an expiry time, after which it will be automatically purged from the store. Expiry times default to 1 hour, but can be set to other times, indefinite (no expiry), or renewed/updated as needed.
This is a list of all items in the store. The size (in bytes) is shown, and the administrator has links to inspect or clear (delete) the item. Some items (cached items, configurations) will automatically be reloaded if they are needed, so they may reappear after you delete them.
The item name gives some indication of its purpose:
There may be other items in the store as well, but they are not described here.
To clear all items in the store, use the Reset Store button. This
does not affect any items beginning with "_" (ie. _id
and
_log
).
Click the inspect links to see what is actually contained in an item in the store. The structure of the resulting data will vary depending on what you are looking at.
The expiry time of the item is noted above the data, as MM:SS. Some items do not expire, and will be noted as such. Items that have passed their expiry time are noted as EXPIRED, but will not actually be removed until the next time the store goes through a round of garbage collection. (The time until the next round of garbage collection is noted at the bottom of the store inventory.)
Why should you enable the store?
However, there are a few reasons why you might not want to use the store:
Note that all of these issues can be mitigated by manual intervention, to clear affected items, reset the store, or rebuild the store database. (However, manual intervention is not always possible or practical.) If you decide that the benefits outweight the disadvantages, you need to do the following things to enable the store:
Local::store_conf()
to set your store
configuration parameters. Remove "_disabled
" from the
routine name to ensure that the configuration is picked up by the
system.../bin/store.pl --reset