Configure runtime settings manually
To configure Vuser runtime settings manually, you modify the default.cfg and default.usp files created with the script.
Overview
The default.cfg and default.usp files are located in the script folder. The settings detailed below appear in either the default.cfg file or the default.usp file, as follows:
default.cfg | default.usr |
---|---|
General Think Time Log Web (for relevant protocols) |
Run Logic Pacing |
These runtime settings correspond to VuGen's runtime settings (see Configure runtime settings).
General settings
There is one General setting for Linux Vuser scripts:
ContinueOnError instructs the Vuser to continue when an error occurs. To activate the option, specify 1. To disable the option, specify 0.
In the following example, the Vuser will continue on an error.
[General] ContinueOnError=1
Think Time settings
You can set the Think Time settings to control how the Vuser uses think time when running the script. You set the parameters Options, Factor, LimitFlag, and Limit parameters according to the following chart.
Option
|
Options
|
Factor
|
LimitFlag
|
Limit
|
---|---|---|---|---|
Ignore think time
|
NOTHINK
|
N/A
|
N/A
|
N/A
|
Use recorded think time
|
RECORDED
|
1.000
|
N/A
|
N/A
|
Multiply the recorded think time by...
|
MULTIPLY
|
number
|
N/A
|
N/A
|
Use random percentage of recorded think time
|
RANDOM
|
range
|
lowest percentage
|
upper percentage
|
Limit the recorded think time to...
|
RECORDED/ MULTIPLY
|
number (for MULTIPLY)
|
1
|
value in seconds
|
To limit the think time used, set the LimitFlag
variable to 1 and specify the think time Limit
, in seconds.
In the following example, the settings tell the Vuser to multiply the recorded think time by a random percentage, ranging from 50 to 150.
[ThinkTime] Options=RANDOM Factor=1 LimitFlag=0 Limit=0 ThinkTimeRandomLow=50 ThinkTimeRandomHigh=150
Log settings
You can set the Log settings to create a brief or detailed log file for the script run.
[Log] LogOptions=LogBrief MsgClassData=0 MsgClassParameters=0 MsgClassFull=0
You set the parameters LogOptions, MsGClassData, MsgClassParameters, and MsgClassFull variables according to the following chart:
Logging Type
|
LogOptions
|
MsgClassData
|
MsgClassParameters
|
MsgClassFull
|
---|---|---|---|---|
Disable Logging
|
LogDisabled
|
N/A
|
N/A
|
N/A
|
Standard Log
|
LogBrief
|
N/A
|
N/A
|
N/A
|
Parameter Substitution (only)
|
LogExtended
|
0
|
1
|
0
|
Data Returned by Server (only)
|
LogExtended
|
1
|
0
|
0
|
Advanced Trace (only)
|
LogExtended
|
0
|
0
|
1
|
All
|
LogExtended
|
1
|
1
|
1
|
In the following example, the settings tell the Vuser to log all data returned by the server and the parameters used for substitution.
[Log] LogOptions=LogExtended MsgClassData=1 MsgClassParameters=1 MsgClassFull=0
Web settings
In the Web settings, you can specify the following settings.
Bypass HTTP codes
You can set certain HTTP codes to be bypassed if they are received when running the script. If a specified HTTP code is received when the script is run, the HTTP code is bypassed and is not treated as an error.
To specify the HTTP codes you want to bypass, you add ByPassHTTPCode="<HTTP codes>" to the Web section of the default.cfg file. For example, if you want to bypass HTTP codes 403 and 404, add the following line:
ByPassHTTPCode="403,404"
Use CNG Engine
Version support: This option is supported from version 24.3.
You can set the script to use the OpenSSL Cryptographic Next Generation (CNG) Engine when running the script, instead of the default CAPI engine. This provides support for the CNG private key when processing certificates in Windows Certificate Store.
To set CNG Engine user, add the following to the Web section of the default.cfg file:
OpensslEngineType=1
To use the CNG Engine when recording the script, see HTTP properties > Advanced recording options.
Iterations and run logic
You can set the Iteration settings to perform multiple iterations and control the pacing between the iterations. You can also manually set the order of the actions and their weight. To modify the run logic and iteration properties of a script, you edit the default.usp file.
To instruct the Vuser to perform multiple iterations of the Actions section, set RunLogicNumOfIterations to the appropriate value.
To control the pacing between the iterations, set the RunLogicPaceType variable and its related values, according to the following chart:
Pacing
|
RunLogicPaceType
|
Related Variables
|
---|---|---|
As soon as possible
|
ASAP
|
N/A
|
Wait between Iterations for a set time
|
Const
|
RunLogicPaceConstTime
|
Wait between iterations a random time
|
Random
|
RunLogicRandomPaceMin, RunLogicRandomPaceMax
|
Wait after each iteration a set time
|
ConstAfter
|
RunLogicPaceConstAfterTime
|
Wait after each iteration a random time
|
After
|
RunLogicAfterPaceMin, RunLogicAfterPaceMax
|
In the following example, the settings tell the Vuser to perform four iterations, while waiting a random number of seconds between iterations. The range of the random number is from 60 to 90 seconds.
[RunLogicRunRoot] MercIniTreeFather="" MercIniTreeSectionName="RunLogicRunRoot" RunLogicRunMode="Random" RunLogicActionOrder="Action,Action2,Action3" RunLogicPaceType="Random" RunLogicRandomPaceMax="90.000" RunLogicPaceConstTime="40.000" RunLogicObjectKind="Group" RunLogicAfterPaceMin="50.000" Name="Run" RunLogicNumOfIterations="4" RunLogicActionType="VuserRun" RunLogicAfterPaceMax="70.000" RunLogicRandomPaceMin="60.000" MercIniTreeSons="Action,Action2,Action3" RunLogicPaceConstAfterTime="30.000"