r5535 - in trunk/BOOK: . general/prog introduction/welcome postlfs/security server/databases

randy at linuxfromscratch.org randy at linuxfromscratch.org
Sat Jan 7 10:17:16 PST 2006


Author: randy
Date: 2006-01-07 11:17:08 -0700 (Sat, 07 Jan 2006)
New Revision: 5535

Modified:
   trunk/BOOK/general.ent
   trunk/BOOK/general/prog/python.xml
   trunk/BOOK/introduction/welcome/changelog.xml
   trunk/BOOK/postlfs/security/heimdal.xml
   trunk/BOOK/server/databases/db.xml
Log:
Updated to Berkeley DB-4.4.16, added a patch to the Python instructions to support the new BDB, updated the Heimdal instructions to account for the changed library file names

Modified: trunk/BOOK/general/prog/python.xml
===================================================================
--- trunk/BOOK/general/prog/python.xml	2006-01-07 16:19:20 UTC (rev 5534)
+++ trunk/BOOK/general/prog/python.xml	2006-01-07 18:17:08 UTC (rev 5535)
@@ -5,11 +5,11 @@
   %general-entities;
 
   <!ENTITY python-download-http "http://www.python.org/ftp/python/&Python-version;/Python-&Python-version;.tar.bz2">
-  <!ENTITY python-download-ftp "ftp://ftp.python.org/pub/python/&Python-version;/Python-&Python-version;.tar.bz2">
-  <!ENTITY python-md5sum "98db1465629693fc434d4dc52db93838">
-  <!ENTITY python-size "7.5 MB">
-  <!ENTITY python-buildsize "115 MB">
-  <!ENTITY python-time "0.91 SBU (additional 2.20 SBU to run the testsuite)">
+  <!ENTITY python-download-ftp  "ftp://ftp.python.org/pub/python/&Python-version;/Python-&Python-version;.tar.bz2">
+  <!ENTITY python-md5sum        "98db1465629693fc434d4dc52db93838">
+  <!ENTITY python-size          "7.5 MB">
+  <!ENTITY python-buildsize     "115 MB">
+  <!ENTITY python-time          "0.9 SBU (additional 2.2 SBU to run the test suite)">
 ]>
 
 <sect1 id="python" xreflabel="Python-&Python-version;">
@@ -66,15 +66,19 @@
         <para>Required patch: <ulink
         url="&patch-root;/Python-&Python-version;-gdbm-1.patch"/></para>
       </listitem>
+      <listitem>
+        <para>Required patch: <ulink
+        url="&patch-root;/Python-&Python-version;-db44-1.patch"/></para>
+      </listitem>
     </itemizedlist>
 
     <bridgehead renderas="sect3">Python Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional"><xref linkend="openssl"/>,
-    <xref linkend="tk"/>,
-    <xref linkend="gdbm"/> and
-    <xref linkend="db"/></para>
+    <xref linkend="tk"/>, and
+    <xref linkend="gdbm"/></para>
+    <!-- <xref linkend="db"/> -->
 
   </sect2>
 
@@ -85,6 +89,7 @@
     commands:</para>
 
 <screen><userinput>patch -Np1 -i ../Python-&Python-version;-gdbm-1.patch &&
+patch -Np1 -i ../Python-&Python-version;-db44-1.patch &&
 ./configure --prefix=/usr --enable-shared &&
 make</userinput></screen>
 

Modified: trunk/BOOK/general.ent
===================================================================
--- trunk/BOOK/general.ent	2006-01-07 16:19:20 UTC (rev 5534)
+++ trunk/BOOK/general.ent	2006-01-07 18:17:08 UTC (rev 5535)
@@ -304,7 +304,7 @@
 
 <!-- Ensure you check the library version number and update the
      Heimdal instructions (postlfs/security/heimdal.xml) if necessary -->
-<!ENTITY db-version                   "4.3.29">
+<!ENTITY db-version                   "4.4.16">
 <!-- End special note about Heimdal -->
 
 <!ENTITY mysql-version                "5.0.16">

Modified: trunk/BOOK/introduction/welcome/changelog.xml
===================================================================
--- trunk/BOOK/introduction/welcome/changelog.xml	2006-01-07 16:19:20 UTC (rev 5534)
+++ trunk/BOOK/introduction/welcome/changelog.xml	2006-01-07 18:17:08 UTC (rev 5535)
@@ -45,6 +45,11 @@
       <para>January 7th, 2006</para>
       <itemizedlist>
         <listitem>
+          <para>[randy] - Updated to Berkeley DB-4.4.16, added a patch to the
+          Python instructions to support the new BDB, updated the Heimdal
+          instructions to account for the changed library file names.</para>
+        </listitem>
+        <listitem>
           <para>[randy] - Updated to GIMP-2.2.10.</para>
         </listitem>
         <listitem>

