ftpbench

.. -- mode: rst --

What is ftpbench?

It's benchmark for load testing FTP servers.

Feature

• login benchmark
• upload benchmark (STOR command)
• download benchmark (RETR command)
• run test for multiple servers
• auto-detection for dns round-robin records
• save result to cvs file

Requires

• gevent (http://www.gevent.org/)
• dnspython (http://www.dnspython.org/)
• docopt (http://docopt.org)
• Timecard (https://github.com/selectel/timecard)

Installation

From source::

$ git clone https://github.com/selectel/ftpbench
$ cd ftpbench/
$ python setup.py install  # auto install all requires

From pypi::

$ pip install ftpbench

Standalone for ubuntu::

$ apt-get install python-gevent python-dnspython
$ git clone https://github.com/selectel/ftpbench
$ cd ftpbench/ftpbench/
$ wget https://raw.githubusercontent.com/docopt/docopt/master/docopt.py
$ wget https://raw.githubusercontent.com/selectel/timecard/master/timecard.py
$ python ftpbench.py --help

Usage

Run::

$ ftpbench --help

FTP benchmark.

Usage:
    ftpbench --help
    ftpbench -h <host> -u <user> -p <password> [options] login
    ftpbench -h <host> -u <user> -p <password> [options] upload <workdir> [-s <size>]
    ftpbench -h <host> -u <user> -p <password> [options] download <workdir> [-s <size>] [--files <count>]

Connection options:
    -h <host>, --host=<host>              FTP host [default: 127.0.0.1:21]
                                          You can list multiple servers, separated by commas,
                                          e.g.: -h 10.0.0.1,10.0.0.2,10.0.0.3.
                                          Auto-detection of dns round-robin records is supported.
    -u <user>, --user=<user>              FTP user
    -p <password>, --password=<password>  FTP password

Timing options:
    -t <sec>, --timeout=<sec>             Timeout for operation [default: 10]
    --maxrun=<minutes>                    Duration of benchmarking in minutes [default: 5]
    --fixevery=<sec>                      Recording period for stat values [default: 5]

Benchmark options:
    -c <count>, --concurrent=<count>      Concurrent operations [default: 10]
    --csv=<file>                          Save result to csv file
    <workdir>                             Base ftp dir to store test files
    -s <size>, --size=<size>              Size of test files in MB [default: 10]
    --files <count>                       Number of files generated for download test [default: 10]