IBM Support

How do I increase the JVM setting for ClearQuest Web server for optimal performance and to avoid out-of-memory errors?

Technote (troubleshooting)


Problem(Abstract)

During an installation or upgrade to IBM Rational ClearQuest V8.0 or V8.0.0.x, the IBM Installation Manager does not increase the JVM setting for optimal performance.

Symptom

Running ClearQuest Web server in an IBM WebSphere Application Server environment with a JVM setting of less than 1 GB can lead to stability issues such as out-of-memory errors.


Cause

During an installation or upgrade to Rational ClearQuest Web server V8.0 or V8.0.0.x, the IBM Installation Manager does not set the JVM heap size value for the WebSphere Application Server profile. By default, when a new WebSphere Application Server profile is created, the JVM value is set to 256 MB. This value is too low for ClearQuest Web server V8.0 and V8.0.0.x and must be increased to 1 GB.

Resolving the problem

NOTE: This technote is not required for ClearQuest 8.0.0.6 or later.


After installing or upgrading ClearQuest Web server to ClearQuest V8.0 or V8.0.0.x, ensure that you increase the default JVM setting for the WebSphere Application Server profile by following the next steps.

Before you begin

The examples in the next procedure assume that ClearQuest Web server is deployed in the default profile cqwebprofile.  If you deploy ClearQuest Web server in a different profile name, use that profile name instead of cqwebprofile. Also, this example assumes you have WebSphere and ClearQuest are installed in the default directory.

Procedure

1. In a Windows command prompt window or a UNIX or Linux command shell, navigate to your ClearQuest scripts directory. For example:

    On Windows:
      cd C:\Program Files\IBM\RationalSDLC\ClearQuest\cqweb\scripts\

    On the UNIX system and Linux:
      /opt/ibm/RationalSDLC/clearquest/cqweb/scripts/

2. Run the following WebSphere command to set the JVM heap size for the WebSphere Application Server profile in which ClearQuest Web server is deployed to 1024. For example:
    On Windows:
      C:\Program Files\IBM\WebSphere\AppServer\bin\wsadmin.bat -profile -profileName cqwebprofile teamAdminUtils.jacl -c "setJvmMaxHeapSize 1024"

    On the UNIX system and Linux:
      /opt/IBM/WebSphere/AppServer/bin/wsadmin.sh -profile -profileName cqwebprofile "/opt/ibm/RationalSDLC/clearquest/cqweb/scripts/teamAdminUtils.jacl" -c "setJvmMaxHeapSize 1024"

3) Restart the WebSphere Application Server profile for the change to take effect. For example:
    On Windows:

      C:\Program Files\IBM\WebSphere\AppServer\bin\stopServer.bat server1 -profileName cqwebprofile
      C:\Program Files\IBM\WebSphere\AppServer\bin\startServer.bat server1 -profileName cqwebprofile

    On the UNIX system and Linux:

      /opt/IBM/WebSphere/AppServer/bin/stopServer.sh server1 -profileName cqwebprofile
      /opt/IBM/WebSphere/AppServer/bin/startServer.sh server1 -profileName cqwebprofile

Product Alias/Synonym

ClearQuest

Document information

More support for: Rational ClearQuest
CM Server

Software version: 8.0, 8.0.0.1, 8.0.0.2, 8.0.0.3, 8.0.0.4, 8.0.0.5

Operating system(s): AIX, Linux, Solaris, Windows

Reference #: 1610500

Modified date: 22 July 2013