mrc0mmand / rpms / lvm2

Forked from rpms/lvm2 2 years ago
Clone

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

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