README
1This directory contains files for simple regression tests.
2To execute regress.sh you need to install:
3
4- pgpool_setup
5- PostgreSQL 8.3 or later (requires EXTENSION)
6- pgbench
7- perl PostgreSQL interface
8- other tools or libraries required in each test cases
9
10regress.sh: the regression test driver. To execute the test, type "sh regress.sh".
11 To get the lists of arguments accepted by regress.sh type "sh regress.sh -?"
12
13clean.sh: remove files including PostgreSQL DB clusters created by regress.sh.
14
15tests: test scripts live here. Each test case has its own
16 subdirectory. In the directory the test script resides and the
17 script name must be "test.sh". The script should return exit
18 code 0 upon successfull completion of the test. Otherwise it
19 should return non 0 value. To add a new test case, simply
20 create a shell script under this.
21
22 The test name "001.*" to "050.*" is for regular regression
23 tests, while after "051.*" are for bugs.
24
25 regress.sh exports following environment variables which can be
26 used by test scripts.
27
28 PGPOOL_SETUP file path of pgpool_setup file
29 PGPOOL_INSTALL_DIR pgpool-II installed directory
30 PGBIN directory path containing PostgreSQL binaries
31 JDBC_DRIVER file path of JDBC driver
32
33
34log: any output of the test files above is created under the
35 directory. The log file name is same as the test name.
36
37libs.sh: contains some useful bash functions. The file name is
38 exported as "$TESTLIBS",
39
40