openload (1)

openload [options] url [clients]

This manual page documents briefly the openload usage.

This manual page was written for the Debian distribution because the original program does not have a manual page.

openload is (currently) a commandline tool, easy to use and providing near real-time performance measurements of the application under test which is very usefull during optimizations.

openload uses the usual GNU command line syntax, but the options starting with one dash (`-').

To run this program it is necessary to set the PATH or URL under test. You can set the clients number after the URL, which is the number of simultanous clients to simulate, defaults to 5.

A summary of options is included below.

-t

Test mode: No throughput measurements are done. However the full response from the webserver (including headers) is displayed. This is useful for verifying that you get the right content before executing the real test. In this mode the number of clients defaults to 1.

-h

Header value: Specifies a HTTP request header. You can use this option several times to specify several headers. The sentence is -h followed by the name of header and the quoted value, separated by spaces. E.g. openload -h User-Agent "MSIE 5.0" mysite.com

-l

Time limit: number of seconds. The test will only run for the specified number of seconds. The sentence is -l followed by number of seconds, separated by spaces. E.g. openload -l 10 mysite.com

-o

Output mode: Currently only CSV (comma seperated values) is supported. This is useful for importing the result in a spreadsheet. The fields are: Url, Number of clients, TPS (Transactions Per Second), Average response time (seconds), Maximum response time, Total number of requests.

-v

Verifier mode: (undocumented)

-b

Body request: The test just request body response from the test URL. E.g. openload -b mysite.com

A description of output results is listing below.

    * MaTps: a 20 second moving average of TPS.
    * Tps: (Transactions Per Second) is the number of completed requests during that second.
    * Resp Time: the average response time in seconds for the elapsed second.
    * Err: the percentage of responses that was erronous, i.e. didn't return a HTTP 200 Ok staus.
    * Count: the total number of completed requests.
    * Total TPS is the average TPS for the whole run, i.e. (Total completed requests) / (Total elapsed time).
    * Avg. Response time: the overall average response time in seconds.
    * Max Response time: the highest response time during this run.

To abort the process just press Enter or return Key, or use the terminal interrupt key (usually Ctrl-C).

For a complete description of data results see the README file.

openload was written by Pelle Johnsen <[email protected]>.

This manual page was written by Silvia Alvarez <[email protected]>, for the Debian project (but may be used by others).