From 8b849dc378465dc19efca1d155477b45772191c5 Mon Sep 17 00:00:00 2001
From: Dietmar Maurer <dietmar@proxmox.com>
Date: Mon, 12 Sep 2016 12:18:27 +0200
Subject: [PATCH] include/improve new LVM page

---
 Makefile                                      |  1 +
 .../pve-docs-mediawiki-import                 |  4 ++
 local-lvm.adoc                                | 37 +++++++++++++++++--
 sysadmin.adoc                                 |  4 ++
 4 files changed, 42 insertions(+), 4 deletions(-)

diff --git a/Makefile b/Makefile
index f956ddc..5879968 100644
--- a/Makefile
+++ b/Makefile
@@ -104,6 +104,7 @@ SYSADMIN_PARTS=					\
 	pve-package-repos			\
 	pve-installation			\
 	system-software-updates			\
+	local-lvm				\
 	local-zfs
 
 SYSADMIN_SOURCES=				\
diff --git a/debian/tree/pve-docs-mediawiki/pve-docs-mediawiki-import b/debian/tree/pve-docs-mediawiki/pve-docs-mediawiki-import
index d1d98d7..6e6d1cd 100755
--- a/debian/tree/pve-docs-mediawiki/pve-docs-mediawiki-import
+++ b/debian/tree/pve-docs-mediawiki/pve-docs-mediawiki-import
@@ -80,6 +80,10 @@ my $docs = {
 	title => "ZFS on Linux",
 	category => $cat_refdoc,
     },
+    'sysadmin-local-lvm-plain.html' => {
+	title => "Logical Volume Manager (LVM)",
+	category => $cat_refdoc,
+    },
     'sysadmin-pve-installation-plain.html' => {
 	title => "Installation",
 	category => $cat_refdoc,
diff --git a/local-lvm.adoc b/local-lvm.adoc
index 6f66292..999b7bc 100644
--- a/local-lvm.adoc
+++ b/local-lvm.adoc
@@ -3,9 +3,38 @@ Logical Volume Manager (LVM)
 include::attributes.txt[]
 
 Most people install {pve} directly on a local disk. The {pve}
-installation CD offers several options for local disk management. The
-current default setup uses LVM and 'ext4' for the root
-partition. LVM-thin is used for VM images, because this has efficient
-support for snapshots and clones.
+installation CD offers several options for local disk management, and
+the current default setup uses LVM. The installer let you select a
+single disk for such setup, and uses that disk as physical volume for
+the **V**olume **G**roup (VG) 'pve'. The following output is from a
+test installation using a small 8GB disk:
 
+----
+# pvs
+  PV         VG   Fmt  Attr PSize PFree  
+  /dev/sda3  pve  lvm2 a--  7.87g 876.00m
+
+# vgs
+  VG   #PV #LV #SN Attr   VSize VFree  
+  pve    1   3   0 wz--n- 7.87g 876.00m
+----
+
+The installer allocates three **L**ogical **V**olumes (LV) inside this
+VG:
+
+----
+# lvs
+  LV   VG   Attr       LSize   Pool Origin Data%  Meta%
+  data pve  twi-a-tz--   4.38g             0.00   0.63
+  root pve  -wi-ao----   1.75g
+  swap pve  -wi-ao---- 896.00m     
+----
+
+root:: Formatted as 'ext4', and contains the operation system.
+
+swap:: Swap partition
+
+data:: This volume uses LVM-thin, and is used to store VM
+images. LVM-thin is preferable for this task, because it offers
+efficient support for snapshots and clones.
 
diff --git a/sysadmin.adoc b/sysadmin.adoc
index 74c6c8c..855b895 100644
--- a/sysadmin.adoc
+++ b/sysadmin.adoc
@@ -79,6 +79,8 @@ See Also
 
 * link:/wiki/System_Software_Updates[System Software Updates]
 
+* link:/wiki/Logical_Volume_Manager_(LVM)[Logical Volume Manager (LVM)]
+
 * link:/wiki/ZFS_on_Linux[ZFS on Linux]
 
 endif::wiki[]
@@ -96,6 +98,8 @@ include::system-software-updates.adoc[]
 
 include::pve-network.adoc[]
 
+include::local-lvm.adoc[]
+
 include::local-zfs.adoc[]
 
 endif::wiki[]
-- 
2.39.2