shaba/lvm2
1
0
Fork 0
mirror of git://sourceware.org/git/lvm2.git synced 2025-03-10 16:58:47 +03:00
Code Releases Activity

man: update lvmthin

Browse Source 
Add few more notes about thin-pool repair.
Fix couple typos.
This commit is contained in:
Zdenek Kabelac 2021-01-23 00:40:52 +01:00
parent a690d16d29
commit b218a7cfe7
1 changed files with 23 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
man/lvmthin.7_main
View File

@ -394,7 +394,7 @@ the pmspare LV.
\& \&
If thin pool metadata is damaged, it may be repairable. If thin pool metadata is damaged, it may be repairable.
Checking and repairing thin pool metadata is analagous to Checking and repairing thin pool metadata is analogous to
running fsck/repair on a file system. running fsck/repair on a file system.
When a thin pool LV is activated, lvm runs the thin_check command When a thin pool LV is activated, lvm runs the thin_check command
@ -437,14 +437,24 @@ copy to the VG's pmspare LV.
If step 1 is successful, the thin pool metadata LV is replaced If step 1 is successful, the thin pool metadata LV is replaced
with the pmspare LV containing the corrected metadata. with the pmspare LV containing the corrected metadata.
The previous thin pool metadata LV, containing the damaged metadata, The previous thin pool metadata LV, containing the damaged metadata,
becomes visible with the new name ThinPoolLV_tmetaN (where N is 0,1,...). becomes visible with the new name ThinPoolLV_metaN (where N is 0,1,...).
If the repair works, the thin pool LV and its thin LVs can be activated, If the repair works, the thin pool LV and its thin LVs can be activated.
and the LV containing the damaged thin pool metadata can be removed. User should manually check if repaired thin pool kernel metadata
It may be useful to move the new metadata LV (previously pmspare) to a has all data for all lvm2 known LVs by individual activation of
better PV. every thin LV. When all works, user should continue with fsck of
all filesystems present these such volumes.
Once the thin pool is considered fully functional user may remove ThinPoolLV_metaN
(the LV containing the damaged thin pool metadata) for possible
space reuse.
For a better performance it may be useful to pvmove the new repaired metadata LV
(written to previous pmspare volume) to a better PV (i.e. SSD)
If the repair does not work, the thin pool LV and its thin LVs are lost. If the repair operation fails, the thin pool LV and its thin LVs
are not accessible and it may be necessary to restore their content
from a backup. In such case the content of unmodified original damaged
ThinPoolLV_metaN volume can be used by your support for more
advanced recovery methods.
If metadata is manually restored with thin_repair directly, If metadata is manually restored with thin_repair directly,
the pool metadata LV can be manually swapped with another LV the pool metadata LV can be manually swapped with another LV
@ -452,6 +462,9 @@ containing new metadata:
.B lvconvert --thinpool VG/ThinPoolLV --poolmetadata VG/NewThinMetaLV .B lvconvert --thinpool VG/ThinPoolLV --poolmetadata VG/NewThinMetaLV
Note: Thin pool metadata is compact so even small corruptions
in them may result in significant portions of mappings to be lost.
It is recommended to use fast resilient storage for them.
.SS Activation of thin snapshots .SS Activation of thin snapshots
@ -549,7 +562,7 @@ Command to extend thin pool data space:
.fi .fi
Other methods of increasing free data space in a thin pool LV Other methods of increasing free data space in a thin pool LV
include removing a thin LV and its related snapsots, or running include removing a thin LV and its related snapshots, or running
fstrim on the file system using a thin LV. fstrim on the file system using a thin LV.
@ -689,7 +702,7 @@ with two configuration settings:
.B thin_pool_autoextend_threshold .B thin_pool_autoextend_threshold
.br .br
is a percentage full value that defines when the thin pool LV should be is a percentage full value that defines when the thin pool LV should be
extended. Setting this to 100 disables automatic extention. The minimum extended. Setting this to 100 disables automatic extension. The minimum
value is 50. value is 50.
.BR lvm.conf (5) .BR lvm.conf (5)
@ -716,7 +729,7 @@ the --ignoremonitoring option can be used. With this option, the command
will not ask dmeventd to monitor the thin pool LV. will not ask dmeventd to monitor the thin pool LV.
.IP \[bu] .IP \[bu]
Setting thin_pool_autoextend_threshould to 100 disables automatic Setting thin_pool_autoextend_threshold to 100 disables automatic
extension of thin pool LVs, even if they are being monitored by dmeventd. extension of thin pool LVs, even if they are being monitored by dmeventd.
.P .P