source: server/databases/db.xml@ 869e6892

10.0 10.1 11.0 11.1 11.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus perl-modules plabs/python-mods qt5new trunk upgradedb xry111/intltool xry111/soup3 xry111/test-20220226
Last change on this file since 869e6892 was 869e6892, checked in by Bruce Dubbs <bdubbs@…>, 4 years ago

Update to db-18.1.25

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

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