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-4932 Lustre <p>Design documentation for Lustre file system and it's features has traditionally appeared and withered in various wikis and presentations.</p> <p>The documentation should be kept with the source where it can be reviewed and kept up-to-date.</p> LU-4932

include design documentation in with the Lustre source code.

Technical task LU-1892 Critical Resolved Fixed Richard Henwood Richard Henwood Mon, 21 Apr 2014 14:06:22 +0000 Wed, 29 Mar 2017 21:56:26 +0000 Fri, 28 Aug 2015 17:56:27 +0000 Lustre 2.8.0 0 8 <p>first patch for LFSCK is available here:</p> <p><a href="http://review.whamcloud.com/#/c/10033/" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/#/c/10033/</a></p> <p><a href="http://review.whamcloud.com/#/c/10040/" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/#/c/10040/</a></p> <p>Richard, the 10033 patch has landed to master for 2.6.0. It would be good to start pushing some of the other docs, like DNE Phase 1, Imperative Recovery, etc. </p> <p>Richard, could you please work with the engineers to submit patches for their design documentation for features that have already landed.</p> <p>Yep. LFSCK 3 is in progress:</p> <p><a href="http://review.whamcloud.com/#/c/10040/3" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/#/c/10040/3</a></p> <p>I will ask Amir for DLC documentation.</p> <p>Can you help with </p> <p><a href="https://jira.whamcloud.com/browse/LU-3527" title="UID/GID Mapping" class="issue-link" data-issue-key="LU-3527"><del>LU-3527</del></a> - UID/GID Mapping<br/> <a href="https://jira.whamcloud.com/browse/LU-2182" title="Add llapi_file_get_layout() function in liblustreapi" class="issue-link" data-issue-key="LU-2182"><del>LU-2182</del></a> - Striping API (LLNL)<br/> <a href="https://jira.whamcloud.com/browse/LU-4665" title="utils: lfs setstripe to specify OSTs" class="issue-link" data-issue-key="LU-4665"><del>LU-4665</del></a> - OST Placement (ORNL)<br/> <a href="https://jira.whamcloud.com/browse/LU-5030" title="&quot;lctl {get,set}_param&quot; should also check in /sys/fs/{lnet,lustre}" class="issue-link" data-issue-key="LU-5030"><del>LU-5030</del></a> - Deprecate procfs (ORNL)</p> <p>Also, as per discussion with Doug: the guidance currently is:</p> <p> + the format is plain text.<br/> + diagrams must be in plain text. <a href="http://www.asciidraw.com/" class="external-link" target="_blank" rel="nofollow noopener">http://www.asciidraw.com/</a> and <a href="http://asciiflow.com/" class="external-link" target="_blank" rel="nofollow noopener">http://asciiflow.com/</a> may be of interest.</p> <p>also </p> <p><a href="http://review.whamcloud.com/#/c/10618/" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/#/c/10618/</a></p> <p>Andreas Dilger (andreas.dilger@intel.com) merged in patch <a href="http://review.whamcloud.com/10040/" class="external-link" target="_blank" rel="nofollow noopener">http://review.whamcloud.com/10040/</a><br/> Subject: <a href="https://jira.whamcloud.com/browse/LU-4932" title="include design documentation in with the Lustre source code." class="issue-link" data-issue-key="LU-4932"><del>LU-4932</del></a> doc: update design doc for LFSCK<br/> Project: fs/lustre-release<br/> Branch: master<br/> Current Patch Set: <br/> Commit: b3a5032f6195cd4cf6ea7f39dd2010c115e99337</p> <p>Both patches have landed. Closing the ticket. We will open new tickets for any future work needed.</p> <p>Andreas Dilger (andreas.dilger@intel.com) uploaded a new patch: <a href="https://review.whamcloud.com/26253" class="external-link" target="_blank" rel="nofollow noopener">https://review.whamcloud.com/26253</a><br/> Subject: <a href="https://jira.whamcloud.com/browse/LU-4932" title="include design documentation in with the Lustre source code." class="issue-link" data-issue-key="LU-4932"><del>LU-4932</del></a> doc: update LFSCK documentation<br/> Project: fs/lustre-release<br/> Branch: master<br/> Current Patch Set: 1<br/> Commit: 3c5bd6266af83026a08208cef876b848929c74f4</p> Related LU-5147 Development Rank 1|hzwkmf: Rank (Obsolete) 13636