1
0
mirror of git://sourceware.org/git/lvm2.git synced 2024-12-30 17:18:21 +03:00

man: document creation of VDO thin-pool

Show some examples how to create and convert thin-pools
with VDO volume for thin-pool data.
This commit is contained in:
Zdenek Kabelac 2023-12-14 23:21:11 +01:00
parent db0de73d6e
commit cd3275ce73
3 changed files with 39 additions and 2 deletions

View File

@ -89,6 +89,11 @@ through thinLV and for the conversion set the pool metadata size to 1GiB.
.br
.B lvconvert --type thin --poolmetadatasize 1G vg/lvol1
.P
Convert an LV into a thin-pool with VDO deduplication and compression
for storing its data.
.br
.B lvconvert --type thin-pool --pooldatavdo y vg/lvol1
.P
Convert an LV into a thin LV in the specified thin pool. The existing LV
is used as an external read-only origin for the new thin LV.
.br

View File

@ -272,6 +272,36 @@ Convert LV to a thin pool with chunk size 256KiB.
thick vg Vwi-a-tz-- 12,00m thick_tpool0 100,00 0
thick_tpool0 vg twi---tz-- 12,00m 100,00 10,94 256,00k
.
.SS \n+[step]. Create thin-pool with compression and deduplication
.
Create a new thin-pool with the use of VDO layer for compression and
deduplication of stored data.
.P
.B lvcreate --type thin-pool --pooldatavdo y VG/PoolLV
.P
.I Example
.br
Create a 10G CompressedPool thin-pool with VDO data volume whose
VDO slab size is 4096 MiB.
.br
.nf
# lvcreate --type thin-pool -L10G --pooldatavdo y \\
--vdosettings 'slab_size_mb=4096' VG/CompressedPool
.fi
.
.SS \n+[step]. Convert an LV into a compressed deduplicated thin-pool
.
Convert an existing LV (linear, stripe,...) to the thinpool whose
data volume is using VDO layer for compression and deduplication.
.P
.B lvconvert --type thin-pool --pooldatavdo y VG/LV
.P
.I Example
.br
Convert existing BigVolume LV into a compressed thin-pool.
.br
# lvconvert --type thin-pool --pooldatavdo y VG/BigVolume
.
.SH THIN TOPICS
.
.B Automatic pool metadata LV
@ -1362,4 +1392,7 @@ skipped while mounting readonly:
.BR thin_check (8),
.BR thin_dump (8),
.BR thin_repair (8),
.BR thin_restore (8)
.BR thin_restore (8),
.P
.BR vdoformat (8),
.BR vdostats (8)

View File

@ -441,7 +441,6 @@ a dense UDS index uses 17 GiB of storage and a sparse UDS index will use
.BR lvremove (8),
.BR lvs (8),
.P
.BR vdo (8),
.BR vdoformat (8),
.BR vdostats (8),
.P