Modified: trunk/BOOK/postlfs/security/heimdal.xml
===================================================================
--- trunk/BOOK/postlfs/security/heimdal.xml	2006-01-07 16:19:20 UTC (rev 5534)
+++ trunk/BOOK/postlfs/security/heimdal.xml	2006-01-07 18:17:08 UTC (rev 5535)
@@ -188,9 +188,9 @@
 mv -v /usr/bin/{login,su} /bin &&
 ln -v -sf ../../bin/login /usr/bin &&
 mv -v /usr/lib/lib{otp,kafs,krb5,asn1,roken,crypto}.so.* \
-      /usr/lib/libdb-4.3.so /lib &&
-ln -v -sf ../../lib/libdb-4.3.so /usr/lib/libdb.so &&
-ln -v -sf ../../lib/libdb-4.3.so /usr/lib/libdb-4.so &&
+      /usr/lib/libdb-4.4.so /lib &&
+ln -v -sf ../../lib/libdb-4.4.so /usr/lib/libdb.so &&
+ln -v -sf ../../lib/libdb-4.4.so /usr/lib/libdb-4.so &&
 for SYMLINK in otp.so.0.1.3  kafs.so.0.4.1   krb5.so.17.4.0 \
                asn1.so.6.1.0 roken.so.16.1.0 crypto.so.0.9.7
 do

Modified: trunk/BOOK/server/databases/db.xml
===================================================================
--- trunk/BOOK/server/databases/db.xml	2006-01-07 16:19:20 UTC (rev 5534)
+++ trunk/BOOK/server/databases/db.xml	2006-01-07 18:17:08 UTC (rev 5535)
@@ -6,10 +6,10 @@
 
   <!ENTITY db-download-http "http://downloads.sleepycat.com/db-&db-version;.tar.gz">
   <!ENTITY db-download-ftp  "ftp://ftp.sleepycat.com/releases/db-&db-version;.tar.gz">
-  <!ENTITY db-md5sum        "13585a20ce32f113b8e8cdb57f52e3bb">
-  <!ENTITY db-size          "5.9 MB">
-  <!ENTITY db-buildsize     "74 MB (additional 140 MB to run parallel standard testsuite)">
-  <!ENTITY db-time          "1.0 SBU (additional 80 SBU to run parallel standard testsuite)">
+  <!ENTITY db-md5sum        "ec58179a39695cab6512eee0db0d71b9">
+  <!ENTITY db-size          "8.1 MB">
+  <!ENTITY db-buildsize     "94 MB (additional 100 MB to run parallel standard test suite)">
+  <!ENTITY db-time          "1.5 SBU (builds all bindings, add an additional 145 SBU to run parallel standard test suite)">
 ]>
 
 <sect1 id="db" xreflabel="Berkeley DB-&db-version;">
@@ -35,7 +35,10 @@
 
     <para>The <application>Berkeley DB</application> package contains programs
     and utilities used by many other applications for database related
-    functions.</para>
+    functions. This package is also installed during LFS and may already exist
+    on your system. It is listed here in BLFS as well because you may need to
+    reinstall it if you need the additional language bindings or the RPC
+    server.</para>
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
     <itemizedlist spacing="compact">
@@ -62,7 +65,8 @@
     <bridgehead renderas="sect3">Berkeley DB Dependencies</bridgehead>
 
     <bridgehead renderas="sect4">Optional</bridgehead>
-    <para role="optional"><xref linkend="tcl"/>, <xref linkend="jdk"/> and
+    <para role="optional"><xref linkend="tcl"/>,
+    <xref linkend="jdk"/>, and
     <ulink url="http://www.gnu.org/software/sharutils/">sharutils</ulink>
     (for the <command>uudecode</command> command)</para>
 
@@ -71,40 +75,41 @@
   <sect2 role="testing">
     <title>Testing Berkeley DB</title>
 
-    <para>It is recommended you skip ahead to Installation.  The test-suite
-    takes more than 80 SBU and has a few bugs causing reports of 'Regression
-    Tests Failed'. You must have <application>Tcl</application> to test
-    <application>Berkeley DB</application>.</para>
+    <para>You may want to skip ahead to <xref linkend="bdb-installation"/>. The
+    test suite can take up to 150 SBUs and has a few bugs causing a report of
+    <quote>Regression tests failed</quote>. However, running the test suite is
+    a very exhaustive test of your hardware, perhaps pushing your machine
+    harder (especially disk I/O) than it will ever see during production use.
+    Note that you must have <application>Tcl</application> installed to run the
+    test suite.</para>
 
     <para>Build for the <application>Berkeley DB</application> test by running
     the following commands:</para>
 
 <screen><userinput>cd build_unix &&
-../dist/configure --prefix=/usr \
-    --enable-test --enable-tcl --with-tcl=/usr/lib &&
-make LIBSO_LIBS="-lpthread" LIBXSO_LIBS="-lpthread" &&
-chmod 644 ../test/sijointest.tcl &&
-sed -i 's:puts "[s,S].*::' \
-    ../test/sijointest.tcl</userinput></screen>
+../dist/configure --prefix=/usr --enable-test \
+                  --enable-tcl  --with-tcl=/usr/lib &&
+make</userinput></screen>
 
     <para>To test the results, start <command>tclsh</command>:</para>
 
 <screen><userinput>tclsh</userinput></screen>
 
