1<?xml version="1.0" encoding="UTF-8" standalone="no"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml"> 4 <head> 5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 6 <title>Running the test suite under Windows</title> 7 <link rel="stylesheet" href="gettingStarted.css" type="text/css" /> 8 <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /> 9 <link rel="start" href="index.html" title="Berkeley DB Programmer's Reference Guide" /> 10 <link rel="up" href="build_win.html" title="Chapter��28.�� Building Berkeley DB for Windows" /> 11 <link rel="prev" href="build_win_small.html" title="Building a small memory footprint library" /> 12 <link rel="next" href="build_win_notes.html" title="Windows notes" /> 13 </head> 14 <body> 15 <div class="navheader"> 16 <table width="100%" summary="Navigation header"> 17 <tr> 18 <th colspan="3" align="center">Running the test suite under Windows</th> 19 </tr> 20 <tr> 21 <td width="20%" align="left"><a accesskey="p" href="build_win_small.html">Prev</a>��</td> 22 <th width="60%" align="center">Chapter��28.�� 23 Building Berkeley DB for Windows 24 </th> 25 <td width="20%" align="right">��<a accesskey="n" href="build_win_notes.html">Next</a></td> 26 </tr> 27 </table> 28 <hr /> 29 </div> 30 <div class="sect1" lang="en" xml:lang="en"> 31 <div class="titlepage"> 32 <div> 33 <div> 34 <h2 class="title" style="clear: both"><a id="build_win_test"></a>Running the test suite under Windows</h2> 35 </div> 36 </div> 37 </div> 38 <div class="toc"> 39 <dl> 40 <dt> 41 <span class="sect2"> 42 <a href="build_win_test.html#id1633142">Building the software needed by the tests</a> 43 </span> 44 </dt> 45 <dt> 46 <span class="sect2"> 47 <a href="build_win_test.html#id1633225">Running the test suite under Windows</a> 48 </span> 49 </dt> 50 </dl> 51 </div> 52 <p>To build the test suite on Windows platforms, you will need to configure 53Tcl support. You will also need sufficient main memory (at least 64MB), 54and disk (around 250MB of disk will be sufficient).</p> 55 <div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id1633142"></a>Building the software needed by the tests</h3></div></div></div> 56The test suite must be run against a Debug version of 57Berkeley DB, so you will need a Debug version of the Tcl 58libraries. This involves building Tcl from its source. See the Tcl 59sources for more information. 60Then build the Tcl API - see 61<a class="xref" href="build_win_tcl.html" title="Building the Tcl API">Building the Tcl API</a> for details. 62<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id1633181"></a>Visual Studio 2005 or newer</h4></div></div></div><p>To build for testing, perform the following steps:</p><p> 63</p><div class="orderedlist"><ol type="1"><li>Open the Berkeley DB solution.</li><li>Ensure that the target configuration is Debug</li><li>Right click the <span class="emphasis"><em>db_tcl</em></span> project in the Solution Explorer, and select <span class="emphasis"><em>Build</em></span>.</li><li>Right click the <span class="emphasis"><em>db_test</em></span> project in the Solution Explorer, and select <span class="emphasis"><em>Build</em></span>.</li></ol></div><p> 64</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id1633474"></a>Visual Studio 2003 .NET or earlier</h4></div></div></div><p>To build for testing, perform the following steps:</p><div class="orderedlist"><ol type="1"><li>Open the Berkeley DB workspace.</li><li>In Visual C++ 6.0, set the active configuration to db_test -- 65Debug. To set an active configuration, under the <span class="emphasis"><em>Build</em></span> menu, 66select <span class="emphasis"><em>Set Active Configuration</em></span>. Then choose 67<span class="emphasis"><em>db_test -- Debug</em></span>. In Visual C++ .NET, just make sure 68<span class="emphasis"><em>Debug</em></span> is selected in the drop down list on the tool bar.</li><li>Build. In Visual C++ 6.0, the IDE menu item for this is 69called "build dbkill.exe", even though dbkill is just one of the things 70that is built. In Visual C++ .NET, right-click on the 71<span class="emphasis"><em>db_test</em></span> project and select <span class="emphasis"><em>Build</em></span>. This step makes 72sure that the base Berkeley DB .dll, tcl support, and various tools that 73are needed by the test suite are all built.</li></ol></div></div></div> 74 <div class="sect2" lang="en" xml:lang="en"> 75 <div class="titlepage"> 76 <div> 77 <div> 78 <h3 class="title"><a id="id1633225"></a>Running the test suite under Windows</h3> 79 </div> 80 </div> 81 </div> 82 <p>Before running the tests for the first time, you must edit the file 83<code class="filename">include.tcl</code> in your build directory and change the line 84that reads:</p> 85 <pre class="programlisting">set tclsh_path SET_YOUR_TCLSH_PATH</pre> 86 <p>You will want to use the location of the <code class="filename">tclsh</code> program (be 87sure to include the name of the executable). For example, if Tcl is 88installed in <code class="filename">d:\tcl</code>, this line should be the following:</p> 89 <pre class="programlisting">set tclsh_path d:\tcl\bin\tclsh84g.exe</pre> 90 <p>If your path includes spaces be sure to enclose it in quotes:</p> 91 <pre class="programlisting">set tclsh_path "c:\Program Files\tcl\bin\tclsh84g.exe"</pre> 92 <p>Make sure that the path to Berkeley DB's tcl library is in your 93current path. On Windows NT/2000/XP, edit your PATH using the My 94Computer -> Properties -> Advanced -> Environment 95Variables dialog. On earlier versions of Windows, you may find it 96convenient to add a line to c:\AUTOEXEC.BAT:</p> 97 <pre class="programlisting">SET PATH=%PATH%;c:\db\build_windows</pre> 98 <p>Then, in a shell of your choice enter the following commands:</p> 99 <div class="orderedlist"> 100 <ol type="1"> 101 <li>cd build_windows</li> 102 <li>run <code class="filename">d:\tcl\bin\tclsh84g.exe</code>, or the equivalent name of 103the Tcl shell for your system. 104<p>You should get a "%" prompt.</p></li> 105 <li>% source ../test/test.tcl 106<p>If no errors occur, you should get a "%" prompt.</p></li> 107 </ol> 108 </div> 109 <p>You are now ready to run tests in the test suite; see 110<a class="xref" href="test.html#test_run" title="Running the test suite">Running the test suite</a> for more 111information.</p> 112 </div> 113 </div> 114 <div class="navfooter"> 115 <hr /> 116 <table width="100%" summary="Navigation footer"> 117 <tr> 118 <td width="40%" align="left"><a accesskey="p" href="build_win_small.html">Prev</a>��</td> 119 <td width="20%" align="center"> 120 <a accesskey="u" href="build_win.html">Up</a> 121 </td> 122 <td width="40%" align="right">��<a accesskey="n" href="build_win_notes.html">Next</a></td> 123 </tr> 124 <tr> 125 <td width="40%" align="left" valign="top">Building a small memory footprint library��</td> 126 <td width="20%" align="center"> 127 <a accesskey="h" href="index.html">Home</a> 128 </td> 129 <td width="40%" align="right" valign="top">��Windows notes</td> 130 </tr> 131 </table> 132 </div> 133 </body> 134</html> 135