000021398 - How do you increase the java heap size?

Document created by RSA Customer Support Employee on Jun 16, 2016Last modified by RSA Customer Support Employee on Apr 21, 2017
Version 2Show Document
  • View in full screen mode

Article Content

Article Number000021398
Applies ToJVM
RSA ClearTrust 5.5.2 Authorization Server (AServer)
IssueHow do you increase the java heap size?
How do you enable enhanced java heap garbage collection?
Error: "Java outOfMemoryError" in RSA ClearTrust 5.5.2 Authorization Server
AServer logs the following error message:

    sequence_number=636,2004-07-26 08:15:30:152 CDT,messageID=-2,internal_error,description='null',details='java.lang.OutOfMemoryError'
CauseThis can occur if there is insufficient JVM heap memory allocated to the AServer process. Sufficient real physical memory must be available to hold both operational variables, and the memory allocated to the AServer cache. AServer cache requirements may be considerable. See the configuration guide for information guidelines on how much memory may be consumed by cache. If any changes to AServer cache configuration are made in excess of the default values, then additional JVM heap memory may be required.
ResolutionThe JVM heap memory usage can be optimized by using an aggressive JVM garbage collection routines. The following JVM command line options are recommended for the AServer.

Here is a sample startup script using 512 MB heap memory:

$JAVA_HOME/bin/java -DAuth -Xms512m -Xmx512m -Xrs $DEBUG \
-Djava.ext.dirs=$JAVA_HOME/lib/ext:$CT_ROOT/lib \
-verbose:gc -Xnoclassgc -XX:+PrintGCDetails -Xloggc:/opt/ctrust55/logs/aserver-loggc.log \
-XX:NewSize=64m -XX:MaxNewSize=64m -XX:+UseParNewGC -XX:+UseConcMarkSweepGC \
-XX:+CMSParallelRemarkEnabled \
-XX:MaxTenuringThreshold=0 -XX:SurvivorRatio=128 \
sirrus.authserver.AuthorizationServer \
>> ${LOGFILE:-/dev/null} 2>&1 &

Modify the JVM startup parameters in the aserver.bat file, aserver.sh, or if started from services the registry entry.
NotesA comprehensive guide to tuning the JVM garbage collector can be found at http://java.sun.com/docs/hotspot/gc1.4.2/
Legacy Article IDa22800