Increasing the maximum JVM heap size

You can increase the JVM maximum heap size for CM Server.

The IBM® WebSphere® Application Server installation that is part of CM Server may use a default maximum heap size that must be increased. You can set the JVM heap size from the command line by using a utility provided in the installation.

You first must navigate to the directory in a command prompt to the CM scripts directory (for example, C:\Program Files\IBM\RationalSDLC\common\cm\scripts on Windows®, and /opt/IBM/RationalSDLC/common/CM/scripts on the UNIX® system, and /opt/ibm/RationalSDLC/common/CM/scripts on Linux®). In the following commands, %WAS_BIN% is the path to your eWAS\bin directory (for example, C:\Program Files\IBM\RationalSDLC\common\eWAS\bin).

The following command (on Windows) shows the current maximum heap size:
%WAS_BIN%\wsadmin.bat -profile teamAdminUtils.jacl -c "getJvmMaxHeapSize" 
The following command (on Windows) sets the maximum heap size to 1024 MB:
%WAS_BIN%\wsadmin.bat -profile teamAdminUtils.jacl -c "setJvmMaxHeapSize 1024"
If you have more than one WebSphere Application Server profile, you can modify the examples to also specify the profile. For example:
%WAS_BIN%\wsadmin.bat -profile -profileName cmprofile teamAdminUtils.jacl -c "getJvmMaxHeapSize"
%WAS_BIN%\wsadmin.bat -profile -profileName cmprofile teamAdminUtils.jacl -c "setJvmMaxHeapSize 1024"
You can also use these commands for the UNIX system and on Linux. For example:
$WAS_BIN/wsadmin.sh -profile -profileName cmprofile teamAdminUtils.jacl -c "getJvmMaxHeapSize" 
$WAS_BIN/wsadmin.sh -profile -profileName cmprofile teamAdminUtils.jacl -c "setJvmMaxHeapSize 1024"

The Windows CM Server registry setting that controls the noninteractive heap size on the CM Server for CCRC or ClearQuest® Web server might need to be changed rather than use the default settings. To prevent errors, you can increase the non-interactive desktop heap size. Also, the default registry value for SessionViewSize on Windows must be increased if your system supports larger numbers of CM Server users.


Feedback