Setting system properties during startup

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

cassandra-env.sh

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

jvm.options

The location of the jvm.options file depends on the type of installation:
Package installations /etc/dse/cassandra/jvm.options
Tarball installations installation_location/resources/cassandra/conf/jvm.options
Use the system property (-D) switch to modify the DataStax Enterprise (DSE) settings during start up.
Tip: To automatically pass the settings each time DSE starts, uncomment or add the switch to the jvm.options file.
Important: As of DSE 6.7, metrics collection is enabled by default. To disable metrics collection, set -Dinsights.default_mode to disabled.

Synopsis

Change the start up parameters using the following syntax:
  • Command line:
    dse cassandra -Dparameter_name=value
  • jvm.options file:
    -Dparameter_name=value
  • cassandra-env.sh 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.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:
    -Dcassandra.join_ring=false
Replacing a dead node:
  • Command line:
    dse cassandra -Dcassandra.replace_address=10.91.176.160
  • jvm.options:
    -Dcassandra.replace_address=10.91.176.160
Disabling DSE metrics collection:
  • Command line:
    dse cassandra -Dinsights.default_mode=disabled
  • jvm-server.options:
    -Dinsights.default_mode=disabled
Changing LDAP authentication retry interval from its default of 10 ms:
  • Command line:
    dse -Ddse.ldap.retry_interval.ms=20
  • jvm.options:
    -Ddse.ldap.retry_interval.ms=20