xenial (1) openload.1.gz

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)