public interface LocalDBBackendCfgClient extends BackendCfgClient
The Local DB Backend uses the Berkeley DB Java Edition to store user-provided data in a local repository.
Modifier and Type | Method and Description |
---|---|
<C extends LocalDBIndexCfgClient> |
createLocalDBIndex(ManagedObjectDefinition<C,? extends LocalDBIndexCfg> d,
String name,
Collection<PropertyException> exceptions)
Creates a new Local DB Index.
|
<C extends LocalDBVLVIndexCfgClient> |
createLocalDBVLVIndex(ManagedObjectDefinition<C,? extends LocalDBVLVIndexCfg> d,
String name,
Collection<PropertyException> exceptions)
Creates a new Local DB VLV Index.
|
ManagedObjectDefinition<? extends LocalDBBackendCfgClient,? extends LocalDBBackendCfg> |
definition()
Get the configuration definition associated with this Local DB Backend.
|
int |
getDBCachePercent()
Gets the "db-cache-percent" property.
|
long |
getDBCacheSize()
Gets the "db-cache-size" property.
|
long |
getDBCheckpointerBytesInterval()
Gets the "db-checkpointer-bytes-interval" property.
|
long |
getDBCheckpointerWakeupInterval()
Gets the "db-checkpointer-wakeup-interval" property.
|
int |
getDBCleanerMinUtilization()
Gets the "db-cleaner-min-utilization" property.
|
String |
getDBDirectory()
Gets the "db-directory" property.
|
String |
getDBDirectoryPermissions()
Gets the "db-directory-permissions" property.
|
int |
getDBEvictorCoreThreads()
Gets the "db-evictor-core-threads" property.
|
long |
getDBEvictorKeepAlive()
Gets the "db-evictor-keep-alive" property.
|
int |
getDBEvictorMaxThreads()
Gets the "db-evictor-max-threads" property.
|
int |
getDBEvictorNodesPerScan()
Gets the "db-evictor-nodes-per-scan" property.
|
int |
getDBLogFilecacheSize()
Gets the "db-log-filecache-size" property.
|
long |
getDBLogFileMax()
Gets the "db-log-file-max" property.
|
String |
getDBLoggingLevel()
Gets the "db-logging-level" property.
|
Integer |
getDBNumCleanerThreads()
Gets the "db-num-cleaner-threads" property.
|
Integer |
getDBNumLockTables()
Gets the "db-num-lock-tables" property.
|
long |
getDiskFullThreshold()
Gets the "disk-full-threshold" property.
|
long |
getDiskLowThreshold()
Gets the "disk-low-threshold" property.
|
int |
getImportQueueSize()
Gets the "import-queue-size" property.
|
int |
getImportThreadCount()
Gets the "import-thread-count" property.
|
int |
getIndexEntryLimit()
Gets the "index-entry-limit" property.
|
int |
getIndexFilterAnalyzerMaxFilters()
Gets the "index-filter-analyzer-max-filters" property.
|
String |
getJavaClass()
Gets the "java-class" property.
|
SortedSet<String> |
getJEProperty()
Gets the "je-property" property.
|
LocalDBIndexCfgClient |
getLocalDBIndex(String name)
Gets the named Local DB Index.
|
LocalDBVLVIndexCfgClient |
getLocalDBVLVIndex(String name)
Gets the named Local DB VLV Index.
|
long |
getPreloadTimeLimit()
Gets the "preload-time-limit" property.
|
BackendCfgDefn.WritabilityMode |
getWritabilityMode()
Gets the "writability-mode" property.
|
boolean |
isCompactEncoding()
Gets the "compact-encoding" property.
|
boolean |
isDBEvictorLruOnly()
Gets the "db-evictor-lru-only" property.
|
boolean |
isDBLoggingFileHandlerOn()
Gets the "db-logging-file-handler-on" property.
|
boolean |
isDBRunCleaner()
Gets the "db-run-cleaner" property.
|
boolean |
isDBTxnNoSync()
Gets the "db-txn-no-sync" property.
|
boolean |
isDBTxnWriteNoSync()
Gets the "db-txn-write-no-sync" property.
|
boolean |
isEntriesCompressed()
Gets the "entries-compressed" property.
|
boolean |
isIndexFilterAnalyzerEnabled()
Gets the "index-filter-analyzer-enabled" property.
|
boolean |
isSubordinateIndexesEnabled()
Gets the "subordinate-indexes-enabled" property.
|
String[] |
listLocalDBIndexes()
Lists the Local DB Indexes.
|
String[] |
listLocalDBVLVIndexes()
Lists the Local DB VLV Indexes.
|
void |
removeLocalDBIndex(String name)
Removes the named Local DB Index.
|
void |
removeLocalDBVLVIndex(String name)
Removes the named Local DB VLV Index.
|
void |
setCompactEncoding(Boolean value)
Sets the "compact-encoding" property.
|
void |
setDBCachePercent(Integer value)
Sets the "db-cache-percent" property.
|
void |
setDBCacheSize(Long value)
Sets the "db-cache-size" property.
|
void |
setDBCheckpointerBytesInterval(Long value)
Sets the "db-checkpointer-bytes-interval" property.
|
void |
setDBCheckpointerWakeupInterval(Long value)
Sets the "db-checkpointer-wakeup-interval" property.
|
void |
setDBCleanerMinUtilization(Integer value)
Sets the "db-cleaner-min-utilization" property.
|
void |
setDBDirectory(String value)
Sets the "db-directory" property.
|
void |
setDBDirectoryPermissions(String value)
Sets the "db-directory-permissions" property.
|
void |
setDBEvictorCoreThreads(Integer value)
Sets the "db-evictor-core-threads" property.
|
void |
setDBEvictorKeepAlive(Long value)
Sets the "db-evictor-keep-alive" property.
|
void |
setDBEvictorLruOnly(Boolean value)
Sets the "db-evictor-lru-only" property.
|
void |
setDBEvictorMaxThreads(Integer value)
Sets the "db-evictor-max-threads" property.
|
void |
setDBEvictorNodesPerScan(Integer value)
Sets the "db-evictor-nodes-per-scan" property.
|
void |
setDBLogFilecacheSize(Integer value)
Sets the "db-log-filecache-size" property.
|
void |
setDBLogFileMax(Long value)
Sets the "db-log-file-max" property.
|
void |
setDBLoggingFileHandlerOn(Boolean value)
Sets the "db-logging-file-handler-on" property.
|
void |
setDBLoggingLevel(String value)
Sets the "db-logging-level" property.
|
void |
setDBNumCleanerThreads(Integer value)
Sets the "db-num-cleaner-threads" property.
|
void |
setDBNumLockTables(Integer value)
Sets the "db-num-lock-tables" property.
|
void |
setDBRunCleaner(Boolean value)
Sets the "db-run-cleaner" property.
|
void |
setDBTxnNoSync(Boolean value)
Sets the "db-txn-no-sync" property.
|
void |
setDBTxnWriteNoSync(Boolean value)
Sets the "db-txn-write-no-sync" property.
|
void |
setDiskFullThreshold(Long value)
Sets the "disk-full-threshold" property.
|
void |
setDiskLowThreshold(Long value)
Sets the "disk-low-threshold" property.
|
void |
setEntriesCompressed(Boolean value)
Sets the "entries-compressed" property.
|
void |
setImportQueueSize(Integer value)
Sets the "import-queue-size" property.
|
void |
setImportThreadCount(Integer value)
Sets the "import-thread-count" property.
|
void |
setIndexEntryLimit(Integer value)
Sets the "index-entry-limit" property.
|
void |
setIndexFilterAnalyzerEnabled(Boolean value)
Sets the "index-filter-analyzer-enabled" property.
|
void |
setIndexFilterAnalyzerMaxFilters(Integer value)
Sets the "index-filter-analyzer-max-filters" property.
|
void |
setJavaClass(String value)
Sets the "java-class" property.
|
void |
setJEProperty(Collection<String> values)
Sets the "je-property" property.
|
void |
setPreloadTimeLimit(Long value)
Sets the "preload-time-limit" property.
|
void |
setSubordinateIndexesEnabled(Boolean value)
Sets the "subordinate-indexes-enabled" property.
|
void |
setWritabilityMode(BackendCfgDefn.WritabilityMode value)
Sets the "writability-mode" property.
|
getBackendId, getBaseDN, isEnabled, setBackendId, setBaseDN, setEnabled
commit, properties
ManagedObjectDefinition<? extends LocalDBBackendCfgClient,? extends LocalDBBackendCfg> definition()
definition
in interface BackendCfgClient
definition
in interface ConfigurationClient
boolean isCompactEncoding()
Indicates whether the backend should use a compact form when encoding entries by compressing the attribute descriptions and object class sets.
Note that this property applies only to the entries themselves and does not impact the index data.
void setCompactEncoding(Boolean value) throws PropertyException
Indicates whether the backend should use a compact form when encoding entries by compressing the attribute descriptions and object class sets.
Note that this property applies only to the entries themselves and does not impact the index data.
value
- The value of the "compact-encoding" property.PropertyException
- If the new value is invalid.int getDBCachePercent()
Specifies the percentage of JVM memory to allocate to the database cache.
Specifies the percentage of memory available to the JVM that should be used for caching database contents. Note that this is only used if the value of the db-cache-size property is set to "0 MB". Otherwise, the value of that property is used instead to control the cache size configuration.
void setDBCachePercent(Integer value) throws PropertyException
Specifies the percentage of JVM memory to allocate to the database cache.
Specifies the percentage of memory available to the JVM that should be used for caching database contents. Note that this is only used if the value of the db-cache-size property is set to "0 MB". Otherwise, the value of that property is used instead to control the cache size configuration.
value
- The value of the "db-cache-percent" property.PropertyException
- If the new value is invalid.long getDBCacheSize()
The amount of JVM memory to allocate to the database cache.
Specifies the amount of memory that should be used for caching database contents. A value of "0 MB" indicates that the db-cache-percent property should be used instead to specify the cache size.
void setDBCacheSize(Long value) throws PropertyException
The amount of JVM memory to allocate to the database cache.
Specifies the amount of memory that should be used for caching database contents. A value of "0 MB" indicates that the db-cache-percent property should be used instead to specify the cache size.
value
- The value of the "db-cache-size" property.PropertyException
- If the new value is invalid.long getDBCheckpointerBytesInterval()
Specifies the maximum number of bytes that may be written to the database before it is forced to perform a checkpoint.
This can be used to bound the recovery time that may be required if the database environment is opened without having been properly closed. If this property is set to a non-zero value, the checkpointer wakeup interval is not used. To use time-based checkpointing, set this property to zero.
void setDBCheckpointerBytesInterval(Long value) throws PropertyException
Specifies the maximum number of bytes that may be written to the database before it is forced to perform a checkpoint.
This can be used to bound the recovery time that may be required if the database environment is opened without having been properly closed. If this property is set to a non-zero value, the checkpointer wakeup interval is not used. To use time-based checkpointing, set this property to zero.
value
- The value of the "db-checkpointer-bytes-interval" property.PropertyException
- If the new value is invalid.long getDBCheckpointerWakeupInterval()
Specifies the maximum length of time that may pass between checkpoints.
Note that this is only used if the value of the checkpointer bytes interval is zero.
void setDBCheckpointerWakeupInterval(Long value) throws PropertyException
Specifies the maximum length of time that may pass between checkpoints.
Note that this is only used if the value of the checkpointer bytes interval is zero.
value
- The value of the "db-checkpointer-wakeup-interval" property.PropertyException
- If the new value is invalid.int getDBCleanerMinUtilization()
Specifies the minimum percentage of "live" data that the database cleaner attempts to keep in database log files.
If the amount of live data in any database log file drops below this percentage, then the cleaner moves the remaining live data in that file to the end of the database and deletes the original file in order to keep the database relatively compact.
void setDBCleanerMinUtilization(Integer value) throws PropertyException
Specifies the minimum percentage of "live" data that the database cleaner attempts to keep in database log files.
If the amount of live data in any database log file drops below this percentage, then the cleaner moves the remaining live data in that file to the end of the database and deletes the original file in order to keep the database relatively compact.
value
- The value of the "db-cleaner-min-utilization" property.PropertyException
- If the new value is invalid.String getDBDirectory()
Specifies the path to the filesystem directory that is used to hold the Berkeley DB Java Edition database files containing the data for this backend.
The path may be either an absolute path or a path relative to the directory containing the base of the OpenDJ directory server installation. The path may be any valid directory path in which the server has appropriate permissions to read and write files and has sufficient space to hold the database contents.
void setDBDirectory(String value) throws PropertyException
Specifies the path to the filesystem directory that is used to hold the Berkeley DB Java Edition database files containing the data for this backend.
The path may be either an absolute path or a path relative to the directory containing the base of the OpenDJ directory server installation. The path may be any valid directory path in which the server has appropriate permissions to read and write files and has sufficient space to hold the database contents.
value
- The value of the "db-directory" property.PropertyException
- If the new value is invalid.String getDBDirectoryPermissions()
Specifies the permissions that should be applied to the directory containing the server database files.
They should be expressed as three-digit octal values, which is the traditional representation for UNIX file permissions. The three digits represent the permissions that are available for the directory's owner, group members, and other users (in that order), and each digit is the octal representation of the read, write, and execute bits. Note that this only impacts permissions on the database directory and not on the files written into that directory. On UNIX systems, the user's umask controls permissions given to the database files.
void setDBDirectoryPermissions(String value) throws PropertyException
Specifies the permissions that should be applied to the directory containing the server database files.
They should be expressed as three-digit octal values, which is the traditional representation for UNIX file permissions. The three digits represent the permissions that are available for the directory's owner, group members, and other users (in that order), and each digit is the octal representation of the read, write, and execute bits. Note that this only impacts permissions on the database directory and not on the files written into that directory. On UNIX systems, the user's umask controls permissions given to the database files.
value
- The value of the "db-directory-permissions" property.PropertyException
- If the new value is invalid.int getDBEvictorCoreThreads()
Specifies the core number of threads in the eviction thread pool.
Specifies the core number of threads in the eviction thread pool. These threads help keep memory usage within cache bounds, offloading work from application threads. db-evictor-core-threads, db-evictor-max-threads and db-evictor-keep-alive are used to configure the core, max and keepalive attributes for the eviction thread pool.
void setDBEvictorCoreThreads(Integer value) throws PropertyException
Specifies the core number of threads in the eviction thread pool.
Specifies the core number of threads in the eviction thread pool. These threads help keep memory usage within cache bounds, offloading work from application threads. db-evictor-core-threads, db-evictor-max-threads and db-evictor-keep-alive are used to configure the core, max and keepalive attributes for the eviction thread pool.
value
- The value of the "db-evictor-core-threads" property.PropertyException
- If the new value is invalid.long getDBEvictorKeepAlive()
The duration that excess threads in the eviction thread pool will stay idle. After this period, idle threads will terminate.
The duration that excess threads in the eviction thread pool will stay idle. After this period, idle threads will terminate. db-evictor-core-threads, db-evictor-max-threads and db-evictor-keep-alive are used to configure the core, max and keepalive attributes for the eviction thread pool.
void setDBEvictorKeepAlive(Long value) throws PropertyException
The duration that excess threads in the eviction thread pool will stay idle. After this period, idle threads will terminate.
The duration that excess threads in the eviction thread pool will stay idle. After this period, idle threads will terminate. db-evictor-core-threads, db-evictor-max-threads and db-evictor-keep-alive are used to configure the core, max and keepalive attributes for the eviction thread pool.
value
- The value of the "db-evictor-keep-alive" property.PropertyException
- If the new value is invalid.boolean isDBEvictorLruOnly()
Indicates whether the database should evict existing data from the cache based on an LRU policy (where the least recently used information will be evicted first).
If set to "false", then the eviction keeps internal nodes of the underlying Btree in the cache over leaf nodes, even if the leaf nodes have been accessed more recently. This may be a better configuration for databases in which only a very small portion of the data is cached.
void setDBEvictorLruOnly(Boolean value) throws PropertyException
Indicates whether the database should evict existing data from the cache based on an LRU policy (where the least recently used information will be evicted first).
If set to "false", then the eviction keeps internal nodes of the underlying Btree in the cache over leaf nodes, even if the leaf nodes have been accessed more recently. This may be a better configuration for databases in which only a very small portion of the data is cached.
value
- The value of the "db-evictor-lru-only" property.PropertyException
- If the new value is invalid.int getDBEvictorMaxThreads()
Specifies the maximum number of threads in the eviction thread pool.
Specifies the maximum number of threads in the eviction thread pool. These threads help keep memory usage within cache bounds, offloading work from application threads. db-evictor-core-threads, db-evictor-max-threads and db-evictor-keep-alive are used to configure the core, max and keepalive attributes for the eviction thread pool.
void setDBEvictorMaxThreads(Integer value) throws PropertyException
Specifies the maximum number of threads in the eviction thread pool.
Specifies the maximum number of threads in the eviction thread pool. These threads help keep memory usage within cache bounds, offloading work from application threads. db-evictor-core-threads, db-evictor-max-threads and db-evictor-keep-alive are used to configure the core, max and keepalive attributes for the eviction thread pool.
value
- The value of the "db-evictor-max-threads" property.PropertyException
- If the new value is invalid.int getDBEvictorNodesPerScan()
Specifies the number of Btree nodes that should be evicted from the cache in a single pass if it is determined that it is necessary to free existing data in order to make room for new information.
Changes to this property do not take effect until the backend is restarted. It is recommended that you also change this property when you set db-evictor-lru-only to false. This setting controls the number of Btree nodes that are considered, or sampled, each time a node is evicted. A setting of 10 often produces good results, but this may vary from application to application. The larger the nodes per scan, the more accurate the algorithm. However, don't set it too high. When considering larger numbers of nodes for each eviction, the evictor may delay the completion of a given database operation, which impacts the response time of the application thread. In JE 4.1 and later, setting this value too high in an application that is largely CPU bound can reduce the effectiveness of cache eviction. It's best to start with the default value, and increase it gradually to see if it is beneficial for your application.
void setDBEvictorNodesPerScan(Integer value) throws PropertyException
Specifies the number of Btree nodes that should be evicted from the cache in a single pass if it is determined that it is necessary to free existing data in order to make room for new information.
Changes to this property do not take effect until the backend is restarted. It is recommended that you also change this property when you set db-evictor-lru-only to false. This setting controls the number of Btree nodes that are considered, or sampled, each time a node is evicted. A setting of 10 often produces good results, but this may vary from application to application. The larger the nodes per scan, the more accurate the algorithm. However, don't set it too high. When considering larger numbers of nodes for each eviction, the evictor may delay the completion of a given database operation, which impacts the response time of the application thread. In JE 4.1 and later, setting this value too high in an application that is largely CPU bound can reduce the effectiveness of cache eviction. It's best to start with the default value, and increase it gradually to see if it is beneficial for your application.
value
- The value of the "db-evictor-nodes-per-scan" property.PropertyException
- If the new value is invalid.int getDBLogFilecacheSize()
Specifies the size of the file handle cache.
The file handle cache is used to keep as much opened log files as possible. When the cache is smaller than the number of logs, the database needs to close some handles and open log files it needs, resulting in less optimal performances. Ideally, the size of the cache should be higher than the number of files contained in the database. Make sure the OS number of open files per process is also tuned appropriately.
void setDBLogFilecacheSize(Integer value) throws PropertyException
Specifies the size of the file handle cache.
The file handle cache is used to keep as much opened log files as possible. When the cache is smaller than the number of logs, the database needs to close some handles and open log files it needs, resulting in less optimal performances. Ideally, the size of the cache should be higher than the number of files contained in the database. Make sure the OS number of open files per process is also tuned appropriately.
value
- The value of the "db-log-filecache-size" property.PropertyException
- If the new value is invalid.long getDBLogFileMax()
Specifies the maximum size for a database log file.
void setDBLogFileMax(Long value) throws PropertyException
Specifies the maximum size for a database log file.
value
- The value of the "db-log-file-max" property.PropertyException
- If the new value is invalid.boolean isDBLoggingFileHandlerOn()
Indicates whether the database should maintain a je.info file in the same directory as the database log directory.
This file contains information about the internal processing performed by the underlying database.
void setDBLoggingFileHandlerOn(Boolean value) throws PropertyException
Indicates whether the database should maintain a je.info file in the same directory as the database log directory.
This file contains information about the internal processing performed by the underlying database.
value
- The value of the "db-logging-file-handler-on" property.PropertyException
- If the new value is invalid.String getDBLoggingLevel()
Specifies the log level that should be used by the database when it is writing information into the je.info file.
The database trace logging level is (in increasing order of verbosity) chosen from: OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL.
void setDBLoggingLevel(String value) throws PropertyException
Specifies the log level that should be used by the database when it is writing information into the je.info file.
The database trace logging level is (in increasing order of verbosity) chosen from: OFF, SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL.
value
- The value of the "db-logging-level" property.PropertyException
- If the new value is invalid.Integer getDBNumCleanerThreads()
Specifies the number of threads that the backend should maintain to keep the database log files at or near the desired utilization.
In environments with high write throughput, multiple cleaner threads may be required to maintain the desired utilization.
void setDBNumCleanerThreads(Integer value) throws PropertyException
Specifies the number of threads that the backend should maintain to keep the database log files at or near the desired utilization.
In environments with high write throughput, multiple cleaner threads may be required to maintain the desired utilization.
value
- The value of the "db-num-cleaner-threads" property.PropertyException
- If the new value is invalid.Integer getDBNumLockTables()
Specifies the number of lock tables that are used by the underlying database.
This can be particularly important to help improve scalability by avoiding contention on systems with large numbers of CPUs. The value of this configuration property should be set to a prime number that is less than or equal to the number of worker threads configured for use in the server.
void setDBNumLockTables(Integer value) throws PropertyException
Specifies the number of lock tables that are used by the underlying database.
This can be particularly important to help improve scalability by avoiding contention on systems with large numbers of CPUs. The value of this configuration property should be set to a prime number that is less than or equal to the number of worker threads configured for use in the server.
value
- The value of the "db-num-lock-tables" property.PropertyException
- If the new value is invalid.boolean isDBRunCleaner()
Indicates whether the database cleaner threads should be enabled.
The cleaner threads are used to periodically compact the database by identifying database files with a low (that is, less than the amount specified by the db-cleaner-min-utilization property) percentage of live data, moving the remaining live data to the end of the log and deleting that file.
void setDBRunCleaner(Boolean value) throws PropertyException
Indicates whether the database cleaner threads should be enabled.
The cleaner threads are used to periodically compact the database by identifying database files with a low (that is, less than the amount specified by the db-cleaner-min-utilization property) percentage of live data, moving the remaining live data to the end of the log and deleting that file.
value
- The value of the "db-run-cleaner" property.PropertyException
- If the new value is invalid.boolean isDBTxnNoSync()
Indicates whether database writes should be primarily written to an internal buffer but not immediately written to disk.
Setting the value of this configuration attribute to "true" may improve write performance but could cause the most recent changes to be lost if the OpenDJ directory server or the underlying JVM exits abnormally, or if an OS or hardware failure occurs (a behavior similar to running with transaction durability disabled in the Sun Java System Directory Server).
void setDBTxnNoSync(Boolean value) throws PropertyException
Indicates whether database writes should be primarily written to an internal buffer but not immediately written to disk.
Setting the value of this configuration attribute to "true" may improve write performance but could cause the most recent changes to be lost if the OpenDJ directory server or the underlying JVM exits abnormally, or if an OS or hardware failure occurs (a behavior similar to running with transaction durability disabled in the Sun Java System Directory Server).
value
- The value of the "db-txn-no-sync" property.PropertyException
- If the new value is invalid.boolean isDBTxnWriteNoSync()
Indicates whether the database should synchronously flush data as it is written to disk.
If this value is set to "false", then all data written to disk is synchronously flushed to persistent storage and thereby providing full durability. If it is set to "true", then data may be cached for a period of time by the underlying operating system before actually being written to disk. This may improve performance, but could cause the most recent changes to be lost in the event of an underlying OS or hardware failure (but not in the case that the OpenDJ directory server or the JVM exits abnormally).
void setDBTxnWriteNoSync(Boolean value) throws PropertyException
Indicates whether the database should synchronously flush data as it is written to disk.
If this value is set to "false", then all data written to disk is synchronously flushed to persistent storage and thereby providing full durability. If it is set to "true", then data may be cached for a period of time by the underlying operating system before actually being written to disk. This may improve performance, but could cause the most recent changes to be lost in the event of an underlying OS or hardware failure (but not in the case that the OpenDJ directory server or the JVM exits abnormally).
value
- The value of the "db-txn-write-no-sync" property.PropertyException
- If the new value is invalid.long getDiskFullThreshold()
Full disk threshold to limit database updates
When the available free space on the disk used by this database instance falls below the value specified, no updates are permitted and the server returns an UNWILLING_TO_PERFORM error. Updates are allowed again as soon as free space rises above the threshold.
void setDiskFullThreshold(Long value) throws PropertyException
Full disk threshold to limit database updates
When the available free space on the disk used by this database instance falls below the value specified, no updates are permitted and the server returns an UNWILLING_TO_PERFORM error. Updates are allowed again as soon as free space rises above the threshold.
value
- The value of the "disk-full-threshold" property.PropertyException
- If the new value is invalid.long getDiskLowThreshold()
Low disk threshold to limit database updates
Specifies the "low" free space on the disk. When the available free space on the disk used by this database instance falls below the value specified, protocol updates on this database are permitted only by a user with the BYPASS_LOCKDOWN privilege.
void setDiskLowThreshold(Long value) throws PropertyException
Low disk threshold to limit database updates
Specifies the "low" free space on the disk. When the available free space on the disk used by this database instance falls below the value specified, protocol updates on this database are permitted only by a user with the BYPASS_LOCKDOWN privilege.
value
- The value of the "disk-low-threshold" property.PropertyException
- If the new value is invalid.boolean isEntriesCompressed()
Indicates whether the backend should attempt to compress entries before storing them in the database.
Note that this property applies only to the entries themselves and does not impact the index data. Further, the effectiveness of the compression is based on the type of data contained in the entry.
void setEntriesCompressed(Boolean value) throws PropertyException
Indicates whether the backend should attempt to compress entries before storing them in the database.
Note that this property applies only to the entries themselves and does not impact the index data. Further, the effectiveness of the compression is based on the type of data contained in the entry.
value
- The value of the "entries-compressed" property.PropertyException
- If the new value is invalid.int getImportQueueSize()
This parameter has been deprecated in OpenDS 2.1 and will be removed in OpenDJ 3.0. It is only being kept for migration ease and is ignored in OpenDS versions after 2.0.
void setImportQueueSize(Integer value) throws PropertyException
This parameter has been deprecated in OpenDS 2.1 and will be removed in OpenDJ 3.0. It is only being kept for migration ease and is ignored in OpenDS versions after 2.0.
value
- The value of the "import-queue-size" property.PropertyException
- If the new value is invalid.int getImportThreadCount()
This parameter has been deprecated in OpenDS 2.1 and will be removed in OpenDJ 3.0. It is only being kept for migration ease and is ignored in OpenDS versions after 2.0.
This parameter has been deprecated in OpenDS 2.1 and will be removed in OpenDJ 3.0. It is only being kept for migration ease and is ignored in OpenDS versions after 2.0.
void setImportThreadCount(Integer value) throws PropertyException
This parameter has been deprecated in OpenDS 2.1 and will be removed in OpenDJ 3.0. It is only being kept for migration ease and is ignored in OpenDS versions after 2.0.
This parameter has been deprecated in OpenDS 2.1 and will be removed in OpenDJ 3.0. It is only being kept for migration ease and is ignored in OpenDS versions after 2.0.
value
- The value of the "import-thread-count" property.PropertyException
- If the new value is invalid.int getIndexEntryLimit()
Specifies the maximum number of entries that is allowed to match a given index key before that particular index key is no longer maintained.
This property is analogous to the ALL IDs threshold in the Sun Java System Directory Server. Note that this is the default limit for the backend, and it may be overridden on a per-attribute basis.A value of 0 means there is no limit.
void setIndexEntryLimit(Integer value) throws PropertyException
Specifies the maximum number of entries that is allowed to match a given index key before that particular index key is no longer maintained.
This property is analogous to the ALL IDs threshold in the Sun Java System Directory Server. Note that this is the default limit for the backend, and it may be overridden on a per-attribute basis.A value of 0 means there is no limit.
value
- The value of the "index-entry-limit" property.PropertyException
- If the new value is invalid.boolean isIndexFilterAnalyzerEnabled()
Indicates whether to gather statistical information about the search filters processed by the directory server while evaluating the usage of indexes.
Analyzing indexes requires gathering search filter usage patterns from user requests, especially for values as specified in the filters and subsequently looking the status of those values into the index files. When a search requests is processed, internal or user generated, a first phase uses indexes to find potential entries to be returned. Depending on the search filter, if the index of one of the specified attributes matches too many entries (exceeds the index entry limit), the search becomes non-indexed. In any case, all entries thus gathered (or the entire DIT) are matched against the filter for actually returning the search result.
void setIndexFilterAnalyzerEnabled(Boolean value) throws PropertyException
Indicates whether to gather statistical information about the search filters processed by the directory server while evaluating the usage of indexes.
Analyzing indexes requires gathering search filter usage patterns from user requests, especially for values as specified in the filters and subsequently looking the status of those values into the index files. When a search requests is processed, internal or user generated, a first phase uses indexes to find potential entries to be returned. Depending on the search filter, if the index of one of the specified attributes matches too many entries (exceeds the index entry limit), the search becomes non-indexed. In any case, all entries thus gathered (or the entire DIT) are matched against the filter for actually returning the search result.
value
- The value of the "index-filter-analyzer-enabled" property.PropertyException
- If the new value is invalid.int getIndexFilterAnalyzerMaxFilters()
The maximum number of search filter statistics to keep.
When the maximum number of search filter is reached, the least used one will be deleted.
void setIndexFilterAnalyzerMaxFilters(Integer value) throws PropertyException
The maximum number of search filter statistics to keep.
When the maximum number of search filter is reached, the least used one will be deleted.
value
- The value of the "index-filter-analyzer-max-filters" property.PropertyException
- If the new value is invalid.String getJavaClass()
Specifies the fully-qualified name of the Java class that provides the backend implementation.
getJavaClass
in interface BackendCfgClient
void setJavaClass(String value) throws PropertyException
Specifies the fully-qualified name of the Java class that provides the backend implementation.
setJavaClass
in interface BackendCfgClient
value
- The value of the "java-class" property.PropertyException
- If the new value is invalid.SortedSet<String> getJEProperty()
Specifies the database and environment properties for the Berkeley DB Java Edition database serving the data for this backend.
Any Berkeley DB Java Edition property can be specified using the following form: property-name=property-value. Refer to OpenDJ documentation for further information on related properties, their implications, and range values. The definitive identification of all the property parameters is available in the example.properties file of Berkeley DB Java Edition distribution.
void setJEProperty(Collection<String> values) throws PropertyException
Specifies the database and environment properties for the Berkeley DB Java Edition database serving the data for this backend.
Any Berkeley DB Java Edition property can be specified using the following form: property-name=property-value. Refer to OpenDJ documentation for further information on related properties, their implications, and range values. The definitive identification of all the property parameters is available in the example.properties file of Berkeley DB Java Edition distribution.
values
- The values of the "je-property" property.PropertyException
- If one or more of the new values are invalid.long getPreloadTimeLimit()
Specifies the length of time that the backend is allowed to spend "pre-loading" data when it is initialized.
The pre-load process is used to pre-populate the database cache, so that it can be more quickly available when the server is processing requests. A duration of zero means there is no pre-load.
void setPreloadTimeLimit(Long value) throws PropertyException
Specifies the length of time that the backend is allowed to spend "pre-loading" data when it is initialized.
The pre-load process is used to pre-populate the database cache, so that it can be more quickly available when the server is processing requests. A duration of zero means there is no pre-load.
value
- The value of the "preload-time-limit" property.PropertyException
- If the new value is invalid.boolean isSubordinateIndexesEnabled()
Indicates whether id2children and id2subtree indexes should be used for this backend. These indexes are used for constraining filtered searches to the search request's scope as well as for generating values for the hasSubordinates and numSubordinates virtual attributes.
Subordinate indexing is enabled by default and should only be disabled for specialized use cases. A typical use case is where the backend is to be subjected to heavy add/delete load beneath the same parent entry such as when used as a session database. Disabling the subordinate indexes means that the numSubordinates and hasSubordinates virtual attributes will not be supported.
void setSubordinateIndexesEnabled(Boolean value) throws PropertyException
Indicates whether id2children and id2subtree indexes should be used for this backend. These indexes are used for constraining filtered searches to the search request's scope as well as for generating values for the hasSubordinates and numSubordinates virtual attributes.
Subordinate indexing is enabled by default and should only be disabled for specialized use cases. A typical use case is where the backend is to be subjected to heavy add/delete load beneath the same parent entry such as when used as a session database. Disabling the subordinate indexes means that the numSubordinates and hasSubordinates virtual attributes will not be supported.
value
- The value of the "subordinate-indexes-enabled" property.PropertyException
- If the new value is invalid.BackendCfgDefn.WritabilityMode getWritabilityMode()
Specifies the behavior that the backend should use when processing write operations.
getWritabilityMode
in interface BackendCfgClient
void setWritabilityMode(BackendCfgDefn.WritabilityMode value) throws PropertyException
Specifies the behavior that the backend should use when processing write operations.
setWritabilityMode
in interface BackendCfgClient
value
- The value of the "writability-mode" property.PropertyException
- If the new value is invalid.String[] listLocalDBIndexes() throws ConcurrentModificationException, org.forgerock.opendj.ldap.LdapException
ConcurrentModificationException
- If this Local DB Backend has been removed from the
server by another client.org.forgerock.opendj.ldap.LdapException
- If any other error occurs.LocalDBIndexCfgClient getLocalDBIndex(String name) throws DefinitionDecodingException, ManagedObjectDecodingException, ManagedObjectNotFoundException, ConcurrentModificationException, org.forgerock.opendj.ldap.LdapException
name
- The name of the Local DB Index to retrieve.DefinitionDecodingException
- If the named Local DB Index was found but its type
could not be determined.ManagedObjectDecodingException
- If the named Local DB Index was found but one or more
of its properties could not be decoded.ManagedObjectNotFoundException
- If the named Local DB Index was not found on the
server.ConcurrentModificationException
- If this Local DB Backend has been removed from the
server by another client.org.forgerock.opendj.ldap.LdapException
- If any other error occurs.<C extends LocalDBIndexCfgClient> C createLocalDBIndex(ManagedObjectDefinition<C,? extends LocalDBIndexCfg> d, String name, Collection<PropertyException> exceptions) throws IllegalManagedObjectNameException
ConfigurationClient.commit()
method.C
- The type of the Local DB Index being created.d
- The definition of the Local DB Index to be created.name
- The name of the new Local DB Index.exceptions
- An optional collection in which to place any PropertyException
s that occurred whilst attempting to
determine the default values of the Local DB Index. This
argument can be null.
IllegalManagedObjectNameException
- If the name of the new Local DB Index is invalid.void removeLocalDBIndex(String name) throws ManagedObjectNotFoundException, OperationRejectedException, ConcurrentModificationException, org.forgerock.opendj.ldap.LdapException
name
- The name of the Local DB Index to remove.ManagedObjectNotFoundException
- If the Local DB Index does not exist.OperationRejectedException
- If the server refuses to remove the Local DB Index due
to some server-side constraint which cannot be satisfied
(for example, if it is referenced by another managed
object).ConcurrentModificationException
- If this Local DB Backend has been removed from the
server by another client.org.forgerock.opendj.ldap.LdapException
- If any other error occurs.String[] listLocalDBVLVIndexes() throws ConcurrentModificationException, org.forgerock.opendj.ldap.LdapException
ConcurrentModificationException
- If this Local DB Backend has been removed from the
server by another client.org.forgerock.opendj.ldap.LdapException
- If any other error occurs.LocalDBVLVIndexCfgClient getLocalDBVLVIndex(String name) throws DefinitionDecodingException, ManagedObjectDecodingException, ManagedObjectNotFoundException, ConcurrentModificationException, org.forgerock.opendj.ldap.LdapException
name
- The name of the Local DB VLV Index to retrieve.DefinitionDecodingException
- If the named Local DB VLV Index was found but its type
could not be determined.ManagedObjectDecodingException
- If the named Local DB VLV Index was found but one or
more of its properties could not be decoded.ManagedObjectNotFoundException
- If the named Local DB VLV Index was not found on the
server.ConcurrentModificationException
- If this Local DB Backend has been removed from the
server by another client.org.forgerock.opendj.ldap.LdapException
- If any other error occurs.<C extends LocalDBVLVIndexCfgClient> C createLocalDBVLVIndex(ManagedObjectDefinition<C,? extends LocalDBVLVIndexCfg> d, String name, Collection<PropertyException> exceptions) throws IllegalManagedObjectNameException
ConfigurationClient.commit()
method.C
- The type of the Local DB VLV Index being created.d
- The definition of the Local DB VLV Index to be created.name
- The name of the new Local DB VLV Index.exceptions
- An optional collection in which to place any PropertyException
s that occurred whilst attempting to
determine the default values of the Local DB VLV Index.
This argument can be null.
IllegalManagedObjectNameException
- If the name of the new Local DB VLV Index is invalid.void removeLocalDBVLVIndex(String name) throws ManagedObjectNotFoundException, OperationRejectedException, ConcurrentModificationException, org.forgerock.opendj.ldap.LdapException
name
- The name of the Local DB VLV Index to remove.ManagedObjectNotFoundException
- If the Local DB VLV Index does not exist.OperationRejectedException
- If the server refuses to remove the Local DB VLV Index
due to some server-side constraint which cannot be
satisfied (for example, if it is referenced by another
managed object).ConcurrentModificationException
- If this Local DB Backend has been removed from the
server by another client.org.forgerock.opendj.ldap.LdapException
- If any other error occurs.Copyright © 2011-2015 ForgeRock AS. All Rights Reserved.