Adjusting the Java Virtual Machine (JVM) Settings

As with any Java-based web application, you can sometimes improve performance by assigning particular values to the Java Virtual Machine options. You can edit the JVM minimum and maximum memory settings on a node, as well as the JVM "PermGen" setting by editing the values for JVM_HEAP_MAX, JVM_HEAP_MIN, and JVM_PERM_GEN variables. These values are expressed in MB. For example, to set the minimum and maximum heap available on the node to 4GB, add or edit the following lines to the file where the JVM properties are stored:

export JVM_HEAP_MAX=4096
export JVM_HEAP_MIN=4096

The following table lists the default JVM values for each of the nodes. Note that your particular community may need to decrease or increase these values depending on the size and traffic of your community. For sizing capacity recommendations, be sure to read Deployment Sizing and Capacity Planning.

JVM Defaults and Recommendations

Node File Location of Stored Values on the Node Default JVM Values Additional Notes and Recommendations
Jive Web Application(s) /usr/local/jive/applications/<instance-name>/bin/instance
JVM_HEAP_MIN=<value in MB>
JVM_HEAP_MAX=<value in MB>
JVM_PERM_GEN=<value in MB>
To ensure that the appropriate resources are available to the running application, we recommend setting the JVM_HEAP_MIN and JVM_HEAP_MAX to the same value on the web application node(s). In a clustered environment, these min and max values should be the same for all of the web application nodes. For larger communities, that is, communities that get more than 100,000 page views per day or that contain a large amount of content (more than 100,000 messages, documents, or blog posts), you may need to increase the JVM heap min and max settings to be both 4096 or both 6144.The JVM_PERM_GEN should remain unchanged from the default value.
Additional Cluster Nodes (if your configuration includes these optional nodes) /usr/local/jive/applications/<instance-name>/bin/instance
JVM_HEAP_MIN=<should match the web app node's values>
JVM_HEAP_MAX=<should match the web app node's values>
JVM_PERM_GEN=<should match the web app node's values>
These values should match those of the primary web app nodes.
Activity Engine /usr/local/jive/services/eae-service/bin/instance
JVM_HEAP_MIN=<value in MB>
JVM_HEAP_MAX=<value in MB>
By default, the Activity Engine does not use a JVM_PERM_GEN value.
Cache Server(s) (if your configuration includes these optional nodes) /usr/local/jive/etc/conf/cache.conf By default, the cache server(s) does not use a JVM_PERM_GEN value. To change the JVM heap settings on the cache server(s), see Adjusting JVM Settings on the Cache Server.  
Document Conversion (if you have this optional module) /usr/local/jive/services/docconverter/bin/instance
JVM_HEAP_MIN=<value in MB>
JVM_HEAP_MAX=<value in MB>
JVM_PERM_GEN=<value in MB>
We recommend not changing the default settings. They have consistently performed well in all pre-release quality, stress, and performance tests.