How to change the JBoss heap memory

After the installation of JBoss , it is sometimes necessary to change the heap memory used by JBoss. This is usually done when there is an increase in the number of active projects in Quality Center or an increase in the number of concurrent user sessions.

Increasing the heap size (virtual memory) for JBoss

For Windows, you can increase the heap size by uninstalling/reinstalling the Quality Center Service and modifying the InstallJbossService.bat file. For Linux/Unix, you need to modify the run.sh file. The user who re-installs the JBOSS service should be the same user that is running the JBOSS service. Usually that is the Local System Account.

Recommended heap sizes, depending on the number of concurrent user sessions:

Small: 128 – 256MB ~ Up to 10 concurrent user sessions

Medium: 256 – 512MB ~ Up to 100 concurrent user sessions

Very Large: 1024 – 2048MB ~ Up to 350 concurrent user sessions

Notes:

Neither value can be more than your max RAM size

Neither value can be more than supported by your Operating System

Uninstall/Reinstall QC Service for Windows:

Note: Verify that users are not working on Quality Center and Quality Center Service is stopped.

1. Open Command Prompt and navigate to "<Drive Letter:>\program files\HP\Quality Center\jboss\bin" folder.

Note: For TestDirector for Quality Center 9.0 the path is "<Drive Letter:>\program files\Mercury\Quality Center\jboss\bin"

2. Execute the following command (this will uninstall the existing service):

InstallJbossService.bat -uninstall

3.Edit the InstallJbossService.bat file.

Example:

If the heap memory is currently:

set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx512m

increase the heap size as follows:

set JAVA_OPTS=%JAVA_OPTS% -Xms512m -Xmx1024m

4. Save and close the InstallJbossService.bat.

5. Execute the following command (this will install the service with the modified heap size parameter):

InstallJbossService.bat -c default (-help shows options)

6. Verify that the service has been installed, Control Panel -> Administrative Tools -> Services.

7. Start the HP Quality Center Service.

8. Check that the Quality Center Debug Console shows heap size that was specified as available memory:

http://hostname:8080/qcbin/servlet/tdservlet?method=debuginfo

http://hostname:8080/sabin/servlet/tdsiteadminservlet?method=debuginfo

Notes:

If you are using a cluster environment, the hostname should be the cluster machine name, and you will need to apply the above steps to each cluster.

Also edit the run.bat file to ensure it is synchronized with the way the QC service runs.

Modify the run.bat file:

1. On the application server, locate the JBoss bin folder under your TD for QC installation. By default, the location is <System Drive:>\Program Files\HP\Quality Center\JBoss\bin.

Note: For TestDirector for Quality Center 9.0 the path is <System Drive:>\Program Files\Mercury\Quality Center\JBoss\bin.

2. Edit the run.bat file (or run.sh for Linux/Unix).

Example:

If the heap memory is currently:

set JAVA_OPTS=%JAVA_OPTS% -Xms256m -Xmx512m

increase the heap size as follows:

set JAVA_OPTS=%JAVA_OPTS% -Xms512m -Xmx1024m

3. Save and close the run.bat.

4. Execute the run.sh file only for Linux/Unix.

Advertisements

One thought on “How to change the JBoss heap memory

  1. locksmith carrollton

    Nice post. I was checking constantly this blog and I’m impressed!
    Very useful information particularly the last part 🙂 I care for
    such information much. I was seeking this certain info for a long time.
    Thank you and best of luck.

    Reply

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s