Cassandra system properties
Apache Cassandra® native Java Virtual Machine (JVM) system parameters.
For a complete reference of all JVM server options, see JVM server options reference.
- -Dcassandra.auto_bootstrap
-
Set
auto_bootstrap
tofalse
during the initial set up of a node to override the default setting in thecassandra.yaml
file.Default:
true
.
- -Dcassandra.available_processors
-
Number of processors available to HCD. In a multi-instance deployment, each instance independently assumes that all CPU processors are available to it. Use this setting to specify a smaller set of processors.
Default: All processors.
- -Dcassandra.config
-
Set to the directory location of the
cassandra.yaml
file.The default depends on your installation type.
- -Dcassandra.vector_type_allowed
-
Set
vector_type_allowed
tofalse
to override the ability to use vector search as you initially set up HCD.Default: enabled for the installation of HCD with Vector Add-on.
- -Dcassandra.consistent_rangemovement
-
Overrides the default bootstrapping behavior of consistent range movement. In the case of an unavailable replica, the consistent bootstrap process can fail.
Default:
true
.
- -Dcassandra.disable_auth_caches_remote_configuration
-
Set to true to disable authentication caches, for example the caches used for credentials, permissions, and roles. This will mean those config options can only be set (persistently) in the
cassandra.yaml
file and requires a restart for new values to take effect.Default:
false
.
- -Dcassandra.expiration_date_overflow_policy
-
Set the policy (
REJECT
orCAP
) for any TTL (time to live) timestamps that exceeds the maximum value supported by the storage engine,2038-01-19T03:14:06+00:00
. The database storage engine can only encode TTL timestamps throughJanuary 19 2038 03:14:07 UTC
due to the Year 2038 problem.-
REJECT
(default): Reject requests that contain an expiration timestamp later than2038-01-19T03:14:06+00:00
. -
CAP
: Allow requests and insert expiration timestamps later than2038-01-19T03:14:06+00:00
as2038-01-19T03:14:06+00:00
. -
CAP-NOWARN
: Allow requests and insert expiration timestamps later than2038-01-19T03:14:06+00:00
as2038-01-19T03:14:06+00:00
, but do not emit a warning.
-
- -Dcassandra.force_default_indexing_page_size
-
Set to
true
to disable dynamic calculation of the page size used when indexing an entire partition during initial index build or a rebuild. Fixes the page size to the default of 10000 rows per page.Default:
false
.
- -Dcassandra.initial_token
-
Use when HCD is not using virtual nodes (vnodes). Because vnodes automatically select tokens, this property sets the initial partitioner token for the node on the first start up.
Default: Not set.
- -Dcassandra.join_ring
-
Default:
true
. Set tofalse
to prevent the node from joining a ring on startup.Add the node to the ring afterwards using
nodetool join
and a JMX call.
- -Dcassandra.load_ring_state
-
Set to
false
to clear all gossip state for the node on restart.Default:
true
.
- -Dcassandra.max_bf_memory_mb
-
Caps the maximum amount of memory used by bloom filters. A bloom filter is an off-heap structure associated with each SSTable that checks if any data for the requested row exists in the SSTable before doing any disk I/O.
DataStax recommends using the default (unlimited) for this
-Dcassandra.max_bf_memory_mb
property. Do not change this property unless directed to do so by DataStax Support. The lack of bloom filters can have negative performance consequences.Default: Unlimited.
- -Dcassandra.native_transport_port
-
Set to the port number that CQL native transport listens for clients.
Default:
9042
.
- -Dcassandra.native_transport_startup_delay_seconds
-
Set to the number of seconds to delay the native transport server start up.
Default:
0
(no delay).
- -Dcassandra.partitioner
-
Set to the partitioner name.
Default:
org.apache.cassandra.dht.Murmur3Partitioner
.
- -Dcassandra.partition_sstables_by_token_range
-
Default:
true
. Set tofalse
to disable JBOD SSTable partitioning by token range to multiple data_file_directories.This is an advanced setting that should only be used with guidance from DataStax Support.
- -Dcassandra.replace_address
-
Set to the
listen_address
or thebroadcast_address
when replacing a dead node with a new node. The new node must be in the same state as before bootstrapping, without any data in its data directory.The
broadcast_address
defaults to thelisten_address
except when the ring is using the Configuring Amazon EC2 multi-region snitch.
- -Dcassandra.printHeapHistogramOnOutOfMemoryError
-
Set to
false
to disable a heap histogram dump on an OutOfMemoryError.Default:
false
.
- -Dcassandra.replace_address_first_boot
-
Same as
-Dcassandra.replace_address
but only runs the first time the HCD node boots.This property is preferred over
-Dcassandra.replace_address
since it has no effect on subsequent boots if it is not removed fromjvm-server.options
orcassandra-env.sh
.
- -Dcassandra.replayList
-
Allows restoring specific tables from an archived commit log.
- -Dcassandra.ring_delay_ms
-
Set to the number of milliseconds the node waits to hear from other nodes before formally joining the ring.
Default:
30000
.
- -Dcassandra.ssl_storage_port
-
Sets the SSL port for encrypted communication.
Default:
7001
.
- -Dcassandra.start_native_transport
-
Enables or disables the native transport server. See
start_native_transport
incassandra.yaml
.Default:
true
.
- -Dcassandra.storage_port
-
Sets the port for internode communication.
Default:
7000
.
- -Dcassandra.write_survey
-
Set to
true
to enable a tool for testing new compaction and compression strategies.write_survey
allows you to experiment with different strategies and benchmark write performance differences without affecting the production workload. See Testing compaction and compression.Default:
false
.