2013-01-10 17:35:12 +00:00
|
|
|
Improve the documentation that will be installed in the mysql-test RPM.
|
|
|
|
|
|
2016-03-29 08:29:29 +00:00
|
|
|
--- mariadb-10.1.13/mysql-test/README.orig 2016-03-24 10:12:10.000000000 +0100
|
|
|
|
|
+++ mariadb-10.1.13/mysql-test/README 2016-03-29 10:23:30.074326900 +0200
|
2013-07-30 21:25:34 +00:00
|
|
|
@@ -1,15 +1,28 @@
|
2013-01-10 17:35:12 +00:00
|
|
|
-This directory contains a test suite for the MySQL daemon. To run
|
|
|
|
|
-the currently existing test cases, simply execute ./mysql-test-run in
|
|
|
|
|
-this directory. It will fire up the newly built mysqld and test it.
|
|
|
|
|
-
|
|
|
|
|
-Note that you do not have to have to do "make install", and you could
|
|
|
|
|
-actually have a co-existing MySQL installation. The tests will not
|
|
|
|
|
-conflict with it. To run the test suite in a source directory, you
|
|
|
|
|
-must do make first.
|
|
|
|
|
-
|
|
|
|
|
-All tests must pass. If one or more of them fail on your system, please
|
|
|
|
|
-read the following manual section for instructions on how to report the
|
|
|
|
|
-problem:
|
|
|
|
|
+This directory contains a test suite for the MariaDB daemon. To run
|
|
|
|
|
+the currently existing test cases, execute ./mysql-test-run in
|
|
|
|
|
+this directory.
|
|
|
|
|
+
|
|
|
|
|
+For use in Red Hat distributions, you should run the script as user mysql,
|
2013-07-30 21:25:34 +00:00
|
|
|
+who is created with nologin shell however, so the best bet is something like
|
|
|
|
|
+ $ su -
|
|
|
|
|
+ # cd /usr/share/mysql-test
|
2017-05-23 13:14:48 +00:00
|
|
|
+ # su -s /bin/bash mysql -c "./mysql-test-run --skip-test-list=unstable-tests"
|
2013-07-30 21:25:34 +00:00
|
|
|
+
|
2013-01-10 17:35:12 +00:00
|
|
|
+This will use the installed mysql executables, but will run a private copy
|
|
|
|
|
+of the server process (using data files within /usr/share/mysql-test),
|
|
|
|
|
+so you need not start the mysqld service beforehand.
|
|
|
|
|
+
|
2017-05-23 13:14:48 +00:00
|
|
|
+The "--skip-test-list=unstable-tests" option excludes tests that are
|
2013-01-10 17:35:12 +00:00
|
|
|
+known to fail on one or more Red-Hat-supported platforms. You can omit it
|
|
|
|
|
+if you want to check whether such failures occur for you. Documentation
|
|
|
|
|
+about the reasons for omitting such tests can be found in the file
|
2017-05-23 13:14:48 +00:00
|
|
|
+unstable-tests.
|
2013-01-10 17:35:12 +00:00
|
|
|
+
|
|
|
|
|
+To clean up afterwards, remove the created "var" subdirectory, eg
|
2013-07-30 21:25:34 +00:00
|
|
|
+ # su -s /bin/bash - mysql -c "rm -rf /usr/share/mysql-test/var"
|
2013-01-10 17:35:12 +00:00
|
|
|
+
|
|
|
|
|
+If one or more tests fail on your system, please read the following manual
|
|
|
|
|
+section for instructions on how to report the problem:
|
|
|
|
|
|
2016-03-29 08:29:29 +00:00
|
|
|
https://mariadb.com/kb/en/reporting-bugs
|
2013-01-10 17:35:12 +00:00
|
|
|
|
2013-07-30 21:25:34 +00:00
|
|
|
@@ -26,7 +39,8 @@ other relevant options.
|
2013-01-10 17:35:12 +00:00
|
|
|
|
|
|
|
|
With no test cases named on the command line, mysql-test-run falls back
|
|
|
|
|
to the normal "non-extern" behavior. The reason for this is that some
|
|
|
|
|
-tests cannot run with an external server.
|
|
|
|
|
+tests cannot run with an external server (because they need to control the
|
|
|
|
|
+options with which the server is started).
|
|
|
|
|
|
|
|
|
|
You can create your own test cases. To create a test case, create a new
|
|
|
|
|
file in the t subdirectory using a text editor. The file should have a .test
|
