1
0
mirror of git://sourceware.org/git/lvm2.git synced 2024-10-27 10:25:13 +03:00
lvm2/man
Jonathan Brassow ff64e3500f RAID: Add scrubbing support for RAID LVs
New options to 'lvchange' allow users to scrub their RAID LVs.
Synopsis:
	lvchange --syncaction {check|repair} vg/raid_lv

RAID scrubbing is the process of reading all the data and parity blocks in
an array and checking to see whether they are coherent.  'lvchange' can
now initaite the two scrubbing operations: "check" and "repair".  "check"
will go over the array and recored the number of discrepancies but not
repair them.  "repair" will correct the discrepancies as it finds them.

'lvchange --syncaction repair vg/raid_lv' is not to be confused with
'lvconvert --repair vg/raid_lv'.  The former initiates a background
synchronization operation on the array, while the latter is designed to
repair/replace failed devices in a mirror or RAID logical volume.

Additional reporting has been added for 'lvs' to support the new
operations.  Two new printable fields (which are not printed by
default) have been added: "syncaction" and "mismatches".  These
can be accessed using the '-o' option to 'lvs', like:
	lvs -o +syncaction,mismatches vg/lv
"syncaction" will print the current synchronization operation that the
RAID volume is performing.  It can be one of the following:
        - idle:   All sync operations complete (doing nothing)
        - resync: Initializing an array or recovering after a machine failure
        - recover: Replacing a device in the array
        - check: Looking for array inconsistencies
        - repair: Looking for and repairing inconsistencies
The "mismatches" field with print the number of descrepancies found during
a check or repair operation.

The 'Cpy%Sync' field already available to 'lvs' will print the progress
of any of the above syncactions, including check and repair.

Finally, the lv_attr field has changed to accomadate the scrubbing operations
as well.  The role of the 'p'artial character in the lv_attr report field
as expanded.  "Partial" is really an indicator for the health of a
logical volume and it makes sense to extend this include other health
indicators as well, specifically:
        'm'ismatches:  Indicates that there are discrepancies in a RAID
                       LV.  This character is shown after a scrubbing
                       operation has detected that portions of the RAID
                       are not coherent.
        'r'efresh   :  Indicates that a device in a RAID array has suffered
                       a failure and the kernel regards it as failed -
                       even though LVM can read the device label and
                       considers the device to be ok.  The LV should be
                       'r'efreshed to notify the kernel that the device is
                       now available, or the device should be 'r'eplaced
                       if it is suspected of failing.
2013-04-11 15:33:59 -05:00
..
blkdeactivate.8.in scripts: introduce blkdeactivate 2012-10-12 14:44:24 +02:00
clvmd.8.in Update man pages 2012-04-11 12:42:10 +00:00
cmirrord.8.in a little more information for the cmirrord man page 2010-01-22 21:48:17 +00:00
dmeventd.8.in Updated documentation for dmeventd. 2011-12-22 15:50:38 +00:00
dmsetup.8.in man: dmsetup mangle also processes UUIDs now 2012-10-10 17:16:15 +02:00
fsadm.8.in Update man pages 2012-04-11 12:42:10 +00:00
lvchange.8.in RAID: Add scrubbing support for RAID LVs 2013-04-11 15:33:59 -05:00
lvconvert.8.in man: updates for lvconvert and lvcreate 2013-04-05 14:14:20 +02:00
lvcreate.8.in man: lvceate document external origin snapshot 2013-04-05 14:15:03 +02:00
lvdisplay.8.in Update man pages 2012-04-11 12:42:10 +00:00
lvextend.8.in Update man pages 2012-04-11 12:42:10 +00:00
lvm.8.in man: updates for lvconvert and lvcreate 2013-04-05 14:14:20 +02:00
lvm.conf.5.in docs: host tags has a default volume_list 2012-11-19 22:29:23 +00:00
lvmchange.8.in Update man pages 2012-04-11 12:42:10 +00:00
lvmconf.8.in Update man pages 2012-04-11 12:42:10 +00:00
lvmdiskscan.8.in Update man pages 2012-04-11 12:42:10 +00:00
lvmdump.8.in Update man pages 2012-04-11 12:42:10 +00:00
lvmetad.8.in lvmetad: use -l for logging level not -d 2012-10-15 10:44:43 +01:00
lvmsadc.8.in Update man pages 2012-04-11 12:42:10 +00:00
lvmsar.8.in Update man pages 2012-04-11 12:42:10 +00:00
lvreduce.8.in Update man pages 2012-04-11 12:42:10 +00:00
lvremove.8.in Update man pages 2012-04-11 12:42:10 +00:00
lvrename.8.in Update man pages 2012-04-11 12:42:10 +00:00
lvresize.8.in Support rounding of percentage upward 2012-01-05 15:38:18 +00:00
lvs.8.in RAID: Add scrubbing support for RAID LVs 2013-04-11 15:33:59 -05:00
lvscan.8.in Update man pages 2012-04-11 12:42:10 +00:00
Makefile.in scripts: introduce blkdeactivate 2012-10-12 14:44:24 +02:00
pvchange.8.in Update man pages 2012-04-11 12:42:10 +00:00
pvck.8.in Update man pages 2012-04-11 12:42:10 +00:00
pvcreate.8.in man: update pvcreate/pvs/vgconvert man page to cover embedding area support 2013-02-26 14:46:42 +01:00
pvdisplay.8.in Update man pages 2012-04-11 12:42:10 +00:00
pvmove.8.in Update man pages 2012-04-11 12:42:10 +00:00
pvremove.8.in Update man pages 2012-04-11 12:42:10 +00:00
pvresize.8.in Update man pages 2012-04-11 12:42:10 +00:00
pvs.8.in man: update pvcreate/pvs/vgconvert man page to cover embedding area support 2013-02-26 14:46:42 +01:00
pvscan.8.in man: --activate ay and auto_activation_volume_list 2012-06-29 12:40:26 +02:00
vgcfgbackup.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgcfgrestore.8.in thin: allow restore with --force 2012-11-27 14:08:24 +01:00
vgchange.8.in activate: skip manual activation for --sysinit -aay 2012-07-10 14:01:33 +02:00
vgck.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgconvert.8.in man: update pvcreate/pvs/vgconvert man page to cover embedding area support 2013-02-26 14:46:42 +01:00
vgcreate.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgdisplay.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgexport.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgextend.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgimport.8.in vgimport: Allow '--force' to import VGs with missing PVs. 2013-02-20 16:37:41 -06:00
vgimportclone.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgmerge.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgmknodes.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgreduce.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgremove.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgrename.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgs.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgscan.8.in Update man pages 2012-04-11 12:42:10 +00:00
vgsplit.8.in Update man pages 2012-04-11 12:42:10 +00:00