Configuring the DataStax Agent JVM

The DataStax Agent JVM is designed to have a minimal footprint on your nodes and simply work without extra configuration for most environments.

JVM properties for the agent are configured in datastax-agent-env.sh. The default location of this DataStax agent environment shell script depends on the type of installation:

  • Package installations: /etc/datastax-agent/datastax-agent-env.sh

  • Tarball installations: install_location/agent/conf/datastax-agent-env.sh

Agent Heap Size

For most environments, the DataStax agent will require 1GB of heap. If an agent is experiencing OutOfMemory issues, try changing the -Xmx property in datastax-agent-env.sh to 2048M (-Xmx2048M). If issues still persist, please contact DataStax Support so DataStax can determine whether your environment requires even more heap or if there is an issue in the agent.