boinc/test
David Anderson fd316544cd various
svn path=/trunk/boinc/; revision=1536
2003-06-18 20:52:17 +00:00
..
.cvsignore write pid to pidfile ; trap sigints and exit on check_stop_trigger() ; stop servers by killing them 2003-06-14 20:25:36 +00:00
1sec_correct_output Initial revision 2002-04-30 22:22:54 +00:00
1sec_result make work 2002-10-09 04:56:41 +00:00
1sec_wu result retry 2002-11-07 19:31:34 +00:00
Makefile.am converting test scripts to python 2003-06-18 02:59:57 +00:00
Makefile.in *** empty log message *** 2003-06-18 03:04:06 +00:00
README config.xml paths ; test scripts 2003-06-14 20:15:52 +00:00
abort_result *** empty log message *** 2003-06-16 18:23:39 +00:00
boinc.py converting test scripts to python 2003-06-11 22:42:40 +00:00
boinc_db.inc various 2003-06-18 20:52:17 +00:00
boinc_db.py *** empty log message *** 2003-06-18 03:04:06 +00:00
concat_correct_output Initial revision 2002-04-30 22:22:54 +00:00
concat_result make work 2002-10-09 04:56:41 +00:00
concat_wu file sizes 2002-12-12 01:07:24 +00:00
db_def_to_php more test suite stuff 2003-06-11 23:09:11 +00:00
db_def_to_py *** empty log message *** 2003-06-18 03:04:06 +00:00
gen_keys.php http 1.0 2003-05-10 00:52:36 +00:00
init.inc bug fix 2003-02-14 23:19:51 +00:00
input Initial revision 2002-04-30 22:22:54 +00:00
log_flags.xml throughput limit and measurement 2003-02-26 00:47:57 +00:00
make_project.php renamed result_retry to timeout_check 2003-03-12 21:37:50 +00:00
make_project_ap.php admin interface to DB 2003-06-11 23:36:47 +00:00
make_project_sah.php renamed result_retry to timeout_check 2003-03-12 21:37:50 +00:00
miniserv.pl config.xml paths ; test scripts 2003-06-14 20:15:52 +00:00
shrm Script to remove shared memory segment in UNIX (for debugging). 2002-07-09 00:46:21 +00:00
small_input Initial revision 2002-04-30 22:22:54 +00:00
ta_correct_atc Added a test script for the api. 2002-06-24 02:29:51 +00:00
ta_correct_f Improved test_api.php, added app_completed to api, removed #ifdef solaris. 2002-07-03 20:48:01 +00:00
test.inc converting test scripts to python 2003-06-18 02:59:57 +00:00
test_1sec.php more test suite stuff 2003-06-11 23:09:11 +00:00
test_abort.php *** empty log message *** 2003-06-16 18:23:39 +00:00
test_api.php Improved test_api.php, added app_completed to api, removed #ifdef solaris. 2002-07-03 20:48:01 +00:00
test_backend.php test suite stuf 2003-06-11 23:47:36 +00:00
test_concat.php more test suite stuff 2003-06-11 23:09:11 +00:00
test_download_backoff.php more test suite stuff 2003-06-11 23:09:11 +00:00
test_limit.php more test suite stuff 2003-06-11 23:09:11 +00:00
test_loop.php test fixes 2003-04-01 07:34:08 +00:00
test_masterurl_failure.php testing upload and connection failures 2003-06-17 01:36:47 +00:00
test_mdownload_backoff.php more test suite stuff 2003-06-11 23:09:11 +00:00
test_pers.php more test suite stuff 2003-06-11 23:09:11 +00:00
test_prefs.php *** empty log message *** 2003-06-16 17:59:38 +00:00
test_rsc.php more test suite stuff 2003-06-11 23:09:11 +00:00
test_sanity.php test suite overhaul 2003-06-11 22:11:32 +00:00
test_sched_failure.php more test suite stuff 2003-06-11 23:09:11 +00:00
test_sticky.php test suite stuf 2003-06-11 23:47:36 +00:00
test_suite.php Rewrote build system using automake 2003-06-06 19:00:42 +00:00
test_time.php more test suite stuff 2003-06-11 23:09:11 +00:00
test_uc.inc testing upload and connection failures 2003-06-17 01:36:47 +00:00
test_uc.php testing upload and connection failures 2003-06-17 01:36:47 +00:00
test_uc.py converting test scripts to python 2003-06-11 22:42:40 +00:00
test_uc_slow.php *** empty log message *** 2003-06-16 17:59:38 +00:00
test_uc_win.php *** empty log message *** 2003-05-28 22:27:58 +00:00
test_upload_backoff.php converting test scripts to python 2003-06-18 02:59:57 +00:00
test_upload_resume.php testing upload and connection failures 2003-06-17 01:36:47 +00:00
test_water.php test scripts 2002-10-04 05:30:44 +00:00
testproxy converting test scripts to python 2003-06-18 02:59:57 +00:00
uc_correct_output Initial revision 2002-04-30 22:22:54 +00:00
uc_multiple_download_wu *** empty log message *** 2002-11-22 22:23:05 +00:00
uc_multiple_uploads_result *** empty log message *** 2002-11-22 22:23:05 +00:00
uc_result make work 2002-10-09 04:56:41 +00:00
uc_result_sticky test fixes 2003-04-01 07:34:08 +00:00
uc_small_correct_output Initial revision 2002-04-30 22:22:54 +00:00
uc_wu file sizes 2002-12-12 01:07:24 +00:00
uc_wu_sticky test fixes 2003-04-01 07:34:08 +00:00
ucs_wu file sizes 2002-12-12 01:07:24 +00:00
version.inc.in test suite overhaul 2003-06-11 22:11:32 +00:00
version.py.in converting test scripts to python 2003-06-11 22:42:40 +00:00

