aboutsummaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorTom Lane <tgl@sss.pgh.pa.us>2011-08-18 11:45:25 -0400
committerTom Lane <tgl@sss.pgh.pa.us>2011-08-18 11:45:25 -0400
commit11c88e59a60b2096ab42fa7cf9bff542717ec1e0 (patch)
tree4763714548e786971545ebfaa5d868ab5ba3a0c6 /src
parentaf35737313f92fcbe227baf51bb69b8650acc41a (diff)
downloadpostgresql-11c88e59a60b2096ab42fa7cf9bff542717ec1e0.tar.gz
postgresql-11c88e59a60b2096ab42fa7cf9bff542717ec1e0.zip
Explain max_prepared_transactions requirement in isolation tests' README.
Now that we have a test that requires nondefault settings to pass, it seems like we'd better mention that detail in the directions about how to run the tests. Also do some very minor copy-editing.
Diffstat (limited to 'src')
-rw-r--r--src/test/isolation/README15
1 files changed, 10 insertions, 5 deletions
diff --git a/src/test/isolation/README b/src/test/isolation/README
index 58fe50e58a2..aeef7f6c3ab 100644
--- a/src/test/isolation/README
+++ b/src/test/isolation/README
@@ -5,13 +5,20 @@ Isolation tests
This directory contains a set of tests for the serializable isolation level.
Testing isolation requires running multiple overlapping transactions,
-which requires multiple concurrent connections, and can't therefore be
+which requires multiple concurrent connections, and therefore can't be
tested using the normal pg_regress program.
+To run the tests, you need to have a server running at the default port
+expected by libpq. (You can set PGPORT and so forth in your environment
+to control this.) Then run
+ gmake installcheck
+Note that the prepared-transactions test will not pass unless you have
+the server's max_prepared_transactions parameter set to at least 3.
+
To represent a test with overlapping transactions, we use a test specification
-file with a custom syntax, described in the next section.
+file with a custom syntax, which is described in the next section.
-isolationtester is program that uses libpq to open multiple connections,
+isolationtester is a program that uses libpq to open multiple connections,
and executes a test specified by a spec file. A libpq connection string
specifies the server and database to connect to; defaults derived from
environment variables are used otherwise.
@@ -19,8 +26,6 @@ environment variables are used otherwise.
pg_isolation_regress is a tool similar to pg_regress, but instead of using
psql to execute a test, it uses isolationtester.
-To run the tests, you need to have a server up and running. Run
- gmake installcheck
Test specification
==================