Configuration Reference Home
Oracle Unified Directory - FIFO Entry Cache

FIFO Entry Cache

FIFO Entry Caches use a FIFO queue to keep track of the cached entries.

Entries that have been in the cache the longest are the most likely candidates for purging if space is needed. In contrast to other cache structures, the selection of entries to purge is not based on how frequently or recently the entries have been accessed. This requires significantly less locking (it will only be required when an entry is added or removed from the cache, rather than each time an entry is accessed). Cache sizing is based on the percentage of free memory within the JVM, such that if enough memory is free, then adding an entry to the cache will not require purging, but if more than a specified percentage of the available memory within the JVM is already consumed, then one or more entries will need to be removed in order to make room for a new entry. It is also possible to configure a maximum number of entries for the cache. If this is specified, then the number of entries will not be allowed to exceed this value, but it may not be possible to hold this many entries if the available memory fills up first. Other configurable parameters for this cache include the maximum length of time to block while waiting to acquire a lock, and a set of filters that may be used to define criteria for determining which entries are stored in the cache. If a filter list is provided, then only entries matching at least one of the given filters will be stored in the cache.

Parent Component

The FIFO Entry Cache component inherits from the Entry Cache

Properties

A description of each property follows.


Basic Properties: Advanced Properties:
↓ cache-level ↓ java-class
↓ enabled ↓ lock-timeout
↓ exclude-filter
↓ include-filter
↓ max-entries
↓ max-memory-percent

Basic Properties

cache-level

Description
Specifies the cache level in the cache order if more than one instance of the cache is configured.
Default Value
None
Allowed Values
An integer value. Lower value is 1.
Multi-valued
No
Required
Yes
Admin Action Required
None
Advanced Property
No
Read-only
No

enabled

Description
Indicates whether the Entry Cache is enabled.
Default Value
None
Allowed Values
true
false
Multi-valued
No
Required
Yes
Admin Action Required
None
Advanced Property
No
Read-only
No

exclude-filter

Description
The set of filters that define the entries that should be excluded from the cache.
Default Value
None
Allowed Values
A String
Multi-valued
Yes
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No

include-filter

Description
The set of filters that define the entries that should be included in the cache.
Default Value
None
Allowed Values
A String
Multi-valued
Yes
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No

max-entries

Description
Specifies the maximum number of entries that we will allow in the cache.
Default Value
2147483647
Allowed Values
An integer value. Lower value is 0.
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No

max-memory-percent

Description
Specifies the maximum memory usage for the entry cache as a percentage of the total JVM memory.
Default Value
90
Allowed Values
An integer value. Lower value is 1. Upper value is 100 .
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
No
Read-only
No


Advanced Properties

java-class

Description
Specifies the fully-qualified name of the Java class that provides the FIFO Entry Cache implementation.
Default Value
org.opends.server.extensions.FIFOEntryCache
Allowed Values
A java class that implements or extends the class(es) :
org.opends.server.api.EntryCache
Multi-valued
No
Required
Yes
Admin Action Required
The FIFO Entry Cache must be disabled and re-enabled for changes to this setting to take effect
Advanced Property
Yes
Read-only
No

lock-timeout

Description
Specifies the length of time to wait while attempting to acquire a read or write lock.
Default Value
2000.0ms
Allowed Values
A duration Syntax. A value of "-1" or "unlimited" for no limit. Lower limit is 0 milliseconds.
Multi-valued
No
Required
No
Admin Action Required
None
Advanced Property
Yes
Read-only
No


Copyright © 2011,2012, Oracle and/or its affiliates. All rights reserved.