Increasing memory allocation

The virtual users that access your Web server require memory to prepare requests, send requests, and receive responses. Because the amount of memory is not automatically set on remote computers, you might receive an out-of-memory error. To correct this situation, increase the memory allocation for that computer.

About this task

If you receive an out-of-memory error when you run a test or schedule, override the default amount of memory that is allocated for that computer. To do this, set the RPT_VMARGS property, which overrides RPT_DEFAULT_MEMORY_SIZE.

Procedure

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. Under Property Groups, click the General Properties link, and then click Add.
  4. In the New Property window:
    1. In the Property Name field, type RPT_VMARGS.
    2. In the Operator field, confirm that the operator is =.
    3. In the Property Value field, type -Xmxnnnnm, where nnnn is the amount of memory, in megabytes, and then click OK.
    If you need to set multiple RPT_VMARGS values for a location, place them in the same property entry and separate them with a space. Do not use multiple property entries to set multiple RPT_VMARGS values for a location. The following New Property window sets maximum heap to 1500 megabytes:
    New Property window, which shows the Property Name set to RPT_VMARGS, the Operator set to Equals, and the Property Value set to -Xmx1500m

What to do next

If you have increased the available memory and you still receive out-of-memory errors, add more remote computers for your user groups. For information about how to do this, see Running a user group at a remote location.

Feedback