<?xml version="1.0" encoding="utf-8"?>
|
<!--
|
! CDDL HEADER START
|
!
|
! The contents of this file are subject to the terms of the
|
! Common Development and Distribution License, Version 1.0 only
|
! (the "License"). You may not use this file except in compliance
|
! with the License.
|
!
|
! You can obtain a copy of the license at
|
! trunk/opends/resource/legal-notices/OpenDS.LICENSE
|
! or https://OpenDS.dev.java.net/OpenDS.LICENSE.
|
! See the License for the specific language governing permissions
|
! and limitations under the License.
|
!
|
! When distributing Covered Code, include this CDDL HEADER in each
|
! file and include the License file at
|
! trunk/opends/resource/legal-notices/OpenDS.LICENSE. If applicable,
|
! add the following below this CDDL HEADER, with the fields enclosed
|
! by brackets "[]" replaced with your own identifying information:
|
! Portions Copyright [yyyy] [name of copyright owner]
|
!
|
! CDDL HEADER END
|
!
|
!
|
! Portions Copyright 2007-2008 Sun Microsystems, Inc.
|
! -->
|
<adm:managed-object name="file-system-entry-cache"
|
plural-name="file-system-entry-caches"
|
package="org.opends.server.admin.std" extends="entry-cache"
|
xmlns:adm="http://www.opends.org/admin"
|
xmlns:ldap="http://www.opends.org/admin-ldap">
|
<adm:synopsis>
|
The
|
<adm:user-friendly-name />
|
is an entry cache implementation which uses a JE database to keep
|
track of the entries.
|
</adm:synopsis>
|
<adm:description>
|
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.
|
</adm:description>
|
<adm:profile name="ldap">
|
<ldap:object-class>
|
<ldap:name>ds-cfg-file-system-entry-cache</ldap:name>
|
<ldap:superior>ds-cfg-entry-cache</ldap:superior>
|
</ldap:object-class>
|
</adm:profile>
|
<adm:property name="lock-timeout" advanced="true">
|
<adm:synopsis>
|
The length of time to wait while attempting to acquire a read or
|
write lock.
|
</adm:synopsis>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>2000.0ms</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:duration base-unit="ms" allow-unlimited="true" />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-lock-timeout</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="max-memory-size">
|
<adm:synopsis>
|
The maximum size of the entry cache in bytes.
|
</adm:synopsis>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>0b</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:size />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-max-memory-size</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="max-entries">
|
<adm:synopsis>
|
The maximum number of entries allowed in the cache.
|
</adm:synopsis>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>2147483647</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:integer lower-limit="0" />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-max-entries</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="cache-type">
|
<adm:synopsis>
|
Specifies the policy which should be used for purging entries from
|
the cache.
|
</adm:synopsis>
|
<adm:requires-admin-action>
|
<adm:component-restart />
|
</adm:requires-admin-action>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>fifo</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:enumeration>
|
<adm:value name="fifo">
|
<adm:synopsis>FIFO based entry cache.</adm:synopsis>
|
</adm:value>
|
<adm:value name="lru">
|
<adm:synopsis>LRU based entry cache.</adm:synopsis>
|
</adm:value>
|
</adm:enumeration>
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-cache-type</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="cache-directory">
|
<adm:synopsis>
|
Specifies the directory in which the JE environment should store
|
the cache.
|
</adm:synopsis>
|
<adm:requires-admin-action>
|
<adm:component-restart />
|
</adm:requires-admin-action>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>/tmp/OpenDS.FSCache</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:string />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-cache-directory</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="persistent-cache">
|
<adm:synopsis>
|
Specifies whether the cache should persist across restarts.
|
</adm:synopsis>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>false</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:boolean />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-persistent-cache</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="compact-encoding">
|
<adm:synopsis>
|
Indicates whether the cache should use a compact form when
|
encoding cache entries by compressing the attribute descriptions
|
and object class sets.
|
</adm:synopsis>
|
<adm:description>
|
Note that compression does not preserve user-supplied
|
capitalization in the object class and attribute type names.
|
</adm:description>
|
<adm:requires-admin-action>
|
<adm:none>
|
<adm:synopsis>
|
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.
|
</adm:synopsis>
|
</adm:none>
|
</adm:requires-admin-action>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>true</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:boolean />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-compact-encoding</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="db-cache-percent">
|
<adm:synopsis>
|
Specifies the maximum memory usage for the internal JE cache as a percentage
|
of the total JVM memory.
|
</adm:synopsis>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>0</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:integer lower-limit="0" upper-limit="90" />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-db-cache-percent</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="db-cache-size">
|
<adm:synopsis>
|
Specifies the maximum JVM memory usage in bytes for the internal JE cache.
|
</adm:synopsis>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>0b</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:size />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-db-cache-size</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property name="je-property" multi-valued="true"
|
advanced="true">
|
<adm:synopsis>
|
Specifies the environment properties for the Berkeley DB Java
|
Edition database providing the backend for this entry cache.
|
</adm:synopsis>
|
<adm:description>
|
Any Berkeley DB Java Edition property can be specified using the
|
following form: property-name=property-value. Refer to the 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 in the Berkeley DB Java Edition distribution.
|
</adm:description>
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>je.log.fileMax=10485760</adm:value>
|
<adm:value>je.cleaner.minUtilization=90</adm:value>
|
<adm:value>je.cleaner.maxBatchFiles=1</adm:value>
|
<adm:value>je.cleaner.minAge=1</adm:value>
|
<adm:value>je.cleaner.minFileUtilization=50</adm:value>
|
<adm:value>je.checkpointer.bytesInterval=10485760</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
<adm:syntax>
|
<adm:string />
|
</adm:syntax>
|
<adm:profile name="ldap">
|
<ldap:attribute>
|
<ldap:name>ds-cfg-je-property</ldap:name>
|
</ldap:attribute>
|
</adm:profile>
|
</adm:property>
|
<adm:property-reference name="include-filter" />
|
<adm:property-reference name="exclude-filter" />
|
<adm:property-override name="java-class" advanced="true">
|
<adm:default-behavior>
|
<adm:defined>
|
<adm:value>
|
org.opends.server.extensions.FileSystemEntryCache
|
</adm:value>
|
</adm:defined>
|
</adm:default-behavior>
|
</adm:property-override>
|
</adm:managed-object>
|
