Setting system properties during startup
Modify DataStax Enterprise system properties from the startup command line or file.
jvm-server.options
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
Package installations | /etc/dse/cassandra/jvm [8 | 11] -server.options |
Tarball installations | installation_location/resources/cassandra/conf/jvm [8 | 11] -server.options |
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 |
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
.Synopsis
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:
-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-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:
-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