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