1
0
mirror of git://sourceware.org/git/lvm2.git synced 2025-01-02 01:18:26 +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 .br
.B lvconvert --type thin --poolmetadatasize 1G vg/lvol1 .B lvconvert --type thin --poolmetadatasize 1G vg/lvol1
.P .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 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. is used as an external read-only origin for the new thin LV.
.br .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 vg Vwi-a-tz-- 12,00m thick_tpool0 100,00 0
thick_tpool0 vg twi---tz-- 12,00m 100,00 10,94 256,00k 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 .SH THIN TOPICS
. .
.B Automatic pool metadata LV .B Automatic pool metadata LV
@ -1362,4 +1392,7 @@ skipped while mounting readonly:
.BR thin_check (8), .BR thin_check (8),
.BR thin_dump (8), .BR thin_dump (8),
.BR thin_repair (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 lvremove (8),
.BR lvs (8), .BR lvs (8),
.P .P
.BR vdo (8),
.BR vdoformat (8), .BR vdoformat (8),
.BR vdostats (8), .BR vdostats (8),
.P .P