Changeset 99fcc47

Timestamp:

10/25/2015 11:23:37 AM (8 years ago)

Author:

Pierre Labastie <pieere@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 7.10, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, ken/inkscape-core-mods, lazarus, nosym, perl-modules, plabs/python-mods, qt5new, trunk, upgradedb, xry111/intltool, xry111/soup3, xry111/test-20220226

Children:

08347b2

Parents:

8e236eb

Message:

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

Files:

• general.ent (modified) (2 diffs)
• introduction/welcome/changelog.xml (modified) (1 diff)
• postlfs/filesystems/lvm2.xml (modified) (6 diffs)

general.ent

@@ -1 +1 @@
 <!-- $LastChangedBy$ $Date$ -->
 
-<!ENTITY day          "24">                   <!-- Always 2 digits -->
+<!ENTITY day          "25">                   <!-- Always 2 digits -->
 <!ENTITY month        "10">                   <!-- Always 2 digits -->
 <!ENTITY year         "2015">
@@ -7 +7 @@
 <!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 #] -->

introduction/welcome/changelog.xml

@@ -46 +46 @@
 
     <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

@@ -9 +9 @@
   <!ENTITY lvm2-md5sum        "80af5af726949bbbb2aceb15b24b7d20">
   <!ENTITY lvm2-size          "1.8 MB">
-  <!ENTITY lvm2-buildsize     "31 MB (44 MB with tests)">
-  <!ENTITY lvm2-time          "0.3 SBU (9.7 SBU with tests, see below)">
+  <!ENTITY lvm2-buildsize     "31 MB (during tests, transcient files can grow up to around 500 MB)">
+  <!ENTITY lvm2-time          "0.3 SBU (around 10 SBU with tests, see below)">
 ]>
 
@@ -31 +31 @@
 
     <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>
 
@@ -77 +78 @@
     <bridgehead renderas="sect4">Optional</bridgehead>
     <para role="optional">
-      <xref linkend='mdadm'/> (for checks) and
-      <xref linkend='xfsprogs'/> (for checks)
+      <xref linkend='mdadm'/>,
+      <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>
 
@@ -105 +112 @@
     &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>
 
@@ -131 +139 @@
 
     <para>
-      To test the results, issue: <command>make -k
-      check</command> as the <systemitem class="username">root</systemitem>
-      user. At least one partition on a hard drive must be set up as a Linux
-      LVM partition (type 8e00). 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. Tests have been reported to hang when run in
-      a virtual machine under <application>QEMU</application>.
-<!-- My results: 460 tests: 121 passed, 307 skipped, 21 broken, 11 failed
-     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
-      by Bruce were better (448 tests: 141 passed, 302 skipped, 5 broken,
-      0 failed). - Pierre -->
+      The tests use <application>udev</application> for logical volume
+      synchronization, so that the LVM udev rules and some utilities need to
+      be installed before running the tests. If you are installing
+      <application>LVM2</application> for the first time, and do not
+      want to install the full package before running the tests, the minimal
+      set of utilities can be installed by running the following instructions
+      as the <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen role="root"><userinput>make -C tools install_dmsetup_dynamic &amp;&amp;
+make -C udev  install                 &amp;&amp;
+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>
 
@@ -181 +202 @@
       building of the <application>Device Mapper</application>
       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>