boinc/test/README

91 lines
2.2 KiB
Plaintext
Raw Normal View History

$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