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-379 Lustre Documentation <p>The new ladvise lockahead feature (<a href="https://jira.whamcloud.com/browse/LU-6179" title="Lock ahead - Request extent locks from userspace" class="issue-link" data-issue-key="LU-6179"><del>LU-6179</del></a>) should be documented in the manual.</p> LUDOC-379

Document ladvise lockahead feature

Bug Minor Resolved Fixed Patrick Farrell Patrick Farrell Tue, 6 Jun 2017 18:50:25 +0000 Mon, 21 May 2018 14:46:32 +0000 Wed, 16 May 2018 17:49:41 +0000 0 6 <p>Feel free to assign this to me.</p> <p>Patrick</p> <p>When do you expect to have some content suitable for the manual for lock-ahead? We could help with the formatting if you have the content in some other kind of format (Word, RTF, etc)</p> <p>Peter</p> <p>Yeah, I need to get moving on this.  Looking at the manual, I see there's now some ladvise documentation in there!</p> <p>I've got some stuff written up, I'll see about integrating it.  A little tricky figuring out quite where to put some of it.</p> <p>Attempting to follow the instructions from here:</p> <p><a href="https://wiki.hpdd.intel.com/display/PUB/Making+changes+to+the+Lustre+Manual+source" class="external-link" target="_blank" rel="nofollow noopener">https://wiki.hpdd.intel.com/display/PUB/Making+changes+to+the+Lustre+Manual+source</a></p> <p>I ran in to this:</p> <p><span class="error">&#91;build@centbuild02 lustre-manual&#93;</span>$ make check &amp;&amp; make pdf<br/> xmllint --noout --xinclude --noent --relaxng ./index.xml<br/> ./index.xml:-1: Relax-NG parser error : xmlRelaxNGParse: ./index.xml is empty<br/> Relax-NG schema ./index.xml failed to compile</p> <p>I didn't check out a local branch (yet), but that seems unlikely to be causing this...?</p> <p><a href="https://jira.whamcloud.com/secure/ViewProfile.jspa?name=jgmitter" class="user-hover" rel="jgmitter">jgmitter</a> any advice for Patrick?</p> <p><a href="https://jira.whamcloud.com/secure/ViewProfile.jspa?name=paf" class="user-hover" rel="paf">paf</a> I would suggest adding what content you have first and listing any uncertainties about where to place the content. Then we can iterate towards something we can integrate into the manual.</p> <p>Hi Patrick,</p> <p>What platform are you attempting to build on?  I would try to build the html version first as I have seen issues with missing packages when attempting to build a pdf for the first time.</p> <p>make check &amp;&amp; make html</p> <p>Thanks.</p> <p>Joe</p> <p>Thanks, Peter - I'm starting with updating the obvious bits (usage, lists of options, etc), and then, yes, I'll drop the general guidance in there somewhere and we can try to figure out where would be good.</p> <p>Joseph,</p> <p>centos7 - That error is from make check:</p> <p><span class="error">&#91;build@centbuild02 lustre-manual&#93;</span>$ make check<br/> xmllint --noout --xinclude --noent --relaxng ./index.xml<br/> ./index.xml:-1: Relax-NG parser error : xmlRelaxNGParse: ./index.xml is empty<br/> Relax-NG schema ./index.xml failed to compile</p> <p>Perhaps I'm missing some tool that make is supposed to be calling?</p> <p>Hi Patrick,</p> <p>I replicated the error on a fresh centos7 install.  It appears the error is coming from missing the docbook5-style-xsl docbook5-schema docbook5-schemas packages.  I would make sure that you have all of the following packages installed:</p> <p>yum install fop libxml2 libxslt docbook5-style-xsl docbook5-schema docbook5-schemas</p> <p>Installing that basic set on a fresh centos7 image allows me to run make check, make html, and make pdf.</p> <p>Thanks.</p> <p>Joe</p> <p>Joe,</p> <p>Thanks, that worked great.  Now I can find my syntax errors <img class="emoticon" src="https://jira.whamcloud.com/images/icons/emoticons/smile.png" height="16" width="16" align="absmiddle" alt="" border="0"/></p> <p>I'll keep working this a little and then submit.</p> <p>Patrick Farrell (paf@cray.com) uploaded a new patch: <a href="https://review.whamcloud.com/32331" class="external-link" target="_blank" rel="nofollow noopener">https://review.whamcloud.com/32331</a><br/> Subject: <a href="https://jira.whamcloud.com/browse/LUDOC-379" title="Document ladvise lockahead feature" class="issue-link" data-issue-key="LUDOC-379"><del>LUDOC-379</del></a>: Ladvise Lockahead<br/> Project: doc/manual<br/> Branch: master<br/> Current Patch Set: 1<br/> Commit: 89f9ccf0557dff2a43784e91cd0b1b07f801b0a7</p> <p>Joseph Gmitter (joseph.gmitter@intel.com) merged in patch <a href="https://review.whamcloud.com/32331/" class="external-link" target="_blank" rel="nofollow noopener">https://review.whamcloud.com/32331/</a><br/> Subject: <a href="https://jira.whamcloud.com/browse/LUDOC-379" title="Document ladvise lockahead feature" class="issue-link" data-issue-key="LUDOC-379"><del>LUDOC-379</del></a>: Ladvise Lockahead<br/> Project: doc/manual<br/> Branch: master<br/> Current Patch Set: <br/> Commit: 976ef1f4cae06717b84299d8f1a653f151262ec3</p> <p>Patch has landed.</p> <p>Patrick Farrell (paf@cray.com) uploaded a new patch: <a href="https://review.whamcloud.com/32436" class="external-link" target="_blank" rel="nofollow noopener">https://review.whamcloud.com/32436</a><br/> Subject: <a href="https://jira.whamcloud.com/browse/LUDOC-379" title="Document ladvise lockahead feature" class="issue-link" data-issue-key="LUDOC-379"><del>LUDOC-379</del></a>: Ladvise Lockahead<br/> Project: doc/manual<br/> Branch: master<br/> Current Patch Set: 1<br/> Commit: e590c8f9a3f01a10c9524b462c3e1ad88a3049da</p> <p>Joseph Gmitter (joseph.gmitter@intel.com) merged in patch <a href="https://review.whamcloud.com/32436/" class="external-link" target="_blank" rel="nofollow noopener">https://review.whamcloud.com/32436/</a><br/> Subject: <a href="https://jira.whamcloud.com/browse/LUDOC-379" title="Document ladvise lockahead feature" class="issue-link" data-issue-key="LUDOC-379"><del>LUDOC-379</del></a>: Ladvise Lockahead<br/> Project: doc/manual<br/> Branch: master<br/> Current Patch Set: <br/> Commit: 59ea0bc323e725cf9e5051144d82665f27814ce6</p> Related LU-6179 Development Rank 1|hzzebr: Rank (Obsolete) 9223372036854775807 Severity