Configure the OpsCenter JVM

The OpsCenter JVM is 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 you to further tune these parameters.

To configure the OpsCenter JVM, do the following:

  1. Locate the opscenter script. The location depends on the type of installation:

    • Package installations: /usr/share/opscenter/bin/opscenter

    • Tarball installations: INSTALL_DIRECTORY/bin/opscenter

  2. Locate the line beginning with OPSC_JVM_OPTS: in the opscenter script.

    For example:

    OPSC_JVM_OPTS="-server -Xmx2048m -Xms1024m -Dpython.cachedir.skip=false
                    -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=$OPSC_LOG_PATH
                    -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -XX:G1ReservePercent=0
                    -XX:ParallelGCThreads=4 -XX:ConcGCThreads=4 $GC_OPTIONS $OPSC_JVM_OPTS"

    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. When you are managing multiple clusters or you see OutOfMemory errors in opscenterd.log, try doubling the heap size to 4096m (4GB).

      If memory-related issues continue, contact IBM Support.

    • -Xms: The initial amount of heap space that the opscenterd process uses on startup. Lower this value if opscenterd is having trouble starting. Alternatively, setting this value to match -Xmx will prevent the JVM from dynamically resizing the heap, thus reducing performance overhead.

    • Do not modify Garbage Collection parameters for Java. However, if there is a need to modify and tune other garbage collection parameters, follow the Garbage Collection Tuning Guide for Java 8 or Java 9.

    • -Djava.io.tmpdir=/path/to/dir: 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.

  3. Edit the opscenter script directly, while OpsCenter is running or not.

  4. Restart OpsCenter:

    sudo service opscenterd restart

    You must restart OpsCenter any time you change these JVM parameters.

Was this helpful?

Give Feedback

How can we improve the documentation?

© Copyright IBM Corporation 2026 | 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: Contact IBM