The
is an entry cache implementation which uses a JE database to keep
track of the entries.
For 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-based
(configurable) list implementation. Cache sizing is based on
the size 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. If more than the specified size of the file
system available space is already consumed, then one or more entries
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 are not 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 a 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/OpenDJ.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 only affects 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
Specifies the maximum memory usage for the internal JE cache as a percentage
of the total JVM memory.
1
ds-cfg-db-cache-percent
Specifies 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 the
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 in the Berkeley DB Java Edition distribution.
je.env.isLocking=false
ds-cfg-je-property
org.opends.server.extensions.FileSystemEntryCache