aboutsummaryrefslogtreecommitdiffstats
path: root/lib/test_server/README
diff options
context:
space:
mode:
Diffstat (limited to 'lib/test_server/README')
-rw-r--r--lib/test_server/README113
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.