source: server/databases/db.xml@ f4002c5

10.0 10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f4002c5 was f4002c5, checked in by Bruce Dubbs <bdubbs@…>, 16 months ago

Archive expect, dejagnu, and tcl which are now included in LFS.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@23319 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 14.1 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY db-download-http "&sources-anduin-http;/bdb/db-&db-version;.tar.gz">
8 <!ENTITY db-download-ftp " ">
9 <!ENTITY db-md5sum "b99454564d5b4479750567031d66fe24">
10 <!ENTITY db-size "34 MB">
11 <!ENTITY db-buildsize "265 MB">
12 <!ENTITY db-time "0.6 SBU">
13]>
14
15<sect1 id="db" xreflabel="Berkeley DB-&db-version;">
16 <?dbhtml filename="db.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Berkeley DB-&db-version;</title>
24
25 <indexterm zone="db">
26 <primary sortas="a-Berkeley-DB">Berkeley DB</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Berkeley DB</title>
31
32 <para>
33 The <application>Berkeley DB</application> package contains programs and
34 utilities used by many other applications for database related functions.
35 </para>
36
37 &lfs91_checked;
38
39 <bridgehead renderas="sect3">Package Information</bridgehead>
40 <itemizedlist spacing="compact">
41 <listitem>
42 <para>
43 Download (HTTP): <ulink url="&db-download-http;"/>
44 </para>
45 </listitem>
46 <listitem>
47 <para>
48 Download (FTP): <ulink url="&db-download-ftp;"/>
49 </para>
50 </listitem>
51 <listitem>
52 <para>
53 Download MD5 sum: &db-md5sum;
54 </para>
55 </listitem>
56 <listitem>
57 <para>
58 Download size: &db-size;
59 </para>
60 </listitem>
61 <listitem>
62 <para>
63 Estimated disk space required: &db-buildsize;
64 </para>
65 </listitem>
66 <listitem>
67 <para>
68 Estimated build time: &db-time;
69 </para>
70 </listitem>
71 </itemizedlist>
72
73 <bridgehead renderas="sect3">Berkeley DB Dependencies</bridgehead>
74
75 <bridgehead renderas="sect4">Optional</bridgehead>
76 <para role="optional">
77 <!-- <xref linkend="tcl"/> and -->
78 <xref linkend="sharutils"/> (for the <command>uudecode</command> command)
79
80 <!--,
81 <xref linkend="openjdk"/> or <xref linkend="java"/>, and
82- - This is currently broken, removed for now. - -
83 <xref linkend="sharutils"/> (for the <command>uudecode</command> command
84 - Java bindings are required) -->
85 </para>
86
87 <para condition="html" role="usernotes">
88 User Notes: <ulink url="&blfs-wiki;/db"/>
89 </para>
90 </sect2>
91
92 <!-- <sect2 role="testing">
93 <title>Testing Berkeley DB before the real install</title>
94
95 <para>
96 If you can't wait 12 hours or so you may want to skip ahead to
97 <xref linkend="bdb-installation"/>. The test suite can take a long time
98 and has a few bugs causing a report of <quote>Regression tests
99 failed</quote>. However, running the test suite is a very exhaustive test
100 of your hardware, perhaps pushing your machine harder (especially disk
101 I/O) than it will ever see during production use. Note that you must have
102 <application>Tcl</application> installed to run the test suite.
103 </para>
104
105 <para>
106 Build for the <application>Berkeley DB</application> test by running the
107 following commands:
108 </para>
109
110<screen><userinput>cd build_unix &amp;&amp;
111../dist/configure -&#45;prefix=/usr \
112 -&#45;enable-test \
113 -&#45;enable-tcl \
114 -&#45;enable-dbm \
115 -&#45;with-tcl=/usr/lib &amp;&amp;
116make</userinput></screen>
117
118 <para>
119 To test the results, start <command>tclsh</command>:
120 </para>
121
122<screen><userinput>tclsh</userinput></screen>
123
124 <para>
125 From the <command>tclsh</command> prompt (<prompt>%&nbsp;</prompt>), run:
126 </para>
127
128<screen><userinput>source ../test/tcl/test.tcl
129run_parallel 5 run_std
130exit</userinput></screen>
131
132 <para>
133 Clean up the source tree with the following command:
134 </para>
135
136<screen><userinput>make realclean &amp;&amp;
137cd ..</userinput></screen>
138
139 <note><para>
140 Test127.f and Repmgr026.c are known to fail.
141 </para></note>
142
143 <para>
144 There are additional testing suites in the
145 <filename class="directory">test/c</filename> and
146 <filename class="directory">test/cxx</filename> directories. See the
147 <filename>README</filename> in each directory for instructions on how to
148 run the tests.
149 </para>
150 </sect2> -->
151
152 <sect2 role="installation" id="bdb-installation">
153 <title>Installation of Berkeley DB</title>
154
155 <para>
156 First apply a fix so that this will compile with current versions of
157 <command>g++</command>:
158 </para>
159
160<screen><userinput>sed -i 's/\(__atomic_compare_exchange\)/\1_db/' src/dbinc/atomic.h</userinput></screen>
161
162 <!-- move parts of hte testing to here, possibly as sect3 -->
163
164 <para>
165 Install <application>Berkeley DB</application> by running the following
166 commands:
167 </para>
168
169<screen><userinput>cd build_unix &amp;&amp;
170../dist/configure --prefix=/usr \
171 --enable-compat185 \
172 --enable-dbm \
173 --disable-static \
174 --enable-cxx &amp;&amp;
175make</userinput></screen>
176
177 <para>
178 Now, as the <systemitem class="username">root</systemitem> user:
179 </para>
180
181<screen role="root"><userinput>make docdir=/usr/share/doc/db-&db-version; install &amp;&amp;
182
183chown -v -R root:root \
184 /usr/bin/db_* \
185 /usr/include/db{,_185,_cxx}.h \
186 /usr/lib/libdb*.{so,la} \
187 /usr/share/doc/db-&db-version;</userinput></screen>
188 </sect2>
189
190 <sect2 role="commands">
191 <title>Command Explanations</title>
192
193 <para>
194 <command>cd build_unix &amp;&amp; ../dist/configure
195 --prefix=/usr...</command>: This replaces the normal
196 <command>./configure</command> command, as
197 <application>Berkeley DB</application> comes with various build
198 directories for different platforms.
199 </para>
200
201 <para>
202 <parameter>--enable-compat185</parameter>: This switch enables building
203 the DB-1.85 compatibility API.
204 </para>
205
206 <para>
207 <parameter>--enable-cxx</parameter>: This switch enables building C++ API
208 libraries.
209 </para>
210
211 <para>
212 <parameter>--enable-dbm</parameter>: Enables legacy interface support
213 needed by some older packages.
214 </para>
215
216 <para>
217 <command>make docdir=/usr/share/doc/db-&db-version; install</command>:
218 This installs the documentation in the standard location instead of
219 <filename class="directory">/usr/docs</filename>.
220 </para>
221
222 <para>
223 <command>chown -v -R root:root ...</command>:This command changes the
224 ownership of various installed files from the uid:gid of the builder to
225 root:root.
226 </para>
227
228 <para>
229 <option>--enable-tcl --with-tcl=/usr/lib</option>: Enables
230 <application>Tcl</application> support in DB and creates the
231 <filename class="libraryfile">libdb_tcl</filename> libraries.
232 </para>
233
234 <para>
235 <option>--enable-java</option>: Enables <application>Java</application>
236 support in DB and creates the
237 <filename class="libraryfile">libdb_java</filename> libraries.
238<!--
239checking if java works... yes
240checking for javac... /opt/jdk/bin/javac
241checking absolute path of javac... /opt/jdk/bin/javac
242checking java version... 10.0.1
243configure: error: Java version 1.3 or higher required, got 10.0.1
244-->
245 Support is currently broken with Java-&openjdk-build;.x.
246 </para>
247 </sect2>
248
249 <sect2 role="content">
250 <title>Contents</title>
251
252 <segmentedlist>
253 <segtitle>Installed Programs</segtitle>
254 <segtitle>Installed Libraries</segtitle>
255 <segtitle>Installed Directory</segtitle>
256
257 <seglistitem>
258 <seg>
259 db_archive,
260 db_checkpoint,
261 db_deadlock,
262 db_dump,
263 db_hotbackup,
264 db_load,
265 db_log_verify,
266 db_printlog,
267 db_recover,
268 db_replicate,
269 db_stat,
270 db_tuner,
271 db_upgrade, and
272 db_verify
273 </seg>
274 <seg>
275 libdb.so,
276 libdb_cxx.so, and
277<!-- libdb_java.so, and -->
278 libdb_tcl.so
279 </seg>
280 <seg>/usr/share/doc/db-&db-version;</seg>
281 </seglistitem>
282 </segmentedlist>
283
284 <variablelist>
285 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
286 <?dbfo list-presentation="list"?>
287 <?dbhtml list-presentation="table"?>
288
289 <varlistentry id="db_archive">
290 <term><command>db_archive</command></term>
291 <listitem>
292 <para>
293 prints the pathnames of log files that are no longer in use.
294 </para>
295 <indexterm zone="db db_archive">
296 <primary sortas="b-db_archive">db_archive</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="db_checkpoint">
302 <term><command>db_checkpoint</command></term>
303 <listitem>
304 <para>
305 is a daemon process used to monitor and checkpoint database logs.
306 </para>
307 <indexterm zone="db db_checkpoint">
308 <primary sortas="b-db_checkpoint">db_checkpoint</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="db_deadlock">
314 <term><command>db_deadlock</command></term>
315 <listitem>
316 <para>
317 is used to abort lock requests when deadlocks are detected.
318 </para>
319 <indexterm zone="db db_deadlock">
320 <primary sortas="b-db_deadlock">db_deadlock</primary>
321 </indexterm>
322 </listitem>
323 </varlistentry>
324
325 <varlistentry id="db_dump">
326 <term><command>db_dump</command></term>
327 <listitem>
328 <para>
329 converts database files to a flat file format readable by
330 <command>db_load</command>.
331 </para>
332 <indexterm zone="db db_dump">
333 <primary sortas="b-db_dump">db_dump</primary>
334 </indexterm>
335 </listitem>
336 </varlistentry>
337
338 <varlistentry id="db_hotbackup">
339 <term><command>db_hotbackup</command></term>
340 <listitem>
341 <para>
342 creates "hot backup" or "hot failover" snapshots of Berkeley DB
343 databases.
344 </para>
345 <indexterm zone="db db_hotbackup">
346 <primary sortas="b-db_hotbackup">db_hotbackup</primary>
347 </indexterm>
348 </listitem>
349 </varlistentry>
350
351 <varlistentry id="db_load">
352 <term><command>db_load</command></term>
353 <listitem>
354 <para>
355 is used to create database files from flat files created with
356 <command>db_dump</command>.
357 </para>
358 <indexterm zone="db db_load">
359 <primary sortas="b-db_load">db_load</primary>
360 </indexterm>
361 </listitem>
362 </varlistentry>
363
364 <varlistentry id="db_log_verify">
365 <term><command>db_log_verify</command></term>
366 <listitem>
367 <para>
368 verifies the log files of a database.
369 </para>
370 <indexterm zone="db db_log_verify">
371 <primary sortas="b-db_log_verify">db_log_verify</primary>
372 </indexterm>
373 </listitem>
374 </varlistentry>
375
376 <varlistentry id="db_printlog">
377 <term><command>db_printlog</command></term>
378 <listitem>
379 <para>
380 converts database log files to human readable text.
381 </para>
382 <indexterm zone="db db_printlog">
383 <primary sortas="b-db_printlog">db_printlog</primary>
384 </indexterm>
385 </listitem>
386 </varlistentry>
387
388 <varlistentry id="db_recover">
389 <term><command>db_recover</command></term>
390 <listitem>
391 <para>
392 is used to restore a database to a consistent state after a failure.
393 </para>
394 <indexterm zone="db db_recover">
395 <primary sortas="b-db_recover">db_recover</primary>
396 </indexterm>
397 </listitem>
398 </varlistentry>
399
400 <varlistentry id="db_replicate">
401 <term><command>db_replicate</command></term>
402 <listitem>
403 <para>
404 is a daemon process that provides replication/HA services on a
405 transactional environment.
406 </para>
407 <indexterm zone="db db_replicate">
408 <primary sortas="b-db_replicate">db_replicate</primary>
409 </indexterm>
410 </listitem>
411 </varlistentry>
412
413 <varlistentry id="db_stat">
414 <term><command>db_stat</command></term>
415 <listitem>
416 <para>
417 displays database environment statistics.
418 </para>
419 <indexterm zone="db db_stat">
420 <primary sortas="b-db_stat">db_stat</primary>
421 </indexterm>
422 </listitem>
423 </varlistentry>
424
425 <varlistentry id="db_tuner">
426 <term><command>db_tuner</command></term>
427 <listitem>
428 <para>
429 analyzes the data in a btree database, and suggests a page size that
430 is likely to deliver optimal operation.
431 </para>
432 <indexterm zone="db db_tuner">
433 <primary sortas="b-db_tuner">db_tuner</primary>
434 </indexterm>
435 </listitem>
436 </varlistentry>
437
438 <varlistentry id="db_upgrade">
439 <term><command>db_upgrade</command></term>
440 <listitem>
441 <para>
442 is used to upgrade database files to a newer version of
443 <application>Berkeley DB</application>.
444 </para>
445 <indexterm zone="db db_upgrade">
446 <primary sortas="b-db_upgrade">db_upgrade</primary>
447 </indexterm>
448 </listitem>
449 </varlistentry>
450
451 <varlistentry id="db_verify">
452 <term><command>db_verify</command></term>
453 <listitem>
454 <para>
455 is used to run consistency checks on database files.
456 </para>
457 <indexterm zone="db db_verify">
458 <primary sortas="b-db_verify">db_verify</primary>
459 </indexterm>
460 </listitem>
461 </varlistentry>
462 </variablelist>
463 </sect2>
464</sect1>
Note: See TracBrowser for help on using the repository browser.