AUTOBENCH
Section: (1)
Updated: March 21, 2001
Index
NAME
autobench - Automates the benchmarking of web servers using httperf
SYNOPSIS
autobench [OPTIONS]...
DESCRIPTION
autobench
is used to to automate web server benchmarking. It runs httperf
against the specified host or hosts, ramping up the number of
requested connections, and logging the results in TSV or CSV format
files. Most options can also be specified in the configuration file
$HOME/.autobench.conf. Options specified on the command line override
those in the configuration file.
OPTIONS
- --file filename
-
Send output to filename instead of STDOUT
- --high_rate hrate
-
The number of connections per second to open at the end of the test
- --low_rate lrate
-
The number of connections per second to open at the start of the test
- --rate_step step
-
autobench runs httperf numerous times against the target machines,
starting at lrate connections per second, increasing the number
of connections per second requested by step until hrate is
reached.
- --host1 hostname
-
The hostname of the first server under test
- --host2 hostname
-
The hostname of the second server under test (ignored if --single_host
is specified)
- --num_conn nconn
-
nconn is the number total number of connections to open per test
- --num_call ncall
-
specifies the number of requests to send down each connection. (Total
number of requests per second = current rate * ncall.)
- --output_fmt tsv|csv
-
Set the output format to either CSV or TSV
- --quiet
-
Don't display httperf output on STDOUT. This option should always be
used if --file is not specified, since the httperf output will
otherwise break up the results table.
- --single_host
-
Only test a single server
- --timeout time
-
time is the time in seconds for which httperf will wait for a
response from the server - responses received after this time will be
counted as errors.
- --uri1 uri
-
The URI to test on the first server (eg. /foo/bar/index.html)
- --uri2 uri
-
The URI to test on the second server
- --version
-
Returns the current version
EXAMPLES
Notice that in each of the examples below, configuration options not
specified on the command line will be taken from the configuration
file ($HOME/.autobench.conf)
- autobench --single_host --host1 testhost.foo.com --uri1 /index.html --quiet --file bench.tsv
-
Benchmark testhost.foo.com using the URI /index.html, don't display
httperf output on STDOUT, and save the results in 'bench.tsv'.
- autobench --host1 test1.foo.com --host2 test2.foo.com --uri1 /10k.txt --uri2 /10k.txt --rate_step 50 --quiet
-
Conduct a comparative test of test1.foo.com and test2.foo.com,
increasing the requested number of connections per second by 50 on
each iteration. Output will go to STDOUT.
FILES
- /usr/local/etc/autobench.conf
-
Default configuration file, copied into the user's home directory when
autobench is first run.
- $HOME/.autobench.conf
-
The active autobench configuration file.
SEE ALSO
httperf(1),
crfile(1)
AUTHOR
Julian T. J. Midgley <jtjm@xenoclast.org>
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- EXAMPLES
-
- FILES
-
- SEE ALSO
-
- AUTHOR
-