Man Linux: Main Page and Category List

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