README

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

$Id$

TEST SCRIPTS
============
These test scripts will test that BOINC works as expected/designed.

PREREQUISITES
-------------
1. MySQL installed and running.  Currently the script expects it to be running
   on localhost but that could be changed.
2. Python 2.2, Python module MySQLdb
3. Perl
4. PHP

COREQUISITES
------------
1. Webserver.  Normally boinc.py will use the included miniserv.pl but any
   webserver could be used if configured. See below.

OTHER RECOMMENDED TOOLS
-----------------------
1. PHPMyAdmin.  Useful for viewing database.

RUNNING
-------

Type: (in either the test/ directory or the boinc source root directory)

   make check






APPENDICES
==========

OPTIONAL ENVIRONMENT VARIABLES
------------------------------
The following environment variables are optional and apply whatever web server
you use:

BOINC_TEST_USER_NAME
    User name to use for setting up database name. Defaults to $USER

BOINC_TEST_VERBOSE
    Verbosity level.
        0            print nothing
        1  [default] print some
                     if output is a tty, overwrite lines.
        2            print all

BOINC_TEST_DELETE
    Specifies whether or not to delete testbed after the test finishes. Case
    doesn't matter.  Only relevant when BOINC_TEST_AUTO_SETUP=0.  Possible
    values:
        No
        If-Successful   [default]
        Always

BOINC_TEST_INSTALL_METHOD
    Specifies how to install html/php, cgi from source directories to testbed
    location.
        link [default]   - hardlink
        symlink          - symbolic link
        copy             - copy

    Copying is useful because it preserves what version of the file was used
    in a particular test run and

    Hardlinking is best because compiled cgi and scheduler programs are not
    disrupted by parallel builds.


WEB SERVER
----------
By default, the test script will use the "miniserv" program to set up a web
server testing environment.  You can also use Apache or some other webserver
with manually set-up directories by setting these environment variables:

BOINC_TEST_AUTO_SETUP=0   [default=1]
BOINC_TEST_KEY_DIR
BOINC_TEST_PROJECTS_DIR
BOINC_TEST_CGI_URL
BOINC_TEST_HTML_URL
BOINC_TEST_CGI_DIR
BOINC_TEST_HTML_DIR
BOINC_TEST_HOSTS_DIR