source: postlfs/filesystems/lvm2.xml@ 24b17d76

10.0 10.1 11.0 11.1 7.10 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since 24b17d76 was 24b17d76, checked in by Pierre Labastie <pieere@…>, 7 years ago

Update to LVM2-2.02.115. Fixes ticket 6056

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

  • Property mode set to 100644
File size: 10.2 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/LVM2.&lvm2-version;.tgz">
9 <!ENTITY lvm2-md5sum "450744ce2ffd15c017d04bb314979e00">
10 <!ENTITY lvm2-size "1.5 MB">
11 <!ENTITY lvm2-buildsize "27 MB (additional 10 MB to run the test suite)">
12 <!ENTITY lvm2-time "0.4 SBU (additional 40 SBU to run the test suite)">
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 &lfs76_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 The check command must be run as the <systemitem
134 class="username">root</systemitem> user. Also the tests are known to
135 hang if at least one partition on a hard drive is not set up as a Linux
136 LVM partition (type 8e00). To test the results, issue: <command>make
137 check</command> as the <systemitem class="username">root</systemitem>
138 user. The test timings are very dependent on the speed of the disk(s),
139 and on the number of enabled kernel options.
140 </para>
141
142 <para>
143 Now, as the <systemitem class="username">root</systemitem> user:
144 </para>
145
146<screen role="root"><userinput>make install</userinput></screen>
147
148 </sect2>
149
150 <sect2 role="commands">
151 <title>Command Explanations</title>
152
153 <para>
154 <parameter>--enable-applib</parameter>: This switch enables
155 building of the shared application library.
156 </para>
157
158 <para>
159 <parameter>--enable-cmdlib</parameter>: This switch enables
160 building of the shared command library. It is required
161 when building the event daemon.
162 </para>
163
164 <para>
165 <parameter>--enable-pkgconfig</parameter>: This switch enables
166 installation of <command>pkg-config</command> support files.
167 </para>
168
169 <para>
170 <parameter>--enable-udev_sync</parameter>: This switch enables
171 synchronisation with <application>Udev</application> processing.
172 </para>
173
174 <para>
175 <option>--enable-dmeventd</option>: This switch enables
176 building of the <application>Device Mapper</application>
177 event daemon.
178 </para>
179
180 </sect2>
181
182 <sect2 role="content">
183 <title>Contents</title>
184
185 <segmentedlist>
186 <segtitle>Installed Programs</segtitle>
187 <segtitle>Installed Libraries</segtitle>
188 <segtitle>Installed Directories</segtitle>
189
190 <seglistitem>
191 <seg>
192 blkdeactivate, dmeventd (optional), dmsetup, fsadm, lvm, lvmconf,
193 lvmdump, vgimportclone. There are also numerous symbolic links to
194 lvm that implement specific functionalities
195 </seg>
196 <seg>
197 libdevmapper.so, liblvm2app.so and liblvm2cmd.so; optional:
198 libdevmapper-event.so, libdevmapper-event-lvm2.so,
199 libdevmapper-event-lvm2mirror.so, libdevmapper-event-lvm2snapshot.so,
200 libdevmapper-event-lvm2raid.so, and libdevmapper-event-lvm2thin.so
201 </seg>
202 <seg>
203 /etc/lvm and
204 /lib/device-mapper (optional)
205 </seg>
206 </seglistitem>
207 </segmentedlist>
208
209 <variablelist>
210 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
211 <?dbfo list-presentation="list"?>
212
213 <?dbhtml list-presentation="table"?>
214
215 <varlistentry id="blkdeactivate">
216 <term><command>blkdeactivate</command></term>
217 <listitem>
218 <para>
219 utility to deactivate block device.
220 </para>
221 <indexterm zone="lvm2 blkdeactivate">
222 <primary sortas="b-blkdeactivate">blkdeactivate</primary>
223 </indexterm>
224 </listitem>
225 </varlistentry>
226
227 <varlistentry id="dmeventd">
228 <term><command>dmeventd</command></term>
229 <listitem>
230 <para>
231 (optional) is the Device Mapper event daemon.
232 </para>
233 <indexterm zone="lvm2 dmeventd">
234 <primary sortas="b-dmeventd">dmeventd</primary>
235 </indexterm>
236 </listitem>
237 </varlistentry>
238
239 <varlistentry id="dmsetup">
240 <term><command>dmsetup</command></term>
241 <listitem>
242 <para>
243 is a low level logical volume management tool.
244 </para>
245 <indexterm zone="lvm2 dmsetup">
246 <primary sortas="b-dmsetup">dmsetup</primary>
247 </indexterm>
248 </listitem>
249 </varlistentry>
250
251 <varlistentry id="fsadm">
252 <term><command>fsadm</command></term>
253 <listitem>
254 <para>
255 is an utility used to resize or check filesystem on a device.
256 </para>
257 <indexterm zone="lvm2 fsadm">
258 <primary sortas="b-fsadm">fsadm</primary>
259 </indexterm>
260 </listitem>
261 </varlistentry>
262
263 <varlistentry id="lvm">
264 <term><command>lvm</command></term>
265 <listitem>
266 <para>
267 provides the command-line tools for <application>LVM2</application>.
268 Commands are implemented via sympolic links to this program to
269 manage physical devices (pv*), volume groups (vg*) and logical
270 volumes (lv*).
271 </para>
272 <indexterm zone="lvm2 lvm">
273 <primary sortas="b-lvm">lvm</primary>
274 </indexterm>
275 </listitem>
276 </varlistentry>
277
278 <varlistentry id="lvmconf">
279 <term><command>lvmconf</command></term>
280 <listitem>
281 <para>
282 is a script that modifies the locking configuration in
283 the <application>LVM2</application> configuration file.
284 </para>
285 <indexterm zone="lvm2 lvmconf">
286 <primary sortas="b-lvmconf">lvmconf</primary>
287 </indexterm>
288 </listitem>
289 </varlistentry>
290
291 <varlistentry id="lvmdump">
292 <term><command>lvmdump</command></term>
293 <listitem>
294 <para>
295 is a tool used to dump various information concerning
296 <application>LVM2</application>.
297 </para>
298 <indexterm zone="lvm2 lvmdump">
299 <primary sortas="b-lvmdump">lvmdump</primary>
300 </indexterm>
301 </listitem>
302 </varlistentry>
303
304 <varlistentry id="vgimportclone">
305 <term><command>vgimportclone</command></term>
306 <listitem>
307 <para>
308 is used to import a duplicated VG (e.g. hardware snapshot).
309 </para>
310 <indexterm zone="lvm2 vgimportclone">
311 <primary sortas="b-vgimportclone">vgimportclone</primary>
312 </indexterm>
313 </listitem>
314 </varlistentry>
315
316 <varlistentry id="libdevmapper">
317 <term><filename class='libraryfile'>libdevmapper.so</filename></term>
318 <listitem>
319 <para>
320 contains the <application>Device Mapper</application> API
321 functions.
322 </para>
323 <indexterm zone="lvm2 libdevmapper">
324 <primary sortas="c-libdevmapper">libdevmapper.so</primary>
325 </indexterm>
326 </listitem>
327 </varlistentry>
328
329 </variablelist>
330
331 </sect2>
332
333</sect1>
Note: See TracBrowser for help on using the repository browser.