From 0e13f6625e9cd0a33baa0336eded58fff9896927 Mon Sep 17 00:00:00 2001 From: Richard Henwood Date: Wed, 6 May 2015 12:39:42 -0500 Subject: [PATCH] LUDOC-254 lfsck: clarify commands. Clarify the starting of LFSCK with -A. Device is an ambigious term, remove it and use 'target' instead. Fix up some other small issues. Change-Id: I1b77da753b60bf405936539d626eecb33f5717f9 Signed-off-by: Richard Henwood Reviewed-on: http://review.whamcloud.com/14692 Tested-by: Jenkins --- TroubleShootingRecovery.xml | 64 ++++++++++++++++++++------------------------- 1 file changed, 28 insertions(+), 36 deletions(-) diff --git a/TroubleShootingRecovery.xml b/TroubleShootingRecovery.xml index 3c24798..b6bb0e5 100644 --- a/TroubleShootingRecovery.xml +++ b/TroubleShootingRecovery.xml @@ -239,26 +239,18 @@ root# e2fsck -fp /dev/sda # fix errors with prudent answers (usually
Usage - lctl lfsck_start -M | --device -[MDT,OST]_device \ +lctl lfsck_start <-M | --device [MDT,OST]_device> \ [-A | --all] \ - [-c | --create_ostobj -[on | off]] \ - [-C | --create_mdtobj -[on | off]] \ - [-e | --error -{continue | abort}] \ + [-c | --create_ostobj on | off] \ + [-C | --create_mdtobj on | off] \ + [-e | --error {continue | abort}] \ [-h | --help] \ - [-n | --dryrun -[on | off]] \ + [-n | --dryrun on | off] \ [-o | --orphan] \ [-r | --reset] \ - [-s | --speed -ops_per_sec_limit] \ - [-t | --type -lfsck_type[,lfsck_type...]] \ - [-w | --window_size -size] + [-s | --speed ops_per_sec_limit] \ + [-t | --type check_type[,check_type...]] \ + [-w | --window_size size]
Options @@ -292,7 +284,7 @@ root# e2fsck -fp /dev/sda # fix errors with prudent answers (usually - The MDT or OST device to start LFSCK on. + The MDT or OST target to start LFSCK on. @@ -302,9 +294,10 @@ root# e2fsck -fp /dev/sda # fix errors with prudent answers (usually - Start LFSCK on all devices. - This applies to both layout and - namespace consistency checking and repair. + Start LFSCK on all + targets on all servers simultaneously. + By default, both layout and namespace + consistency checking and repair are started. @@ -471,8 +464,7 @@ root# e2fsck -fp /dev/sda # fix errors with prudent answers (usually
Usage - lctl lfsck_stop -M | --device -[MDT,OST]_device \ +lctl lfsck_stop <-M | --device [MDT,OST]_device> \ [-A | --all] \ [-h | --help]
@@ -508,7 +500,7 @@ root# e2fsck -fp /dev/sda # fix errors with prudent answers (usually - The MDT or OST device to stop LFSCK on. + The MDT or OST target to stop LFSCK on. @@ -518,7 +510,8 @@ root# e2fsck -fp /dev/sda # fix errors with prudent answers (usually - Stop LFSCK on all devices. + Stop LFSCK on all targets on all servers + simultaneously. @@ -548,13 +541,12 @@ root# e2fsck -fp /dev/sda # fix errors with prudent answers (usually to trace the corresponding LFSCK component status. For OI Scrub, the interface is the OSD layer procfs interface, named oi_scrub. To display OI Scrub status, the standard - lctl get_param command is used as shown in the usage below.
Usage - lctl get_param -n osd-ldiskfs.FSNAME-[MDT_device|OST_device].oi_scrub + lctl get_param -n osd-ldiskfs.FSNAME-[MDT_target|OST_target].oi_scrub
Output @@ -686,13 +678,13 @@ root# e2fsck -fp /dev/sda # fix errors with prudent answers (usually Success Count total number of - completed OI_scrub runs on the device. + completed OI_scrub runs on the target. Run Time how long the scrub has run, tally from the time of scanning from the beginning of - the specified MDT device, not include the + the specified MDT target, not include the paused/failure time among checkpoints. @@ -747,7 +739,7 @@ root# e2fsck -fp /dev/sda # fix errors with prudent answers (usually
Usage - lctl get_param -n mdd. FSNAME-MDT_device.lfsck_namespace + lctl get_param -n mdd. FSNAME-MDT_target.lfsck_namespace
Output @@ -1043,7 +1035,7 @@ root# e2fsck -fp /dev/sda # fix errors with prudent answers (usually Success Count the total number of - completed LFSCK runs on the device. + completed LFSCK runs on the target. @@ -1112,10 +1104,10 @@ root# e2fsck -fp /dev/sda # fix errors with prudent answers (usually Usage lctl get_param -n mdd. FSNAME- -MDT_device.lfsck_layout +MDT_target.lfsck_layout lctl get_param -n obdfilter. FSNAME- -OST_device.lfsck_layout +OST_target.lfsck_layout
Output @@ -1222,7 +1214,7 @@ lctl get_param -n obdfilter. Success Count: the total number of - completed LFSCK runs on the device. + completed LFSCK runs on the target. @@ -1348,9 +1340,9 @@ lctl get_param -n obdfilter.
Usage - lctl set_param mdd.${FSNAME}-${MDT_device}.lfsck_speed_limit= + lctl set_param mdd.${FSNAME}-${MDT_target}.lfsck_speed_limit= N -lctl set_param obdfilter.${FSNAME}-${OST_device}.lfsck_speed_limit= +lctl set_param obdfilter.${FSNAME}-${OST_target}.lfsck_speed_limit= N
@@ -1404,7 +1396,7 @@ lctl set_param obdfilter.${FSNAME}-${OST_device}.lfsck_speed_limit=
Usage - lctl set_param osd_ldiskfs.${FSNAME}-${MDT_device}.auto_scrub=N + lctl set_param osd_ldiskfs.${FSNAME}-${MDT_target}.auto_scrub=N where Nis an integer as described below. Lustre software 2.5 and later supports -- 1.8.3.1