LVM2: Update introduction and

give more details in the test section

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

general.ent

@@ -1,12 +1,12 @@
 <!-- $LastChangedBy$ $Date$ -->
 
-<!ENTITY day          "24">                   <!-- Always 2 digits -->
+<!ENTITY day          "25">                   <!-- Always 2 digits -->
 <!ENTITY month        "10">                   <!-- Always 2 digits -->
 <!ENTITY year         "2015">
 <!ENTITY copyrightdate "2001-&year;">
 <!ENTITY copyholder   "The BLFS Development Team">
 <!ENTITY version      "&year;-&month;-&day;">
-<!ENTITY releasedate  "October 24th &year;">
+<!ENTITY releasedate  "October 25th &year;">
 <!ENTITY pubdate      "&year;-&month;-&day;"> <!-- metadata req. by TLDP -->
 <!ENTITY blfs-version "svn">                  <!-- svn|[release #] -->
 <!ENTITY lfs-version  "development">          <!-- x.y|development] -->

introduction/welcome/changelog.xml

@@ -44,6 +44,15 @@
 
 -->
 
+    <listitem>
+      <para>October 25th, 2015</para>
+      <itemizedlist>
+        <listitem>
+          <para>[pierre] - LVM2: Update introduction and test sections.</para>
+        </listitem>
+      </itemizedlist>
+    </listitem>
+
     <listitem>
       <para>October 24th, 2015</para>
       <itemizedlist>

postlfs/filesystems/lvm2.xml

@@ -8,8 +8,8 @@
   <!ENTITY lvm2-download-ftp  "ftp://sources.redhat.com/pub/lvm2/releases/LVM2.&lvm2-version;.tgz">
   <!ENTITY lvm2-md5sum        "80af5af726949bbbb2aceb15b24b7d20">
   <!ENTITY lvm2-size          "1.8 MB">
-  <!ENTITY lvm2-buildsize     "31 MB (44 MB with tests)">
+  <!ENTITY lvm2-buildsize     "31 MB (during tests, transcient files can grow up to around 500 MB)">
-  <!ENTITY lvm2-time          "0.3 SBU (9.7 SBU with tests, see below)">
+  <!ENTITY lvm2-time          "0.3 SBU (around 10 SBU with tests, see below)">
 ]>
 
 <sect1 id="lvm2" xreflabel="LVM2-&lvm2-version;">
@@ -30,10 +30,11 @@
     <title>Introduction to LVM2</title>
 
     <para>
-      The <application>LVM2</application> package is a package that manages
+      The <application>LVM2</application> package is a set of tools that manage
       logical partitions. It allows spanning of file systems across multiple
       physical disks and disk partitions and provides for dynamic growing or
-      shrinking of logical partitions.
+      shrinking of logical partitions, mirroring and low storage footprint
+      snapshots.
     </para>
 
     &lfs78_checked;
@@ -76,8 +77,14 @@
 
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
-      <xref linkend='mdadm'/> (for checks) and
+      <xref linkend='mdadm'/>,
-      <xref linkend='xfsprogs'/> (for checks)
+      <xref linkend='reiserfs'/>,
+      <xref linkend='valgrind'/>,
+      <xref linkend='which'/>,
+      <xref linkend='xfsprogs'/> (all five may be used, but are not required,
+        for tests), and
+      <ulink url='https://github.com/jthornber/thin-provisioning-tools'>
+        thin-provisioning-tools</ulink>
     </para>
 
     <para condition="html" role="usernotes">User Notes:
@@ -104,6 +111,7 @@
     &lt;*/M&gt;   Device mapper support                         [CONFIG_BLK_DEV_DM]
     &lt;*/M/ &gt;   Crypt target support                        [CONFIG_DM_CRYPT]
     &lt;*/M/ &gt;   Snapshot target                             [CONFIG_DM_SNAPSHOT]
+    &lt;*/M/ &gt;   Thin provisioning target                    [CONFIG_DM_THIN_PROVISIONING]
     &lt;*/M/ &gt;   Mirror target                               [CONFIG_DM_MIRROR]</literal></screen>
 
     <indexterm zone="lvm2 lvm2-kernel">
@@ -130,18 +138,31 @@
 make</userinput></screen>
 
     <para>
-      To test the results, issue: <command>make -k
+      The tests use <application>udev</application> for logical volume
-      check</command> as the <systemitem class="username">root</systemitem>
+      synchronization, so that the LVM udev rules and some utilities need to
-      user. At least one partition on a hard drive must be set up as a Linux
+      be installed before running the tests. If you are installing
-      LVM partition (type 8e00). The test timings are very dependent on the
+      <application>LVM2</application> for the first time, and do not
-      speed of the disk(s), and on the number of enabled kernel options. A
+      want to install the full package before running the tests, the minimal
-      number of tests may fail. Tests have been reported to hang when run in
+      set of utilities can be installed by running the following instructions
-      a virtual machine under <application>QEMU</application>.
+      as the <systemitem class="username">root</systemitem> user:
-<!-- My results: 460 tests: 121 passed, 307 skipped, 21 broken, 11 failed
+    </para>
-     version LVM2-2.02.132. Not all kernel settings enabled, but those
+
-     above all were set. Previous reported test results for LVM2-2.02.125
+<screen role="root"><userinput>make -C tools install_dmsetup_dynamic &amp;&amp;
-      by Bruce were better (448 tests: 141 passed, 302 skipped, 5 broken,
+make -C udev  install                 &amp;&amp;
-      0 failed). - Pierre -->
+make -C libdm install</userinput></screen>
+
+    <para>
+      To test the results, issue: <command>make check_local</command> as the
+      <systemitem class="username">root</systemitem> user. Other targets are
+      available and can be listed with <command>make -C test help</command>.
+      The test timings are very dependent on the speed of the disk(s), and on
+      the number of enabled kernel options. A number of tests may fail. Two
+      tests have been reported to hang, and can be disabled via <command>rm
+      test/shell/lvcreate-large-raid.sh</command> and <command>rm
+      test/shell/snapshot-remove-dmsetup.sh</command>. The tests generate a lot
+      of kernel messages, which may clutter your terminal. You can disable them
+      by issuing <command>dmesg -D</command> before running the tests (do not
+      forget to issue <command>dmesg -E</command> when tests are done).
     </para>
 
     <para>
@@ -182,6 +203,13 @@ make</userinput></screen>
       event daemon.
     </para>
 
+    <para>
+      <option>--enable-lvmetad</option>: This switch enables
+      building of the <application>LVM</application> metadata daemon,
+      which avoids scanning all the filesystems when an lvm command is
+      run.
+    </para>
+
   </sect2>
 
   <sect2 role="content">