Do not file a bug report before you have found out as much
as possible about what when wrong. See the instructions at
Section 1.8, “How to Report Bugs or Problems”.
Make sure to include the output of
mysql-test-run, as well as contents of
all .reject
files in the
mysql-test/r
directory.
-
Check whether an individual test in the test suite also
fails when run on its own:
cd mysql-test
mysql-test-run --local test-name
If this fails, you should configure MySQL with
--with-debug
and run
mysql-test-run with the
--debug
option. If this also fails, send
the trace file
mysql-test/var/tmp/master.trace
to
ftp://ftp.mysql.com/pub/mysql/upload/ so that we can examine
it. Please remember to also include a full description of
your system, the version of the mysqld
binary and how you compiled it.
Try also to run mysql-test-run with the
--force
option to see whether any other
tests fail.
If you have compiled MySQL yourself, check our manual to
see whether there are any platform-specific issues for
your system (see
Section 2.12, “Operating System-Specific Notes”). There
might be configuration workarounds to deal with the
problems that you observe. Also, consider using one of the
binaries we have compiled for you at
https://dev.mysql.com/downloads/. All our standard
binaries should pass the test suite!
-
If you get an error such as Result length
mismatch
or Result content
mismatch
it means that the output of the test
was not an exact match for the expected output. This could
be a bug in MySQL or it could be that your version of
mysqld produces slightly different
results under some circumstances.
The results file has a .result
extension. A failed test result is put in a file with the
same base name as the result file and a
.reject
extension. If your test case
is failing, you should use diff to
compare the .result
and
.reject
files. If you cannot see how
they are different, examine both with od
-c and also check their lengths.
If a test fails completely, you should check the logs file
in the mysql-test/var/log
directory
for hints of what went wrong.
-
If you have compiled MySQL with debugging, you can try to
debug test failures by running
mysql-test-run with either or both of
the --gdb
and --debug
options. See Section E.1.2, “Creating Trace Files”.
If you have not compiled MySQL for debugging you should
probably do so by specifying the
--with-debug
option when you invoke
configure. See
Section 2.8.2, “Typical configure Options”.