keylabs_curl_test.txt for KeyLabs Test Packages
===========================================================

Curl is used to load test the ftp and Apache servers as well as the network
connections of a system.

Using the Curl Test
-------------------

Steps:

1. Put curl in the path (/usr/local/bin/ for example)
2. Copy testfiles into the proper ftp and httpd directories (see below)
3. Run the testfiles script once in each directory.
4. Check that all the ftp* and www* files are in the same directory
   as the startload and stopload script files.  Make sure all have
   executable permissions set.
5. Set the TESTMACHINE environmental variable to the IP address of the
   machine being tested.
6. Run the startload script to start the loop tests; run the stopload
   program to stop the loop tests.


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

1.  Put the curl program somewhere in the path: /usr/bin/ or /usr/local/bin for
    example.

2.  Next you'll need to make the test files used by the test.  These are the
    files which actually get transferred.  The file named testfiles is a simple bash
    script that uses /dev/zero to output the various test files that need to be on
    the test system.  Copy the file testfiles into the pub directory for your ftp
    installation (often /var/ftp/pub) and also copy it into the html directory of
    your httpd directory (often /var/www/html).  

3.  Make sure the file named
    testfiles is executable then run it once in each of the directories and the test
    files will be generated.

4.  The load testing scripts were developed using curl 5.5.1, but newer
    versions should work as well.  These are the script files with the names ftp*
    and www*.  They need to be in the directory from which you will run the
    startload and stopload script files.  These files will also have to have
    executable permissions set.

5.  Set the TESTMACHINE environmental variable to the IP address of the machine
    being tested.  For example: 

export TESTMACHINE=192.168.0.14

6.  The startload script file will run all 22 load test loops while the stopload
    script file will stop all load test loops.  Be sure to check the stopload program
    for executable permissions before you run startload.