OPENLOAD(1)						      General Commands Manual						       OPENLOAD(1)

NAME

       openload - Tool for load testing of web applications

SYNOPSIS

       openload [options] url [clients]

DESCRIPTION

       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.

OPTIONS

       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

OUTPUT RESULTS

       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.

ABORTING THE PROCESS

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

SEE ALSO

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

AUTHOR

       openload was written by Pelle Johnsen <pelle.johnsen@mail.dk>.

       This manual page was written by Silvia Alvarez <sils@powered-by-linux.com>, for the Debian project (but may be used by others).

								 January 29, 2007						       OPENLOAD(1)