source: server/databases/db.xml@ a0111a9

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since a0111a9 was a0111a9, checked in by Bruce Dubbs <bdubbs@…>, 10 years ago

LFS75 tags

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@12720 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 14.3 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 "http://download.oracle.com/berkeley-db/db-&db-version;.tar.gz">
9 <!ENTITY db-download-ftp " ">
10 <!ENTITY db-md5sum "f73afcb308aefde7e6ece4caa87b22a9">
11 <!ENTITY db-size "35 MB">
12 <!ENTITY db-buildsize "279 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 &lfs75_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"/>,
79 <xref linkend="openjdk"/><!-- or <xref linkend="jdk"/> -->, and
80 <xref linkend="sharutils"/> (for the <command>uudecode</command> command)
81 </para>
82
83 <para condition="html" role="usernotes">
84 User Notes: <ulink url="&blfs-wiki;/db"/>
85 </para>
86 </sect2>
87
88 <!-- <sect2 role="testing">
89 <title>Testing Berkeley DB</title>
90
91 <para>
92 If you can't wait 12 hours or so you may want to skip ahead to
93 <xref linkend="bdb-installation"/>. The test suite can take a long time
94 and has a few bugs causing a report of <quote>Regression tests
95 failed</quote>. However, running the test suite is a very exhaustive test
96 of your hardware, perhaps pushing your machine harder (especially disk
97 I/O) than it will ever see during production use. Note that you must have
98 <application>Tcl</application> installed to run the test suite.
99 </para>
100
101 <para>
102 Build for the <application>Berkeley DB</application> test by running the
103 following commands:
104 </para>
105
106<screen><userinput>cd build_unix &amp;&amp;
107../dist/configure -&#45;prefix=/usr \
108 -&#45;enable-test \
109 -&#45;enable-tcl \
110 -&#45;enable-dbm \
111 -&#45;with-tcl=/usr/lib &amp;&amp;
112make</userinput></screen>
113
114 <para>
115 To test the results, start <command>tclsh</command>:
116 </para>
117
118<screen><userinput>tclsh</userinput></screen>
119
120 <para>
121 From the <command>tclsh</command> prompt (<prompt>%&nbsp;</prompt>), run:
122 </para>
123
124<screen><userinput>source ../test/tcl/test.tcl
125run_parallel 5 run_std
126exit</userinput></screen>
127
128 <para>
129 Clean up the source tree with the following command:
130 </para>
131
132<screen><userinput>make realclean &amp;&amp;
133cd ..</userinput></screen>
134
135 <note><para>
136 Test127.f and Repmgr026.c are known to fail.
137 </para></note>
138
139 <para>
140 There are additional testing suites in the
141 <filename class="directory">test/c</filename> and
142 <filename class="directory">test/cxx</filename> directories. See the
143 <filename>README</filename> in each directory for instructions on how to
144 run the tests.
145 </para>
146 </sect2> -->
147
148 <sect2 role="installation" id="bdb-installation">
149 <title>Installation of Berkeley DB</title>
150
151 <!-- <note>
152 <para>
153 If you plan on installing <application>Berkeley DB</application> with
154 Java support, you should check the system for certain versions of
155 <xref linkend="jdk"/> and <xref linkend="gmime"/>. Specifically,
156 if <application>JDK</application>-6 Update X and the
157 <command>uudecode</command> program from the
158 <application>GMime</application> program is on the system, the build
159 will fail (unless you run the modified <command>./configure</command>
160 command shown below). You can run two commands
161 (<command>javac -version</command> and
162 <command>uudecode -&#45;version</command>) to determine what versions are
163 installed. You can also download and run a shell script from
164 <ulink url="&files-anduin;/jdk-uudecode-check.sh"/> that will alert you
165 to a non-working condition. If the identified programs exist on the
166 system, you must modify the <command>./configure</command> command as
167 shown below.
168 </para>
169
170<screen><userinput>uudecode="no" ../dist/configure -&#45;(use the parameters shown below)</userinput></screen>
171 </note> -->
172
173 <para>
174 Install <application>Berkeley DB</application> by running the following
175 commands:
176 </para>
177
178<screen><userinput>cd build_unix &amp;&amp;
179../dist/configure --prefix=/usr \
180 --enable-compat185 \
181 --enable-dbm \
182 --disable-static \
183 --enable-cxx &amp;&amp;
184make</userinput></screen>
185
186 <para>
187 Now, as the <systemitem class="username">root</systemitem> user:
188 </para>
189
190<screen role="root"><userinput>make docdir=/usr/share/doc/db-&db-version; install &amp;&amp;
191chown -v -R root:root \
192 /usr/bin/db_* \
193 /usr/include/db{,_185,_cxx}.h \
194 /usr/lib/libdb*.{so,la} \
195 /usr/share/doc/db-&db-version;</userinput></screen>
196 </sect2>
197
198 <sect2 role="commands">
199 <title>Command Explanations</title>
200
201 <para>
202 <command>cd build_unix &amp;&amp; ../dist/configure
203 --prefix=/usr...</command>: This replaces the normal
204 <command>./configure</command> command, as
205 <application>Berkeley DB</application> comes with various build
206 directories for different platforms.
207 </para>
208
209 <para>
210 <option>--enable-compat185</option>: This switch enables building
211 the DB-1.85 compatibility API.
212 </para>
213
214 <para>
215 <option>--enable-cxx</option>: This switch enables building C++ API
216 libraries.
217 </para>
218
219 <para>
220 <option>--enable-dbm</option>: Enables legacy interface support
221 needed by some older packages.
222 </para>
223
224 <para>
225 <command>make docdir=/usr/share/doc/db-&db-version; install</command>:
226 This installs the documentation in the standard location instead of
227 <filename class="directory">/usr/docs</filename>.
228 </para>
229
230 <para>
231 <command>chown -v -R root:root ...</command>:This command changes the
232 ownership of various installed files from the uid:gid of the builder to
233 root:root.
234 </para>
235
236 <para>
237 <option>--enable-tcl --with-tcl=/usr/lib</option>: Enables
238 <application>Tcl</application> support in DB and creates the
239 <filename class="libraryfile">libdb_tcl</filename> libraries.
240 </para>
241
242 <para>
243 <option>--enable-java</option>: Enables
244 <application>Java</application> support in DB and creates the
245 <filename class="libraryfile">libdb_java</filename> libraries.
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 and
276 libdb_cxx.so
277 </seg>
278 <seg>/usr/share/doc/db-&db-version;</seg>
279 </seglistitem>
280 </segmentedlist>
281
282 <variablelist>
283 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
284 <?dbfo list-presentation="list"?>
285 <?dbhtml list-presentation="table"?>
286
287 <varlistentry id="db_archive">
288 <term><command>db_archive</command></term>
289 <listitem>
290 <para>
291 prints the pathnames of log files that are no longer in use.
292 </para>
293 <indexterm zone="db db_archive">
294 <primary sortas="b-db_archive">db_archive</primary>
295 </indexterm>
296 </listitem>
297 </varlistentry>
298
299 <varlistentry id="db_checkpoint">
300 <term><command>db_checkpoint</command></term>
301 <listitem>
302 <para>
303 is a daemon process used to monitor and checkpoint database logs.
304 </para>
305 <indexterm zone="db db_checkpoint">
306 <primary sortas="b-db_checkpoint">db_checkpoint</primary>
307 </indexterm>
308 </listitem>
309 </varlistentry>
310
311 <varlistentry id="db_deadlock">
312 <term><command>db_deadlock</command></term>
313 <listitem>
314 <para>
315 is used to abort lock requests when deadlocks are detected.
316 </para>
317 <indexterm zone="db db_deadlock">
318 <primary sortas="b-db_deadlock">db_deadlock</primary>
319 </indexterm>
320 </listitem>
321 </varlistentry>
322
323 <varlistentry id="db_dump">
324 <term><command>db_dump</command></term>
325 <listitem>
326 <para>
327 converts database files to a flat file format readable by
328 <command>db_load</command>.
329 </para>
330 <indexterm zone="db db_dump">
331 <primary sortas="b-db_dump">db_dump</primary>
332 </indexterm>
333 </listitem>
334 </varlistentry>
335
336 <varlistentry id="db_hotbackup">
337 <term><command>db_hotbackup</command></term>
338 <listitem>
339 <para>
340 creates "hot backup" or "hot failover" snapshots of Berkeley DB
341 databases.
342 </para>
343 <indexterm zone="db db_hotbackup">
344 <primary sortas="b-db_hotbackup">db_hotbackup</primary>
345 </indexterm>
346 </listitem>
347 </varlistentry>
348
349 <varlistentry id="db_load">
350 <term><command>db_load</command></term>
351 <listitem>
352 <para>
353 is used to create database files from flat files created with
354 <command>db_dump</command>.
355 </para>
356 <indexterm zone="db db_load">
357 <primary sortas="b-db_load">db_load</primary>
358 </indexterm>
359 </listitem>
360 </varlistentry>
361
362 <varlistentry id="db_log_verify">
363 <term><command>db_log_verify</command></term>
364 <listitem>
365 <para>verifies the log files of a database.</para>
366 <indexterm zone="db db_log_verify">
367 <primary sortas="b-db_log_verify">db_log_verify</primary>
368 </indexterm>
369 </listitem>
370 </varlistentry>
371
372 <varlistentry id="db_printlog">
373 <term><command>db_printlog</command></term>
374 <listitem>
375 <para>converts database log files to human readable text.</para>
376 <indexterm zone="db db_printlog">
377 <primary sortas="b-db_printlog">db_printlog</primary>
378 </indexterm>
379 </listitem>
380 </varlistentry>
381
382 <varlistentry id="db_recover">
383 <term><command>db_recover</command></term>
384 <listitem>
385 <para>
386 is used to restore a database to a consistent state after a failure.
387 </para>
388 <indexterm zone="db db_recover">
389 <primary sortas="b-db_recover">db_recover</primary>
390 </indexterm>
391 </listitem>
392 </varlistentry>
393
394 <varlistentry id="db_replicate">
395 <term><command>db_replicate</command></term>
396 <listitem>
397 <para>
398 is a daemon process that provides replication/HA services on a
399 transactional environment.
400 </para>
401 <indexterm zone="db db_replicate">
402 <primary sortas="b-db_replicate">db_replicate</primary>
403 </indexterm>
404 </listitem>
405 </varlistentry>
406
407 <varlistentry id="db_stat">
408 <term><command>db_stat</command></term>
409 <listitem>
410 <para>displays database environment statistics.</para>
411 <indexterm zone="db db_stat">
412 <primary sortas="b-db_stat">db_stat</primary>
413 </indexterm>
414 </listitem>
415 </varlistentry>
416
417 <varlistentry id="db_tuner">
418 <term><command>db_tuner</command></term>
419 <listitem>
420 <para>
421 analyzes the data in a btree database, and suggests a page size that
422 is likely to deliver optimal operation.
423 </para>
424 <indexterm zone="db db_tuner">
425 <primary sortas="b-db_tuner">db_tuner</primary>
426 </indexterm>
427 </listitem>
428 </varlistentry>
429
430 <varlistentry id="db_upgrade">
431 <term><command>db_upgrade</command></term>
432 <listitem>
433 <para>
434 is used to upgrade database files to a newer version of
435 <application>Berkeley DB</application>.
436 </para>
437 <indexterm zone="db db_upgrade">
438 <primary sortas="b-db_upgrade">db_upgrade</primary>
439 </indexterm>
440 </listitem>
441 </varlistentry>
442
443 <varlistentry id="db_verify">
444 <term><command>db_verify</command></term>
445 <listitem>
446 <para>is used to run consistency checks on database files.</para>
447 <indexterm zone="db db_verify">
448 <primary sortas="b-db_verify">db_verify</primary>
449 </indexterm>
450 </listitem>
451 </varlistentry>
452 </variablelist>
453 </sect2>
454</sect1>
Note: See TracBrowser for help on using the repository browser.