The
is an entry cache implementation which uses a JE database to keep
track of the entries.
For the best performance the JE database should reside in a memory
based file system, although any file system will do for this cache
to function. Entries are maintained either by FIFO (default) or LRU
(configurable) based list implementation. Cache sizing is based on
the size or percentage of free space available in the file system,
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 file system available space 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 set of
filters are provided then an entry must match at least one of them
in order to be stored in the cache. JE environment cache size can
also be configured either as percentage of the free memory available
in the JVM, or as an absolute size in bytes. This cache has a
persistence property which, if enabled, allows for the contents of
the cache to persist across server or cache restarts.
ds-cfg-file-system-entry-cache
ds-cfg-entry-cache
The length of time to wait while attempting to acquire a read or
write lock.
2000.0ms
ds-cfg-lock-timeout
The maximum size of the entry cache in bytes.
0b
ds-cfg-max-memory-size
The maximum number of entries allowed in the cache.
2147483647
ds-cfg-max-entries
Specifies the policy which should be used for purging entries from
the cache.
fifo
FIFO based entry cache.
LRU based entry cache.
ds-cfg-cache-type
Specifies the directory in which the JE environment should store
the cache.
/tmp/OpenDS.FSCache
ds-cfg-cache-directory
Specifies whether the cache should persist across restarts.
false
ds-cfg-persistent-cache
Indicates whether the cache should use a compact form when
encoding cache entries by compressing the attribute descriptions
and object class sets.
Note that compression does not preserve user-supplied
capitalization in the object class and attribute type names.
Changing this property will only affect the encoding of the
cache entries put in the cache after the change is made. It
will not be retroactively applied to existing cache entries.
true
ds-cfg-compact-encoding
The maximum memory usage for the internal JE cache as a percentage
of the total JVM memory.
0
ds-cfg-db-cache-percent
The maximum JVM memory usage in bytes for the internal JE cache.
0b
ds-cfg-db-cache-size
Specifies the environment properties for the Berkeley DB Java
Edition database providing the backend for this entry cache.
Any Berkeley DB Java Edition property can be specified using the
following form: property-name=property-value Refer to OpenDS
documentation for further information on related properties, their
implications and range values. The definitive identification of
all the property parameters available in the example.properties
file of Berkeley DB Java Edition distribution.
je.log.fileMax=10485760
je.cleaner.minUtilization=90
je.cleaner.maxBatchFiles=1
je.cleaner.minAge=1
je.cleaner.minFileUtilization=50
je.checkpointer.bytesInterval=10485760
ds-cfg-je-property
org.opends.server.extensions.FileSystemEntryCache