Set system properties during startup

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

Hyper-Converged Database (HCD) is built to run on Java 11.

The default JVM garbage collector for HCD is G1 GC. Configure GC options in the jvm11-server.options file.

Synopsis

Change the start up parameters using the following syntax:

  • Command line:

    hcd cassandra -D<parameter_name>=<value>
  • jvm-server.options file:

    -D<parameter_name>=<value>
  • cassandra-env.sh 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, HCD might fail to start or may use the wrong parameter.

Startup examples

Starting a node without joining the ring:

  • Command line:

    hcd cassandra -Dcassandra.join_ring=false
  • jvm-server.options file:

    -Dcassandra.join_ring=false

Replacing a dead node:

  • Command line:

    hcd cassandra -Dcassandra.replace_address=10.91.176.160
  • jvm-server.options file:

    -Dcassandra.replace_address=10.91.176.160

Apache Cassandra® system properties

Change HCD database native Cassandra system properties at startup.

Java Management Extension system properties

Change Java Management Extension system properties of the HCD database.

Was this helpful?

Give Feedback

How can we improve the documentation?

© 2025 DataStax | Privacy policy | Terms of use | Manage Privacy Choices

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, info@datastax.com