To build the test suite on Windows platforms, you will need to configure Tcl support. You will also need sufficient main memory (at least 64MB), and disk (around 250MB of disk will be sufficient).
The test suite must be run against a Debug version of Berkeley DB, so you will need a Debug version of the Tcl libraries. This involves building Tcl from its source. See the Tcl sources for more information. Then build the Tcl API - see Building the Tcl API for details.
To build for testing, perform the following steps:
Before running the tests for the first time, you must
edit the file include.tcl
in your
build directory and change the line that reads:
set tclsh_path SET_YOUR_TCLSH_PATH
You will want to use the location of the
tclsh
program (be sure to include
the name of the executable). For example, if Tcl is
installed in d:\tcl
, this line should
be the following:
set tclsh_path d:\tcl\bin\tclsh86.exe
If your path includes spaces be sure to enclose it in quotes:
set tclsh_path "c:\Program Files\tcl\bin\tclsh86.exe"
Make sure that the path to Berkeley DB's tcl library is in your current path. Edit your PATH using the Control Panel -> System -> Advanced system settings -> Environment Variables dialog. On earlier versions of Windows, you may find it convenient to add a line to c:\AUTOEXEC.BAT:
SET PATH=%PATH%;c:\db\build_windows
Then, in a shell of your choice enter the following commands:
d:\tcl\bin\tclsh86.exe
, or the
equivalent name of the Tcl shell for your system.
You should get a "%" prompt.
If no errors occur, you should get a "%" prompt.
You are now ready to run tests in the test suite; see Running the test suite for more information.
The SQL test suite must be run against a Debug version of Berkeley DB, so you need a Debug version of the Tcl libraries. This involves building Tcl from its source. See the Tcl sources for more information. Then build the Tcl API - see Building the Tcl API for details.
Before building for SQL tests, build the db_tcl and db_sql_testfixture projects. This requires Tcl 8.6 or above. If you are using a later version of Tcl, edit the Tcl library that db_tcl and db_sql_testfixture link to.
To do this right click the
db_tcl/
db_sql_testfixture
project, select Properties -> Configuration
Properties -> Linker -> Input -> Additional
Dependencies and edit the Tcl library,
tcl85.lib, to match the version
you are using.
Building the db_sql_testfixture project builds the
testfixture.exe program in
../build_windows/Win32/Debug
. It
also builds the projects db and db_sql, on which it
depends.
To build for testing, perform the following steps:
To test extensions, specify the following in the Preprocessor Definitions of the db_sql_testfixture project:
SQLITE_ENABLE_FTS3
to enable
the full text search layer
SQLITE_ENABLE_RTREE
to enable
the R-Tree layer