mrc0mmand / rpms / lvm2

Forked from rpms/lvm2 2 years ago
Clone

Blame SOURCES/lvm2-2_03_12-man-update-lvmthin.patch

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