# HG changeset patch
# User Tom Gottfried <tom@intevation.de>
# Date 1564590362 -7200
# Node ID ab08a74ad2f4d78709c60683c9de4f481dabff5f
# Parent  3cec90587ff98ded7c283edfe00a73979e61db4a
Document how to run database tests

diff -r 3cec90587ff9 -r ab08a74ad2f4 README.md
--- a/README.md	Wed Jul 31 18:00:49 2019 +0200
+++ b/README.md	Wed Jul 31 18:26:02 2019 +0200
@@ -21,6 +21,21 @@
 For further details see [docs/DEVELOPMENT](docs/DEVELOPMENT.md),
 
 
+## Running Tests
+
+- Running database tests:
+
+  * You will need a PostgreSQL cluster with PostGIS and pgTAP.
+  * To run the tests use the script `./schema/run_tests.sh`.
+  * `./schema/run_tests.sh --help` shows you available options.
+    Per default the script will create (and drop if it already exists)
+    a database named "gemma_test" and all necessary roles in the postgres
+    default cluster (listening on port 5432) and run the tests
+    in that database.
+  * The script must be run as a user with PostgreSQL super user rights.
+    By convention this is "postgres" on most systems.
+
+
 ## Setup Database
 
 - You will need a PostgreSQL cluster with PostGIS.