Increasing memory allocation

The virtual users accessing your Web server require memory to prepare requests, send requests, and receive responses. If you receive an out-of-memory error, you should override the default amount of memory that is allocated.

On remote computers running Windows XP, Windows 2003 Server, Red Hat Enterprise, or SuSE, the property RPT_DEFAULT_MEMORY_SIZE is automatically set to 75% of total memory size after the first schedule run. This value, although arbitrary, is intended to provide the best execution environment for your computer.

On other remote computers, this property is not automatically set. Therefore, you are somewhat more likely to receive an out-of-memory error.

If you receive an out-of-memory error when you run a test or schedule, increase the memory allocation for that remote computer. To do this, set the RPT_VMARGS property, which overrides RPT_DEFAULT_MEMORY_SIZE.

To increase the memory allocation on a remote computer:

  1. In the Test Navigator (from your local computer), expand the project until you find the deployment location that you want to change. Deployment locations are represented by the "location icon, which looks like three little monitors" icon.
  2. Right-click the deployment location, and then click Open.
  3. In the deployment location, click the Attributes tab, and then click Add.
  4. In the New Property window:
    1. In the Property Name field, enter RPT_VMARGS.
    2. In the Operator field, confirm that the operator is =.
    3. In the Property Value field, enter -Xmxnnnnm, where nnnn is the amount of memory, in megabytes, and then click OK
    The following New Property window sets maximum heap to 2000 megabytes:
    New Property window,
which shows the Property Name set to RTP_VMARGS, the Operator set to Equals,
and the Property Value set to -Xmx2000m
Note: If, after increasing available memory, you still receive out-of-memory errors, add additional remote computers for your user groups. For more information on how to do this, see Running a user group at a remote location.

Parent topic: Running schedules

Terms of use | Feedback
(C) Copyright IBM Corporation 2005. All Rights Reserved.