Parameter | Type | Default value | Description |
Globals: |
|||
Clients | Integer | 1 | Amount of virtual clients. |
Requests | Integer | 50 | How many times the main Test sequence [TestSeq] will be executed. |
Server | String (host) | Localhost | Name (or IP) of the server being tested. |
Uri | String | / | Default URI (can be redefined in specific requests). |
Port | Integer | 80/443 | Port number of the tested application. Defaults to 80 for HTTP and to 443 for HTTPS (secure connections). |
Method | GET/POST | GET | Default HTTP request method (can be redefined in specific requests). |
Timeout | Integer | 30 | Maximal time that Web Roller will wait for a response to a single request before dropping the connection (seconds). |
Delay | Integer | 0 | Delay inserted after each subsequent request (milliseconds). |
Keepalive | Yes/No | No | Triggers the use of keep-alive requests. |
Secure | Yes/No | No | Triggers the use of HTTPS (secure connections). |
Httpver | 1.1 or 1 | 1 | Version of HTTP protocol used by virtual clients. |
Delaystart | Integer | 0 | Delay between the start of subsequent virtual clients. By default, the server load with a great amount of virtual clients will rise quickly, but not abruptly. If we set this parameter to zero, all virtual clients will be launched exactly at the same time. |
Softdelay | Yes/No | No | Triggers a special mode of using the Delay: instead of pure Delay, the value of (Delay - total_request_time) will be used. This mode allows to provide a more even server load. |
Proxy | String (host:port) | <empty> | Name (or IP) and port of the external proxy server. |
Proxynocache | Yes/No | No | Triggers use of the external proxy caching. |
Maxrequests | Integer | 0 | Sets the limit for total amount of requests issued by all virtual clients. If this limit is reached, all clients will be shut down (in no dependence with the amount of requests issued by each separate client ). Zero = disabled. |
Nowait | Yes/No | No | Disable the timeout check. Allows to provide massive server loads using a single client computer. Consequently, can lead to hang-up of individual virtual clients. |
Scripting: |
|||
Scriptfile | N/A | Either a fully qualified filename of the file with script (must reside on local filesystem), or specify the language of inline script by using either of $inline.js, $inline.pl or $inline.vbs). Currently JScript, PerlScript and VBScript are supported (see also Scripting). | |
Endofscript | [/script] | The sequence of characters indicating the end of a script. | |
Runtime: |
|||
Proxyemulation | Yes/No | No | Adds the fields emulating access of multiple clients via a proxy (X-Forwarded-For) to the HTTP requests. Useful for emulating user activities from different IPs'. |
Proxymask | String (IP address) | 192.168.$C2.$C1 | IP mask used by proxyemulation.
Allowed meta-numbers: $C1 - low byte of the virtual client number. $C2 - high byte of the virtual client number. $R1 - low byte of the request number. $R2 - high byte of the request number. All values span from 1 to 254. To emulate a new IP for each request, you can set the mask as follows: $C2.$C1.$R2.$R1 If the amount of requests exceeds 64262, the numbers of $Rx will obviously be repeated. You can use a static number instead of the default $C2 if the number of clients does not exceed 253. |
Maxtime | Integer | 0 | The maximal time for the test run (seconds). A Test script will run until all requests are completed or its running time exceeds Maxtime. Zero = disabled. |
Abortseq | Yes/No | No | Selects whether to abort the running sequence if Maxtimeis reached or to wait for normal sequence termination. |
Noredir | Yes/No | No | Triggers processing of redirects. By default, Web Roller processes redirects - i.e. if the response to some request contains a redirect, Web Roller will make a respective request. The total of all redirects for the initial request will be accounted as the response time. If a redirect results in an error, the whole request will be accounted as failed. |
Ignoreerrors | Yes/No | No | Triggers whether to abort the sequence upon obtaining errors. Useful when running “negative” tests, when an error is the expected result. |
MaxSpeed | Integer | 0 | Allows to set network connection bandwidth limit for each virtual client. Useful for emulating modem connections. Set in kbps (kilobits per second). Zero = no limit. |
TimingMode | Integer | 0 |
Sets the mode of Web Roller time measurements.
|
Authorization | String (login:password) | <empty> | Basic authorization credentials. Substitutes the specified login:password for requests requiring basic authorization. |
Output: |
|||
Outfile | String | %n-%s-%cx%r.xls | The filename to write the summary results and statistics to. The resulting
Tab-separated files are suitable for immediate
work with MS Excel. Meta-characters: %n - project name; %s - server name (see server above); %c - virtual client number; %r - amount of requests per client (see requests above). |
Log | Yes/No | No | Triggers whether to write detailed log files (including all requests respective server responses). A separate log file is created for each virtual client. |
Showbadresults | Yes/No | Yes | Triggers whether to list the requests which resulted in errors to the summary file. |
Httperrorsymbol | String(8) | HTTPERR | A string indicating HTTP protocol errors - 400, 500, 404, 403 etc. Written to the summary file instead of response times. |
Socketerrorsymbol | String(8) | NETERR | A string indicating network (socket) errors. Written to the summary file instead of response times. |
Failerrorsymbol | String(8) | FAIL | A string indicating that the $fail error condition was obtained. Written to the summary file instead of response times. |
Timeouterrorsymbol | String(8) | T/O | A string indicating that a request timeout occurred. Written to the summary file instead of response times. |
Reportinfo | Yes/No | No | Triggers whether to include detailed test info into the summary file (amount of clients and requests, the username and workstation name of the client computer, projectname and description if set). |
Projectname | String | <empty> | Project name used by reportinfo. |
Description | String | <empty> | Test description used by reportinfo. |
Round | Integer | 10 | Sets the rounding limits. Zero = no rounding (minimum detected value = 0.01 mS). |
Timestamp | Yes/No | No | Triggers writing the times of starting and finishing of each test sequence to the summary file. |
Sumredirecttime | Yes/No | Yes | Triggers totaling of request times for redirects. |
Nodetails | Yes/No | No | Switch on/off writing of details for individual requests in the summary file. |
Printdate | Yes/No | No | Triggers whether to print the test date/time to the summary file. |
Appendresult | Yes/No | No | Triggers whether to append results (logs, summaries) to existing files with same names, or to erase existing files and start new ones. |
Summarytimes | Yes/No | Yes | Triggers printing of overall statistics in the summary file. |
Exacttiminginterval | Integer | 1000 | Minimum time (in milliseconds) required for accurate estimation of summarytimes. During this period ALL virtual clients should be active. |
Locale | String | <system default> | International settings for results output (date, time and delimiters format). To obtain a comma (“,”) as the decimal delimiter, set one of the appropriate locales (e.g. Russian). |