blob: 70070130e777287b255caf5d7127ef3eac3e4344 [file] [log] [blame]
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.ignite;
import java.io.Serializable;
import java.lang.management.RuntimeMXBean;
import java.util.Arrays;
import java.util.Iterator;
import java.util.Map;
import java.util.Properties;
import javax.net.ssl.HostnameVerifier;
import org.apache.ignite.cache.CacheEntryProcessor;
import org.apache.ignite.cluster.ClusterGroup;
import org.apache.ignite.configuration.CacheConfiguration;
import org.apache.ignite.configuration.CheckpointWriteOrder;
import org.apache.ignite.configuration.DataStorageConfiguration;
import org.apache.ignite.configuration.DeploymentMode;
import org.apache.ignite.configuration.DiskPageCompression;
import org.apache.ignite.configuration.IgniteConfiguration;
import org.apache.ignite.internal.client.GridClient;
import org.apache.ignite.internal.marshaller.optimized.OptimizedMarshaller;
import org.apache.ignite.internal.processors.cache.persistence.checkpoint.CheckpointEntry;
import org.apache.ignite.internal.processors.metastorage.DistributedMetaStorage;
import org.apache.ignite.internal.processors.performancestatistics.FilePerformanceStatisticsWriter;
import org.apache.ignite.internal.processors.query.schema.SchemaIndexCachePartitionWorker;
import org.apache.ignite.internal.processors.rest.GridRestCommand;
import org.apache.ignite.internal.util.GridLogThrottle;
import org.apache.ignite.lang.IgniteExperimental;
import org.apache.ignite.mxbean.MetricsMxBean;
import org.apache.ignite.spi.communication.tcp.TcpCommunicationSpi;
import org.apache.ignite.spi.metric.ReadOnlyMetricRegistry;
import org.apache.ignite.stream.StreamTransformer;
import org.jetbrains.annotations.Nullable;
import static org.apache.ignite.cache.CacheManager.DFLT_JCACHE_DEFAULT_ISOLATED;
import static org.apache.ignite.configuration.DataStorageConfiguration.DFLT_USE_ASYNC_FILE_IO_FACTORY;
import static org.apache.ignite.internal.IgniteKernal.DFLT_EVENT_DRIVEN_SERVICE_PROCESSOR_ENABLED;
import static org.apache.ignite.internal.IgniteKernal.DFLT_LOG_CLASSPATH_CONTENT_ON_STARTUP;
import static org.apache.ignite.internal.IgniteKernal.DFLT_LONG_OPERATIONS_DUMP_TIMEOUT;
import static org.apache.ignite.internal.IgniteKernal.DFLT_PERIODIC_STARVATION_CHECK_FREQ;
import static org.apache.ignite.internal.LongJVMPauseDetector.DEFAULT_JVM_PAUSE_DETECTOR_THRESHOLD;
import static org.apache.ignite.internal.LongJVMPauseDetector.DFLT_JVM_PAUSE_DETECTOR_LAST_EVENTS_COUNT;
import static org.apache.ignite.internal.LongJVMPauseDetector.DFLT_JVM_PAUSE_DETECTOR_PRECISION;
import static org.apache.ignite.internal.binary.streams.BinaryMemoryAllocator.DFLT_MARSHAL_BUFFERS_PER_THREAD_POOL_SIZE;
import static org.apache.ignite.internal.binary.streams.BinaryMemoryAllocator.DFLT_MARSHAL_BUFFERS_RECHECK;
import static org.apache.ignite.internal.managers.discovery.GridDiscoveryManager.DFLT_DISCOVERY_HISTORY_SIZE;
import static org.apache.ignite.internal.processors.affinity.AffinityAssignment.DFLT_AFFINITY_BACKUPS_THRESHOLD;
import static org.apache.ignite.internal.processors.affinity.GridAffinityAssignmentCache.DFLT_AFFINITY_HISTORY_SIZE;
import static org.apache.ignite.internal.processors.affinity.GridAffinityAssignmentCache.DFLT_PART_DISTRIBUTION_WARN_THRESHOLD;
import static org.apache.ignite.internal.processors.cache.CacheAffinitySharedManager.DFLT_CLIENT_CACHE_CHANGE_MESSAGE_TIMEOUT;
import static org.apache.ignite.internal.processors.cache.GridCacheAdapter.DFLT_CACHE_RETRIES_COUNT;
import static org.apache.ignite.internal.processors.cache.GridCacheAdapter.DFLT_CACHE_START_SIZE;
import static org.apache.ignite.internal.processors.cache.GridCacheContext.DFLT_READ_LOAD_BALANCING;
import static org.apache.ignite.internal.processors.cache.GridCacheMvccManager.DFLT_MAX_NESTED_LISTENER_CALLS;
import static org.apache.ignite.internal.processors.cache.GridCachePartitionExchangeManager.DFLT_DIAGNOSTIC_WARN_LIMIT;
import static org.apache.ignite.internal.processors.cache.GridCachePartitionExchangeManager.DFLT_EXCHANGE_HISTORY_SIZE;
import static org.apache.ignite.internal.processors.cache.GridCachePartitionExchangeManager.DFLT_EXCHANGE_MERGE_DELAY;
import static org.apache.ignite.internal.processors.cache.GridCacheProcessor.DFLT_ALLOW_START_CACHES_IN_PARALLEL;
import static org.apache.ignite.internal.processors.cache.GridCacheTtlManager.DFLT_UNWIND_THROTTLING_TIMEOUT;
import static org.apache.ignite.internal.processors.cache.GridCacheUtils.DFLT_TTL_EXPIRE_BATCH_SIZE;
import static org.apache.ignite.internal.processors.cache.WalStateManager.DFLT_DISABLE_WAL_DURING_REBALANCING;
import static org.apache.ignite.internal.processors.cache.binary.CacheObjectBinaryProcessorImpl.DFLT_WAIT_SCHEMA_UPDATE;
import static org.apache.ignite.internal.processors.cache.distributed.dht.CacheDistributedGetFutureAdapter.DFLT_MAX_REMAP_CNT;
import static org.apache.ignite.internal.processors.cache.distributed.dht.atomic.GridDhtAtomicCache.DFLT_ATOMIC_DEFERRED_ACK_BUFFER_SIZE;
import static org.apache.ignite.internal.processors.cache.distributed.dht.atomic.GridDhtAtomicCache.DFLT_ATOMIC_DEFERRED_ACK_TIMEOUT;
import static org.apache.ignite.internal.processors.cache.distributed.dht.preloader.GridDhtPartitionsExchangeFuture.DFLT_LONG_OPERATIONS_DUMP_TIMEOUT_LIMIT;
import static org.apache.ignite.internal.processors.cache.distributed.dht.preloader.GridDhtPartitionsExchangeFuture.DFLT_PARTITION_RELEASE_FUTURE_DUMP_THRESHOLD;
import static org.apache.ignite.internal.processors.cache.distributed.dht.preloader.GridDhtPreloader.DFLT_PRELOAD_RESEND_TIMEOUT;
import static org.apache.ignite.internal.processors.cache.distributed.dht.topology.GridDhtLocalPartition.DFLT_ATOMIC_CACHE_DELETE_HISTORY_SIZE;
import static org.apache.ignite.internal.processors.cache.distributed.dht.topology.GridDhtLocalPartition.DFLT_CACHE_REMOVE_ENTRIES_TTL;
import static org.apache.ignite.internal.processors.cache.mvcc.MvccCachingManager.DFLT_MVCC_TX_SIZE_CACHING_THRESHOLD;
import static org.apache.ignite.internal.processors.cache.persistence.GridCacheDatabaseSharedManager.DFLT_DEFRAGMENTATION_REGION_SIZE_PERCENTAGE;
import static org.apache.ignite.internal.processors.cache.persistence.GridCacheDatabaseSharedManager.DFLT_PDS_WAL_REBALANCE_THRESHOLD;
import static org.apache.ignite.internal.processors.cache.persistence.checkpoint.CheckpointHistory.DFLT_PDS_MAX_CHECKPOINT_MEMORY_HISTORY_SIZE;
import static org.apache.ignite.internal.processors.cache.persistence.checkpoint.CheckpointWorkflow.DFLT_CHECKPOINT_PARALLEL_SORT_THRESHOLD;
import static org.apache.ignite.internal.processors.cache.persistence.diagnostic.pagelocktracker.PageLockTrackerFactory.DFLT_PAGE_LOCK_TRACKER_CAPACITY;
import static org.apache.ignite.internal.processors.cache.persistence.diagnostic.pagelocktracker.PageLockTrackerFactory.HEAP_LOG;
import static org.apache.ignite.internal.processors.cache.persistence.diagnostic.pagelocktracker.SharedPageLockTracker.DFLT_PAGE_LOCK_TRACKER_CHECK_INTERVAL;
import static org.apache.ignite.internal.processors.cache.persistence.pagemem.FullPageIdTable.DFLT_LONG_LONG_HASH_MAP_LOAD_FACTOR;
import static org.apache.ignite.internal.processors.cache.persistence.pagemem.PageMemoryImpl.DFLT_DELAYED_REPLACED_PAGE_WRITE;
import static org.apache.ignite.internal.processors.cache.persistence.pagemem.PageMemoryImpl.DFLT_LOADED_PAGES_BACKWARD_SHIFT_MAP;
import static org.apache.ignite.internal.processors.cache.persistence.pagemem.PagesWriteThrottlePolicy.DFLT_THROTTLE_LOG_THRESHOLD;
import static org.apache.ignite.internal.processors.cache.persistence.tree.BPlusTree.IGNITE_BPLUS_TREE_LOCK_RETRIES_DEFAULT;
import static org.apache.ignite.internal.processors.cache.persistence.wal.FileWriteAheadLogManager.DFLT_CHECKPOINT_TRIGGER_ARCHIVE_SIZE_PERCENTAGE;
import static org.apache.ignite.internal.processors.cache.persistence.wal.FileWriteAheadLogManager.DFLT_THRESHOLD_WAIT_TIME_NEXT_WAL_SEGMENT;
import static org.apache.ignite.internal.processors.cache.persistence.wal.FileWriteAheadLogManager.DFLT_WAL_COMPRESSOR_WORKER_THREAD_CNT;
import static org.apache.ignite.internal.processors.cache.persistence.wal.FileWriteAheadLogManager.DFLT_WAL_MMAP;
import static org.apache.ignite.internal.processors.cache.persistence.wal.filehandle.FileHandleManagerImpl.DFLT_WAL_SEGMENT_SYNC_TIMEOUT;
import static org.apache.ignite.internal.processors.cache.persistence.wal.serializer.RecordSerializerFactory.LATEST_SERIALIZER_VERSION;
import static org.apache.ignite.internal.processors.cache.transactions.IgniteTxManager.DFLT_DEFERRED_ONE_PHASE_COMMIT_ACK_REQUEST_BUFFER_SIZE;
import static org.apache.ignite.internal.processors.cache.transactions.IgniteTxManager.DFLT_DEFERRED_ONE_PHASE_COMMIT_ACK_REQUEST_TIMEOUT;
import static org.apache.ignite.internal.processors.cache.transactions.IgniteTxManager.DFLT_DUMP_TX_COLLISIONS_INTERVAL;
import static org.apache.ignite.internal.processors.cache.transactions.IgniteTxManager.DFLT_MAX_COMPLETED_TX_CNT;
import static org.apache.ignite.internal.processors.cache.transactions.IgniteTxManager.DFLT_SLOW_TX_WARN_TIMEOUT;
import static org.apache.ignite.internal.processors.cache.transactions.IgniteTxManager.DFLT_TRANSACTION_TIME_DUMP_SAMPLES_PER_SECOND_LIMIT;
import static org.apache.ignite.internal.processors.cache.transactions.IgniteTxManager.DFLT_TX_DEADLOCK_DETECTION_MAX_ITERS;
import static org.apache.ignite.internal.processors.cache.transactions.IgniteTxManager.DFLT_TX_OWNER_DUMP_REQUESTS_ALLOWED;
import static org.apache.ignite.internal.processors.cache.transactions.TxDeadlockDetection.DFLT_TX_DEADLOCK_DETECTION_TIMEOUT;
import static org.apache.ignite.internal.processors.cluster.ClusterProcessor.DFLT_DIAGNOSTIC_ENABLED;
import static org.apache.ignite.internal.processors.cluster.ClusterProcessor.DFLT_UPDATE_NOTIFIER;
import static org.apache.ignite.internal.processors.cluster.baseline.autoadjust.BaselineTopologyUpdater.DFLT_BASELINE_AUTO_ADJUST_LOG_INTERVAL;
import static org.apache.ignite.internal.processors.datastructures.GridAtomicCacheQueueImpl.DFLT_ATOMIC_CACHE_QUERY_RETRY_TIMEOUT;
import static org.apache.ignite.internal.processors.diagnostic.DiagnosticProcessor.DFLT_DUMP_PAGE_LOCK_ON_FAILURE;
import static org.apache.ignite.internal.processors.failure.FailureProcessor.DFLT_FAILURE_HANDLER_RESERVE_BUFFER_SIZE;
import static org.apache.ignite.internal.processors.job.GridJobProcessor.DFLT_JOBS_HISTORY_SIZE;
import static org.apache.ignite.internal.processors.jobmetrics.GridJobMetricsProcessor.DFLT_JOBS_METRICS_CONCURRENCY_LEVEL;
import static org.apache.ignite.internal.processors.metastorage.persistence.DistributedMetaStorageImpl.DFLT_MAX_HISTORY_BYTES;
import static org.apache.ignite.internal.processors.performancestatistics.FilePerformanceStatisticsWriter.DFLT_BUFFER_SIZE;
import static org.apache.ignite.internal.processors.performancestatistics.FilePerformanceStatisticsWriter.DFLT_CACHED_STRINGS_THRESHOLD;
import static org.apache.ignite.internal.processors.performancestatistics.FilePerformanceStatisticsWriter.DFLT_FILE_MAX_SIZE;
import static org.apache.ignite.internal.processors.performancestatistics.FilePerformanceStatisticsWriter.DFLT_FLUSH_SIZE;
import static org.apache.ignite.internal.processors.query.QueryUtils.DFLT_INDEXING_DISCOVERY_HISTORY_SIZE;
import static org.apache.ignite.internal.processors.query.schema.SchemaIndexCachePartitionWorker.DFLT_IGNITE_INDEX_REBUILD_BATCH_SIZE;
import static org.apache.ignite.internal.processors.rest.GridRestProcessor.DFLT_SES_TIMEOUT;
import static org.apache.ignite.internal.processors.rest.GridRestProcessor.DFLT_SES_TOKEN_INVALIDATE_INTERVAL;
import static org.apache.ignite.internal.processors.rest.handlers.task.GridTaskCommandHandler.DFLT_MAX_TASK_RESULTS;
import static org.apache.ignite.internal.util.GridLogThrottle.DFLT_LOG_THROTTLE_CAPACITY;
import static org.apache.ignite.internal.util.GridReflectionCache.DFLT_REFLECTION_CACHE_SIZE;
import static org.apache.ignite.internal.util.GridUnsafe.DFLT_MEMORY_PER_BYTE_COPY_THRESHOLD;
import static org.apache.ignite.internal.util.IgniteExceptionRegistry.DEFAULT_QUEUE_SIZE;
import static org.apache.ignite.internal.util.IgniteUtils.DFLT_MBEAN_APPEND_CLASS_LOADER_ID;
import static org.apache.ignite.internal.util.StripedExecutor.DFLT_DATA_STREAMING_EXECUTOR_SERVICE_TASKS_STEALING_THRESHOLD;
import static org.apache.ignite.internal.util.nio.GridNioRecoveryDescriptor.DFLT_NIO_RECOVERY_DESCRIPTOR_RESERVATION_TIMEOUT;
import static org.apache.ignite.internal.util.nio.GridNioServer.DFLT_IO_BALANCE_PERIOD;
import static org.apache.ignite.internal.util.tostring.GridToStringBuilder.DFLT_TO_STRING_COLLECTION_LIMIT;
import static org.apache.ignite.internal.util.tostring.GridToStringBuilder.DFLT_TO_STRING_INCLUDE_SENSITIVE;
import static org.apache.ignite.internal.util.tostring.GridToStringBuilder.DFLT_TO_STRING_MAX_LENGTH;
import static org.apache.ignite.spi.discovery.tcp.TcpDiscoverySpi.DFLT_DISCOVERY_CLIENT_RECONNECT_HISTORY_SIZE;
import static org.apache.ignite.spi.discovery.tcp.TcpDiscoverySpi.DFLT_DISCOVERY_METRICS_QNT_WARN;
import static org.apache.ignite.spi.discovery.tcp.TcpDiscoverySpi.DFLT_DISCO_FAILED_CLIENT_RECONNECT_DELAY;
import static org.apache.ignite.spi.discovery.tcp.TcpDiscoverySpi.DFLT_NODE_IDS_HISTORY_SIZE;
import static org.apache.ignite.spi.discovery.tcp.TcpDiscoverySpi.DFLT_THROTTLE_RECONNECT_RESET_TIMEOUT_INTERVAL;
import static org.apache.ignite.startup.cmdline.CommandLineStartup.DFLT_PROG_NAME;
/**
* Contains constants for all system properties and environmental variables in Ignite.
* These properties and variables can be used to affect the behavior of Ignite.
*/
public final class IgniteSystemProperties {
/**
* If this system property is present the Ignite will include grid name into verbose log.
*
* @deprecated Use {@link #IGNITE_LOG_INSTANCE_NAME}.
*/
@Deprecated
@SystemProperty(value = "If this system property is present Ignite will include grid name into " +
"verbose log", type = String.class)
public static final String IGNITE_LOG_GRID_NAME = "IGNITE_LOG_GRID_NAME";
/**
* If this system property is present the Ignite will include instance name into verbose log.
*/
@SystemProperty(value = "If this system property is present Ignite will include instance name " +
"into verbose log", type = String.class)
public static final String IGNITE_LOG_INSTANCE_NAME = "IGNITE_LOG_INSTANCE_NAME";
/**
* This property is used internally to pass an exit code to loader when
* Ignite instance is being restarted.
*/
@SystemProperty(value = "Exit code to pass to loader when Ignite instance is being restarted",
type = Integer.class, defaults = "0")
public static final String IGNITE_RESTART_CODE = "IGNITE_RESTART_CODE";
/**
* Presence of this system property with value {@code true} will make the grid
* node start as a daemon node. Node that this system property will override
* {@link org.apache.ignite.configuration.IgniteConfiguration#isDaemon()} configuration.
*/
@SystemProperty("If true Ignite will start as a daemon node. Note that this system property " +
"will override IgniteConfiguration.isDaemon() configuration")
public static final String IGNITE_DAEMON = "IGNITE_DAEMON";
/** Defines Ignite installation folder. */
@SystemProperty(value = "Defines Ignite installation folder", type = String.class, defaults = "")
public static final String IGNITE_HOME = "IGNITE_HOME";
/** If this system property is set to {@code true} - no shutdown hook will be set. */
@SystemProperty("If true then no shutdown hook will be set")
public static final String IGNITE_NO_SHUTDOWN_HOOK = "IGNITE_NO_SHUTDOWN_HOOK";
/**
* Name of the system property to disable requirement for proper node ordering
* by discovery SPI. Use with care, as proper node ordering is required for
* cache consistency. If set to {@code true}, then any discovery SPI can be used
* with distributed cache, otherwise, only discovery SPIs that have annotation
* {@link org.apache.ignite.spi.discovery.DiscoverySpiOrderSupport @GridDiscoverySpiOrderSupport(true)} will
* be allowed.
*/
@SystemProperty("If true requirement for proper node ordering " +
"by discovery SPI will be disabled. Use with care, as proper node ordering is required for cache consistency. " +
"If set to true, then any discovery SPI can be used with distributed cache, otherwise, " +
"only discovery SPIs that have annotation @GridDiscoverySpiOrderSupport(true) will be allowed")
public static final String IGNITE_NO_DISCO_ORDER = "IGNITE_NO_DISCO_ORDER";
/** Defines reconnect delay in milliseconds for client node that was failed forcible. */
@SystemProperty(value = "Reconnect delay in milliseconds for client node that was failed forcible",
type = Long.class, defaults = DFLT_DISCO_FAILED_CLIENT_RECONNECT_DELAY + " milliseconds")
public static final String IGNITE_DISCO_FAILED_CLIENT_RECONNECT_DELAY = "IGNITE_DISCO_FAILED_CLIENT_RECONNECT_DELAY";
/**
* If this system property is set to {@code false} - no checks for new versions will
* be performed by Ignite. By default, Ignite periodically checks for the new
* version and prints out the message into the log if a new version of Ignite is
* available for download.
*
* Update notifier enabled flag is a cluster-wide value and determined according to the local setting
* during the start of the first node in the cluster. The chosen value will survive the first node shutdown
* and will override the property value on all newly joining nodes.
*/
@SystemProperty(value = "If this system property is set to false - no checks for new versions will " +
"be performed by Ignite. By default, Ignite periodically checks for the new version and prints out the " +
"message into the log if a new version of Ignite is available for download. Update notifier enabled flag is " +
"a cluster-wide value and determined according to the local setting during the start of the first node in " +
"the cluster. The chosen value will survive the first node shutdown and will override the property value " +
"on all newly joining nodes", defaults = "" + DFLT_UPDATE_NOTIFIER)
public static final String IGNITE_UPDATE_NOTIFIER = "IGNITE_UPDATE_NOTIFIER";
/**
* This system property defines interval in milliseconds in which Ignite will check
* thread pool state for starvation. Zero value will disable this checker.
*/
@SystemProperty(value = "Interval in milliseconds in which Ignite will check thread pool state for starvation. " +
"Zero value will disable checker", type = Long.class,
defaults = DFLT_PERIODIC_STARVATION_CHECK_FREQ + " milliseconds")
public static final String IGNITE_STARVATION_CHECK_INTERVAL = "IGNITE_STARVATION_CHECK_INTERVAL";
/**
* If this system property is present (any value) - no ASCII logo will
* be printed.
*/
@SystemProperty(value = "If this system property is present (any value) - no ASCII logo will be printed")
public static final String IGNITE_NO_ASCII = "IGNITE_NO_ASCII";
/**
* This property allows to override Jetty host for REST processor.
*/
@SystemProperty(value = "Jetty host for REST processor", type = String.class)
public static final String IGNITE_JETTY_HOST = "IGNITE_JETTY_HOST";
/**
* This property allows to override Jetty local port for REST processor.
*/
@SystemProperty(value = "Jetty local port for REST processor", type = Integer.class)
public static final String IGNITE_JETTY_PORT = "IGNITE_JETTY_PORT";
/**
* This property does not allow Ignite to override Jetty log configuration for REST processor.
*/
@SystemProperty("If true then disallow Ignite to override Jetty log configuration for REST processor")
public static final String IGNITE_JETTY_LOG_NO_OVERRIDE = "IGNITE_JETTY_LOG_NO_OVERRIDE";
/** This property allow rewriting default ({@code 30}) REST session expire time (in seconds). */
@SystemProperty(value = "REST session expire time in seconds", type = Long.class,
defaults = DFLT_SES_TIMEOUT + " seconds")
public static final String IGNITE_REST_SESSION_TIMEOUT = "IGNITE_REST_SESSION_TIMEOUT";
/** This property allow rewriting default ({@code 300}) REST session security token expire time (in seconds). */
@SystemProperty(value = "REST session security token expire time in seconds",
type = Long.class, defaults = DFLT_SES_TOKEN_INVALIDATE_INTERVAL + " seconds")
public static final String IGNITE_REST_SECURITY_TOKEN_TIMEOUT = "IGNITE_REST_SECURITY_TOKEN_TIMEOUT";
/**
* This property allows to override maximum count of task results stored on one node
* in REST processor.
*/
@SystemProperty(value = "Maximum count of task results stored on one node in REST processor",
type = Integer.class, defaults = "" + DFLT_MAX_TASK_RESULTS)
public static final String IGNITE_REST_MAX_TASK_RESULTS = "IGNITE_REST_MAX_TASK_RESULTS";
/**
* This property allows to override default behavior that rest processor
* doesn't start on client node. If set {@code true} than rest processor will be started on client node.
*/
@SystemProperty("Enables start of the rest processor on client node")
public static final String IGNITE_REST_START_ON_CLIENT = "IGNITE_REST_START_ON_CLIENT";
/**
* This property changes output format of {@link GridRestCommand#CACHE_GET_ALL} from {k: v, ...}
* to [{"key": k, "value": v}, ...] to allow non-string keys output.
*
* @deprecated Should be made default in Apache Ignite 3.0.
*/
@Deprecated
@SystemProperty("If true output format of GridRestCommand.CACHE_GET_ALL will change from " +
"{k: v, ...} to [{\"key\": k, \"value\": v}, ...] to allow non-string keys output")
public static final String IGNITE_REST_GETALL_AS_ARRAY = "IGNITE_REST_GETALL_AS_ARRAY";
/**
* This property defines the maximum number of attempts to remap near get to the same
* primary node. Remapping may be needed when topology is changed concurrently with
* get operation.
*/
@SystemProperty(value = "Maximum number of attempts to remap near get to the same primary node. " +
"Remapping may be needed when topology is changed concurrently with get operation",
type = Integer.class, defaults = "" + DFLT_MAX_REMAP_CNT)
public static final String IGNITE_NEAR_GET_MAX_REMAPS = "IGNITE_NEAR_GET_MAX_REMAPS";
/**
* Set to either {@code true} or {@code false} to enable or disable quiet mode
* of Ignite. In quiet mode, only warning and errors are printed into the log
* additionally to a shortened version of standard output on the start.
* <p>
* Note that if you use <tt>ignite.{sh|bat}</tt> scripts to start Ignite they
* start by default in quiet mode. You can supply <tt>-v</tt> flag to override it.
*/
@SystemProperty(value = "In quiet mode, only warning and errors are printed into the log additionally to a " +
"shortened version of standard output on the start. Note that if you use ignite.{sh|bat} scripts to start " +
"Ignite they start by default in quiet mode. You can supply -v flag to override it", defaults = "true")
public static final String IGNITE_QUIET = "IGNITE_QUIET";
/**
* Setting this option to {@code true} will enable troubleshooting logger.
* Troubleshooting logger makes logging more verbose without enabling debug mode
* to provide more detailed logs without performance penalty.
*/
@SystemProperty("Enables troubleshooting logger. " +
"Troubleshooting logger makes logging more verbose without enabling debug mode to provide more detailed " +
"logs without performance penalty")
public static final String IGNITE_TROUBLESHOOTING_LOGGER = "IGNITE_TROUBLESHOOTING_LOGGER";
/**
* Setting to {@code true} enables writing sensitive information in {@code toString()} output.
*/
@SystemProperty(value = "Enables writing sensitive information in toString() output",
defaults = "" + DFLT_TO_STRING_INCLUDE_SENSITIVE)
public static final String IGNITE_TO_STRING_INCLUDE_SENSITIVE = "IGNITE_TO_STRING_INCLUDE_SENSITIVE";
/** Maximum length for {@code toString()} result. */
@SystemProperty(value = "Maximum length for toString() result", type = Integer.class,
defaults = "" + DFLT_TO_STRING_MAX_LENGTH)
public static final String IGNITE_TO_STRING_MAX_LENGTH = "IGNITE_TO_STRING_MAX_LENGTH";
/**
* Limit collection (map, array) elements number to output.
*/
@SystemProperty(value = "Number of collection (map, array) elements to output",
type = Integer.class, defaults = "" + DFLT_TO_STRING_COLLECTION_LIMIT)
public static final String IGNITE_TO_STRING_COLLECTION_LIMIT = "IGNITE_TO_STRING_COLLECTION_LIMIT";
/**
* If this property is set to {@code true} (default) and Ignite is launched
* in verbose mode (see {@link #IGNITE_QUIET}) and no console appenders can be found
* in configuration, then default console appender will be added.
* Set this property to {@code false} if no appenders should be added.
*/
@SystemProperty(value = "If true (default) and Ignite is launched in verbose mode (see IGNITE_QUIET) " +
"and no console appenders can be found in configuration, then default console appender will be added. " +
"Set this property to false if no appenders should be added", defaults = "true")
public static final String IGNITE_CONSOLE_APPENDER = "IGNITE_CONSOLE_APPENDER";
/** Maximum size for exchange history. Default value is {@code 1000}.*/
@SystemProperty(value = "Maximum size for exchange history", type = Integer.class,
defaults = "" + DFLT_EXCHANGE_HISTORY_SIZE)
public static final String IGNITE_EXCHANGE_HISTORY_SIZE = "IGNITE_EXCHANGE_HISTORY_SIZE";
/** */
@SystemProperty(value = "Partition map exchange merge delay in milliseconds",
type = Long.class, defaults = "" + DFLT_EXCHANGE_MERGE_DELAY)
public static final String IGNITE_EXCHANGE_MERGE_DELAY = "IGNITE_EXCHANGE_MERGE_DELAY";
/** PME-free switch explicitly disabled. */
@SystemProperty("Disables PME-free switch")
public static final String IGNITE_PME_FREE_SWITCH_DISABLED = "IGNITE_PME_FREE_SWITCH_DISABLED";
/**
* Name of the system property defining name of command line program.
*/
@SystemProperty(value = "Name of command line program", type = String.class, defaults = DFLT_PROG_NAME)
public static final String IGNITE_PROG_NAME = "IGNITE_PROG_NAME";
/**
* Name of the system property defining success file name. This file
* is used with auto-restarting functionality when Ignite is started
* by supplied <tt>ignite.{bat|sh}</tt> scripts.
*/
@SystemProperty(value = "Success file name. This file is used with auto-restarting functionality " +
"when Ignite is started by supplied ignite.{bat|sh} scripts", type = String.class)
public static final String IGNITE_SUCCESS_FILE = "IGNITE_SUCCESS_FILE";
/**
* The system property sets a system-wide local IP address or hostname to be used by Ignite networking components.
* Once provided, the property overrides all the default local binding settings for Ignite nodes.
* <p>
* Note, that the address can also be changed via
* {@link org.apache.ignite.configuration.IgniteConfiguration#setLocalHost(String)} method.
* However, this system property has bigger priority and overrides the settings set via
* {@link org.apache.ignite.configuration.IgniteConfiguration}.
*/
@SystemProperty(value = "Sets a system-wide local IP address or hostname to be " +
"used by Ignite networking components. Once provided, the property overrides all the default local binding " +
"settings for Ignite nodes. Note, that the address can also be changed via " +
"IgniteConfiguration.setLocalHost(String) method. However, this system property has bigger priority and " +
"overrides the settings set via IgniteConfiguration", type = String.class)
public static final String IGNITE_LOCAL_HOST = "IGNITE_LOCAL_HOST";
/**
* System property to override deployment mode configuration parameter.
* Valid values for property are: PRIVATE, ISOLATED, SHARED or CONTINUOUS.
*
* @see org.apache.ignite.configuration.DeploymentMode
* @see org.apache.ignite.configuration.IgniteConfiguration#getDeploymentMode()
*/
@SystemProperty(value = "Sets deployment mode configuration parameter. Valid " +
"values for property are: PRIVATE, ISOLATED, SHARED or CONTINUOUS", type = DeploymentMode.class)
public static final String IGNITE_DEP_MODE_OVERRIDE = "IGNITE_DEPLOYMENT_MODE_OVERRIDE";
/**
* Property controlling size of buffer holding completed transaction versions. Such buffer
* is used to detect duplicate transaction and has a default value of {@code 102400}. In
* most cases this value is large enough and does not need to be changed.
*/
@SystemProperty(value = "Size of buffer holding completed transaction versions. " +
"Buffer is used to detect duplicate transaction. " +
"In most cases this value is large enough and does not need to be changed",
type = Integer.class, defaults = "" + DFLT_MAX_COMPLETED_TX_CNT)
public static final String IGNITE_MAX_COMPLETED_TX_COUNT = "IGNITE_MAX_COMPLETED_TX_COUNT";
/**
* Transactions that take more time, than value of this property, will be output to log
* with warning level. {@code 0} (default value) disables warning on slow transactions.
*/
@SystemProperty(value = "Transactions that take more time, than value of this property (in milliseconds), " +
"will be output to warnings. 0 disables warnings on slow transactions",
type = Integer.class, defaults = "" + DFLT_SLOW_TX_WARN_TIMEOUT)
public static final String IGNITE_SLOW_TX_WARN_TIMEOUT = "IGNITE_SLOW_TX_WARN_TIMEOUT";
/**
* Specifies maximum number of iterations for deadlock detection procedure.
* If value of this property is less then or equal to zero then deadlock detection will be disabled.
*/
@SystemProperty(value = "Maximum number of iterations for deadlock detection procedure. " +
"If value of this property is less then or equal to zero then deadlock detection will be disabled",
type = Integer.class, defaults = "" + DFLT_TX_DEADLOCK_DETECTION_MAX_ITERS)
public static final String IGNITE_TX_DEADLOCK_DETECTION_MAX_ITERS = "IGNITE_TX_DEADLOCK_DETECTION_MAX_ITERS";
/**
* Specifies timeout for deadlock detection procedure.
*/
@SystemProperty(value = "Timeout for deadlock detection procedure", type = Integer.class,
defaults = "" + DFLT_TX_DEADLOCK_DETECTION_TIMEOUT)
public static final String IGNITE_TX_DEADLOCK_DETECTION_TIMEOUT = "IGNITE_TX_DEADLOCK_DETECTION_TIMEOUT";
/**
* System property to enable pending transaction tracker.
* Affects impact of {@link IgniteSystemProperties#IGNITE_DISABLE_WAL_DURING_REBALANCING} property:
* if this property is set, WAL anyway won't be disabled during rebalancing triggered by baseline topology change.
*/
@SystemProperty(value = "Enables pending transaction tracker. " +
"Affects impact of IGNITE_DISABLE_WAL_DURING_REBALANCING property: if this property is set, " +
"WAL anyway won't be disabled during rebalancing triggered by baseline topology change")
public static final String IGNITE_PENDING_TX_TRACKER_ENABLED = "IGNITE_PENDING_TX_TRACKER_ENABLED";
/**
* System property to override multicast group taken from configuration.
* Used for testing purposes.
*/
@SystemProperty(value = "Overrides multicast group taken from configuration. Used for testing purposes",
type = String.class)
public static final String IGNITE_OVERRIDE_MCAST_GRP = "IGNITE_OVERRIDE_MCAST_GRP";
/**
* System property to override default reflection cache size. Default value is {@code 128}.
*/
@SystemProperty(value = "Overrides default reflection cache size", type = Integer.class,
defaults = "" + DFLT_REFLECTION_CACHE_SIZE)
public static final String IGNITE_REFLECTION_CACHE_SIZE = "IGNITE_REFLECTION_CACHE_SIZE";
/**
* System property to override default job processor maps sizes for finished jobs and
* cancellation requests. Default value is {@code 10240}.
*/
@SystemProperty(value = "Job processor maps sizes for finished jobs and cancellation requests. ",
type = Integer.class, defaults = "" + DFLT_JOBS_HISTORY_SIZE)
public static final String IGNITE_JOBS_HISTORY_SIZE = "IGNITE_JOBS_HISTORY_SIZE";
/**
* System property to override default job metrics processor property defining
* concurrency level for structure holding job metrics snapshots.
* Default value is {@code 64}.
*
* @deprecated Check the {@link ReadOnlyMetricRegistry} with "name=compute.jobs" instead.
*/
@Deprecated
@SystemProperty(value = "Job metrics processor property defining concurrency level " +
"for structure holding job metrics snapshots", type = Integer.class,
defaults = "" + DFLT_JOBS_METRICS_CONCURRENCY_LEVEL)
public static final String IGNITE_JOBS_METRICS_CONCURRENCY_LEVEL = "IGNITE_JOBS_METRICS_CONCURRENCY_LEVEL";
/**
* System property to hold optional configuration URL.
*/
@SystemProperty(value = "Configuration URL", type = String.class)
public static final String IGNITE_CONFIG_URL = "IGNITE_CONFIG_URL";
/** System property to hold SSH host for visor-started nodes. */
@SystemProperty(value = "SSH host name for visor-started nodes", type = String.class)
public static final String IGNITE_SSH_HOST = "IGNITE_SSH_HOST";
/**
* System property to enable experimental commands in control.sh script.
* @deprecated Use "--enable-experimental" parameter instead.
*/
@Deprecated
@SystemProperty("Enables experimental commands in control.sh script")
public static final String IGNITE_ENABLE_EXPERIMENTAL_COMMAND = "IGNITE_ENABLE_EXPERIMENTAL_COMMAND";
/** System property to hold SSH user name for visor-started nodes. */
@SystemProperty(value = "SSH user name for visor-started nodes", type = String.class)
public static final String IGNITE_SSH_USER_NAME = "IGNITE_SSH_USER_NAME";
/** System property to hold preload resend timeout for evicted partitions. */
@SystemProperty(value = "Preload resend timeout for evicted partitions in milliseconds", type = Long.class,
defaults = "" + DFLT_PRELOAD_RESEND_TIMEOUT)
public static final String IGNITE_PRELOAD_RESEND_TIMEOUT = "IGNITE_PRELOAD_RESEND_TIMEOUT";
/**
* System property to specify how often in milliseconds marshal buffers
* should be rechecked and potentially trimmed. Default value is {@code 10,000ms}.
*/
@SystemProperty(value = "How often in milliseconds marshal buffers should be rechecked and potentially trimmed",
type = Long.class, defaults = "" + DFLT_MARSHAL_BUFFERS_RECHECK)
public static final String IGNITE_MARSHAL_BUFFERS_RECHECK = "IGNITE_MARSHAL_BUFFERS_RECHECK";
/**
* System property to specify per thread binary allocator chunk pool size. Default value is {@code 32}.
*/
@SystemProperty(value = "Per thread binary allocator chunk pool size",
type = Integer.class, defaults = "" + DFLT_MARSHAL_BUFFERS_PER_THREAD_POOL_SIZE)
public static final String IGNITE_MARSHAL_BUFFERS_PER_THREAD_POOL_SIZE = "IGNITE_MARSHAL_BUFFERS_PER_THREAD_POOL_SIZE";
/**
* System property to disable {@link HostnameVerifier} for SSL connections.
* Can be used for development with self-signed certificates. Default value is {@code false}.
*/
@SystemProperty("Disables HostnameVerifier for SSL connections. " +
"Can be used for development with self-signed certificates")
public static final String IGNITE_DISABLE_HOSTNAME_VERIFIER = "IGNITE_DISABLE_HOSTNAME_VERIFIER";
/**
* System property to disable buffered communication if node sends less messages count than
* specified by this property. Default value is {@code 512}.
*
* @deprecated Not used anymore.
*/
@Deprecated
@SystemProperty(value = "Disables buffered communication if node sends less messages count " +
"than specified by this property", type = Integer.class, defaults = "512")
public static final String IGNITE_MIN_BUFFERED_COMMUNICATION_MSG_CNT = "IGNITE_MIN_BUFFERED_COMMUNICATION_MSG_CNT";
/**
* Flag that will force Ignite to fill memory block with some recognisable pattern right before
* this memory block is released. This will help to recognize cases when already released memory is accessed.
*/
@SystemProperty("Force Ignite to fill memory block with some recognisable pattern right before this " +
"memory block is released. This will help to recognize cases when already released memory is accessed")
public static final String IGNITE_OFFHEAP_SAFE_RELEASE = "IGNITE_OFFHEAP_SAFE_RELEASE";
/** Maximum size for atomic cache queue delete history (default is 200 000 entries per partition). */
@SystemProperty(value = "Maximum size for atomic cache queue delete history",
type = Integer.class, defaults = "" + DFLT_ATOMIC_CACHE_DELETE_HISTORY_SIZE + " per partition")
public static final String IGNITE_ATOMIC_CACHE_DELETE_HISTORY_SIZE = "IGNITE_ATOMIC_CACHE_DELETE_HISTORY_SIZE";
/** Ttl of removed cache entries (ms). */
@SystemProperty(value = "Ttl of removed cache entries in milliseconds",
type = Long.class, defaults = "" + DFLT_CACHE_REMOVE_ENTRIES_TTL)
public static final String IGNITE_CACHE_REMOVED_ENTRIES_TTL = "IGNITE_CACHE_REMOVED_ENTRIES_TTL";
/**
* Comma separated list of addresses in format "10.100.22.100:45000,10.100.22.101:45000".
* Makes sense only for {@link org.apache.ignite.spi.discovery.tcp.ipfinder.vm.TcpDiscoveryVmIpFinder}.
*/
@SystemProperty(value = "Comma separated list of addresses in format " +
"\"10.100.22.100:45000,10.100.22.101:45000\". Used only for " +
"org.apache.ignite.spi.discovery.tcp.ipfinder.vm.TcpDiscoveryVmIpFinder", type = String.class)
public static final String IGNITE_TCP_DISCOVERY_ADDRESSES = "IGNITE_TCP_DISCOVERY_ADDRESSES";
/**
* Flag indicating whether performance suggestions output on start should be disabled.
*/
@SystemProperty("Disables performance suggestions output on start")
public static final String IGNITE_PERFORMANCE_SUGGESTIONS_DISABLED = "IGNITE_PERFORMANCE_SUGGESTIONS_DISABLED";
/**
* Flag indicating whether atomic operations allowed for use inside transactions.
*/
@SystemProperty(value = "Allows atomic operations inside transactions",
defaults = "true")
public static final String IGNITE_ALLOW_ATOMIC_OPS_IN_TX = "IGNITE_ALLOW_ATOMIC_OPS_IN_TX";
/**
* Atomic cache deferred update response buffer size.
*/
@SystemProperty(value = "Atomic cache deferred update response buffer size", type = Integer.class,
defaults = "" + DFLT_ATOMIC_DEFERRED_ACK_BUFFER_SIZE)
public static final String IGNITE_ATOMIC_DEFERRED_ACK_BUFFER_SIZE = "IGNITE_ATOMIC_DEFERRED_ACK_BUFFER_SIZE";
/**
* Atomic cache deferred update timeout.
*/
@SystemProperty(value = "Atomic cache deferred update timeout", type = Integer.class,
defaults = "" + DFLT_ATOMIC_DEFERRED_ACK_TIMEOUT)
public static final String IGNITE_ATOMIC_DEFERRED_ACK_TIMEOUT = "IGNITE_ATOMIC_DEFERRED_ACK_TIMEOUT";
/**
* Atomic cache deferred update timeout.
*/
@SystemProperty(value = "Atomic cache deferred update timeout", type = Integer.class,
defaults = "" + DFLT_ATOMIC_CACHE_QUERY_RETRY_TIMEOUT)
public static final String IGNITE_ATOMIC_CACHE_QUEUE_RETRY_TIMEOUT = "IGNITE_ATOMIC_CACHE_QUEUE_RETRY_TIMEOUT";
/**
* One phase commit deferred ack request timeout.
*/
@SystemProperty(value = "One phase commit deferred ack request timeout", type = Integer.class,
defaults = "" + DFLT_DEFERRED_ONE_PHASE_COMMIT_ACK_REQUEST_TIMEOUT)
public static final String IGNITE_DEFERRED_ONE_PHASE_COMMIT_ACK_REQUEST_TIMEOUT =
"IGNITE_DEFERRED_ONE_PHASE_COMMIT_ACK_REQUEST_TIMEOUT";
/**
* One phase commit deferred ack request buffer size.
*/
@SystemProperty(value = "One phase commit deferred ack request buffer size", type = Integer.class,
defaults = "" + DFLT_DEFERRED_ONE_PHASE_COMMIT_ACK_REQUEST_BUFFER_SIZE)
public static final String IGNITE_DEFERRED_ONE_PHASE_COMMIT_ACK_REQUEST_BUFFER_SIZE =
"IGNITE_DEFERRED_ONE_PHASE_COMMIT_ACK_REQUEST_BUFFER_SIZE";
/**
* If this property set then debug console will be opened for H2 indexing SPI.
*
* @deprecated Since 2.8. H2 console is no longer supported.
*/
@Deprecated
@SystemProperty(value = "Enables debug console for H2 indexing SPI",
type = String.class)
public static final String IGNITE_H2_DEBUG_CONSOLE = "IGNITE_H2_DEBUG_CONSOLE";
/**
* This property allows to specify user defined port which H2 indexing SPI will use
* to start H2 debug console on. If this property is not set or set to 0, H2 debug
* console will use system-provided dynamic port.
* This property is only relevant when {@link #IGNITE_H2_DEBUG_CONSOLE} property is set.
*
* @deprecated Since 2.8. H2 console is no longer supported.
*/
@Deprecated
@SystemProperty(value = "User defined port which H2 indexing SPI will use to start H2 debug console on. " +
"If this property is not set or set to 0, H2 debug console will use system-provided dynamic port. " +
"This property is only relevant when " + IGNITE_H2_DEBUG_CONSOLE + " property is set", type = Integer.class)
public static final String IGNITE_H2_DEBUG_CONSOLE_PORT = "IGNITE_H2_DEBUG_CONSOLE_PORT";
/**
* If this property is set to {@code true} then shared memory space native debug will be enabled.
*/
@SystemProperty("Enables native debug of the shared memory space")
public static final String IGNITE_IPC_SHMEM_SPACE_DEBUG = "IGNITE_IPC_SHMEM_SPACE_DEBUG";
/**
* Property allowing to skip configuration consistency checks.
*/
@SystemProperty("Skip configuration consistency checks")
public static final String IGNITE_SKIP_CONFIGURATION_CONSISTENCY_CHECK =
"IGNITE_SKIP_CONFIGURATION_CONSISTENCY_CHECK";
/**
* Flag indicating whether validation of keys put to cache should be disabled.
*
* @deprecated Since 2.10 Obsolete because of common use of binary marshaller.
*/
@Deprecated
@SystemProperty("Disables validation of keys put to cache")
public static final String IGNITE_CACHE_KEY_VALIDATION_DISABLED = "IGNITE_CACHE_KEY_VALIDATION_DISABLED";
/**
* Environment variable to override logging directory that has been set in logger configuration.
*/
@SystemProperty(value = "Logging directory. Overrides configuration value", type = String.class)
public static final String IGNITE_LOG_DIR = "IGNITE_LOG_DIR";
/**
* Environment variable to set work directory.
* The property {@link org.apache.ignite.configuration.IgniteConfiguration#setWorkDirectory} has higher priority.
*/
@SystemProperty(value = "Work directory. The property IgniteConfiguration.setWorkDirectory has higher priority",
type = String.class)
public static final String IGNITE_WORK_DIR = "IGNITE_WORK_DIR";
/**
* If this property is set to {@code true} then Ignite will append
* hash code of {@link Ignite} class as hex string and append
* JVM name returned by {@link RuntimeMXBean#getName()}.
* <p>
* This may be helpful when running Ignite in some application server
* clusters or similar environments to avoid MBean name collisions.
* <p>
* Default is {@code false}.
*/
@SystemProperty("Enables Ignite to append hash code of Ignite class as hex string and append JVM name " +
"returned by RuntimeMXBean.getName(). This may be helpful when running Ignite in some application server " +
"clusters or similar environments to avoid MBean name collisions")
public static final String IGNITE_MBEAN_APPEND_JVM_ID = "IGNITE_MBEAN_APPEND_JVM_ID";
/**
* If this property is set to {@code true} then Ignite will append
* hash code of class loader to MXBean name.
* <p>
* Default is {@code true}.
*/
@SystemProperty(value = "Enables Ignite to append hash code of class loader to MXBean name",
defaults = "" + DFLT_MBEAN_APPEND_CLASS_LOADER_ID)
public static final String IGNITE_MBEAN_APPEND_CLASS_LOADER_ID = "IGNITE_MBEAN_APPEND_CLASS_LOADER_ID";
/**
* If property is set to {@code true}, then Ignite will disable MBeans registration.
* This may be helpful if MBeans are not allowed e.g. for security reasons.
*
* Default is {@code false}
*/
@SystemProperty("Disable MBeans registration. This may be helpful if MBeans are not allowed " +
"e.g. for security reasons")
public static final String IGNITE_MBEANS_DISABLED = "IGNITE_MBEANS_DISABLED";
/**
* If property is set to {@code true}, then test features will be enabled.
*
* Default is {@code false}.
*/
@SystemProperty("Enables test features")
public static final String IGNITE_TEST_FEATURES_ENABLED = "IGNITE_TEST_FEATURES_ENABLED";
/**
* Property controlling size of buffer holding last exception. Default value of {@code 1000}.
*/
@SystemProperty(value = "Size of buffer holding last exception", type = Integer.class,
defaults = "" + DEFAULT_QUEUE_SIZE)
public static final String IGNITE_EXCEPTION_REGISTRY_MAX_SIZE = "IGNITE_EXCEPTION_REGISTRY_MAX_SIZE";
/**
* Property controlling default behavior of cache client flag.
*/
@SystemProperty("Starts node in client mode. Have lower priority than configuration value")
public static final String IGNITE_CACHE_CLIENT = "IGNITE_CACHE_CLIENT";
/**
* Property controlling whether CacheManager will start grid with isolated IP finder when default URL
* is passed in. This is needed to pass TCK tests which use default URL and assume isolated cache managers
* for different class loaders.
*/
@SystemProperty(value = "Enables CacheManager to start grid with isolated " +
"IP finder when default URL is passed in. This is needed to pass TCK tests which use default URL and " +
"assume isolated cache managers for different class loaders", defaults = "" + DFLT_JCACHE_DEFAULT_ISOLATED)
public static final String IGNITE_JCACHE_DEFAULT_ISOLATED = "IGNITE_CACHE_CLIENT";
/**
* Property controlling maximum number of SQL result rows which can be fetched into a merge table.
* If there are less rows than this threshold then multiple passes throw a table will be possible,
* otherwise only one pass (e.g. only result streaming is possible).
*/
@SystemProperty(value = "Maximum number of SQL result rows which can be fetched into a merge table. " +
"If there are less rows than this threshold then multiple passes throw a table will be possible, " +
"otherwise only one pass (e.g. only result streaming is possible)",
type = Integer.class, defaults = "10000")
public static final String IGNITE_SQL_MERGE_TABLE_MAX_SIZE = "IGNITE_SQL_MERGE_TABLE_MAX_SIZE";
/**
* Property controlling number of SQL result rows that will be fetched into a merge table at once before
* applying binary search for the bounds.
*/
@SystemProperty(value = "Number of SQL result rows that will be fetched into a merge table at once " +
"before applying binary search for the bounds", type = Integer.class, defaults = "1024")
public static final String IGNITE_SQL_MERGE_TABLE_PREFETCH_SIZE = "IGNITE_SQL_MERGE_TABLE_PREFETCH_SIZE";
/** Disable fallback to H2 SQL parser if the internal SQL parser fails to parse the statement. */
@SystemProperty("Disables fallback to H2 SQL parser if the internal SQL parser fails to " +
"parse the statement")
public static final String IGNITE_SQL_PARSER_DISABLE_H2_FALLBACK = "IGNITE_SQL_PARSER_DISABLE_H2_FALLBACK";
/**
* Force all SQL queries to be processed lazily regardless of what clients request.
*
* @deprecated Since version 2.8.
*/
@Deprecated
@SystemProperty("Force all SQL queries to be processed lazily regardless of what clients request")
public static final String IGNITE_SQL_FORCE_LAZY_RESULT_SET = "IGNITE_SQL_FORCE_LAZY_RESULT_SET";
/** Disable SQL system views. */
@SystemProperty("Disables SQL system views")
public static final String IGNITE_SQL_DISABLE_SYSTEM_VIEWS = "IGNITE_SQL_DISABLE_SYSTEM_VIEWS";
/** SQL retry timeout. */
@SystemProperty(value = "SQL retry timeout in milliseconds", type = Long.class, defaults = "30 seconds")
public static final String IGNITE_SQL_RETRY_TIMEOUT = "IGNITE_SQL_RETRY_TIMEOUT";
/** Enable backward compatible handling of UUID through DDL. */
@SystemProperty("Enables backward compatible handling of UUID through DDL")
public static final String IGNITE_SQL_UUID_DDL_BYTE_FORMAT = "IGNITE_SQL_UUID_DDL_BYTE_FORMAT";
/** Maximum size for affinity assignment history. */
@SystemProperty(value = "Maximum size for affinity assignment history", type = Integer.class,
defaults = "" + DFLT_AFFINITY_HISTORY_SIZE)
public static final String IGNITE_AFFINITY_HISTORY_SIZE = "IGNITE_AFFINITY_HISTORY_SIZE";
/** Maximum size for discovery messages history. */
@SystemProperty(value = "Maximum size for discovery messages history", type = Integer.class,
defaults = "" + DFLT_DISCOVERY_HISTORY_SIZE)
public static final String IGNITE_DISCOVERY_HISTORY_SIZE = "IGNITE_DISCOVERY_HISTORY_SIZE";
/** Maximum number of discovery message history used to support client reconnect. */
@SystemProperty(value = "Maximum number of discovery message history used to support client reconnect",
type = Integer.class, defaults = "" + DFLT_DISCOVERY_CLIENT_RECONNECT_HISTORY_SIZE)
public static final String IGNITE_DISCOVERY_CLIENT_RECONNECT_HISTORY_SIZE =
"IGNITE_DISCOVERY_CLIENT_RECONNECT_HISTORY_SIZE";
/** Logging a warning message when metrics quantity exceeded a specified number. */
@SystemProperty(value = "Enables logging a warning message when metrics quantity exceeded a specified number",
type = Integer.class, defaults = "" + DFLT_DISCOVERY_METRICS_QNT_WARN)
public static final String IGNITE_DISCOVERY_METRICS_QNT_WARN =
"IGNITE_DISCOVERY_METRICS_QNT_WARN";
/** Time interval that indicates that client reconnect throttle must be reset to zero. 2 minutes by default. */
@SystemProperty(value = "Time interval in milliseconds that indicates client reconnect throttle " +
"must be reset to zero", type = Long.class, defaults = "" + DFLT_THROTTLE_RECONNECT_RESET_TIMEOUT_INTERVAL)
public static final String CLIENT_THROTTLE_RECONNECT_RESET_TIMEOUT_INTERVAL =
"CLIENT_THROTTLE_RECONNECT_RESET_TIMEOUT_INTERVAL";
/** Number of cache operation retries in case of topology exceptions. */
@SystemProperty(value = "Number of cache operation retries in case of topology exceptions", type = Integer.class,
defaults = "" + DFLT_CACHE_RETRIES_COUNT)
public static final String IGNITE_CACHE_RETRIES_COUNT = "IGNITE_CACHE_RETRIES_COUNT";
/** If this property is set to {@code true} then Ignite will log thread dump in case of partition exchange timeout. */
@SystemProperty("Enables logging thread dump in case of partition exchange timeout")
public static final String IGNITE_THREAD_DUMP_ON_EXCHANGE_TIMEOUT = "IGNITE_THREAD_DUMP_ON_EXCHANGE_TIMEOUT";
/** */
@SystemProperty("Enables dump SPI stats to diagnostic log")
public static final String IGNITE_IO_DUMP_ON_TIMEOUT = "IGNITE_IO_DUMP_ON_TIMEOUT";
/** */
@SystemProperty(value = "Enables diagnostic flag", defaults = "" + DFLT_DIAGNOSTIC_ENABLED)
public static final String IGNITE_DIAGNOSTIC_ENABLED = "IGNITE_DIAGNOSTIC_ENABLED";
/** Cache operations that take more time than value of this property will be output to log. Set to {@code 0} to disable. */
@SystemProperty(value = "Cache operations that take more time than value of this property will be " +
"output to log. Set to 0 to disable", type = Long.class, defaults = "" + DFLT_LONG_OPERATIONS_DUMP_TIMEOUT)
public static final String IGNITE_LONG_OPERATIONS_DUMP_TIMEOUT = "IGNITE_LONG_OPERATIONS_DUMP_TIMEOUT";
/** Upper time limit between long running/hanging operations debug dumps. */
@SystemProperty(value = "Upper time limit between long running/hanging operations debug dumps " +
"in milliseconds", type = Long.class, defaults = "" + DFLT_LONG_OPERATIONS_DUMP_TIMEOUT_LIMIT)
public static final String IGNITE_LONG_OPERATIONS_DUMP_TIMEOUT_LIMIT = "IGNITE_LONG_OPERATIONS_DUMP_TIMEOUT_LIMIT";
/** JDBC driver cursor remove delay. */
@SystemProperty(value = "JDBC driver cursor remove delay in milliseconds", type = Long.class,
defaults = "10 minutes")
public static final String IGNITE_JDBC_DRIVER_CURSOR_REMOVE_DELAY = "IGNITE_JDBC_DRIVER_CURSOR_RMV_DELAY";
/** Long-long offheap map load factor. */
@SystemProperty(value = "Long-long offheap map load factor", type = Float.class,
defaults = "" + DFLT_LONG_LONG_HASH_MAP_LOAD_FACTOR)
public static final String IGNITE_LONG_LONG_HASH_MAP_LOAD_FACTOR = "IGNITE_LONG_LONG_HASH_MAP_LOAD_FACTOR";
/** Maximum number of nested listener calls before listener notification becomes asynchronous. */
@SystemProperty(value = "Maximum number of nested listener calls before listener notification " +
"becomes asynchronous", type = Integer.class, defaults = "" + DFLT_MAX_NESTED_LISTENER_CALLS)
public static final String IGNITE_MAX_NESTED_LISTENER_CALLS = "IGNITE_MAX_NESTED_LISTENER_CALLS";
/** Indicating whether local store keeps primary only. Backward compatibility flag. */
@SystemProperty("Enables local store keeps primary only. Backward compatibility flag")
public static final String IGNITE_LOCAL_STORE_KEEPS_PRIMARY_ONLY = "IGNITE_LOCAL_STORE_KEEPS_PRIMARY_ONLY";
/**
* Manages {@link OptimizedMarshaller} behavior of {@code serialVersionUID} computation for
* {@link Serializable} classes.
*/
@SystemProperty("Manages OptimizedMarshaller behavior of serialVersionUID computation " +
"for Serializable classes")
public static final String IGNITE_OPTIMIZED_MARSHALLER_USE_DEFAULT_SUID =
"IGNITE_OPTIMIZED_MARSHALLER_USE_DEFAULT_SUID";
/**
* Manages type of serialization mechanism for {@link String} that is marshalled/unmarshalled by BinaryMarshaller.
* Should be used for cases when a String contains a surrogate symbol without its pair one. This is frequently used
* in algorithms that encrypts data in String format.
*/
@SystemProperty("Manages type of serialization mechanism for String that is " +
"marshalled/unmarshalled by BinaryMarshaller. Should be used for cases when a String contains a surrogate " +
"symbol without its pair one. This is frequently used in algorithms that encrypts data in String format")
public static final String IGNITE_BINARY_MARSHALLER_USE_STRING_SERIALIZATION_VER_2 =
"IGNITE_BINARY_MARSHALLER_USE_STRING_SERIALIZATION_VER_2";
/** Defines path to the file that contains list of classes allowed to safe deserialization.*/
@SystemProperty(value = "Path to the file that contains list of classes allowed to safe deserialization",
type = String.class)
public static final String IGNITE_MARSHALLER_WHITELIST = "IGNITE_MARSHALLER_WHITELIST";
/** Defines path to the file that contains list of classes disallowed to safe deserialization.*/
@SystemProperty(value = "Path to the file that contains list of classes disallowed to safe deserialization",
type = String.class)
public static final String IGNITE_MARSHALLER_BLACKLIST = "IGNITE_MARSHALLER_BLACKLIST";
/**
* If set to {@code true}, then default selected keys set is used inside
* {@code GridNioServer} which lead to some extra garbage generation when
* processing selected keys.
* <p>
* Default value is {@code false}. Should be switched to {@code true} if there are
* any problems in communication layer.
*/
@SystemProperty("Enables default selected keys set to be used inside GridNioServer " +
"which lead to some extra garbage generation when processing selected keys. " +
"Should be switched to true if there are any problems in communication layer")
public static final String IGNITE_NO_SELECTOR_OPTS = "IGNITE_NO_SELECTOR_OPTS";
/**
* System property to specify period in milliseconds between calls of the SQL statements cache cleanup task.
* <p>
* Cleanup tasks clears cache for terminated threads and for threads which did not perform SQL queries within
* timeout configured via {@link #IGNITE_H2_INDEXING_CACHE_THREAD_USAGE_TIMEOUT} property.
* <p>
* Default value is {@code 10,000ms}.
*/
@SystemProperty(value = "Period in milliseconds between calls of the SQL " +
"statements cache cleanup task. Cleanup tasks clears cache for terminated threads and for threads which did " +
"not perform SQL queries within timeout configured via IGNITE_H2_INDEXING_CACHE_THREAD_USAGE_TIMEOUT" +
" property", type = Long.class, defaults = "10 seconds")
public static final String IGNITE_H2_INDEXING_CACHE_CLEANUP_PERIOD = "IGNITE_H2_INDEXING_CACHE_CLEANUP_PERIOD";
/**
* System property to specify timeout in milliseconds after which thread's SQL statements cache is cleared by
* cleanup task if the thread does not perform any query.
* <p>
* Default value is {@code 600,000ms}.
*/
@SystemProperty(value = "Timeout in milliseconds after which thread's SQL statements cache is cleared " +
"by cleanup task if the thread does not perform any query",
type = Long.class, defaults = "10 minutes")
public static final String IGNITE_H2_INDEXING_CACHE_THREAD_USAGE_TIMEOUT =
"IGNITE_H2_INDEXING_CACHE_THREAD_USAGE_TIMEOUT";
/**
* Manages backward compatibility of {@link StreamTransformer#from(CacheEntryProcessor)} method.
* <p>
* If the property is {@code true}, then the wrapped {@link CacheEntryProcessor} won't be able to be loaded over
* P2P class loading.
* <p>
* If the property is {@code false}, then another implementation of {@link StreamTransformer} will be returned,
* that fixes P2P class loading for {@link CacheEntryProcessor}, but it will be incompatible with old versions
* of Ignite.
*/
@SystemProperty("Enables backward compatibility of StreamTransformer.from(CacheEntryProcessor) method. " +
"If the property is true, then the wrapped CacheEntryProcessor won't be able to be loaded " +
"over P2P class loading. If the property is false, then another implementation of StreamTransformer " +
"will be returned, that fixes P2P class loading for CacheEntryProcessor, " +
"but it will be incompatible with old versions of Ignite")
public static final String IGNITE_STREAM_TRANSFORMER_COMPATIBILITY_MODE =
"IGNITE_STREAM_TRANSFORMER_COMPATIBILITY_MODE";
/**
* When set to {@code true} tree-based data structures - {@code TreeMap} and {@code TreeSet} - will not be
* wrapped into special holders introduced to overcome serialization issue caused by missing {@code Comparable}
* interface on {@code BinaryObject}.
* <p>
* @deprecated Should be removed in Apache Ignite 2.0.
*/
@Deprecated
@SystemProperty("If enabled then tree-based data structures - TreeMap and TreeSet - will " +
"not be wrapped into special holders introduced to overcome serialization issue caused by missing " +
"Comparable interface on BinaryObject")
public static final String IGNITE_BINARY_DONT_WRAP_TREE_STRUCTURES = "IGNITE_BINARY_DONT_WRAP_TREE_STRUCTURES";
/**
* When set to {@code true}, for consistent id will calculate by host name, without port, and you can use
* only one node for host in cluster.
*/
@SystemProperty("Enables consistent ID to calculate by host name, without port, " +
"and you can use only one node for host in cluster")
public static final String IGNITE_CONSISTENT_ID_BY_HOST_WITHOUT_PORT = "IGNITE_CONSISTENT_ID_BY_HOST_WITHOUT_PORT";
/**
* System property to specify consistent id of Ignite node.
* <p>
* Value of the system property will overwrite matched property
* {@link org.apache.ignite.configuration.IgniteConfiguration#setConsistentId(Serializable)} in configuration.
*/
@SystemProperty(value = "Consistent ID of Ignite node. Value of the " +
"system property will overwrite matched property IgniteConfiguration.setConsistentId(Serializable) " +
"in configuration", type = String.class)
public static final String IGNITE_OVERRIDE_CONSISTENT_ID = "IGNITE_OVERRIDE_CONSISTENT_ID";
/** */
@SystemProperty(value = "IO balance period in milliseconds", type = Long.class,
defaults = "" + DFLT_IO_BALANCE_PERIOD)
public static final String IGNITE_IO_BALANCE_PERIOD = "IGNITE_IO_BALANCE_PERIOD";
/**
* When set to {@code true} fields are written by BinaryMarshaller in sorted order. Otherwise
* the natural order is used.
* <p>
* NOTICE: Should be the default in Apache Ignite 3.0
*/
@SystemProperty("Enables fields to be written by BinaryMarshaller in sorted order. " +
"By default, the natural order is used")
public static final String IGNITE_BINARY_SORT_OBJECT_FIELDS = "IGNITE_BINARY_SORT_OBJECT_FIELDS";
/**
* Whether Ignite can access unaligned memory addresses.
* <p>
* Defaults to {@code false}, meaning that unaligned access will be performed only on x86 architecture.
*/
@SystemProperty("Whether Ignite can access unaligned memory addresses. Defaults to false, " +
"meaning that unaligned access will be performed only on x86 architecture")
public static final String IGNITE_MEMORY_UNALIGNED_ACCESS = "IGNITE_MEMORY_UNALIGNED_ACCESS";
/**
* When unsafe memory copy if performed below this threshold, Ignite will do it on per-byte basis instead of
* calling to Unsafe.copyMemory().
* <p>
* Defaults to 0, meaning that threshold is disabled.
*/
@SystemProperty(value = "When unsafe memory copy if performed below this threshold, Ignite will do it " +
"on per-byte basis instead of calling to Unsafe.copyMemory(). 0 disables threshold",
type = Long.class, defaults = "" + DFLT_MEMORY_PER_BYTE_COPY_THRESHOLD)
public static final String IGNITE_MEMORY_PER_BYTE_COPY_THRESHOLD = "IGNITE_MEMORY_PER_BYTE_COPY_THRESHOLD";
/**
* When set to {@code true} BinaryObject will be unwrapped before passing to IndexingSpi to preserve
* old behavior query processor with IndexingSpi.
* <p>
* @deprecated Should be removed in Apache Ignite 2.0.
*/
@Deprecated
@SystemProperty("If enabled BinaryObject will be unwrapped before passing to " +
"IndexingSpi to preserve old behavior query processor with IndexingSpi")
public static final String IGNITE_UNWRAP_BINARY_FOR_INDEXING_SPI = "IGNITE_UNWRAP_BINARY_FOR_INDEXING_SPI";
/**
* System property to specify maximum payload size in bytes for {@code H2TreeIndex}.
* <p>
* Defaults to {@code 0}, meaning that inline index store is disabled.
*/
@SystemProperty(value = "Maximum payload size in bytes for H2TreeIndex. " +
"0 means that inline index store is disabled", type = Integer.class, defaults = "10")
public static final String IGNITE_MAX_INDEX_PAYLOAD_SIZE = "IGNITE_MAX_INDEX_PAYLOAD_SIZE";
/**
* Time interval for calculating rebalance rate statistics, in milliseconds. Defaults to 60000.
* @deprecated Use {@link MetricsMxBean#configureHitRateMetric(String, long)} instead.
*/
@Deprecated
@SystemProperty(value = "Time interval for calculating rebalance rate statistics, in milliseconds",
type = Integer.class, defaults = "60000")
public static final String IGNITE_REBALANCE_STATISTICS_TIME_INTERVAL = "IGNITE_REBALANCE_STATISTICS_TIME_INTERVAL";
/**
* When cache has entries with expired TTL, each user operation will also remove this amount of expired entries.
* Defaults to {@code 5}.
*/
@SystemProperty(value = "When cache has entries with expired TTL, each user operation will also " +
"remove this amount of expired entries", type = Integer.class, defaults = "" + DFLT_TTL_EXPIRE_BATCH_SIZE)
public static final String IGNITE_TTL_EXPIRE_BATCH_SIZE = "IGNITE_TTL_EXPIRE_BATCH_SIZE";
/**
* Indexing discovery history size. Protects from duplicate messages maintaining the list of IDs of recently
* arrived discovery messages.
* <p>
* Defaults to {@code 1000}.
*/
@SystemProperty(value = "Indexing discovery history size. Protects from duplicate messages " +
"maintaining the list of IDs of recently arrived discovery messages", type = Integer.class,
defaults = "" + DFLT_INDEXING_DISCOVERY_HISTORY_SIZE)
public static final String IGNITE_INDEXING_DISCOVERY_HISTORY_SIZE = "IGNITE_INDEXING_DISCOVERY_HISTORY_SIZE";
/** Cache start size for on-heap maps. Defaults to 4096. */
@SystemProperty(value = "Cache start size for on-heap maps", type = Integer.class,
defaults = "" + DFLT_CACHE_START_SIZE)
public static final String IGNITE_CACHE_START_SIZE = "IGNITE_CACHE_START_SIZE";
/** */
@SystemProperty("Enables local start all existing caches on client node start")
public static final String IGNITE_START_CACHES_ON_JOIN = "IGNITE_START_CACHES_ON_JOIN";
/**
* Skip CRC calculation flag.
*/
@SystemProperty("Skip CRC calculation flag")
public static final String IGNITE_PDS_SKIP_CRC = "IGNITE_PDS_SKIP_CRC";
/**
* WAL rebalance threshold.
*/
@Deprecated
@SystemProperty(value = "PDS partition destroy checkpoint delay", type = Integer.class)
public static final String IGNITE_PDS_PARTITION_DESTROY_CHECKPOINT_DELAY =
"IGNITE_PDS_PARTITION_DESTROY_CHECKPOINT_DELAY";
/**
* WAL rebalance threshold.
* @deprecated use Distributed MetaStorage property {@code historical.rebalance.threshold}.
*/
@Deprecated
@SystemProperty(value = "WAL rebalance threshold", type = Integer.class,
defaults = "" + DFLT_PDS_WAL_REBALANCE_THRESHOLD)
public static final String IGNITE_PDS_WAL_REBALANCE_THRESHOLD = "IGNITE_PDS_WAL_REBALANCE_THRESHOLD";
/**
* Prefer historical rebalance if there's enough history regardless off all heuristics.
* This property is intended for integration or performance tests.
* Default is {@code false}.
*/
@SystemProperty("Prefer historical rebalance if there's enough history regardless off all heuristics. " +
"This property is intended for integration or performance tests")
public static final String IGNITE_PREFER_WAL_REBALANCE = "IGNITE_PREFER_WAL_REBALANCE";
/** Ignite page memory concurrency level. */
@SystemProperty(value = "Ignite page memory concurrency level", type = Integer.class)
public static final String IGNITE_OFFHEAP_LOCK_CONCURRENCY_LEVEL = "IGNITE_OFFHEAP_LOCK_CONCURRENCY_LEVEL";
/**
* When set to {@code true}, Ignite switches to compatibility mode with versions that don't
* support service security permissions. In this case security permissions will be ignored
* (if they set).
* <p>
* Default is {@code false}, which means that service security permissions will be respected.
* </p>
*/
@SystemProperty("Enables Ignite to switch to compatibility mode with versions that " +
"don't support service security permissions. In this case security permissions will be ignored (if they set)." +
" Default is false, which means that service security permissions will be respected")
public static final String IGNITE_SECURITY_COMPATIBILITY_MODE = "IGNITE_SECURITY_COMPATIBILITY_MODE";
/**
* Ignite cluster name.
* <p>
* Defaults to utility cache deployment ID..
*/
@SystemProperty(value = "Ignite cluster name. Defaults to utility cache deployment ID", type = String.class)
public static final String IGNITE_CLUSTER_NAME = "IGNITE_CLUSTER_NAME";
/**
* When client cache is started or closed special discovery message is sent to notify cluster (for example this is
* needed for {@link ClusterGroup#forCacheNodes(String)} API. This timeout specifies how long to wait
* after client cache start/close before sending this message. If during this timeout another client
* cache changed, these events are combined into single message.
* <p>
* Default is 10 seconds.
*/
@SystemProperty(value = "When client cache is started or closed special discovery message is sent " +
"to notify cluster (for example this is needed for ClusterGroup.forCacheNodes(String) API. This timeout " +
"in milliseconds specifies how long to wait after client cache start/close before sending this message. If " +
"during this timeout another client cache changed, these events are combined into single message",
type = Long.class, defaults = "" + DFLT_CLIENT_CACHE_CHANGE_MESSAGE_TIMEOUT)
public static final String IGNITE_CLIENT_CACHE_CHANGE_MESSAGE_TIMEOUT =
"IGNITE_CLIENT_CACHE_CHANGE_MESSAGE_TIMEOUT";
/**
* If a partition release future completion time during an exchange exceeds this threshold, the contents of
* the future will be dumped to the log on exchange. Default is {@code 0} (disabled).
*/
@SystemProperty(value = "If a partition release future completion time during an exchange exceeds " +
"this threshold (in milliseconds), the contents of the future will be dumped to the log on exchange. " +
"0 means disabled", type = Integer.class, defaults = "" + DFLT_PARTITION_RELEASE_FUTURE_DUMP_THRESHOLD)
public static final String IGNITE_PARTITION_RELEASE_FUTURE_DUMP_THRESHOLD =
"IGNITE_PARTITION_RELEASE_FUTURE_DUMP_THRESHOLD";
/**
* If this property is set, a node will forcible fail a remote node when it fails to establish a communication
* connection.
*/
@SystemProperty("Enables node to forcible fail a remote node when it " +
"fails to establish a communication connection")
public static final String IGNITE_ENABLE_FORCIBLE_NODE_KILL = "IGNITE_ENABLE_FORCIBLE_NODE_KILL";
/**
* Tasks stealing will be started if tasks queue size per data-streamer thread exceeds this threshold.
* <p>
* Default value is {@code 4}.
*/
@SystemProperty(value = "Tasks stealing will be started if tasks queue size per data-streamer thread " +
"exceeds this threshold", type = Integer.class,
defaults = "" + DFLT_DATA_STREAMING_EXECUTOR_SERVICE_TASKS_STEALING_THRESHOLD)
public static final String IGNITE_DATA_STREAMING_EXECUTOR_SERVICE_TASKS_STEALING_THRESHOLD =
"IGNITE_DATA_STREAMING_EXECUTOR_SERVICE_TASKS_STEALING_THRESHOLD";
/**
* If this property is set, then Ignite will use Async File IO factory by default.
*/
@SystemProperty(value = "If this property is set, then Ignite will use Async File IO factory by default",
defaults = "" + DFLT_USE_ASYNC_FILE_IO_FACTORY)
public static final String IGNITE_USE_ASYNC_FILE_IO_FACTORY = "IGNITE_USE_ASYNC_FILE_IO_FACTORY";
/** Max amount of remembered errors for {@link GridLogThrottle}. */
@SystemProperty(value = "Max amount of remembered errors for GridLogThrottle", type = Integer.class,
defaults = "" + DFLT_LOG_THROTTLE_CAPACITY)
public static final String IGNITE_LOG_THROTTLE_CAPACITY = "IGNITE_LOG_THROTTLE_CAPACITY";
/**
* If this property is set, {@link DataStorageConfiguration#setWriteThrottlingEnabled(boolean)}
* will be overridden to {@code true} regardless the initial value in the configuration.
*/
@SystemProperty(value = "Checkpoint throttling policy", type = String.class)
public static final String IGNITE_OVERRIDE_WRITE_THROTTLING_ENABLED = "IGNITE_OVERRIDE_WRITE_THROTTLING_ENABLED";
/**
* Property for setup WAL serializer version.
*/
@SystemProperty(value = "WAL serializer version", type = Integer.class,
defaults = "" + LATEST_SERIALIZER_VERSION)
public static final String IGNITE_WAL_SERIALIZER_VERSION = "IGNITE_WAL_SERIALIZER_VERSION";
/** Property for setup Ignite WAL segment sync timeout. */
@SystemProperty(value = "WAL segment sync timeout in milliseconds", type = Long.class,
defaults = "" + DFLT_WAL_SEGMENT_SYNC_TIMEOUT)
public static final String IGNITE_WAL_SEGMENT_SYNC_TIMEOUT = "IGNITE_WAL_SEGMENT_SYNC_TIMEOUT";
/**
* If the property is set Ignite will use legacy node comparator (based on node order) inste
*
* Default value is {@code false}.
*/
@SystemProperty("Enables usage of legacy node comparator (based on node order)")
public static final String IGNITE_USE_LEGACY_NODE_COMPARATOR = "IGNITE_USE_LEGACY_NODE_COMPARATOR";
/**
* Property that indicates should be mapped byte buffer used or not.
* Possible values: {@code true} and {@code false}.
*/
@SystemProperty(value = "Enables usage of the mapped byte buffer", defaults = "" + DFLT_WAL_MMAP)
public static final String IGNITE_WAL_MMAP = "IGNITE_WAL_MMAP";
/**
* When set to {@code true}, Data store folders are generated only by consistent id, and no consistent ID will be
* set based on existing data store folders. This option also enables compatible folder generation mode as it was
* before 2.3.
*/
@SystemProperty("When set to true, Data store folders are generated only by consistent id, " +
"and no consistent ID will be set based on existing data store folders. This option also enables compatible " +
"folder generation mode as it was before 2.3")
public static final String IGNITE_DATA_STORAGE_FOLDER_BY_CONSISTENT_ID = "IGNITE_DATA_STORAGE_FOLDER_BY_CONSISTENT_ID";
/** Ignite JVM pause detector disabled. */
@SystemProperty("Disables JVM pause detector")
public static final String IGNITE_JVM_PAUSE_DETECTOR_DISABLED = "IGNITE_JVM_PAUSE_DETECTOR_DISABLED";
/** Ignite JVM pause detector precision. */
@SystemProperty(value = "JVM pause detector precision", type = Integer.class,
defaults = "" + DFLT_JVM_PAUSE_DETECTOR_PRECISION)
public static final String IGNITE_JVM_PAUSE_DETECTOR_PRECISION = "IGNITE_JVM_PAUSE_DETECTOR_PRECISION";
/** Ignite JVM pause detector threshold. */
@SystemProperty(value = "JVM pause detector threshold", type = Integer.class,
defaults = "" + DEFAULT_JVM_PAUSE_DETECTOR_THRESHOLD)
public static final String IGNITE_JVM_PAUSE_DETECTOR_THRESHOLD = "IGNITE_JVM_PAUSE_DETECTOR_THRESHOLD";
/** Ignite JVM pause detector last events count. */
@SystemProperty(value = "JVM pause detector last events count", type = Integer.class,
defaults = "" + DFLT_JVM_PAUSE_DETECTOR_LAST_EVENTS_COUNT)
public static final String IGNITE_JVM_PAUSE_DETECTOR_LAST_EVENTS_COUNT = "IGNITE_JVM_PAUSE_DETECTOR_LAST_EVENTS_COUNT";
/**
* Default value is {@code false}.
*
* @deprecated Not used.
*/
@Deprecated
@SystemProperty("Enables WAL debug log on recovery")
public static final String IGNITE_WAL_DEBUG_LOG_ON_RECOVERY = "IGNITE_WAL_DEBUG_LOG_ON_RECOVERY";
/**
* Number of checkpoint history entries held in memory.
*/
@SystemProperty(value = "Number of checkpoint history entries held in memory", type = Integer.class,
defaults = "" + DFLT_PDS_MAX_CHECKPOINT_MEMORY_HISTORY_SIZE)
public static final String IGNITE_PDS_MAX_CHECKPOINT_MEMORY_HISTORY_SIZE = "IGNITE_PDS_MAX_CHECKPOINT_MEMORY_HISTORY_SIZE";
/**
* If this property is set to {@code true} enable logging in {@link GridClient}.
*/
@SystemProperty("Enables logging in GridClient")
public static final String IGNITE_GRID_CLIENT_LOG_ENABLED = "IGNITE_GRID_CLIENT_LOG_ENABLED";
/**
* When set to {@code true}, direct IO may be enabled. Direct IO enabled only if JAR file with corresponding
* feature is available in classpath and OS and filesystem settings allows to enable this mode.
* Default is {@code true}.
*/
@SystemProperty(value = "Enables direct IO. Direct IO enabled only if JAR " +
"file with corresponding feature is available in classpath and OS and filesystem settings allows to enable " +
"this mode", defaults = "true")
public static final String IGNITE_DIRECT_IO_ENABLED = "IGNITE_DIRECT_IO_ENABLED";
/**
* When set to {@code true}, warnings that are intended for development environments and not for production
* (such as coding mistakes in code using Ignite) will not be logged.
*/
@SystemProperty("Enables development environments warnings")
public static final String IGNITE_DEV_ONLY_LOGGING_DISABLED = "IGNITE_DEV_ONLY_LOGGING_DISABLED";
/**
* When set to {@code true} (default), pages are written to page store without holding segment lock (with delay).
* Because other thread may require exactly the same page to be loaded from store, reads are protected by locking.
*/
@SystemProperty(value = "When set to true (default), pages are written to page store without " +
"holding segment lock (with delay). Because other thread may require exactly the same page to be loaded " +
"from store, reads are protected by locking", defaults = "" + DFLT_DELAYED_REPLACED_PAGE_WRITE)
public static final String IGNITE_DELAYED_REPLACED_PAGE_WRITE = "IGNITE_DELAYED_REPLACED_PAGE_WRITE";
/**
* When set to {@code true}, WAL implementation with dedicated worker will be used even in FSYNC mode.
* Default is {@code false}.
*/
@SystemProperty("When set to true, WAL implementation with dedicated worker will be used " +
"even in FSYNC mode")
public static final String IGNITE_WAL_FSYNC_WITH_DEDICATED_WORKER = "IGNITE_WAL_FSYNC_WITH_DEDICATED_WORKER";
/**
* When set to {@code true}, on-heap cache cannot be enabled - see
* {@link CacheConfiguration#setOnheapCacheEnabled(boolean)}.
* Default is {@code false}.
*/
@SystemProperty("When set to true, on-heap cache cannot be enabled - see " +
"CacheConfiguration.setOnheapCacheEnabled(boolean)")
public static final String IGNITE_DISABLE_ONHEAP_CACHE = "IGNITE_DISABLE_ONHEAP_CACHE";
/**
* When set to {@code false}, loaded pages implementation is switched to previous version of implementation,
* FullPageIdTable. {@code True} value enables 'Robin Hood hashing: backward shift deletion'.
* Default is {@code true}.
*/
@SystemProperty(value = "When set to false, loaded pages implementation is switched to previous " +
"version of implementation, FullPageIdTable. True value enables 'Robin Hood hashing: backward shift " +
"deletion'", defaults = "" + DFLT_LOADED_PAGES_BACKWARD_SHIFT_MAP)
public static final String IGNITE_LOADED_PAGES_BACKWARD_SHIFT_MAP = "IGNITE_LOADED_PAGES_BACKWARD_SHIFT_MAP";
/**
* Property for setup percentage of archive size for checkpoint trigger. Default value is 0.25
*/
@SystemProperty(value = "Percentage of archive size for checkpoint trigger",
type = Double.class, defaults = "" + DFLT_CHECKPOINT_TRIGGER_ARCHIVE_SIZE_PERCENTAGE)
public static final String IGNITE_CHECKPOINT_TRIGGER_ARCHIVE_SIZE_PERCENTAGE = "IGNITE_CHECKPOINT_TRIGGER_ARCHIVE_SIZE_PERCENTAGE";
/**
* Threshold time (in millis) to print warning to log if waiting for next wal segment took longer than the threshold.
*
* Default value is 1000 ms.
*/
@SystemProperty(value = "Threshold time (in millis) to print warning to log if waiting for next wal " +
"segment took longer than the threshold", type = Long.class,
defaults = DFLT_THRESHOLD_WAIT_TIME_NEXT_WAL_SEGMENT + " milliseconds")
public static final String IGNITE_THRESHOLD_WAIT_TIME_NEXT_WAL_SEGMENT = "IGNITE_THRESHOLD_WAIT_TIME_NEXT_WAL_SEGMENT";
/**
* Count of WAL compressor worker threads. Default value is 4.
*/
@SystemProperty(value = "Count of WAL compressor worker threads", type = Integer.class,
defaults = "" + DFLT_WAL_COMPRESSOR_WORKER_THREAD_CNT)
public static final String IGNITE_WAL_COMPRESSOR_WORKER_THREAD_CNT = "IGNITE_WAL_COMPRESSOR_WORKER_THREAD_CNT";
/**
* Whenever read load balancing is enabled, that means 'get' requests will be distributed between primary and backup
* nodes if it is possible and {@link CacheConfiguration#isReadFromBackup()} is {@code true}.
*
* Default is {@code true}.
*
* @see CacheConfiguration#isReadFromBackup()
*/
@SystemProperty(value = "Enables read load balancing, that means 'get' requests will be distributed " +
"between primary and backup nodes if it is possible and CacheConfiguration.isReadFromBackup() is true. ",
defaults = "" + DFLT_READ_LOAD_BALANCING)
public static final String IGNITE_READ_LOAD_BALANCING = "IGNITE_READ_LOAD_BALANCING";
/**
* Number of repetitions to capture a lock in the B+Tree.
*/
@SystemProperty(value = "Number of repetitions to capture a lock in the B+Tree", type = Integer.class,
defaults = "" + IGNITE_BPLUS_TREE_LOCK_RETRIES_DEFAULT)
public static final String IGNITE_BPLUS_TREE_LOCK_RETRIES = "IGNITE_BPLUS_TREE_LOCK_RETRIES";
/**
* Amount of memory reserved in the heap at node start, which can be dropped to increase the chances of success when
* handling OutOfMemoryError.
*
* Default is {@code 64kb}.
*/
@SystemProperty(value = "Amount of memory reserved in the heap at node start, which can be dropped " +
"to increase the chances of success when handling OutOfMemoryError", type = Integer.class,
defaults = "" + DFLT_FAILURE_HANDLER_RESERVE_BUFFER_SIZE)
public static final String IGNITE_FAILURE_HANDLER_RESERVE_BUFFER_SIZE = "IGNITE_FAILURE_HANDLER_RESERVE_BUFFER_SIZE";
/**
* The threshold of uneven distribution above which partition distribution will be logged.
*
* The default is '50', that means: warn about nodes with 50+% difference.
*/
@SystemProperty(value = "The threshold of uneven distribution above which partition distribution " +
"will be logged", type = Float.class, defaults = "" + DFLT_PART_DISTRIBUTION_WARN_THRESHOLD)
public static final String IGNITE_PART_DISTRIBUTION_WARN_THRESHOLD = "IGNITE_PART_DISTRIBUTION_WARN_THRESHOLD";
/**
* When set to {@code false}, WAL will not be automatically disabled during rebalancing if there is no partition in
* OWNING state.
* Default is {@code true}.
*/
@SystemProperty(value = "When set to false, WAL will not be automatically disabled during " +
"rebalancing if there is no partition in OWNING state", defaults = "" + DFLT_DISABLE_WAL_DURING_REBALANCING)
public static final String IGNITE_DISABLE_WAL_DURING_REBALANCING = "IGNITE_DISABLE_WAL_DURING_REBALANCING";
/**
* When property is set {@code false} each next exchange will try to compare with previous.
* If last rebalance is equivalent with new possible one, new rebalance does not trigger.
* Set the property {@code true} and each exchange will try to trigger new rebalance.
*
* Default is {@code false}.
*/
@SystemProperty("When property is set false each next exchange will try to compare with previous. " +
"If last rebalance is equivalent with new possible one, new rebalance does not trigger. " +
"Set the property true and each exchange will try to trigger new rebalance")
public static final String IGNITE_DISABLE_REBALANCING_CANCELLATION_OPTIMIZATION =
"IGNITE_DISABLE_REBALANCING_CANCELLATION_OPTIMIZATION";
/**
* Sets timeout for TCP client recovery descriptor reservation.
*/
@SystemProperty(value = "Timeout for TCP client recovery descriptor reservation in milliseconds",
type = Long.class, defaults = "" + DFLT_NIO_RECOVERY_DESCRIPTOR_RESERVATION_TIMEOUT)
public static final String IGNITE_NIO_RECOVERY_DESCRIPTOR_RESERVATION_TIMEOUT =
"IGNITE_NIO_RECOVERY_DESCRIPTOR_RESERVATION_TIMEOUT";
/**
* When set to {@code true}, Ignite will skip partitions sizes check on partition validation after rebalance has finished.
* Partitions sizes may differs on nodes when Expiry Policy is in use and it is ok due to lazy entry eviction mechanics.
*
* There is no need to disable partition size validation either in normal case or when expiry policy is configured for cache.
* But it should be disabled manually when policy is used on per entry basis to hint Ignite to skip this check.
*
* Default is {@code false}.
*/
@SystemProperty("Enables Ignite to skip partitions sizes check on partition " +
"validation after rebalance has finished. Partitions sizes may differs on nodes when Expiry Policy is in " +
"use and it is ok due to lazy entry eviction mechanics. There is no need to disable partition size " +
"validation either in normal case or when expiry policy is configured for cache. But it should be disabled " +
"manually when policy is used on per entry basis to hint Ignite to skip this check")
public static final String IGNITE_SKIP_PARTITION_SIZE_VALIDATION = "IGNITE_SKIP_PARTITION_SIZE_VALIDATION";
/**
* Enables threads dumping on critical node failure.
*
* Default is {@code true}.
*/
@SystemProperty("Enables threads dumping on critical node failure")
public static final String IGNITE_DUMP_THREADS_ON_FAILURE = "IGNITE_DUMP_THREADS_ON_FAILURE";
/**
* Throttling time out for thread dump generation during failure handling.
*
* Default is failure detection timeout. {@code 0} or negative value - throttling is disabled.
*/
@SystemProperty(value = "Throttling time out for thread dump generation during failure handling " +
"in milliseconds. Default is failure detection timeout. 0 or negative value - throttling is disabled",
type = Long.class)
public static final String IGNITE_DUMP_THREADS_ON_FAILURE_THROTTLING_TIMEOUT =
"IGNITE_DUMP_THREADS_ON_FAILURE_THROTTLING_TIMEOUT";
/**
* Throttling timeout in millis which avoid excessive PendingTree access on unwind if there is nothing to clean yet.
*
* Default is 500 ms.
*/
@SystemProperty(value = "Throttling timeout in milliseconds which avoid excessive PendingTree access on " +
"unwind if there is nothing to clean yet",
type = Long.class, defaults = "" + DFLT_UNWIND_THROTTLING_TIMEOUT)
public static final String IGNITE_UNWIND_THROTTLING_TIMEOUT = "IGNITE_UNWIND_THROTTLING_TIMEOUT";
/**
* Threshold for throttling operations logging.
*/
@SystemProperty(value = "Threshold in seconds for throttling operations logging", type = Integer.class,
defaults = "" + DFLT_THROTTLE_LOG_THRESHOLD)
public static final String IGNITE_THROTTLE_LOG_THRESHOLD = "IGNITE_THROTTLE_LOG_THRESHOLD";
/**
* Number of concurrent operation for evict partitions.
*
* @deprecated Since version 2.10. Use {@link IgniteConfiguration#setRebalanceThreadPoolSize(int)} to manage
* eviction parallelism.
*/
@Deprecated
@SystemProperty(value = "Number of concurrent operation for evict partitions", type = Integer.class)
public static final String IGNITE_EVICTION_PERMITS = "IGNITE_EVICTION_PERMITS";
/**
* When set to {@code true}, Ignite will allow execute DML operation (MERGE|INSERT|UPDATE|DELETE)
* within transaction for non MVCC mode.
*
* Default is {@code false}.
*/
@SystemProperty("When set to true, Ignite will allow executing DML operation " +
"(MERGE|INSERT|UPDATE|DELETE) within transactions for non MVCC mode")
public static final String IGNITE_ALLOW_DML_INSIDE_TRANSACTION = "IGNITE_ALLOW_DML_INSIDE_TRANSACTION";
/**
* Timeout between ZooKeeper client retries, default 2s.
*/
@SystemProperty(value = "Timeout between ZooKeeper client retries in milliseconds", type = Long.class,
defaults = "2 seconds")
public static final String IGNITE_ZOOKEEPER_DISCOVERY_RETRY_TIMEOUT = "IGNITE_ZOOKEEPER_DISCOVERY_RETRY_TIMEOUT";
/**
* Number of attempts to reconnect to ZooKeeper.
*/
@SystemProperty(value = "Number of attempts to reconnect to ZooKeeper", type = Integer.class,
defaults = "10")
public static final String IGNITE_ZOOKEEPER_DISCOVERY_MAX_RETRY_COUNT = "IGNITE_ZOOKEEPER_DISCOVERY_MAX_RETRY_COUNT";
/**
* Maximum number for cached MVCC transaction updates. This caching is used for continuous query with MVCC caches.
*/
@SystemProperty(value = "Maximum number for cached MVCC transaction updates. This caching is used " +
"for continuous query with MVCC caches", type = Integer.class,
defaults = "" + DFLT_MVCC_TX_SIZE_CACHING_THRESHOLD)
public static final String IGNITE_MVCC_TX_SIZE_CACHING_THRESHOLD = "IGNITE_MVCC_TX_SIZE_CACHING_THRESHOLD";
/**
* Try reuse memory on deactivation. Useful in case of huge page memory region size.
*/
@SystemProperty("Try reuse memory on deactivation")
public static final String IGNITE_REUSE_MEMORY_ON_DEACTIVATE = "IGNITE_REUSE_MEMORY_ON_DEACTIVATE";
/**
* Maximum inactivity period for system worker in milliseconds. When this value is exceeded, worker is considered
* blocked with consequent critical failure handler invocation.
*/
@SystemProperty(value = "Maximum inactivity period for system worker in milliseconds. When this " +
"value is exceeded, worker is considered blocked with consequent critical failure handler invocation",
type = Long.class)
public static final String IGNITE_SYSTEM_WORKER_BLOCKED_TIMEOUT = "IGNITE_SYSTEM_WORKER_BLOCKED_TIMEOUT";
/**
* Timeout for checkpoint read lock acquisition in milliseconds.
*/
@SystemProperty(value = "Timeout for checkpoint read lock acquisition in milliseconds", type = Long.class)
public static final String IGNITE_CHECKPOINT_READ_LOCK_TIMEOUT = "IGNITE_CHECKPOINT_READ_LOCK_TIMEOUT";
/**
* Timeout for waiting schema update if schema was not found for last accepted version.
*/
@SystemProperty(value = "Timeout for waiting schema update if schema was not found for last accepted " +
"version in milliseconds", type = Long.class, defaults = "" + DFLT_WAIT_SCHEMA_UPDATE)
public static final String IGNITE_WAIT_SCHEMA_UPDATE = "IGNITE_WAIT_SCHEMA_UPDATE";
/**
* System property to override {@link CacheConfiguration#getRebalanceThrottle} configuration property for all caches.
* {@code 0} by default, which means that override is disabled.
* @deprecated Use {@link IgniteConfiguration#getRebalanceThrottle()} instead.
*/
@Deprecated
@SystemProperty(value = "Overrides CacheConfiguration.getRebalanceThrottle " +
"configuration property for all caches in milliseconds. 0 by default, which means that override is disabled",
type = Long.class, defaults = "0")
public static final String IGNITE_REBALANCE_THROTTLE_OVERRIDE = "IGNITE_REBALANCE_THROTTLE_OVERRIDE";
/**
* Enables start caches in parallel.
*
* Default is {@code true}.
*/
@SystemProperty(value = "Allows to start multiple caches in parallel",
defaults = "" + DFLT_ALLOW_START_CACHES_IN_PARALLEL)
public static final String IGNITE_ALLOW_START_CACHES_IN_PARALLEL = "IGNITE_ALLOW_START_CACHES_IN_PARALLEL";
/** For test purposes only. Force Mvcc mode. */
@SystemProperty("For test purposes only. Force Mvcc mode")
public static final String IGNITE_FORCE_MVCC_MODE_IN_TESTS = "IGNITE_FORCE_MVCC_MODE_IN_TESTS";
/**
* Allows to log additional information about all restored partitions after binary and logical recovery phases.
*
* Default is {@code true}.
*/
@SystemProperty("Allows to log additional information about all restored partitions after " +
"binary and logical recovery phases")
public static final String IGNITE_RECOVERY_VERBOSE_LOGGING = "IGNITE_RECOVERY_VERBOSE_LOGGING";
/**
* Disables cache interceptor triggering in case of conflicts.
*
* Default is {@code false}.
*/
@SystemProperty("Disables cache interceptor triggering in case of conflicts")
public static final String IGNITE_DISABLE_TRIGGERING_CACHE_INTERCEPTOR_ON_CONFLICT =
"IGNITE_DISABLE_TRIGGERING_CACHE_INTERCEPTOR_ON_CONFLICT";
/**
* Sets default {@link CacheConfiguration#setDiskPageCompression disk page compression}.
*/
@SystemProperty(value = "Disk page compression - CacheConfiguration#setDiskPageCompression",
type = DiskPageCompression.class)
public static final String IGNITE_DEFAULT_DISK_PAGE_COMPRESSION = "IGNITE_DEFAULT_DISK_PAGE_COMPRESSION";
/**
* Sets default {@link DataStorageConfiguration#setPageSize storage page size}.
*/
@SystemProperty(value = "Storage page size - DataStorageConfiguration#setPageSize", type = Integer.class)
public static final String IGNITE_DEFAULT_DATA_STORAGE_PAGE_SIZE = "IGNITE_DEFAULT_DATA_STORAGE_PAGE_SIZE";
/**
* Manages the type of the implementation of the service processor (implementation of the {@link IgniteServices}).
* All nodes in the cluster must have the same value of this property.
* <p/>
* If the property is {@code true} then event-driven implementation of the service processor will be used.
* <p/>
* If the property is {@code false} then internal cache based implementation of service processor will be used.
* <p/>
* Default is {@code true}.
*/
@SystemProperty(value = "Manages the type of the implementation of the service processor " +
"(implementation of the IgniteServices). All nodes in the cluster must have the same value of this property. " +
"If the property is true then event-driven implementation of the service processor will be used. If the " +
"property is false then internal cache based implementation of service processor will be used",
defaults = "" + DFLT_EVENT_DRIVEN_SERVICE_PROCESSOR_ENABLED)
public static final String IGNITE_EVENT_DRIVEN_SERVICE_PROCESSOR_ENABLED
= "IGNITE_EVENT_DRIVEN_SERVICE_PROCESSOR_ENABLED";
/**
* When set to {@code true}, cache metrics are not included into the discovery metrics update message (in this
* case message contains only cluster metrics). By default cache metrics are included into the message and
* calculated each time the message is sent.
* <p>
* Cache metrics sending can also be turned off by disabling statistics per each cache, but in this case some cache
* metrics will be unavailable via JMX too.
*/
@SystemProperty("When set to true, cache metrics are not included into the discovery metrics " +
"update message (in this case message contains only cluster metrics). By default cache metrics are included " +
"into the message and calculated each time the message is sent. Cache metrics sending can also be turned off " +
"by disabling statistics per each cache, but in this case some cache metrics will be unavailable via JMX too")
public static final String IGNITE_DISCOVERY_DISABLE_CACHE_METRICS_UPDATE = "IGNITE_DISCOVERY_DISABLE_CACHE_METRICS_UPDATE";
/**
* Maximum number of different partitions to be extracted from between expression within sql query.
* In case of limit exceeding all partitions will be used.
*/
@SystemProperty(value = "Maximum number of different partitions to be extracted from between " +
"expression within sql query. In case of limit exceeding all partitions will be used", type = Integer.class,
defaults = "16")
public static final String IGNITE_SQL_MAX_EXTRACTED_PARTS_FROM_BETWEEN =
"IGNITE_SQL_MAX_EXTRACTED_PARTS_FROM_BETWEEN";
/**
* Maximum amount of bytes that can be stored in history of {@link DistributedMetaStorage} updates.
*/
@SystemProperty(value = "Maximum amount of bytes that can be stored in history of DistributedMetaStorage updates",
type = Long.class, defaults = "" + DFLT_MAX_HISTORY_BYTES)
public static final String IGNITE_GLOBAL_METASTORAGE_HISTORY_MAX_BYTES = "IGNITE_GLOBAL_METASTORAGE_HISTORY_MAX_BYTES";
/**
* Size threshold to allocate and retain additional HashMap to improve contains()
* which leads to extra memory consumption.
*/
@SystemProperty(value = "Size threshold to allocate and retain additional HashMap to improve " +
"contains() which leads to extra memory consumption", type = Integer.class,
defaults = "" + DFLT_AFFINITY_BACKUPS_THRESHOLD)
public static final String IGNITE_AFFINITY_BACKUPS_THRESHOLD = "IGNITE_AFFINITY_BACKUPS_THRESHOLD";
/**
* Flag to disable memory optimization:
* BitSets instead of HashSets to store partitions.
* When number of backups per partion is > IGNITE_AFFINITY_BACKUPS_THRESHOLD we use HashMap to improve contains()
* which leads to extra memory consumption, otherwise we use view on the
* list of cluster nodes to reduce memory consumption on redundant data structures.
*/
@SystemProperty("Disables memory optimization: BitSets instead of HashSets to store " +
"partitions. When number of backups per partitions is > IGNITE_AFFINITY_BACKUPS_THRESHOLD we use HashMap to " +
"improve contains() which leads to extra memory consumption, otherwise we use view on the list of cluster " +
"nodes to reduce memory consumption on redundant data structures")
public static final String IGNITE_DISABLE_AFFINITY_MEMORY_OPTIMIZATION = "IGNITE_DISABLE_AFFINITY_MEMORY_OPTIMIZATION";
/**
* Limit the maximum number of objects in memory during the recovery procedure.
*/
@SystemProperty(value = "Limit the maximum number of objects in memory during the recovery procedure",
type = Integer.class)
public static final String IGNITE_RECOVERY_SEMAPHORE_PERMITS = "IGNITE_RECOVERY_SEMAPHORE_PERMITS";
/**
* Maximum size of history of server nodes (server node IDs) that ever joined to current topology.
*/
@SystemProperty(value = "Maximum size of history of server nodes (server node IDs) that ever joined " +
"to current topology", type = Integer.class, defaults = "" + DFLT_NODE_IDS_HISTORY_SIZE)
public static final String IGNITE_NODE_IDS_HISTORY_SIZE = "IGNITE_NODE_IDS_HISTORY_SIZE";
/**
* Maximum number of diagnostic warning messages per category, when waiting for PME.
*/
@SystemProperty(value = "Maximum number of diagnostic warning messages per category, when waiting for PME",
type = Integer.class, defaults = "" + DFLT_DIAGNOSTIC_WARN_LIMIT)
public static final String IGNITE_DIAGNOSTIC_WARN_LIMIT = "IGNITE_DIAGNOSTIC_WARN_LIMIT";
/**
* Flag to enable triggering failure handler for node if unrecoverable partition inconsistency is
* discovered during partition update counters exchange.
*/
@SystemProperty("Enables triggering failure handler for node if unrecoverable " +
"partition inconsistency is discovered during partition update counters exchange")
public static final String IGNITE_FAIL_NODE_ON_UNRECOVERABLE_PARTITION_INCONSISTENCY =
"IGNITE_FAIL_NODE_ON_UNRECOVERABLE_PARTITION_INCONSISTENCY";
/**
* Allow use composite _key, _val columns at the INSERT/UPDATE/MERGE statements.
*/
@SystemProperty("Allow use composite _key, _val columns at the INSERT/UPDATE/MERGE statements")
public static final String IGNITE_SQL_ALLOW_KEY_VAL_UPDATES = "IGNITE_SQL_ALLOW_KEY_VAL_UPDATES";
/**
* Interval between logging of time of next auto-adjust.
*/
@SystemProperty(value = "Interval between logging of time of next auto-adjust in milliseconds", type = Long.class,
defaults = "" + DFLT_BASELINE_AUTO_ADJUST_LOG_INTERVAL)
public static final String IGNITE_BASELINE_AUTO_ADJUST_LOG_INTERVAL = "IGNITE_BASELINE_AUTO_ADJUST_LOG_INTERVAL";
/**
* Starting from this number of dirty pages in checkpoint, array will be sorted with
* {@link Arrays#parallelSort(Comparable[])} in case of {@link CheckpointWriteOrder#SEQUENTIAL}.
*/
@SystemProperty(value = "Starting from this number of dirty pages in checkpoint, array will be " +
"sorted with Arrays.parallelSort(Comparable[]) in case of CheckpointWriteOrder.SEQUENTIAL",
type = Integer.class, defaults = "" + DFLT_CHECKPOINT_PARALLEL_SORT_THRESHOLD)
public static final String CHECKPOINT_PARALLEL_SORT_THRESHOLD = "CHECKPOINT_PARALLEL_SORT_THRESHOLD";
/**
* Keep static cache configuration even if stored cache data differs from the static config. When this property
* is set, static cache configuration will override persisted configuration. DDL operations are not allowed
* when this system property is set.
*/
@SystemProperty("Keep static cache configuration even if stored cache data differs from " +
"the static config. When this property is set, static cache configuration will override persisted " +
"configuration. DDL operations are not allowed when this system property is set")
public static final String IGNITE_KEEP_STATIC_CACHE_CONFIGURATION = "IGNITE_KEEP_STATIC_CACHE_CONFIGURATION";
/** Enable backward compatible to use 'IGNITE' as SQL system schema. */
@SystemProperty("Enable backward compatible to use 'IGNITE' as SQL system schema")
public static final String IGNITE_SQL_SYSTEM_SCHEMA_NAME_IGNITE = "IGNITE_SQL_SYSTEM_SCHEMA_NAME_IGNITE";
/**
* Shows if dump requests from local node to near node are allowed, when long running transaction
* is found. If allowed, the compute request to near node will be made to get thread dump of transaction
* owner thread.
*/
@SystemProperty(value = "Shows if dump requests from local node to near node are allowed, when " +
"long running transaction is found. If allowed, the compute request to near node will be made to get " +
"thread dump of transaction owner thread", defaults = "" + DFLT_TX_OWNER_DUMP_REQUESTS_ALLOWED)
public static final String IGNITE_TX_OWNER_DUMP_REQUESTS_ALLOWED = "IGNITE_TX_OWNER_DUMP_REQUESTS_ALLOWED";
/**
* Page lock tracker type.
* -1 - Disable lock tracking.
* 1 - HEAP_STACK
* 2 - HEAP_LOG
* 3 - OFF_HEAP_STACK
* 4 - OFF_HEAP_LOG
*
* Default is 2 - HEAP_LOG.
*/
@SystemProperty(value = "Page lock tracker type. -1 - Disable lock tracking. 1 - HEAP_STACK. " +
"2 - HEAP_LOG. 3 - OFF_HEAP_STACK. 4 - OFF_HEAP_LOG", type = Integer.class,
defaults = "" + HEAP_LOG)
public static final String IGNITE_PAGE_LOCK_TRACKER_TYPE = "IGNITE_PAGE_LOCK_TRACKER_TYPE";
/**
* Capacity in pages for storing in page lock tracker strucuture.
*
* Default is 512 pages.
*/
@SystemProperty(value = "Capacity in pages for storing in page lock tracker strucuture",
type = Integer.class, defaults = "" + DFLT_PAGE_LOCK_TRACKER_CAPACITY)
public static final String IGNITE_PAGE_LOCK_TRACKER_CAPACITY = "IGNITE_PAGE_LOCK_TRACKER_CAPACITY";
/**
* Page lock tracker thread for checking hangs threads interval.
*
* Default is 60_000 ms.
*/
@SystemProperty(value = "Page lock tracker thread for checking hangs threads interval",
type = Integer.class, defaults = "" + DFLT_PAGE_LOCK_TRACKER_CHECK_INTERVAL)
public static final String IGNITE_PAGE_LOCK_TRACKER_CHECK_INTERVAL = "IGNITE_PAGE_LOCK_TRACKER_CHECK_INTERVAL";
/**
* Enables threads locks dumping on critical node failure.
*
* Default is {@code true}.
*/
@SystemProperty(value = "Enables threads locks dumping on critical node failure",
defaults = "" + DFLT_DUMP_PAGE_LOCK_ON_FAILURE)
public static final String IGNITE_DUMP_PAGE_LOCK_ON_FAILURE = "IGNITE_DUMP_PAGE_LOCK_ON_FAILURE";
/**
* Scan the classpath on startup and log all the files containing in it.
*/
@SystemProperty(value = "Scan the classpath on startup and log all the files containing in it",
defaults = "" + DFLT_LOG_CLASSPATH_CONTENT_ON_STARTUP)
public static final String IGNITE_LOG_CLASSPATH_CONTENT_ON_STARTUP = "IGNITE_LOG_CLASSPATH_CONTENT_ON_STARTUP";
/**
* Threshold timeout for long transactions, if transaction exceeds it, it will be dumped in log with
* information about how much time did it spent in system time (time while aquiring locks, preparing,
* commiting, etc) and user time (time when client node runs some code while holding transaction and not
* waiting it). Equals 0 if not set. No long transactions are dumped in log if nor this parameter
* neither {@link #IGNITE_TRANSACTION_TIME_DUMP_SAMPLES_COEFFICIENT} is set.
*/
@SystemProperty(value = "Threshold timeout for long transactions, if transaction exceeds it, it " +
"will be dumped in log with information about how much time did it spent in system time (time while acquiring " +
"locks, preparing, committing, etc) and user time (time when client node runs some code while holding " +
"transaction and not waiting it). Equals 0 if not set. No long transactions are dumped in log if nor " +
"this parameter neither IGNITE_TRANSACTION_TIME_DUMP_SAMPLES_COEFFICIENT is set", type = Long.class)
public static final String IGNITE_LONG_TRANSACTION_TIME_DUMP_THRESHOLD = "IGNITE_LONG_TRANSACTION_TIME_DUMP_THRESHOLD";
/**
* The coefficient for samples of completed transactions that will be dumped in log. Must be float value
* between 0.0 and 1.0 inclusive. Default value is <code>0.0</code>.
*/
@SystemProperty(value = "The coefficient for samples of completed transactions that will be dumped " +
"in log. Must be float value between 0.0 and 1.0 inclusive", type = Float.class)
public static final String IGNITE_TRANSACTION_TIME_DUMP_SAMPLES_COEFFICIENT =
"IGNITE_TRANSACTION_TIME_DUMP_SAMPLES_COEFFICIENT";
/**
* The limit of samples of completed transactions that will be dumped in log per second, if
* {@link #IGNITE_TRANSACTION_TIME_DUMP_SAMPLES_COEFFICIENT} is above <code>0.0</code>. Must be integer value
* greater than <code>0</code>. Default value is <code>5</code>.
*/
@SystemProperty(value = "The limit of samples of completed transactions that will be dumped in log " +
"per second, if " + IGNITE_TRANSACTION_TIME_DUMP_SAMPLES_COEFFICIENT + " is above 0.0. Must be integer value " +
"greater than 0", type = Integer.class, defaults = "" + DFLT_TRANSACTION_TIME_DUMP_SAMPLES_PER_SECOND_LIMIT)
public static final String IGNITE_TRANSACTION_TIME_DUMP_SAMPLES_PER_SECOND_LIMIT =
"IGNITE_TRANSACTION_TIME_DUMP_SAMPLES_PER_SECOND_LIMIT";
/**
* Disable onheap caching of pages lists (free lists and reuse lists).
* If persistence is enabled changes to page lists are not stored to page memory immediately, they are cached in
* onheap buffer and flushes to page memory on a checkpoint. This property allows to disable such onheap caching.
* Default value is <code>false</code>.
*/
@SystemProperty("Disables onheap caching of pages lists (free lists and reuse lists). " +
"If persistence is enabled changes to page lists are not stored to page memory immediately, they are " +
"cached in onheap buffer and flushes to page memory on a checkpoint. This property allows to disable such " +
"onheap caching")
public static final String IGNITE_PAGES_LIST_DISABLE_ONHEAP_CACHING = "IGNITE_PAGES_LIST_DISABLE_ONHEAP_CACHING";
/**
* The master key name that the node will use during the recovery.
* <p>
* If a node was unavailable during a master key change process it won't be able to join to cluster with old the
* master key. Set up this property to re-encrypt cache keys on startup and join to cluster with the valid
* master key name.
*/
@SystemProperty(value = "The master key name that the node will use during the recovery. If a node " +
"was unavailable during a master key change process it won't be able to join to cluster with old the " +
"master key. Set up this property to re-encrypt cache keys on startup and join to cluster with the valid " +
"master key name", type = String.class)
public static final String IGNITE_MASTER_KEY_NAME_TO_CHANGE_BEFORE_STARTUP =
"IGNITE_MASTER_KEY_NAME_TO_CHANGE_BEFORE_STARTUP";
/**
* Disable group state lazy store. It means that group state won't be cached for {@link CheckpointEntry} and will be
* read from wal every time. Should be used for test purposes only.
*/
@SystemProperty(value = "Disable group state lazy store. It means that group state won't be cached " +
"and will be read from wal every time", defaults = "false")
public static final String IGNITE_DISABLE_GRP_STATE_LAZY_STORE = "IGNITE_DISABLE_GRP_STATE_LAZY_STORE";
/**
* Enables extended logging of indexes create/rebuild process. Default {@code false}.
* <p/>
* <b>Warning</b>: enabling that option can lead to performance degradation of index creation, rebuilding and node
* restart.
*/
@SystemProperty("Enables extended logging of indexes create/rebuild process. " +
"Warning: enabling that option can lead to performance degradation of index creation, rebuilding and " +
"node restart")
public static final String IGNITE_ENABLE_EXTRA_INDEX_REBUILD_LOGGING = "IGNITE_ENABLE_EXTRA_INDEX_REBUILD_LOGGING";
/**
* When enabled, node will wait until all of its data is backed up before shutting down.
* Please note that it will completely prevent last node in cluster from shutting down if any caches exist
* that have backups configured.
*/
@IgniteExperimental
@SystemProperty("Enables node to wait until all of its data is backed up before " +
"shutting down. Please note that it will completely prevent last node in cluster from shutting down if any " +
"caches exist that have backups configured")
public static final String IGNITE_WAIT_FOR_BACKUPS_ON_SHUTDOWN = "IGNITE_WAIT_FOR_BACKUPS_ON_SHUTDOWN";
/**
* Enables subquery rewriting optimization.
* If enabled, subquery will be rewritten to JOIN where possible.
* Default is {@code true}.
*/
@IgniteExperimental
@SystemProperty("Enables subquery rewriting optimization. " +
"If enabled, subquery will be rewritten to JOIN where possible")
public static final String IGNITE_ENABLE_SUBQUERY_REWRITE_OPTIMIZATION = "IGNITE_ENABLE_SUBQUERY_REWRITE_OPTIMIZATION";
/**
* Enables setting attribute value of {@link
* TcpCommunicationSpi#ATTR_HOST_NAMES ATTR_HOST_NAMES} when value {@link
* IgniteConfiguration#getLocalHost getLocalHost} is ip, for backward
* compatibility. By default, {@code false}.
*/
@SystemProperty("Enables setting attribute value of TcpCommunicationSpi#ATTR_HOST_NAMES " +
"when value IgniteConfiguration#getLocalHost is ip, for backward compatibility")
public static final String IGNITE_TCP_COMM_SET_ATTR_HOST_NAMES = "IGNITE_TCP_COMM_SET_ATTR_HOST_NAMES";
/**
* When above zero, prints tx key collisions once per interval.
* Each transaction besides OPTIMISTIC SERIALIZABLE capture locks on all enlisted keys, for some reasons
* per key lock queue may rise. This property sets the interval during which statistics are collected.
* Default is 1000 ms.
*/
@SystemProperty(value = "When above zero, prints tx key collisions once per interval. Each " +
"transaction besides OPTIMISTIC SERIALIZABLE capture locks on all enlisted keys, for some reasons per key " +
"lock queue may rise. This property sets the interval during which statistics are collected", type = Integer.class,
defaults = "" + DFLT_DUMP_TX_COLLISIONS_INTERVAL)
public static final String IGNITE_DUMP_TX_COLLISIONS_INTERVAL = "IGNITE_DUMP_TX_COLLISIONS_INTERVAL";
/**
* Set to true only during the junit tests.
* Signals that the cluster is running in a test environment.
*
* Can be used for changing behaviour of tightly coupled code pieces during the tests.
* Use it as a last resort only, prefer another toolchain like DI, mocks and etc. if possible
*/
@SystemProperty(value = "Set to true only during the junit tests. " +
"Can be used for changing behaviour of tightly coupled code pieces during the tests. " +
"Use it as a last resort only, prefer another toolchain like DI, mocks and etc. if possible",
type = Boolean.class)
public static final String IGNITE_TEST_ENV = "IGNITE_TEST_ENV";
/**
* Defragmentation region size percentage of configured region size.
* This percentage will be calculated from largest configured region size and then proportionally subtracted
* from all configured regions.
*/
@SystemProperty(value = "Defragmentation region size percentage of configured region size. " +
"This percentage will be calculated from largest configured region size and then proportionally subtracted " +
"from all configured regions",
type = Integer.class,
defaults = "" + DFLT_DEFRAGMENTATION_REGION_SIZE_PERCENTAGE)
public static final String IGNITE_DEFRAGMENTATION_REGION_SIZE_PERCENTAGE =
"IGNITE_DEFRAGMENTATION_REGION_SIZE_PERCENTAGE";
/**
* Maximum performance statistics file size in bytes. Performance statistics collection is stopped when the
* file size is exceeded. The default value is {@link FilePerformanceStatisticsWriter#DFLT_FILE_MAX_SIZE}.
*/
@SystemProperty(value = "Maximum performance statistics file size in bytes. Performance statistics collection " +
"is stopped when the file size is exceeded", type = Long.class, defaults = "" + DFLT_FILE_MAX_SIZE)
public static final String IGNITE_PERF_STAT_FILE_MAX_SIZE = "IGNITE_PERF_STAT_FILE_MAX_SIZE";
/**
* Performance statistics off heap buffer size in bytes. The default value is
* {@link FilePerformanceStatisticsWriter#DFLT_BUFFER_SIZE}.
*/
@SystemProperty(value = "Performance statistics off heap buffer size in bytes", type = Integer.class,
defaults = "" + DFLT_BUFFER_SIZE)
public static final String IGNITE_PERF_STAT_BUFFER_SIZE = "IGNITE_PERF_STAT_BUFFER_SIZE";
/**
* Minimal performance statistics batch size to be flushed in bytes. The default value is
* {@link FilePerformanceStatisticsWriter#DFLT_FLUSH_SIZE}.
*/
@SystemProperty(value = "Minimal performance statistics batch size to be flushed in bytes", type = Integer.class,
defaults = "" + DFLT_FLUSH_SIZE)
public static final String IGNITE_PERF_STAT_FLUSH_SIZE = "IGNITE_PERF_STAT_FLUSH_SIZE";
/**
* Maximum performance statistics cached strings threshold. String caching is stopped when the threshold
* is exceeded. The default value is {@link FilePerformanceStatisticsWriter#DFLT_CACHED_STRINGS_THRESHOLD}.
*/
@SystemProperty(value = "Maximum performance statistics cached strings threshold. String caching is " +
"stopped when the threshold is exceeded", type = Integer.class, defaults = "" + DFLT_CACHED_STRINGS_THRESHOLD)
public static final String IGNITE_PERF_STAT_CACHED_STRINGS_THRESHOLD = "IGNITE_PERF_STAT_CACHED_STRINGS_THRESHOLD";
/**
* Count of rows, being processed within a single checkpoint lock when indexes are rebuilt.
* The default value is {@link SchemaIndexCachePartitionWorker#DFLT_IGNITE_INDEX_REBUILD_BATCH_SIZE}.
*/
@SystemProperty(value = "Count of rows, being processed within a single checkpoint lock when indexes are rebuilt",
type = Integer.class, defaults = "" + DFLT_IGNITE_INDEX_REBUILD_BATCH_SIZE)
public static final String IGNITE_INDEX_REBUILD_BATCH_SIZE = "IGNITE_INDEX_REBUILD_BATCH_SIZE";
/**
* Enforces singleton.
*/
private IgniteSystemProperties() {
// No-op.
}
/**
* @param enumCls Enum type.
* @param name Name of the system property or environment variable.
* @return Enum value or {@code null} if the property is not set.
*/
public static <E extends Enum<E>> E getEnum(Class<E> enumCls, String name) {
return getEnum(enumCls, name, null);
}
/**
* @param name Name of the system property or environment variable.
* @return Enum value or the given default.
*/
public static <E extends Enum<E>> E getEnum(String name, E dflt) {
return getEnum(dflt.getDeclaringClass(), name, dflt);
}
/**
* @param enumCls Enum type.
* @param name Name of the system property or environment variable.
* @param dflt Default value.
* @return Enum value or the given default.
*/
private static <E extends Enum<E>> E getEnum(Class<E> enumCls, String name, E dflt) {
assert enumCls != null;
String val = getString(name);
if (val == null)
return dflt;
try {
return Enum.valueOf(enumCls, val);
}
catch (IllegalArgumentException ignore) {
return dflt;
}
}
/**
* Gets either system property or environment variable with given name.
*
* @param name Name of the system property or environment variable.
* @return Value of the system property or environment variable.
* Returns {@code null} if neither can be found for given name.
*/
@Nullable public static String getString(String name) {
assert name != null;
String v = System.getProperty(name);
if (v == null)
v = System.getenv(name);
return v;
}
/**
* Gets either system property or environment variable with given name.
*
* @param name Name of the system property or environment variable.
* @param dflt Default value.
* @return Value of the system property or environment variable.
* Returns {@code null} if neither can be found for given name.
*/
@Nullable public static String getString(String name, String dflt) {
String val = getString(name);
return val == null ? dflt : val;
}
/**
* Gets either system property or environment variable with given name.
* The result is transformed to {@code boolean} using {@code Boolean.valueOf()} method.
*
* @param name Name of the system property or environment variable.
* @return Boolean value of the system property or environment variable.
* Returns {@code False} in case neither system property
* nor environment variable with given name is found.
*/
public static boolean getBoolean(String name) {
return getBoolean(name, false);
}
/**
* Gets either system property or environment variable with given name.
* The result is transformed to {@code boolean} using {@code Boolean.valueOf()} method.
*
* @param name Name of the system property or environment variable.
* @param dflt Default value.
* @return Boolean value of the system property or environment variable.
* Returns default value in case neither system property
* nor environment variable with given name is found.
*/
public static boolean getBoolean(String name, boolean dflt) {
String val = getString(name);
return val == null ? dflt : Boolean.parseBoolean(val);
}
/**
* Gets either system property or environment variable with given name.
* The result is transformed to {@code int} using {@code Integer.parseInt()} method.
*
* @param name Name of the system property or environment variable.
* @param dflt Default value.
* @return Integer value of the system property or environment variable.
* Returns default value in case neither system property
* nor environment variable with given name is found.
*/
public static int getInteger(String name, int dflt) {
String s = getString(name);
if (s == null)
return dflt;
int res;
try {
res = Integer.parseInt(s);
}
catch (NumberFormatException ignore) {
res = dflt;
}
return res;
}
/**
* Gets either system property or environment variable with given name.
* The result is transformed to {@code float} using {@code Float.parseFloat()} method.
*
* @param name Name of the system property or environment variable.
* @param dflt Default value.
* @return Float value of the system property or environment variable.
* Returns default value in case neither system property
* nor environment variable with given name is found.
*/
public static float getFloat(String name, float dflt) {
String s = getString(name);
if (s == null)
return dflt;
float res;
try {
res = Float.parseFloat(s);
}
catch (NumberFormatException ignore) {
res = dflt;
}
return res;
}
/**
* Gets either system property or environment variable with given name.
* The result is transformed to {@code long} using {@code Long.parseLong()} method.
*
* @param name Name of the system property or environment variable.
* @param dflt Default value.
* @return Integer value of the system property or environment variable.
* Returns default value in case neither system property
* nor environment variable with given name is found.
*/
public static long getLong(String name, long dflt) {
String s = getString(name);
if (s == null)
return dflt;
long res;
try {
res = Long.parseLong(s);
}
catch (NumberFormatException ignore) {
res = dflt;
}
return res;
}
/**
* Gets either system property or environment variable with given name.
* The result is transformed to {@code double} using {@code Double.parseDouble()} method.
*
* @param name Name of the system property or environment variable.
* @param dflt Default value.
* @return Integer value of the system property or environment variable.
* Returns default value in case neither system property
* nor environment variable with given name is found.
*/
public static double getDouble(String name, double dflt) {
String s = getString(name);
if (s == null)
return dflt;
double res;
try {
res = Double.parseDouble(s);
}
catch (NumberFormatException ignore) {
res = dflt;
}
return res;
}
/**
* Gets snapshot of system properties.
* Snapshot could be used for thread safe iteration over system properties.
* Non-string properties are removed before return.
*
* @return Snapshot of system properties.
*/
public static Properties snapshot() {
Properties sysProps = (Properties)System.getProperties().clone();
Iterator<Map.Entry<Object, Object>> iter = sysProps.entrySet().iterator();
while (iter.hasNext()) {
Map.Entry entry = iter.next();
if (!(entry.getValue() instanceof String) || !(entry.getKey() instanceof String))
iter.remove();
}
return sysProps;
}
}