[pve-devel] [PATCH pve-manager] Add useful examples to lvm/lvmthin section.

[Dietmar Maurer]

IMHO this is the wrong location. I suggest to use local-lvm.adoc instead.

> On October 6, 2016 at 12:07 PM Wolfgang Link <w.link at proxmox.com> wrote:
> 
> 
> How to manage it.
> ---
>  pve-storage-lvm.adoc     | 38 ++++++++++++++++++++++++++++++++++++++
>  pve-storage-lvmthin.adoc | 43 +++++++++++++++++++++++++++++++++++++++++++
>  2 files changed, 81 insertions(+)
> 
> diff --git a/pve-storage-lvm.adoc b/pve-storage-lvm.adoc
> index 3f21644..18f2810 100644
> --- a/pve-storage-lvm.adoc
> +++ b/pve-storage-lvm.adoc
> @@ -85,6 +85,44 @@ List available volume groups:
>  
>   # pvesm lvmscan
>  
> +
> +Storage Layout
> +~~~~~~~~~~~~~~
> +
> +On a default installation {pve} will use lvm.
> +
> +The layout looks as follows.
> +
> +.Default LVM Layout.
> +[width="100%",options="header"]
> +|==============================================================================
> +|VG  |LV	   |Mountpoint		|Note
> +|pve |swap	   |			|will used as swap partition
> +|pve |root	   |/			|
> +|pve |data	   |/var/lib/vz/	|{pve} < 4.2 installed
> +|pve |data	   |			|{pve} >= 4.2 installed
> +|==============================================================================
> +
> +For {pve} versions up to 4.1, the installer creates a Logical Volume
> +called 'data' which is mounted at /var/lib/vz
> +Starting from 4.2 the Logical Volume 'data' is a LVM thin volume, used
> +for block based storage of guest systems, and /var/lib/vz is simply a
> +directory on the root file system.
> +
> +
> +Creating a Volume Group
> +~~~~~~~~~~~~~~~~~~~~~
> +
> +Let's assume we have an empty disk /dev/sdb, onto which we want to make a
> Volume Group named vmdata.
> +
> +First create a partition.
> +
> + # sgdisk -N 1 /dev/sdb
> +
> + #pvcreate --metadatasize 250k -y -ff /dev/sdb1
> +
> + #vgcreate vmdata /dev/sdb1
> +
>  ifdef::wiki[]
>  
>  See Also
> diff --git a/pve-storage-lvmthin.adoc b/pve-storage-lvmthin.adoc
> index be730cf..8f1e378 100644
> --- a/pve-storage-lvmthin.adoc
> +++ b/pve-storage-lvmthin.adoc
> @@ -76,6 +76,49 @@ List available LVM thin pools on volume group `pve`:
>  
>   # pvesm lvmthinscan pve
>  
> +
> +Creating an extra LV for /var/lib/vz
> +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> +
> +This can be easily done by create a new thin LV.
> +
> + #lvcreate -n <Name> -V <Size[M,G,T]> <VG>/<LVThin_pool>`
> +
> +A real world example might look.
> +
> + # lvcreate -n vz -V 10G pve/data
> +
> +Now a filesystem must be create on the LV.
> +
> + # mkfs.ext4 /dev/data/vz
> +
> +And at last step this have to be mounted.
> +
> +WARNING: be sure that /var/lib/vz is empty. On a default installation it's
> not.
> +
> +To make it always accessible add the following line at '/etc/fstab'.
> +
> + # echo '/dev/pve/vz /var/lib/vz ext4 defaults 0 2' >> /etc/fstab
> +
> +
> +Resizing the thin pool
> +~~~~~~~~~~~~~~~~~~~~~~
> +
> +NOTE: When extending the data pool, the metadata pool must be extended with
> it.
> +
> +Resize the LV and the metadata pool can be achieved with the following
> command.
> +
> + # lvresize --size +<size[\M,G,T]> --poolmetadatasize +<size[\M,G]>
> <VG>/<LVThin_pool>`
> +
> +
> +Create a LVM-Thin pool
> +~~~~~~~~~~~~~~~~~~~~~~
> +
> +A thin pool has to be created on top of a volume group.
> +How to create a Volume Group see Section LVM.
> +
> + # lvcreate -L 80G -T -n vmstore vmdata
> +
>  ifdef::wiki[]
>  
>  See Also
> -- 
> 2.1.4
> 
> 
> _______________________________________________
> pve-devel mailing list
> pve-devel at pve.proxmox.com
> http://pve.proxmox.com/cgi-bin/mailman/listinfo/pve-devel