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)