-    <para>From the tclsh prompt (%), run:</para>
+    <para>From the <command>tclsh</command> prompt (<prompt>%</prompt>),
+    run:</para>
 
-<screen><userinput>source ../test/test.tcl
-run_parallel 4 run_std
-exit</userinput></screen>
+<screen><userinput><prompt>%</prompt>source ../test/test.tcl
+<prompt>%</prompt>run_parallel 5 run_std
+<prompt>%</prompt>exit</userinput></screen>
 
-    <para>Clean up with the following command:</para>
+    <para>Clean up the source tree with the following command:</para>
 
 <screen><userinput>make realclean &&
 cd ..</userinput></screen>
 
   </sect2>
 
-  <sect2 role="installation">
+  <sect2 role="installation" id="bdb-installation">
     <title>Installation of Berkeley DB</title>
 
     <para>Install <application>Berkeley DB</application> by running the
@@ -112,16 +117,16 @@
 
 <screen><userinput>cd build_unix &&
 ../dist/configure --prefix=/usr \
-    --enable-compat185 \
-    --enable-cxx &&
-make LIBSO_LIBS="-lpthread" LIBXSO_LIBS="-lpthread"</userinput></screen>
+                  --enable-compat185 \
+                  --enable-cxx &&
+make</userinput></screen>
 
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
 
 <screen role="root"><userinput>make docdir=/usr/share/doc/db-&db-version; install &&
-chown root:root /usr/bin/db_* \
-    /usr/lib/libdb* /usr/include/db* &&
-chown -R root:root /usr/share/doc/db-&db-version;</userinput></screen>
+chown -v root:root /usr/bin/db_* /usr/lib/libdb* /usr/include/db* &&
+chown -v root:root /usr/bin/berkeley_db_svc &&
+chown -v -R root:root /usr/share/doc/db-&db-version;</userinput></screen>
 
   </sect2>
 
@@ -135,7 +140,7 @@
     build directories for different platforms.</para>
 
     <para><parameter>--enable-compat185</parameter>: This switch enables
-    building DB 1.85 compatibility API.</para>
+    building the DB-1.85 compatibility API.</para>
 
     <para><parameter>--enable-cxx</parameter>: This switch enables building
     C++ API libraries.</para>
@@ -151,35 +156,34 @@
     <para><parameter>--enable-rpc</parameter>: Enables building the
     <application>Berkeley DB</application> RPC server.</para>
 
-    <para><command>make LIBSO_LIBS="-lpthread"
-    LIBXSO_LIBS="-lpthread"</command>: <command>configure</command>
-    does not correctly handle NPTL. These variables force it to
-    properly link against NPTL.</para>
-
     <para><command>make docdir=/usr/share/doc/db-&db-version;
     install</command>: This installs the documentation in
-    the correct place.</para>
+    the correct location instead of
+    <filename class='directory'>/usr/docs</filename>.</para>
 
-    <para><command>sed -i 's:puts "[s,S].*::' ../test/sijointest.tcl</command>:
-    This prevents logging two notes that are not recognized by
-    <command>run_std</command>.</para>
+    <para><command>chown -v root:root /usr/bin/berkeley_db_svc</command>:
+    This command changes the ownership of the RPC server program. It is only
+    required if you passed <parameter>--enable-rpc</parameter> to the
+    <command>configure</command> script.</para>
 
   </sect2>
 
   <sect2 role="content">
     <title>Contents</title>
 
+    <para>Only the program and libraries not installed in LFS are listed here,
+    the others can be found at <ulink
+    url="&lfs-root;/chapter06/db.html#contents-db"/> as they were initially
+    installed during the building of LFS.</para>
+
     <segmentedlist>
-      <segtitle>Installed Programs</segtitle>
+      <segtitle>Installed Program</segtitle>
       <segtitle>Installed Libraries</segtitle>
       <segtitle>Installed Directory</segtitle>
 
       <seglistitem>
-        <seg>db_archive, db_checkpoint, db_deadlock, db_dump, db_load,
-        db_printlog, db_recover, db_stat, db_upgrade, db_verify and
-        berkeley_db_svc if enabled</seg>
-        <seg>libdb.[so,a], libdb_cxx.[so,a], libdb_java.[so,a] and
-        libdb_tcl.[so,a]</seg>
+        <seg>berkeley_db_svc</seg>
+        <seg>libdb_java.[so,a] and libdb_tcl.[so,a]</seg>
         <seg>/usr/share/doc/db-&db-version;</seg>
       </seglistitem>
     </segmentedlist>
@@ -200,6 +204,9 @@
         </listitem>
       </varlistentry>
 
+      <!-- These are left in so that if LFS ever dumps BDB, it is easy to
+           restore this information
+
       <varlistentry id="db_archive">
         <term><command>db_archive</command></term>
         <listitem>
@@ -307,6 +314,8 @@
         </listitem>
       </varlistentry>
 
+      -->
+
     </variablelist>
 
   </sect2>




More information about the blfs-book mailing list