The R13B03 release.OTP_R13B03

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.