remove attributes.txt (use asciidoc/asciidoc-pve.conf instead)
[pve-docs.git] / local-lvm.adoc
1 Logical Volume Manager (LVM)
2 ----------------------------
3 ifdef::wiki[]
4 :pve-toplevel:
5 endif::wiki[]
6
7 Most people install {pve} directly on a local disk. The {pve}
8 installation CD offers several options for local disk management, and
9 the current default setup uses LVM. The installer let you select a
10 single disk for such setup, and uses that disk as physical volume for
11 the **V**olume **G**roup (VG) `pve`. The following output is from a
12 test installation using a small 8GB disk:
13
14 ----
15 # pvs
16   PV         VG   Fmt  Attr PSize PFree  
17   /dev/sda3  pve  lvm2 a--  7.87g 876.00m
18
19 # vgs
20   VG   #PV #LV #SN Attr   VSize VFree  
21   pve    1   3   0 wz--n- 7.87g 876.00m
22 ----
23
24 The installer allocates three **L**ogical **V**olumes (LV) inside this
25 VG:
26
27 ----
28 # lvs
29   LV   VG   Attr       LSize   Pool Origin Data%  Meta%
30   data pve  twi-a-tz--   4.38g             0.00   0.63
31   root pve  -wi-ao----   1.75g
32   swap pve  -wi-ao---- 896.00m     
33 ----
34
35 root:: Formatted as `ext4`, and contains the operation system.
36
37 swap:: Swap partition
38
39 data:: This volume uses LVM-thin, and is used to store VM
40 images. LVM-thin is preferable for this task, because it offers
41 efficient support for snapshots and clones.
42
43 Hardware
44 ~~~~~~~~
45
46 We highly recommend to use a hardware RAID controller (with BBU) for
47 such setups. This increases performance, provides redundancy, and make
48 disk replacements easier (hot-pluggable).
49
50 LVM itself does not need any special hardware, and memory requirements
51 are very low.
52
53
54 Bootloader
55 ~~~~~~~~~~
56
57 We install two boot loaders by default. The first partition contains
58 the standard GRUB boot loader. The second partition is an **E**FI **S**ystem
59 **P**artition (ESP), which makes it possible to boot on EFI systems.