keylabs_bonnie_test.txt for KeyLabs Test Packages
=============================================================

Bonnie is a file system benchmarking utility.  It is used for identifying
and measuring file system bottlenecks.  It is also useful for stress
testing the file system since it can put a heavy load on a file system.

Using bonnie
------------

Steps:

1. Put bonnie in your path (/usr/local/bin/ is good)
2. Set the BONNIESIZE variable (see below)
3. Execute the run-bonnie script

Steps Explained
---------------

1. To use bonnie you'll first want to make sure bonnie is somewhere in the
   path so the system can find and run it.  One of the common bin directories
   is good (/usr/local/bin/) or your personal bin directory (~/bin/) will
   work too.

The run-bonnie script, obviously, requires the bonnie disk test to be
installed and in the path. The run-bonnie script is a simple script used to run the "bonnie" disk test over and over. 

2. You need to set up the BONNIESIZE environment variable before
   running this script. Multiply the ammount of system memory (measured in MB) by 2.5 and
   execute tne following, where n equals your desired test size in megabytes:

export BONNIESIZE=n

You can check the BONNESIZE variable with this command:

echo $BONNIESIZE

3.  If you have problems getting bonnie or run-bonnie to run, check permissions
    on the two files: Both must be executable.  Also, Bonnie will only handle 2GB file sizes per execution.
    If you need a larger file size, set the BONNIESIZE variable to 2GB and run two instances of Bonnie from different
    paths.  This will effectively give you 4GB worth of files. 

Bonnie will return some information about each test.  See the man page for
specifics about the output contents and format.