public interface JeBackendCfg extends PluggableBackendCfg
A JE Backend stores application data in a Berkeley DB Java Edition database.
Modifier and Type | Method and Description |
---|---|
void |
addJeChangeListener(ConfigurationChangeListener<JeBackendCfg> listener)
Register to be notified when this JE Backend is changed.
|
Class<? extends JeBackendCfg> |
configurationClass()
Gets the configuration class associated with this JE 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 |
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.
|
String |
getJavaClass()
Gets the "java-class" property.
|
SortedSet<String> |
getJeProperty()
Gets the "je-property" 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.
|
void |
removeJeChangeListener(ConfigurationChangeListener<JeBackendCfg> listener)
Deregister an existing JE Backend configuration change listener.
|
addBackendIndexAddListener, addBackendIndexDeleteListener, addBackendVlvIndexAddListener, addBackendVlvIndexDeleteListener, addPluggableChangeListener, getBackendIndex, getBackendVlvIndex, getBaseDn, getCipherKeyLength, getCipherTransformation, getImportOffheapMemorySize, getIndexEntryLimit, getIndexFilterAnalyzerMaxFilters, getPreloadTimeLimit, getWritabilityMode, isCompactEncoding, isConfidentialityEnabled, isEntriesCompressed, isIndexFilterAnalyzerEnabled, listBackendIndexes, listBackendVlvIndexes, removeBackendIndexAddListener, removeBackendIndexDeleteListener, removeBackendVlvIndexAddListener, removeBackendVlvIndexDeleteListener, removePluggableChangeListener
addLocalChangeListener, removeLocalChangeListener
addChangeListener, getBackendId, isEnabled, removeChangeListener
dn, name
Class<? extends JeBackendCfg> configurationClass()
configurationClass
in interface BackendCfg
configurationClass
in interface Configuration
configurationClass
in interface LocalBackendCfg
configurationClass
in interface PluggableBackendCfg
void addJeChangeListener(ConfigurationChangeListener<JeBackendCfg> listener)
listener
- The JE Backend configuration change listener.void removeJeChangeListener(ConfigurationChangeListener<JeBackendCfg> listener)
listener
- The JE Backend configuration change listener.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.
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.
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.
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.
int getDbCleanerMinUtilization()
Specifies the occupancy percentage for "live" data in this backend's database.
When the amount of "live" data in the database drops below this value, cleaners will act to increase the occupancy percentage by compacting the database.
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.
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.
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.
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.
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.
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.
long getDbLogFileMax()
Specifies the maximum size of each individual database log file.
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.
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.
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.
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.
boolean isDbRunCleaner()
Indicates whether the cleaner threads should be enabled to compact the database.
The cleaner threads are used to periodically compact the database when it reaches a percentage of occupancy lower than the amount specified by the db-cleaner-min-utilization property. They identify database files with a low percentage of live data, and relocate their remaining live data to the end of the log.
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).
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).
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.
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.
String getJavaClass()
Specifies the fully-qualified name of the Java class that provides the backend implementation.
getJavaClass
in interface BackendCfg
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.
Copyright 2010-2020 ForgeRock AS.