Document content consists of the content elements associated with documents (as specified by the
property on the
object). The cache receives new content in the following circumstances:
- Cache miss: When the cache receives a request for a file not currently residing in the cache, the cache receives a duplicate of that file as part of the document retrieval process.
- Content preloading: When content preloading has been enabled (via the
property), the cache receives duplicates of any new content added to the main storage area.PreloadOnCreate
In both circumstances, new content can be added to the cache only when its storage capacity (as defined by the
and
properties) exceeds the current amount of content (as indicated by the
and
properties). Cache content, however, can end up slightly exceeding the designated storage capacity, as statistics are managed on a delayed basis, and multiple servers can be adding content.
Cache pruning is the process of deleting the content least frequently requested from the cache. Pruning deletes three main categories of files: abandoned, expired, and old. An abandoned file is an incomplete file that has been not properly added to the cache as a result of a server failure of some sort (such as a power failure). An expired file is a file that has remained in an unaccessed state longer than the maximum-time-to-live (as specified by the
property). An old file is a file that, compared to other files in the same directory, has been accessed less recently. Note that these categories are not mutually exclusive; an abandoned file might also be an expired file, and an expired file an old file.
Pruning considers the most recent access time for a file equivalent to its time-of-last-use. This time gets updated to the current time when the file first gets added to the cache, and also whenever the file gets retrieved, provided more than 10 minutes have elapsed since the previous time-of-last-use update. Consequently, the accuracy of the time-of-last-use for a file is within 10 minutes.
Prune actions--specific instances of pruning--operate on the cache directory by directory. For a general discussion on the advantages of this approach, see the
Prune actions get triggered in three different ways:
- Mandatory Prune: Ensures that cache content remains under prune threshold levels. For more information, see the
PruneThresholdContentElements property. - Periodic Prune: Ensures that expired files get deleted on a timely basis. For more information, see the
MaximumTimeToLive property. - Sweeping: Ensures that the statistics concerning content element count (the
property) and content element size (theContentElementCount
property) remain reasonably accurate. A prune action occurs as part of this statistical update. For more information on the sweep action, see theContentElementKBytes ContentElementCount property.
Cache sweeping does not update the count of content element creations (the
property) or the count of content element deletions (the
property). These statistics can become inaccurate over time, but can be optionally reset by clearing the cache. For more information on cache clearing, see the
Namespace: FileNet.Api.Admin
Assembly: FileNet.Api (in filenet.api.dll)
Syntax
Visual Basic (Declaration) |
---|
Public Interface IContentCacheArea Implements IIndependentlyPersistableObject, IIndependentObject, IEngineObject, ICloneable |
C# |
---|
public interface IContentCacheArea : IIndependentlyPersistableObject, IIndependentObject, IEngineObject, ICloneable |
C++ |
---|
interface class IContentCacheArea : IIndependentlyPersistableObject, IIndependentObject, IEngineObject, ICloneable |
J# |
---|
public interface IContentCacheArea implements IIndependentlyPersistableObject, IIndependentObject, IEngineObject, ICloneable |
JScript |
---|
public interface IContentCacheArea extends IIndependentlyPersistableObject, IIndependentObject, IEngineObject, ICloneable |
Remarks
Metadata
Auditable: false
AllowsInstances: true
AllowsSubClasses: false
ClassDefinitionName: None
IsDependent: false
IsHidden: false
Searchable: false
StorageType: Domain
SuperclassName: GenericObject