Configuring the OpsCenter JVM

The OpsCenter JVM has been tuned to handle both large and small clusters with initial memory and garbage collection JVM parameters. These default values should be sufficient for most users. However, certain scenarios can arise that might require users to further tune these parameters.

Locate the opscenterd.log file. The location of this file depends on the type of installation:

  • Package installations: /var/log/opscenter/opscenterd.log

  • Tarball installations: install_location/log/opscenterd.log

There is an environmental variable OPSC_JVM_OPTS that can be set to override the default parameters. Here are some parameters you might consider tuning:

  • -Xmx: The maximum amount of heap space available for opscenterd to use. This default is 2048m (2GB), which should be enough for most installations. If you are managing multiple clusters or otherwise see OutOfMemory errors in opscenterd.log, try doubling the heap to 4096m (4GB). If memory-related issues continue, please contact DataStax Support for assistance.

  • -Xms: The initial amount of heap space that the opscenterd process uses on startup. Lower this value if opscenterd is having trouble starting.

  • Garbage Collection parameters for Java are not recommended for modification. However, if there is a need to modify and tune other garbage collection parameters, follow this guide for Java 8 and for Java 9.

  • The directory that Jython uses to load and execute dynamic classes (default is the system tmp directory). Change this to another directory if you are having trouble loading OpsCenter due to permissions on the default directory.

To modify these parameters, you can simply set the environment variable OPSC_JVM_OPTS prior to starting OpsCenter.

If OpsCenter is running while these parameters are set, a restart is required.

Updating maximum heap size JVM argument:

export OPSC_JVM_OPTS=-Xmx4096m
sudo service opscenterd restart

Depending on the Java implementation in use, the OPSC_JVM_OPTS environment variable value(s) may be reset and therefore ignore a setting override during startup. In this case, update your memory option values directly in the opscenterd startup script:

  • Tarball installations: <installation-location>/bin

  • Package installations: <installation-location>/etc/init.d/opscenterd

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,