public class EnvironmentParams extends Object
| Constructor and Description |
|---|
EnvironmentParams() |
| Modifier and Type | Method and Description |
|---|---|
static void |
addSupportedParam(ConfigParam param) |
public static final String REP_PARAM_PREFIX
public static final Map<String,ConfigParam> SUPPORTED_PARAMS
public static final LongConfigParam MAX_MEMORY
public static final IntConfigParam MAX_MEMORY_PERCENT
public static final BooleanConfigParam ENV_SHARED_CACHE
public static final LongConfigParam MAX_DISK
public static final LongConfigParam FREE_DISK
public static final LongConfigParam RESERVED_DISK
public static final BooleanConfigParam ENV_COMPARATORS_REQUIRED
public static final BooleanConfigParam ENV_RECOVERY
public static final BooleanConfigParam ENV_RECOVERY_FORCE_CHECKPOINT
public static final BooleanConfigParam ENV_RECOVERY_FORCE_NEW_FILE
public static final BooleanConfigParam HALT_ON_COMMIT_AFTER_CHECKSUMEXCEPTION
public static final BooleanConfigParam ENV_RUN_INCOMPRESSOR
public static final BooleanConfigParam ENV_RUN_EVICTOR
public static final BooleanConfigParam ENV_DUP_CONVERT_PRELOAD_ALL
public static final IntConfigParam EVICTOR_CORE_THREADS
public static final IntConfigParam EVICTOR_MAX_THREADS
public static final DurationConfigParam EVICTOR_KEEP_ALIVE
public static final DurationConfigParam EVICTOR_TERMINATE_TIMEOUT
public static final BooleanConfigParam EVICTOR_ALLOW_BIN_DELTAS
public static final BooleanConfigParam EVICTOR_MUTATE_BINS
public static final BooleanConfigParam ENV_RUN_CHECKPOINTER
public static final BooleanConfigParam ENV_RUN_CLEANER
public static final BooleanConfigParam ENV_RUN_EXTINCT_RECORD_SCANNER
public static final IntConfigParam ENV_BACKGROUND_READ_LIMIT
public static final IntConfigParam ENV_BACKGROUND_WRITE_LIMIT
public static final DurationConfigParam ENV_BACKGROUND_SLEEP_INTERVAL
public static final BooleanConfigParam ENV_CHECK_LEAKS
public static final BooleanConfigParam ENV_FORCED_YIELD
public static final BooleanConfigParam ENV_INIT_TXN
public static final BooleanConfigParam ENV_INIT_LOCKING
public static final BooleanConfigParam ENV_RDONLY
public static final BooleanConfigParam ENV_FAIR_LATCHES
public static final BooleanConfigParam ENV_SETUP_LOGGER
public static final DurationConfigParam ENV_LATCH_TIMEOUT
public static final DurationConfigParam ENV_TTL_CLOCK_TOLERANCE
public static final DurationConfigParam ENV_TTL_MAX_TXN_TIME
public static final DurationConfigParam ENV_TTL_LN_PURGE_DELAY
public static final BooleanConfigParam ENV_EXPOSE_USER_DATA
public static final BooleanConfigParam ENV_DB_EVICTION
public static final ConfigParam AUTO_RESERVED_FILE_REPAIR
While performing the repair, the background data verifier is
disabled as if VERIFY_LOG and VERIFY_BTREE were set
to false. Reserved files are repaired, but no other verification is
performed. The repair is run in a separate thread beginning 90s after
startup to allow the app to initialize the metadata needed for its
extinction filter. When the repair has been completed, the background
verifier is reset to its normal mode, according to the verifier
params specified: VERIFY_SCHEDULE, VERIFY_LOG,
VERIFY_BTREE, etc.
The repair is performed only once for each environment (each HA node). After the repair has completed without errors, an internal repair-done durable flag is set. The repair-done flag prevents repair from being initiated by a subsequent startup, even when the param is still enabled.
The repair-done flag is not made durable immediately after the repair is completed, but rather during the next checkpoint. If a crash occurs before it is made durable, the repair will simply be run again (redundantly) at the next startup.
The param value must be one of the following:
The default value is "off" and this disables the param. When "on"
is specified, the repair is enabled and throttling is performed as
specified by VERIFY_BTREE_BATCH_SIZE and VERIFY_BTREE_BATCH_DELAY. If "on.noThrottle" is specified, the repair
is enabled and throttling is disabled.
An INFO-level "Reserved file repair complete" message is logged when the repair has finished without errors. The only way to determine whether the repair was successful is to grep the logs for the presence of this message. Note that in an HA group, the repair is performed independently on each node, so the presence of the INFO message must be checked on each node.
If an error occurs while performing the repair, a WARNING-level "Reserved file repair not complete" message will be logged and the repair will be run again after the next restart. There are three types of errors that can cause this, all of which will additionally be logged as WARNING or SEVERE-level messages:
Although this does not indicate a failure and does not prevent successful completion of the repair, a WARNING-level "Reactivated reserved file" message is logged for each reactivated file.
If it is necessary to repeat the repair after it has been completed successfully, this param must be turned off and then on again, which requires two restarts. Setting it to "off" will clear the repair-done flag, and repair will be run again if the param is enabled at a subsequent startup. Because this param is not mutable at run-time, a restart is required each time it is changed.
This "repair on startup" feature is intended to be a one-off for a specific customer situation. It has drawbacks: the restarts required to change the param, and having to grep the logs to determine whether it worked. We should rely on Environment.verify instead going forward.
See [#27245].
public static final IntConfigParam ADLER32_CHUNK_SIZE
public static final int MIN_LOG_BUFFER_SIZE
public static final int NUM_LOG_BUFFERS_DEFAULT
public static final long LOG_MEM_SIZE_MIN
public static final String LOG_MEM_SIZE_MIN_STRING
public static final LongConfigParam LOG_MEM_SIZE
public static final IntConfigParam NUM_LOG_BUFFERS
public static final IntConfigParam LOG_BUFFER_MAX_SIZE
public static final IntConfigParam LOG_FAULT_READ_SIZE
public static final IntConfigParam LOG_ITERATOR_READ_SIZE
public static final IntConfigParam LOG_ITERATOR_MAX_SIZE
public static final LongConfigParam LOG_FILE_MAX
public static final IntConfigParam LOG_N_DATA_DIRECTORIES
public static final BooleanConfigParam LOG_CHECKSUM_READ
public static final BooleanConfigParam LOG_VERIFY_CHECKSUMS
public static final BooleanConfigParam LOG_MEMORY_ONLY
public static final IntConfigParam LOG_FILE_CACHE_SIZE
public static final IntConfigParam LOG_FILE_WARM_UP_SIZE
public static final IntConfigParam LOG_FILE_WARM_UP_BUF_SIZE
public static final BooleanConfigParam LOG_DETECT_FILE_DELETE
public static final DurationConfigParam LOG_DETECT_FILE_DELETE_INTERVAL
public static final DurationConfigParam LOG_FSYNC_TIMEOUT
LOG_FILE_WARM_UP_SIZE.
Because the warm-up can be concurrent with application CRUD operations,
it is important that a large buffer size be used for reading the data
files during the warm-up. That way, the warm-up is performed using
sequential reads to a large degree, even though CRUD operations may
cause some random I/O. Sequential reads are required to obtain the
performance benefit of the warm-up.
Note that this buffer is allocated outside of the JE cache, so the Java heap size must be set accordingly.
The default value, 10 MiB, is designed to reduce random I/O to some degree. It should be made larger to perform the warm-up more quickly, especially if there are many application threads performing CRUD operations. In our tests, using a value of 100 MiB minimized the time to complete the warm-up while 20 threads performed CRUD operations.
| Name | Type | Mutable | Default | Minimum | Maximum |
| (Use @value here if documented publicly) | Integer | No | 10485760 (10 MiB) | 128 | -none- |
public static final DurationConfigParam LOG_FSYNC_TIME_LIMIT
public static final DurationConfigParam LOG_GROUP_COMMIT_INTERVAL
public static final IntConfigParam LOG_GROUP_COMMIT_THRESHOLD
public static final DurationConfigParam LOG_FLUSH_SYNC_INTERVAL
public static final DurationConfigParam LOG_FLUSH_NO_SYNC_INTERVAL
public static final BooleanConfigParam OLD_REP_RUN_LOG_FLUSH_TASK
public static final DurationConfigParam OLD_REP_LOG_FLUSH_TASK_INTERVAL
public static final BooleanConfigParam LOG_USE_ODSYNC
public static final BooleanConfigParam LOG_USE_NIO
public static final BooleanConfigParam LOG_USE_WRITE_QUEUE
public static final IntConfigParam LOG_WRITE_QUEUE_SIZE
public static final BooleanConfigParam LOG_DEFERREDWRITE_TEMP
public static final BooleanConfigParam ENV_RUN_VERIFIER
public static final ConfigParam VERIFY_SCHEDULE
public static final DurationConfigParam VERIFY_MAX_TARDINESS
public static final BooleanConfigParam VERIFY_LOG
public static final DurationConfigParam VERIFY_LOG_READ_DELAY
public static final BooleanConfigParam VERIFY_BTREE
public static final BooleanConfigParam VERIFY_SECONDARIES
public static final BooleanConfigParam VERIFY_DATA_RECORDS
public static final BooleanConfigParam VERIFY_OBSOLETE_RECORDS
public static final IntConfigParam VERIFY_BTREE_BATCH_SIZE
public static final DurationConfigParam VERIFY_BTREE_BATCH_DELAY
public static final IntConfigParam NODE_MAX
public static final IntConfigParam NODE_MAX_DUPTREE
public static final IntConfigParam TREE_MAX_EMBEDDED_LN
public static final IntConfigParam BIN_DELTA_PERCENT
public static final BooleanConfigParam BIN_DELTA_BLIND_OPS
public static final BooleanConfigParam BIN_DELTA_BLIND_PUTS
public static final LongConfigParam MIN_TREE_MEMORY
public static final IntConfigParam TREE_COMPACT_MAX_KEY_LENGTH
public static final DurationConfigParam COMPRESSOR_WAKEUP_INTERVAL
public static final IntConfigParam COMPRESSOR_RETRY
public static final DurationConfigParam COMPRESSOR_LOCK_TIMEOUT
public static final LongConfigParam EVICTOR_EVICT_BYTES
public static final IntConfigParam EVICTOR_CRITICAL_PERCENTAGE
public static final BooleanConfigParam EVICTOR_USE_DIRTY_LRU
This parameter applies to the new evictor only.
| Name | Type | Mutable | Default |
| (Use @value if documented publicly) | Boolean | No | true |
public static final IntConfigParam EVICTOR_N_LRU_LISTS
public static final BooleanConfigParam EVICTOR_FORCED_YIELD
public static final LongConfigParam MAX_OFF_HEAP_MEMORY
public static final LongConfigParam OFFHEAP_EVICT_BYTES
public static final BooleanConfigParam OFFHEAP_CHECKSUM
public static final BooleanConfigParam ENV_RUN_OFFHEAP_EVICTOR
public static final BooleanConfigParam ENV_EXPIRATION_ENABLED
public static final IntConfigParam OFFHEAP_CORE_THREADS
public static final IntConfigParam OFFHEAP_MAX_THREADS
public static final DurationConfigParam OFFHEAP_KEEP_ALIVE
public static final IntConfigParam OFFHEAP_N_LRU_LISTS
public static final LongConfigParam CHECKPOINTER_BYTES_INTERVAL
public static final DurationConfigParam CHECKPOINTER_WAKEUP_INTERVAL
public static final IntConfigParam CHECKPOINTER_RETRY
public static final BooleanConfigParam CHECKPOINTER_HIGH_PRIORITY
public static final IntConfigParam CLEANER_MIN_UTILIZATION
public static final IntConfigParam CLEANER_MIN_FILE_UTILIZATION
public static final LongConfigParam CLEANER_BYTES_INTERVAL
public static final DurationConfigParam CLEANER_WAKEUP_INTERVAL
public static final BooleanConfigParam CLEANER_FETCH_OBSOLETE_SIZE
public static final IntConfigParam CLEANER_DEADLOCK_RETRY
public static final DurationConfigParam CLEANER_LOCK_TIMEOUT
public static final BooleanConfigParam CLEANER_REMOVE
public static final BooleanConfigParam CLEANER_USE_DELETED_DIR
public static final LongConfigParam CLEANER_FLUSH_EXTINCT_OBSOLETE
| Name | Type | Mutable | Default | Minimum | Maximum |
| (Use @value here if documented publicly) | Long | No | 1073741824 (1GB) | 5242880 (5MB) | -none- |
public static final IntConfigParam CLEANER_EXTINCT_SCAN_BATCH_SIZE
public static final DurationConfigParam CLEANER_EXTINCT_SCAN_BATCH_DELAY
public static final IntConfigParam CLEANER_MIN_AGE
public static final IntConfigParam CLEANER_MAX_BATCH_FILES
public static final IntConfigParam CLEANER_READ_SIZE
public static final DurationConfigParam DOS_PRODUCER_QUEUE_TIMEOUT
public static final BooleanConfigParam CLEANER_TRACK_DETAIL
public static final BooleanConfigParam CLEANER_GRADUAL_EXPIRATION
public static final IntConfigParam CLEANER_TWO_PASS_GAP
public static final IntConfigParam CLEANER_TWO_PASS_THRESHOLD
CLEANER_TWO_PASS_THRESHOLD, and
2. the difference between the minimum and maximum utilization of a file
is greater than or equal to than
CLEANER_TWO_PASS_GAP.
After pass one, pass two is performed only if the recalculated
utilization is greater than or equal to
CLEANER_TWO_PASS_THRESHOLD.
When this parameter is zero, the default, the value used is
EnvironmentConfig.CLEANER_MIN_UTILIZATION minus five.public static final IntConfigParam CLEANER_DETAIL_MAX_MEMORY_PERCENTAGE
public static final BooleanConfigParam CLEANER_RMW_FIX
public static final ConfigParam CLEANER_FORCE_CLEAN_FILES
public static final IntConfigParam CLEANER_UPGRADE_TO_LOG_VERSION
public static final IntConfigParam CLEANER_THREADS
public static final IntConfigParam CLEANER_LOOK_AHEAD_CACHE_SIZE
public static final BooleanConfigParam CLEANER_BACKGROUND_PROACTIVE_MIGRATION
public static final BooleanConfigParam ENV_RUN_ERASER
public static final DurationConfigParam ERASE_PERIOD
public static final BooleanConfigParam ERASE_DELETED_DATABASES
public static final BooleanConfigParam ERASE_EXTINCT_RECORDS
public static final DurationConfigParam ERASE_ABORT_TIMEOUT
DbBackup.startBackup().
The default (30s) should be long enough for any situation, but just in
case that is not true, this internal param can be set.public static final IntConfigParam ENV_DB_CACHE_CLEAR_COUNT
public static final DurationConfigParam ENV_DB_CACHE_TIMEOUT
public static final IntConfigParam N_LOCK_TABLES
public static final DurationConfigParam LOCK_TIMEOUT
public static final BooleanConfigParam LOCK_DEADLOCK_DETECT
public static final DurationConfigParam LOCK_DEADLOCK_DETECT_DELAY
public static final BooleanConfigParam LOCK_OLD_LOCK_EXCEPTIONS
public static final DurationConfigParam TXN_TIMEOUT
public static final BooleanConfigParam TXN_SERIALIZABLE_ISOLATION
public static final BooleanConfigParam TXN_DEADLOCK_STACK_TRACE
public static final BooleanConfigParam TXN_DUMPLOCKS
public static final BooleanConfigParam JE_LOGGING_DBLOG
public static final ConfigParam JE_CONSOLE_LEVEL
public static final ConfigParam JE_FILE_LEVEL
public static final ConfigParam JE_DURABILITY
public static final DurationConfigParam STARTUP_DUMP_THRESHOLD
public static final BooleanConfigParam STATS_COLLECT
public static final IntConfigParam STATS_FILE_ROW_COUNT
public static final IntConfigParam STATS_MAX_FILES
public static final DurationConfigParam STATS_COLLECT_INTERVAL
public static final ConfigParam STATS_FILE_DIRECTORY
public static final ConfigParam FILE_LOGGING_PREFIX
public static final ConfigParam FILE_LOGGING_DIRECTORY
public static final BooleanConfigParam ENV_RUN_BACKUP
public static final ConfigParam BACKUP_SCHEDULE
public static final ConfigParam BACKUP_COPY_CLASS
public static final ConfigParam BACKUP_COPY_CONFIG
public static final ConfigParam BACKUP_LOCATION_CLASS
public static final ConfigParam BACKUP_LOCATION_CONFIG
public static void addSupportedParam(ConfigParam param)
Copyright © 2024. All rights reserved.