https://jira.whamcloud.com This file is an XML representation of an issue en-us 9.4.14 940014 05-12-2023 https://jira.whamcloud.com/browse/LU-8217 Lustre <p>Looking for clarification on the intent of the "-A" option to "lctl lfsck_start".</p> <p>The helpt text says:</p> <div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent"> <pre>options: -M: device to start LFSCK/scrub on -A: start LFSCK on all MDT devices </pre> </div></div> <p>Which implies that one should either run lfsck on just one OR all devices. Yet, it seems that specifying -M is still required:</p> <div class="preformatted panel" style="border-width: 1px;"><div class="preformattedContent panelContent"> <pre>service322 ~ # lctl lfsck_start -A Must specify device to start LFSCK. </pre> </div></div> <p>So, I would guess that "-M" was never made non-mandatory in the arg parsing when -A was added. Or perhaps the help text is just misleading and all that is needed is a documentation update?</p> <p>Should the -A and -M options be mutually-exclusive?</p> <p>Under what circumstances would you NOT want to use -A? Should that just be the default, and then -M is optional to be more restrictive in lfsck operation, and no -A option is needed at all?</p> LU-8217

Clarify interaction of lfsck_start -A and -M options

Bug Minor Closed Not a Bug nasf Nathan Dauchy Mon, 30 May 2016 15:08:15 +0000 Thu, 9 Jun 2016 00:03:28 +0000 Thu, 9 Jun 2016 00:03:28 +0000 Lustre 2.7.0 0 4 <p>Fan Yong</p> <p>Could you please advise?</p> <p>Thanks</p> <p>Peter</p> <p>Sorry for the confusing. The new LFSCK contains several functionalities, some of the them is local device based, such as OI scrub, linkEA and FID-in-dirent verification; some of them cross MDT-OST servers, such as layout LFSCK; some of them needs all MDTs to be involved, such as namespace LFSCK for DNE. All these functionalities or components share the same LFSCK API.</p> <p>The option "-M" specify to which device the LFSCK command is initially sent. For example, if you want to start OI scrub on the MDT0002, you can specify "lctl lfsck_start -M $FSNAME-MDT0002 -t scrub", then related command will be sent to MDT0002 only. If you want to start layout LFSCK on the MDT0003, you can specify "lctl lfsck_start -M $FSNAME-MDT0003 -t layout", then related command will be sent to MDT0003, and MDT0003 will send LFSCK command to OSTs.</p> <p>The option "-A" means we want to start/stop LFSCK on all MDTs devices. Under such case, you still need to specify "-M" option. For example, you have four MDTs in your system, you want to start layout LFSCK on all MDTs (and related OSTs), you can specify "lctl lfsck_start -M $FSNAME-MDT0000 -t layout", then related command will be sent to MDT0000, and MDT0000 will send LFSCK command to other three MDTs, and each MDT will send the LFSCK command to OSTs.</p> <p>So "-M" and "-A" are NOT exclusive each other. "-M" is mandatory, in spite of "-A" specified or not. "-A" is optional, that is disabled by default. But sometimes it will be enabled automatically. For example, if you specify "-o" for layout LFSCK to handle orphan OST-objects, even if you does not specify "-A", the LFSCK commands will be sent to all MDTs and OSTs, that is initially from the MDTxxxx specified by "-M" option. On the other hand, if you want to start namespace LFSCK for DNE case, you need to specify "-A" explicitly, otherwise it will start local namespace LFSCK for linkEA and FID-in-dirent only.</p> <p>That clarification helps a lot, thanks! (maybe some of it should be in the manual or help output?)</p> <p>Just to be sure I understand... on a system with a single MDT, there is never really a need to use the -A option, since the other flags will control whether LFSCK commands are sent to the OSTs, right? Conversely, what is the downside to specifying -A, and why not just make that the default behaviour to simplify things for the system admins?</p> <p>For single MDT system, no need to specify "-A" option. The MDT will dispatch related LFSCK command to OSTs automatically.<br/> As for why not enable "-A" by default, there is no special reason, but consider some use cases, such as OI scrub, it is local device based, such functionality was introduced since Lustre-2.3, at that time, no "-A" option yet. If we make "-A" enable by default, then we need another option for these non "-A" cases.</p> Development End date Tue, 31 May 2016 15:08:15 +0000 Rank 1|hzyd3z: Rank (Obsolete) 9223372036854775807 Severity Start date Mon, 30 May 2016 15:08:15 +0000