summaryrefslogtreecommitdiff
path: root/docs/installation/build_unix_test.html
blob: 4aa5fe83759fb5aeebfad0b174f7325926fb7942 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Running the test suite under UNIX</title>
    <link rel="stylesheet" href="gettingStarted.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
    <link rel="start" href="index.html" title="Berkeley DB Installation and Build Guide" />
    <link rel="up" href="build_unix.html" title="Chapter 7.  Building Berkeley DB for UNIX/POSIX" />
    <link rel="prev" href="build_unix_shlib.html" title="Dynamic shared libraries" />
    <link rel="next" href="build_unix_notes.html" title="Architecture independent FAQ" />
  </head>
  <body>
    <div xmlns="" class="navheader">
      <div class="libver">
        <p>Library Version 12.1.6.1</p>
      </div>
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">Running the test suite under
        UNIX</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="build_unix_shlib.html">Prev</a> </td>
          <th width="60%" align="center">Chapter 7.  Building Berkeley DB for UNIX/POSIX
    </th>
          <td width="20%" align="right"> <a accesskey="n" href="build_unix_notes.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="sect1" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h2 class="title" style="clear: both"><a id="build_unix_test"></a>Running the test suite under
        UNIX</h2>
          </div>
        </div>
      </div>
      <div class="toc">
        <dl>
          <dt>
            <span class="sect2">
              <a href="build_unix_test.html#build_unix_test_sql">Building SQL Test Suite on Unix</a>
            </span>
          </dt>
        </dl>
      </div>
      <p> 
        The Berkeley DB test suite is built if you specify <a class="link" href="build_unix_conf.html#build_unix_conf.--enable-test">--enable-test</a> as an argument 
        when configuring Berkeley DB. The test suite also requires that you configure
        and build the Tcl interface to the library. 
    </p>
      <p> 
        Before running the tests for the first time, you may need
        to edit the <code class="filename">include.tcl</code> file in your
        build directory. The Berkeley DB configuration assumes that
        you intend to use the version of the tclsh utility included in
        the Tcl installation with which Berkeley DB was configured to
        run the test suite, and further assumes that the test suite
        will be run with the libraries prebuilt in the Berkeley DB
        build directory. If either of these assumptions are incorrect,
        you will need to edit the <code class="filename">include.tcl</code>
        file and change the following line to correctly specify the
        full path to the version of tclsh with which you are going to
        run the test suite:
    </p>
      <pre class="programlisting">set tclsh_path ...</pre>
      <p> 
        You may also need to change the following line to correctly
        specify the path from the directory where you are running the
        test suite to the location of the Berkeley DB Tcl library you
        built:
    </p>
      <pre class="programlisting">set test_path ...</pre>
      <p>
        It may not be necessary that this be a full path if you
        have configured your system's shared library mechanisms to
        search the directory where you built or installed the Tcl
        library.
    </p>
      <p> 
        All Berkeley DB tests are run from within <span class="bold"><strong>tclsh</strong></span>. After starting tclsh, you
        must source the file <code class="filename">test.tcl</code> in the test
        directory. For example, if you built in the
        <code class="filename">build_unix</code> directory of the
        distribution, this would be done using the following command: 
    </p>
      <pre class="programlisting">% source ../test/tcl/test.tcl</pre>
      <p> 
        If no errors occur, you should get a "%" prompt.
    </p>
      <p> 
        You are now ready to run tests in the test suite; see
        Running the test suite for more information.
    </p>
      <div class="sect2" lang="en" xml:lang="en">
        <div class="titlepage">
          <div>
            <div>
              <h3 class="title"><a id="build_unix_test_sql"></a>Building SQL Test Suite on Unix</h3>
            </div>
          </div>
        </div>
        <p>
            The Berkeley DB SQL interface test suite is built if
            you specify <a class="link" href="build_unix_conf.html#build_unix_conf.--enable-test">
            --enable-test</a> and <a class="link" href="build_unix_conf.html#build_unix_conf.--enable-sql">--enable-sql
            </a> as arguments, when configuring Berkeley DB. The
            test suite also requires that you build the Berkeley DB
            Tcl API.
        </p>
        <pre class="programlisting">
../dist/configure --enable-sql --enable-test --with-tcl=/usr/lib
</pre>
        <p>
            This builds the <span class="emphasis"><em>testfixture</em></span>
            project in <code class="literal">../build_unix/sql</code>. 
        </p>
        <p> 
            To enable extensions like full text search layer and
            R-Tree layer in the SQL test suite, configure with
            --enable-amalgamation. 
        </p>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="build_unix_shlib.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="build_unix.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="build_unix_notes.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">Dynamic shared libraries </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> Architecture independent FAQ</td>
        </tr>
      </table>
    </div>
  </body>
</html>