Setting system properties during startup

Modify DataStax Enterprise system properties from the startup command line or file.

The location of the file depends on the type of installation:
Package installations /etc/dse/cassandra/
Tarball installations installation_location/resources/cassandra/conf/


There are three files that control Java Virtual Machine options:
  • jvm-server.options: options independent of any particular JVM
  • jvm8-server.options: options particular to JVM 8
  • jvm11-server.options: options particular to JVM 11
The location of the jvm [8 | 11] -server.options file depends on the type of installation:
Package installations /etc/dse/cassandra/jvm [8 | 11] -server.options
Tarball installations installation_location/resources/cassandra/conf/jvm [8 | 11] -server.options
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.
Important: Depending upon the JVM you are using, switches may be located in either jvm8-server.options or jvm11-server.options.
Important: 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 -Dparameter_name=value
  • jvm-server.options, jvm8-server.options, or jvm11-server.options file:
  • file:
    JVM_OPTS="$JVM_OPTS -Dparameter_name=value"
Warning: 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:
    dse cassandra -Dinsights.default_mode=disabled
  • jvm-server.options:
Changing LDAP authentication retry interval from its default of 10 ms:
  • Command line:
  • jvm.options: