Setting system properties during startup

Use the system property (-D) switch to modify the DataStax Enterprise (DSE) settings during start up. To automatically pass the settings each time DSE starts, uncomment or add the switch to the jvm-server.options file.

Depending upon the JVM you are using, switches may be located in either jvm8-server.options or jvm11-server.options.

Metrics collection is enabled by default. To disable metrics collection, set -Dinsights.default_mode to disabled.


Change the start up parameters using the following syntax:

  • Command line:

    dse cassandra -D<parameter_name>=<value>
  • jvm-server.options, jvm8-server.options, or jvm11-server.options file:

  • file:

    JVM_OPTS="$JVM_OPTS -D<parameter_name>=<value>"

Only pass the parameter to the start-up operation once. If the same switch is passed to the start operation multiple times, for example from both the jvm-server.options file and on the command line, DSE may fail to start or may use the wrong parameter.

Startup examples

Starting a node without joining the ring:

  • Command line:

    dse cassandra -Dcassandra.join_ring=false
  • jvm.options:


Replacing a dead node:

  • Command line:

    dse cassandra -Dcassandra.replace_address=
  • jvm.options:


Disabling DSE metrics collection:

  • Command line:

    // adoc partial file for content from ToolsWH.dita
    // <section conkeyref="ToolsWH/cstressDefinition"/>
    dse cassandra -Dinsights.default_mode=disabled
  • jvm-server.options:


Changing LDAP authentication retry interval from its default of 10 ms:

  • Command line:

  • jvm.options:

Cassandra system properties

Change DataStax Enterprise database native Cassandra system properties at startup.

Java Management Extension system properties

Change Java Management Extension system properties of the DataStax Enterprise database.

Search system properties

DataStax Enterprise Search system properties.

Threads per core system properties

Tune TPC using the Netty system parameters.

LDAP system properties for DataStax Enterprise Authentication

Change LDAP system properties.

Kerberos system properties

Change Kerberos system properties.

NodeSync system parameters

Tune NodeSync by setting the system properties at startup.

DSE Metrics Collector properties

Change DSE Metrics Collector JVM properties at startup.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2024 DataStax | Privacy policy | Terms of use

Apache, Apache Cassandra, Cassandra, Apache Tomcat, Tomcat, Apache Lucene, Apache Solr, Apache Hadoop, Hadoop, Apache Pulsar, Pulsar, Apache Spark, Spark, Apache TinkerPop, TinkerPop, Apache Kafka and Kafka are either registered trademarks or trademarks of the Apache Software Foundation or its subsidiaries in Canada, the United States and/or other countries. Kubernetes is the registered trademark of the Linux Foundation.

General Inquiries: +1 (650) 389-6000,