diff options
author | Erlang/OTP <[email protected]> | 2009-11-20 14:54:40 +0000 |
---|---|---|
committer | Erlang/OTP <[email protected]> | 2009-11-20 14:54:40 +0000 |
commit | 84adefa331c4159d432d22840663c38f155cd4c1 (patch) | |
tree | bff9a9c66adda4df2106dfd0e5c053ab182a12bd /lib/test_server/README | |
download | otp-84adefa331c4159d432d22840663c38f155cd4c1.tar.gz otp-84adefa331c4159d432d22840663c38f155cd4c1.tar.bz2 otp-84adefa331c4159d432d22840663c38f155cd4c1.zip |
The R13B03 release.OTP_R13B03
Diffstat (limited to 'lib/test_server/README')
-rw-r--r-- | lib/test_server/README | 113 |
1 files changed, 113 insertions, 0 deletions
diff --git a/lib/test_server/README b/lib/test_server/README new file mode 100644 index 0000000000..fc71c90ca8 --- /dev/null +++ b/lib/test_server/README @@ -0,0 +1,113 @@ +=========================================================================== + OTP Test Server +=========================================================================== + +To compile the 'test_server' application you need to build and install +a Erlang/OTP system from source. Get your open source Erlang/OTP from +http://www.erlang.org/. The resulting "erlc" command must be in the +search path for commands. + +The Erlang test_server application and the example tests are to be +inserted into an existing source tree for Erlang/OTP. + +You don't run the Test Server or the tests from the source tree. +Instead a test installation area $TESTROOT is used with the resulting +directory structure + + $TESTROOT/test_server + $TESTROOT/<app1>_test + $TESTROOT/<app2>_test + . + . + +For more details see the test_server documentation can be found in the +"$ERL_TOP/lib/test_server/doc/html" directory. + + +Unpacking the sources +--------------------- + +Enter your Erlang/OTP source tree and unpack the OTP Test Server and +optionally the test examples + + % cd otp_src_RXX + % gunzip -c test_server-<VSN>.tar.gz | tar xf - + % gunzip -c emulator-YYYY-MM-DD.tar.gz | tar xf - + % gunzip -c stdlib-YYYY-MM-DD.tar.gz | tar xf - + + +How to build and install the OTP Test Server +-------------------------------------------- + +Set the ERL_TOP variable to the top directory of the source tree + + % cd otp_src_RXX + + % setenv ERL_TOP `pwd` + or + % export ERL_TOP=`pwd` + +If not done before you need to run the configure script + + % ./configure + +Then build and install from the the base directory of the test_server +application + + % cd lib/test_server + % gmake release_tests TESTROOT=<some dir> + + +How to build and install the example test suites +------------------------------------------------ + +If you want to build and install the example test suites +you build and install from the the test directories + + % cd $ERL_TOP/lib/stdlib/test + % gmake release_tests TESTROOT=<some dir> + + % cd $ERL_TOP/erts/emulator/test + % gmake release_tests TESTROOT=<some dir> + + +How to run OTP test suites +-------------------------- + +First cd into $TESTROOT/test_server + + % cd $TESTROOT/test_server + +Install the OTP Test Server framework + + % erl + 1> ts:install(). + +Check which tests are available + + 2> ts:tests(). + [...] + +Run the collections of test suites one at the time + + 3> ts:run(emulator). (starts a xterm with an Erlang shell) + 4> ts:run(stdlib). (starts a xterm with an Erlang shell) + +or all at once + + 5> ts:run(). (the node running the tests will be in the background) + +Note that it is normal to see lots of error messages in the Erlang +shell. The tests will stress the system with lots of invalid input to +find problems in the error handling. + +Also note that a failing test case does not always indicate a bug in +Erlang/OTP. Differences in the network setup, machine configuration +etc may cause a test case to fail or time out. + +The result of the tests are recorded in the file named "index.html" in +the "$TESTROOT/test_server" directory. You can follow the progress of +tests suites not yet completed from "last_test.html". + +For more details see the test_server documentation can be found in the +"$ERL_TOP/lib/test_server/doc/html" directory. |