1<!--$Id: test.so,v 10.45 2005/12/01 03:18:51 bostic Exp $--> 2<!--Copyright (c) 1997,2008 Oracle. All rights reserved.--> 3<!--See the file LICENSE for redistribution information.--> 4<html> 5<head> 6<title>Berkeley DB Reference Guide: Running the test suite under Windows</title> 7<meta name="description" content="Berkeley DB: An embedded database programmatic toolkit."> 8<meta name="keywords" content="embedded,database,programmatic,toolkit,btree,hash,hashing,transaction,transactions,locking,logging,access method,access methods,Java,C,C++"> 9</head> 10<body bgcolor=white> 11<a name="2"><!--meow--></a><a name="3"><!--meow--></a> 12<table width="100%"><tr valign=top> 13<td><b><dl><dt>Berkeley DB Reference Guide:<dd>Building Berkeley DB for Windows systems</dl></b></td> 14<td align=right><a href="../build_win/small.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../build_win/notes.html"><img src="../../images/next.gif" alt="Next"></a> 15</td></tr></table> 16<p align=center><b>Running the test suite under Windows</b></p> 17<p>To build the test suite on Windows platforms, you will need to configure 18Tcl support. You will also need sufficient main memory (at least 64MB), 19and disk (around 250MB of disk will be sufficient).</p> 20<b>Building the software needed by the tests</b> 21<p>To build for testing, perform the following steps:</p> 22<ol> 23<p><li>The test suite must be run against a Debug version of 24Berkeley DB, so you will need a Debug version of the Tcl 25libraries. This involves building Tcl from its source. See the Tcl 26sources for more information. 27<p><li>Open the Berkeley DB workspace. 28<p><li>Build the Tcl API (see 29<a href="../../ref/build_win/intro.html">Building the Tcl API</a> for details). 30<p><li>In Visual C++ 6.0, set the active configuration to db_test -- 31Debug. To set an active configuration, under the <i>Build</i> menu, 32select <i>Set Active Configuration</i>. Then choose 33<i>db_test -- Debug</i>. In Visual C++ .NET, just make sure 34<i>Debug</i> is selected in the drop down list on the tool bar. 35<p><li>Build. In Visual C++ 6.0, the IDE menu item for this is 36called "build dbkill.exe", even though dbkill is just one of the things 37that is built. In Visual C++ .NET, right-click on the 38<i>db_test</i> project and select <i>Build</i>. This step makes 39sure that the base Berkeley DB .dll, tcl support, and various tools that 40are needed by the test suite are all built. 41</ol> 42<b>Running the test suite under Windows</b> 43<p>Before running the tests for the first time, you must edit the file 44<b>include.tcl</b> in your build directory and change the line 45that reads:</p> 46<blockquote><pre>set tclsh_path SET_YOUR_TCLSH_PATH</pre></blockquote> 47<p>You will want to use the location of the <b>tclsh</b> program (be 48sure to include the name of the executable). For example, if Tcl is 49installed in <b>d:\tcl</b>, this line should be the following:</p> 50<blockquote><pre>set tclsh_path d:\tcl\bin\tclsh84g.exe</pre></blockquote> 51<p>If your path includes spaces be sure to enclose it in quotes:</p> 52<blockquote><pre>set tclsh_path "c:\Program Files\tcl\bin\tclsh84g.exe"</pre></blockquote> 53<p>Make sure that the path to Berkeley DB's tcl library is in your 54current path. On Windows NT/2000/XP, edit your PATH using the My 55Computer -> Properties -> Advanced -> Environment 56Variables dialog. On earlier versions of Windows, you may find it 57convenient to add a line to c:\AUTOEXEC.BAT:</p> 58<blockquote><pre>SET PATH=%PATH%;c:\db\build_windows\Debug</pre></blockquote> 59<p>Then, in a shell of your choice enter the following commands:</p> 60<ol> 61<p><li>cd build_windows 62<p><li>run <b>d:\tcl\bin\tclsh84g.exe</b>, or the equivalent name of 63the Tcl shell for your system. 64<p>You should get a "%" prompt.</p> 65<p><li>% source ../test/test.tcl 66<p>If no errors occur, you should get a "%" prompt.</p> 67</ol> 68<p>You are now ready to run tests in the test suite; see 69<a href="../../ref/test/run.html">Running the test suite</a> for more 70information.</p> 71<table width="100%"><tr><td><br></td><td align=right><a href="../build_win/small.html"><img src="../../images/prev.gif" alt="Prev"></a><a href="../toc.html"><img src="../../images/ref.gif" alt="Ref"></a><a href="../build_win/notes.html"><img src="../../images/next.gif" alt="Next"></a> 72</td></tr></table> 73<p><font size=1>Copyright (c) 1996,2008 Oracle. All rights reserved.</font> 74</body> 75</html> 76
