source: postlfs/filesystems/lvm2.xml@ 87d69b53

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since 87d69b53 was 87d69b53, checked in by Pierre Labastie <pieere@…>, 9 years ago

Update to LVM2-2.02.132

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@16510 af4574ff-66df-0310-9fd7-8a98e5e911e0
  • Property mode set to 100644
File size: 10.5 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 lvm2-download-http " ">
8 <!ENTITY lvm2-download-ftp "ftp://sources.redhat.com/pub/lvm2/releases/LVM2.&lvm2-version;.tgz">
9 <!ENTITY lvm2-md5sum "80af5af726949bbbb2aceb15b24b7d20">
10 <!ENTITY lvm2-size "1.8 MB">
11 <!ENTITY lvm2-buildsize "31 MB (44 MB with tests)">
12 <!ENTITY lvm2-time "0.3 SBU (9.7 SBU with tests, see below)">
13]>
14
15<sect1 id="lvm2" xreflabel="LVM2-&lvm2-version;">
16 <?dbhtml filename="lvm2.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>LVM2-&lvm2-version;</title>
24
25 <indexterm zone="lvm2">
26 <primary sortas="a-LVM2">LVM2</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to LVM2</title>
31
32 <para>
33 The <application>LVM2</application> package is a package that manages
34 logical partitions. It allows spanning of file systems across multiple
35 physical disks and disk partitions and provides for dynamic growing or
36 shrinking of logical partitions.
37 </para>
38
39 &lfs78_checked;
40
41 <bridgehead renderas="sect3">Package Information</bridgehead>
42 <itemizedlist spacing="compact">
43 <listitem>
44 <para>
45 Download (HTTP): <ulink url="&lvm2-download-http;"/>
46 </para>
47 </listitem>
48 <listitem>
49 <para>
50 Download (FTP): <ulink url="&lvm2-download-ftp;"/>
51 </para>
52 </listitem>
53 <listitem>
54 <para>
55 Download MD5 sum: &lvm2-md5sum;
56 </para>
57 </listitem>
58 <listitem>
59 <para>
60 Download size: &lvm2-size;
61 </para>
62 </listitem>
63 <listitem>
64 <para>
65 Estimated disk space required: &lvm2-buildsize;
66 </para>
67 </listitem>
68 <listitem>
69 <para>
70 Estimated build time: &lvm2-time;
71 </para>
72 </listitem>
73 </itemizedlist>
74
75 <bridgehead renderas="sect3">LVM2 Dependencies</bridgehead>
76
77 <bridgehead renderas="sect4">Optional</bridgehead>
78 <para role="optional">
79 <xref linkend='mdadm'/> (for checks) and
80 <xref linkend='xfsprogs'/> (for checks)
81 </para>
82
83 <para condition="html" role="usernotes">User Notes:
84 <ulink url="&blfs-wiki;/lvm2"/>
85 </para>
86 </sect2>
87
88 <sect2 role="kernel" id="lvm2-kernel">
89 <title>Kernel Configuration</title>
90
91 <para>
92 Enable the following options in the kernel configuration
93 and recompile the kernel:
94 </para>
95
96 <note><para>
97 There are several other Device Mapper options in the kernel beyond those
98 listed below. In order to get reasonable results if running the
99 regression tests, all must be enabled either internally or as a module.
100 </para></note>
101
102<screen><literal>Device Drivers ---&gt;
103 [*] Multiple devices driver support (RAID and LVM) ---&gt; [CONFIG_MD]
104 &lt;*/M&gt; Device mapper support [CONFIG_BLK_DEV_DM]
105 &lt;*/M/ &gt; Crypt target support [CONFIG_DM_CRYPT]
106 &lt;*/M/ &gt; Snapshot target [CONFIG_DM_SNAPSHOT]
107 &lt;*/M/ &gt; Mirror target [CONFIG_DM_MIRROR]</literal></screen>
108
109 <indexterm zone="lvm2 lvm2-kernel">
110 <primary sortas="d-lvm2">lvm2</primary>
111 </indexterm>
112
113 </sect2>
114
115 <sect2 role="installation">
116 <title>Installation of LVM2</title>
117
118 <para>
119 Install <application>LVM2</application> by running the following
120 commands:
121 </para>
122
123<screen><userinput>./configure --prefix=/usr \
124 --exec-prefix= \
125 --with-confdir=/etc \
126 --enable-applib \
127 --enable-cmdlib \
128 --enable-pkgconfig \
129 --enable-udev_sync &amp;&amp;
130make</userinput></screen>
131
132 <para>
133 To test the results, issue: <command>make -k
134 check</command> as the <systemitem class="username">root</systemitem>
135 user. At least one partition on a hard drive must be set up as a Linux
136 LVM partition (type 8e00). The test timings are very dependent on the
137 speed of the disk(s), and on the number of enabled kernel options. A
138 number of tests may fail. Tests have been reported to hang when run in
139 a virtual machine under <application>QEMU</application>.
140<!-- My results: 460 tests: 121 passed, 307 skipped, 21 broken, 11 failed
141 version LVM2-2.02.132. Not all kernel settings enabled, but those
142 above all were set. Previous reported test results for LVM2-2.02.125
143 by Bruce were better (448 tests: 141 passed, 302 skipped, 5 broken,
144 0 failed). - Pierre -->
145 </para>
146
147 <para>
148 Now, as the <systemitem class="username">root</systemitem> user:
149 </para>
150
151<screen role="root"><userinput>make install</userinput></screen>
152
153 </sect2>
154
155 <sect2 role="commands">
156 <title>Command Explanations</title>
157
158 <para>
159 <parameter>--enable-applib</parameter>: This switch enables
160 building of the shared application library.
161 </para>
162
163 <para>
164 <parameter>--enable-cmdlib</parameter>: This switch enables
165 building of the shared command library. It is required
166 when building the event daemon.
167 </para>
168
169 <para>
170 <parameter>--enable-pkgconfig</parameter>: This switch enables
171 installation of <command>pkg-config</command> support files.
172 </para>
173
174 <para>
175 <parameter>--enable-udev_sync</parameter>: This switch enables
176 synchronisation with <application>Udev</application> processing.
177 </para>
178
179 <para>
180 <option>--enable-dmeventd</option>: This switch enables
181 building of the <application>Device Mapper</application>
182 event daemon.
183 </para>
184
185 </sect2>
186
187 <sect2 role="content">
188 <title>Contents</title>
189
190 <segmentedlist>
191 <segtitle>Installed Programs</segtitle>
192 <segtitle>Installed Libraries</segtitle>
193 <segtitle>Installed Directories</segtitle>
194
195 <seglistitem>
196 <seg>
197 blkdeactivate, dmeventd (optional), dmsetup, fsadm, lvm, lvmconf,
198 lvmdump, and vgimportclone. There are also numerous symbolic links to
199 lvm that implement specific functionalities
200 </seg>
201 <seg>
202 libdevmapper.so, liblvm2app.so and liblvm2cmd.so; optional:
203 libdevmapper-event.so, libdevmapper-event-lvm2.so,
204 libdevmapper-event-lvm2mirror.so, libdevmapper-event-lvm2snapshot.so,
205 libdevmapper-event-lvm2raid.so, and libdevmapper-event-lvm2thin.so
206 </seg>
207 <seg>
208 /etc/lvm and
209 /lib/device-mapper (optional)
210 </seg>
211 </seglistitem>
212 </segmentedlist>
213
214 <variablelist>
215 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
216 <?dbfo list-presentation="list"?>
217
218 <?dbhtml list-presentation="table"?>
219
220 <varlistentry id="blkdeactivate">
221 <term><command>blkdeactivate</command></term>
222 <listitem>
223 <para>
224 utility to deactivate block device.
225 </para>
226 <indexterm zone="lvm2 blkdeactivate">
227 <primary sortas="b-blkdeactivate">blkdeactivate</primary>
228 </indexterm>
229 </listitem>
230 </varlistentry>
231
232 <varlistentry id="dmeventd">
233 <term><command>dmeventd</command></term>
234 <listitem>
235 <para>
236 (optional) is the Device Mapper event daemon.
237 </para>
238 <indexterm zone="lvm2 dmeventd">
239 <primary sortas="b-dmeventd">dmeventd</primary>
240 </indexterm>
241 </listitem>
242 </varlistentry>
243
244 <varlistentry id="dmsetup">
245 <term><command>dmsetup</command></term>
246 <listitem>
247 <para>
248 is a low level logical volume management tool.
249 </para>
250 <indexterm zone="lvm2 dmsetup">
251 <primary sortas="b-dmsetup">dmsetup</primary>
252 </indexterm>
253 </listitem>
254 </varlistentry>
255
256 <varlistentry id="fsadm">
257 <term><command>fsadm</command></term>
258 <listitem>
259 <para>
260 is a utility used to resize or check filesystem on a device.
261 </para>
262 <indexterm zone="lvm2 fsadm">
263 <primary sortas="b-fsadm">fsadm</primary>
264 </indexterm>
265 </listitem>
266 </varlistentry>
267
268 <varlistentry id="lvm">
269 <term><command>lvm</command></term>
270 <listitem>
271 <para>
272 provides the command-line tools for <application>LVM2</application>.
273 Commands are implemented via sympolic links to this program to
274 manage physical devices (pv*), volume groups (vg*) and logical
275 volumes (lv*).
276 </para>
277 <indexterm zone="lvm2 lvm">
278 <primary sortas="b-lvm">lvm</primary>
279 </indexterm>
280 </listitem>
281 </varlistentry>
282
283 <varlistentry id="lvmconf">
284 <term><command>lvmconf</command></term>
285 <listitem>
286 <para>
287 is a script that modifies the locking configuration in
288 the <application>LVM2</application> configuration file.
289 </para>
290 <indexterm zone="lvm2 lvmconf">
291 <primary sortas="b-lvmconf">lvmconf</primary>
292 </indexterm>
293 </listitem>
294 </varlistentry>
295
296 <varlistentry id="lvmdump">
297 <term><command>lvmdump</command></term>
298 <listitem>
299 <para>
300 is a tool used to dump various information concerning
301 <application>LVM2</application>.
302 </para>
303 <indexterm zone="lvm2 lvmdump">
304 <primary sortas="b-lvmdump">lvmdump</primary>
305 </indexterm>
306 </listitem>
307 </varlistentry>
308
309 <varlistentry id="vgimportclone">
310 <term><command>vgimportclone</command></term>
311 <listitem>
312 <para>
313 is used to import a duplicated VG (e.g. hardware snapshot).
314 </para>
315 <indexterm zone="lvm2 vgimportclone">
316 <primary sortas="b-vgimportclone">vgimportclone</primary>
317 </indexterm>
318 </listitem>
319 </varlistentry>
320
321 <varlistentry id="libdevmapper">
322 <term><filename class='libraryfile'>libdevmapper.so</filename></term>
323 <listitem>
324 <para>
325 contains the <application>Device Mapper</application> API
326 functions.
327 </para>
328 <indexterm zone="lvm2 libdevmapper">
329 <primary sortas="c-libdevmapper">libdevmapper.so</primary>
330 </indexterm>
331 </listitem>
332 </varlistentry>
333
334 </variablelist>
335
336 </sect2>
337
338</sect1>
Note: See TracBrowser for help on using the repository browser.