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/LUDOC-259 Lustre Documentation <p>Review the whole of the LFSCK documentation in the manual to ensure it is fit for purpose.</p> LUDOC-259

LFSCK4: Review the LFSCK documentation

Improvement Critical Resolved Fixed nasf Richard Henwood Fri, 24 Oct 2014 16:00:41 +0000 Thu, 23 Mar 2017 17:17:36 +0000 Thu, 23 Mar 2017 17:17:36 +0000 0 4 <p>After investigating <a href="https://jira.whamcloud.com/browse/LU-6265" title="Interop 2.6.0&lt;-&gt;2.7 conf-sanity test_28a: unknown param lma_self_repair" class="issue-link" data-issue-key="LU-6265"><del>LU-6265</del></a> I see that the /proc tunables and stats files are not really documented in the user manual. That should be done.</p> <p>One patch landed to improve clarity: <a href="http://review.whamcloud.com/#/c/14692/" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/#/c/14692/</a></p> <p>Now working on a patch for 'index_in_idif'.</p> <p>From discussion with Fan Yong:</p> <blockquote> <p>On Tue, 2015-12-08 at 02:32 +0000, Yong, Fan wrote:<br/> &gt; Yes, it is only for OST upgrade case (always use '0' as the index in <br/> &gt; IDIF, <a href="https://jira.whamcloud.com/browse/LU-3569" title="Use real OST index as ostid_to_fid() parameter instead of always &quot;0&quot;" class="issue-link" data-issue-key="LU-3569"><del>LU-3569</del></a>). It depends on the sysadmin whether to enable OST- <br/> &gt; index in IDIF. Similar as FID-in-dirent, once it is enabled, it cannot<br/> &gt; be reverted. Means cannot downgrade.<br/> &gt; </p> <p>Ok, which upgrade versions does it affect? 2.7-&gt;2.8?<br/> or something different?</p> <p>In fact, the patch of packing OST index into the IDIF has been landed since Lustre-2.6, but the patch for index_in_idif is landed to Lustre-2.7.</p> <p>So the real upgrade case happened for any old OST 2.x (x &lt;=5), but you only can control that for the new OST 2.y (y &gt;=7). That means, if you update 2.5 to 2.6, you should store OST index in IDIF, but you cannot control that.</p></blockquote> <p>The <tt>index_in_idif</tt> tunable was added for Lustre 2.7.0. It is used for improving the on-disk metadata information for ldiskfs OSTs after upgrade to increase the robustness of the LFSCK checking. OST filesystems formatted with Lustre 2.7.0 and later are already using the new on-disk metadata information and this tunable will not be present. For OST filesystems formatted with Lustre 2.4-2.6 that have not yet been upgraded, the <tt>index_in_idif</tt> tunable will be available to allow the one-time upgrade the new on-disk metadata information. Once this upgrade is completed, the system cannot easily be downgraded, so it should only be done after running the 2.7.0 or newer software for a long enough time that there is no chance of downgrade.</p> <p>To check if the filesystem still needs to be upgraded, use <tt>lctl get_param osd-ldiskfs.&#42;.index_in_idif</tt> on a Lustre 2.7.0 or newer OSS node. If this prints <tt>osd-ldiskfs.$fsname-OSTxxxx=0</tt> for any OST, then the OST still needs to be upgraded. In order to enable the improved on-disk metadata information, use <tt>lctl set_param osd-ldiskfs.&#42;.index_in_idif=1</tt> on all OSS nodes in the filesystem. On the next remount of the filesystem the <tt>index_in_idif</tt> tunable will no longer be present.</p> <p>It may be that some of the linked LUDOC tickets have already been addressed in the manual, in which case they can be closed. Otherwise, please submit patches to the manual to address the gaps.</p> <p>Fan Yong (fan.yong@intel.com) uploaded a new patch: <a href="https://review.whamcloud.com/26028" class="external-link" target="_blank" rel="nofollow noopener">https://review.whamcloud.com/26028</a><br/> Subject: <a href="https://jira.whamcloud.com/browse/LUDOC-259" title="LFSCK4: Review the LFSCK documentation " class="issue-link" data-issue-key="LUDOC-259"><del>LUDOC-259</del></a> lfsck: add the missed lfsck commands and options<br/> Project: doc/manual<br/> Branch: master<br/> Current Patch Set: 1<br/> Commit: eb025ea2ceb2ca518437f1fb07f8d4016bbaa0e7</p> <p>Joseph Gmitter (joseph.gmitter@intel.com) merged in patch <a href="https://review.whamcloud.com/26028/" class="external-link" target="_blank" rel="nofollow noopener">https://review.whamcloud.com/26028/</a><br/> Subject: <a href="https://jira.whamcloud.com/browse/LUDOC-259" title="LFSCK4: Review the LFSCK documentation " class="issue-link" data-issue-key="LUDOC-259"><del>LUDOC-259</del></a> lfsck: add the missed lfsck command and option<br/> Project: doc/manual<br/> Branch: master<br/> Current Patch Set: <br/> Commit: f1e4fa7e73797c13a55d3de49bedfb9987e761d7</p> <p>The patch has been landed.</p> Related LUDOC-369 LUDOC-186 LUDOC-145 Development Rank 1|hzwzg7: Rank (Obsolete) 16279