Increasing the Java heap size

After you configure the VMware VI agent, if you are monitoring a large VMware Virtual Infrastructure environment, then you might need to increase the heap size for the Java™ data provider.

About this task

The default maximum heap size for the Java™ data provider is 256 megabytes. You must set the maximum heap size to an appropriate value that depends on the size of the VMware environment. For information about the heap sizes that are required for the various VMware environments, see Table 1.
Important: The system, on which you install and configure the VMware VI agent, must have adequate memory space to accommodate the required heap size.
If any of the following problems arise, then you might need to increase the heap size:
  • The Java data provider stops because of a javacore problem, and creates a file that is named javacore.date.time.number.txt in the CANDLEHOME\tmaitm6_x64 directory.
  • The javacore.date.time.number.txt file contains the string java/lang/OutOfMemoryError.

Procedure

  • Windows Complete the following steps to set a value of 1 GB as the heap size:
    1. Open the %CANDLE_HOME%\TMAITM6_x64\kvm_data_provider.bat file.
    2. Add the following line before the line that starts with KVM_JVM_ARGS="%KVM_CUSTOM_JVM_ARGS...:
      SET KVM_CUSTOM_JVM_ARGS=-Xmx1024m
    3. Restart the agent.
  • LinuxComplete the following steps to set a value of 1 GB as heap size:
    1. Open the $CANDLEHOME/lx8266/vm/bin/kvm_data_provider.sh file.
    2. Add the following line before the line that starts with KVM_JVM_ARGS="$KVM_CUSTOM_JVM_ARGS...:
      KVM_CUSTOM_JVM_ARGS=-Xmx1024m
    3. Restart the agent.